opal 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebf169fc98d390d965c39386668f569467dc11db3eff5f2571db172f9f632b02
-  data.tar.gz: 7d4d4e0de908d931ca39ac6d05d5fcbc1f1f1c1585e0cad22549ad31129f4064
+  metadata.gz: f13610ebfa130a3b3379a2d23f3fc077de87e4fd69c33248a87bdf23e144686a
+  data.tar.gz: 275fa37ed3f201f2c716bcf8f05cc5fcd5ff42dec5aaae1b4753c126a629d5c1
 SHA512:
-  metadata.gz: 6c80d8bcb148c8c8563b88c0e482f77937e4f4e8cc2144a5f9f83ea1e4b914a3e3bf7888b591d9721a20e050a64e08ddb099af7c5b4cb939d8c2f8472a662c9d
-  data.tar.gz: e04acce5335dd3ffe2bafdd40425ad788ff50316240d7863c7b8256b97f69a48a7f18cdcb9d9c1ddf0b738e366d5290b510ed6978735661a8f59f3e9003d3148
+  metadata.gz: b5a9d1f1494542fd5d1669bb16548b5a335777398a3d84945dbabb8477cedd79f1fd1fc251f663e9f22a518a9a7c3d361f83fb14c860bc3cb36b79c7cd6c40b8
+  data.tar.gz: 90f237673bc19937ee643fbe5562cd348476f975a90348c95138785457a6da342b4df98a48d14b223a938e9c91ac603fde0d2c5cbe18982ec1bcc3c1e6d4c375

data/.codeclimate.yml

@@ -9,13 +9,13 @@ checks:
       threshold: 10
   file-lines:
     config:
-      threshold: 250
+      threshold: 1000
   method-complexity:
     config:
       threshold: 5
   method-count:
     config:
-      threshold: 20
+      threshold: 100
   method-lines:
     config:
       threshold: 30
@@ -39,6 +39,7 @@ plugins:
 
 exclude_patterns:
   - "benchmark/*"
+  - "benchmark-ips/*"
   - "build/*"
   - "coverage/*"
   - "docs/*"
@@ -50,5 +51,4 @@ exclude_patterns:
   - "**/node_modules/*"
   - stdlib/nodejs/js-yaml-3-6-1.js
   - lib/opal/source_map/vlq.rb
-  - lib/opal/cli_runners/source-map-support.js
-  - lib/opal/cli_runners/source-map-support-browser.js
+  - lib/opal/cli_runners/source-map-support*.js

data/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,47 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: 'Bug: '
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+<!-- A clear and concise description of what the bug is.
+Please clarify if it's a missing feature. -->
+
+Opal version: …
+
+
+**To Reproduce**
+
+<!--
+Steps to reproduce the behavior. 
+
+You can contrasting it to Ruby's behavior:
+
+```
+$ opal -v -e "puts 123"
+123
+```
+
+```
+$ruby -v -e "puts 123"
+```
+
+or show an error in the compiled code:
+
+```
+$ opal -v -e "puts 123" -cEO
+…
+/* Generated by Opal 1.1.1 */
+(function(Opal) {
+  var self = Opal.top, $nesting = [], nil = Opal.nil, $$$ = Opal.$$$, $$ = Opal.$$;
+
+  Opal.add_stubs(['$puts']);
+  return self.$puts(123)
+})(Opal);
+…
+```
+-->

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: 'Feature: '
+labels: feature
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

data/.github/workflows/build.yml

@@ -6,9 +6,7 @@ on:
       - master
       - "*-stable"
       - "*/ci-check"
-  pull_request:
-    branches:
-      - master
+  pull_request: {}
 
 jobs:
   rake:
@@ -26,14 +24,18 @@ jobs:
           - name: minitest
             ruby: 3.0
             command: bin/rake minitest
+          - name: minitest-strict-mode
+            ruby: 3.0
+            command: bin/rake minitest
+            strict: 'true'
           - name: current-ruby
             ruby: 3.0
           - name: previous-ruby
             ruby: 2.7
           - name: older-ruby
             ruby: 2.6
-          - name: near-eol-ruby
-            ruby: 2.5
+          # - name: near-eol-ruby
+          #   ruby: 2.6
           - name: smoke-test
             ruby: 3.0
             command: bin/rake smoke_test
@@ -87,4 +89,8 @@ jobs:
           bundle config path $PWD/vendor/bundle
           bundle install --jobs 4 --retry 3
           bundle clean
+      - name: set environment variables
+        if: ${{ matrix.combo.strict == 'true' }}
+        run: |
+          echo "USE_STRICT=true" >> $GITHUB_ENV
       - run: ${{ matrix.combo.command || 'bin/rake rspec' }}

data/.gitignore

@@ -3,6 +3,7 @@
 .yardoc
 .bundle
 Gemfile.lock
+Gemfile.local
 build/
 /.github_access_token
 /cdn

data/.jshintrc

@@ -10,7 +10,7 @@
   "undef"         : true, // Prohibit the use of explicitly undeclared variables
   "unused"        : true, // Warn when you define and never use your variables
 
-  "predef"        : ["Opal", "JSON", "Java", "OpalNode", "jsyaml", "globalThis"],
+  "predef"        : ["Opal", "JSON", "Java", "OpalNode", "jsyaml", "globalThis", "FinalizationRegistry", "WeakMap"],
 
   "browser": true,
   "node": true,

data/.rubocop.yml

@@ -107,8 +107,9 @@ Layout/SpaceAroundOperators:
 
 Lint/BooleanSymbol:
   Exclude:
-    # There are AST nodes with types :true and :false
+    # There are AST nodes and rewriters with types :true and :false
     - 'lib/opal/nodes/**/*.rb'
+    - 'lib/opal/rewriters/**/*.rb'
 
 Lint/InheritException:
   Exclude:

data/CHANGELOG.md

@@ -15,7 +15,70 @@ Changes are grouped as follows:
 
 
 
-## [Unreleased](https://github.com/opal/opal/compare/v1.0.5...HEAD) - unreleased
+## [1.2.0](https://github.com/opal/opal/compare/v1.1.1...1.2.0) - 2021-07-28
+
+
+### Added
+
+- Support for multiple arguments in Hash#{merge, merge!, update} ([#2187](https://github.com/opal/opal/pull/2187))
+- Support for Ruby 3.0 forward arguments: `def a(...) puts(...) end` ([#2153](https://github.com/opal/opal/pull/2153))
+- Support for beginless and endless ranges: `(1..)`, `(..1)` ([#2150](https://github.com/opal/opal/pull/2150))
+- Preliminary support for `**nil` argument - see #2240 to note limitations ([#2152](https://github.com/opal/opal/pull/2152))
+- Support for `Random::Formatters` which add methods `#{hex,base64,urlsafe_base64,uuid,random_float,random_number,alphanumeric}` to `Random` and `SecureRandom` ([#2218](https://github.com/opal/opal/pull/2218))
+- Basic support for ObjectSpace finalizers and ObjectSpace::WeakMap ([#2247](https://github.com/opal/opal/pull/2247))
+- A more robust support for encodings (especially binary strings) ([#2235](https://github.com/opal/opal/pull/2235))
+- Support for `"\x80"` syntax in String literals ([#2235](https://github.com/opal/opal/pull/2235))
+- Added `String#+@`, `String#-@` ([#2235](https://github.com/opal/opal/pull/2235))
+- Support for `begin <CODE> end while <CONDITION>` ([#2255](https://github.com/opal/opal/pull/2255))
+
+### Fixed
+
+- Encoding lookup was working only with uppercase names, not giving any errors for wrong ones (#2181, #2183, #2190)
+- Fix `Number#to_i` with huge number ([#2191](https://github.com/opal/opal/pull/2191))
+- Add regexp support to `String#start_with` ([#2198](https://github.com/opal/opal/pull/2198))
+- `String#bytes` now works in strict mode ([#2194](https://github.com/opal/opal/pull/2194))
+- Fix nested module inclusion ([#2053](https://github.com/opal/opal/pull/2053))
+- SecureRandom is now cryptographically secure on most platforms (#2218, #2170)
+- Fix performance regression for `Array#unshift` on v8 > 7.1 ([#2116](https://github.com/opal/opal/pull/2116))
+- String subclasses now call `#initialize` with multiple arguments correctly (with a limitation caused by the String immutability issue, that a source string must be the first argument and `#initialize` can't change its value) (#2238, #2185)
+- Number#step is moved to Numeric ([#2100](https://github.com/opal/opal/pull/2100))
+- Fix class Class < superclass for invalid superclasses ([#2123](https://github.com/opal/opal/pull/2123))
+- Fix `String#unpack("U*")` on binary strings with latin1 high characters, fix performance regression on that call (#2235, #2189, #2129, #2099, #2094, #2000, #2128)
+- Fix `String#to_json` output on some edge cases ([#2235](https://github.com/opal/opal/pull/2235))
+- Rework class variables to support inheritance correctly ([#2251](https://github.com/opal/opal/pull/2251))
+- ISO-8859-1 and US-ASCII encodings are now separated as in MRI ([#2235](https://github.com/opal/opal/pull/2235))
+- `String#b` no longer modifies object strings in-place ([#2235](https://github.com/opal/opal/pull/2235))
+
+### Changed
+
+- `String#unpack`, `Array#pack`, `String#chars`, `String#length`, `Number#chr`, and (only partially) `String#+` are now encoding aware ([#2235](https://github.com/opal/opal/pull/2235))
+- `String#inspect` now uses `\x` for binary stirngs ([#2235](https://github.com/opal/opal/pull/2235))
+- `if RUBY_ENGINE == "opal"` and friends are now outputing less JS code (#2159, #1965)
+- `Array`: `to_a`, `slice`/`[]`, `uniq`, `*`, `difference`/`-`, `intersection`/`&`, `union`/`|`, flatten now return Array, not a subclass, as Ruby 3.0 does ([#2237](https://github.com/opal/opal/pull/2237))
+- `Array`: `difference`, `intersection`, `union` now accept multiple arguments ([#2237](https://github.com/opal/opal/pull/2237))
+
+### Deprecated
+
+- Stopped testing Opal on Ruby 2.5 since it reached EOL.
+
+### Removed
+
+- Removed support for the outdated `c_lexer`, it was optional and didn't work for the last few releases of parser ([#2235](https://github.com/opal/opal/pull/2235))
+
+
+
+
+## [1.1.1](https://github.com/opal/opal/compare/v1.1.0...v1.1.1) - 2021-02-23
+
+
+### Fixed
+
+- The default runner (nodejs) wasn't starting to a bad require in the improved stack-traces ([#2182](https://github.com/opal/opal/pull/2182))
+
+
+
+
+## [1.1.0](https://github.com/opal/opal/compare/v1.0.5...v1.1.0) - 2021-02-19
 
 
 ### Added
@@ -36,6 +99,14 @@ Changes are grouped as follows:
 - Added a generic implementation of Kernel#caller and #warn(uplevel:) that works with sourcemaps in Node.js and Chrome ([#2065](https://github.com/opal/opal/pull/2065))
 - Added support for numblocks `-> { _1 + _2 }.call(3, 4) # => 7` ([#2149](https://github.com/opal/opal/pull/2149))
 - Support `<internal:…>` and `<js:…>` in stacktraces, like MRI we now distinguish internal lines from lib/app lines ([#2154](https://github.com/opal/opal/pull/2154))
+- `Array#difference`, `Array#intersection`, `Array#union` as aliases respectively to `Array#{-,&,|}` ([#2151](https://github.com/opal/opal/pull/2151))
+- Aliases `filter{,!}` to `select{,!}` throughout the corelib classes ([#2151](https://github.com/opal/opal/pull/2151))
+- `Enumerable#filter_map`, `Enumerable#tally` ([#2151](https://github.com/opal/opal/pull/2151))
+- Alias `Kernel#then` for `Kernel#yield_self` ([#2151](https://github.com/opal/opal/pull/2151))
+- Method chaining: `{Proc,Method}#{<<,>>}` ([#2151](https://github.com/opal/opal/pull/2151))
+- Added Integer#to_d ([#2006](https://github.com/opal/opal/pull/2006))
+- Added a compiler option `use_strict` which can also be set by the `use_strict` magic comment ([#1959](https://github.com/opal/opal/pull/1959))
+- Add `--rbrequire (-q)` option to `opal` command line executable ([#2120](https://github.com/opal/opal/pull/2120))
 
 ### Fixed
 
@@ -55,6 +126,7 @@ Changes are grouped as follows:
 - Set#keep_if ([#1987](https://github.com/opal/opal/pull/1987))
 - Set#select! ([#1987](https://github.com/opal/opal/pull/1987))
 - Set#reject! ([#1987](https://github.com/opal/opal/pull/1987))
+- String#unicode_normalize ([#2175](https://github.com/opal/opal/pull/2175))
 - Module#alias_method ([#1983](https://github.com/opal/opal/pull/1983))
 - Enumerable#minmax_by ([#1981](https://github.com/opal/opal/pull/1981))
 - Enumerator#each_with_index ([#1990](https://github.com/opal/opal/pull/1990))
@@ -72,6 +144,21 @@ Changes are grouped as follows:
 - Set match on StringScanner#skip and StringScanner#scan_until ([#2061](https://github.com/opal/opal/pull/2061))
 - Fix ruby 2.7 warnings ([#2071](https://github.com/opal/opal/pull/2071))
 - Improve the --help descriptions ([#2146](https://github.com/opal/opal/pull/2146))
+- Remove BasicObject#class ([#2166](https://github.com/opal/opal/pull/2166))
+- Time#strftime %j leading zeros ([#2161](https://github.com/opal/opal/pull/2161))
+- Fix `call { true or next }` producing invalid code ([#2160](https://github.com/opal/opal/pull/2160))
+- `define_method` can now be called on the main object ([#2029](https://github.com/opal/opal/pull/2029))
+- Fix nested for-loops ([#2033](https://github.com/opal/opal/pull/2033))
+- Fix Number#round for Integers ([#2030](https://github.com/opal/opal/pull/2030))
+- Fix parsing Unicode characters from Opal ([#2073](https://github.com/opal/opal/pull/2073))
+- Integer#===: improve Integer recognition ([#2089](https://github.com/opal/opal/pull/2089))
+- Regexp: ensure ignoreCase is never undefined ([#2098](https://github.com/opal/opal/pull/2098))
+- Hash#delete: ensure String keys are converted to values ([#2106](https://github.com/opal/opal/pull/2106))
+- Array#shift: improve performance on v8 >7.1 ([#2115](https://github.com/opal/opal/pull/2115))
+- Array#pop(1): improve performance ([#2130](https://github.com/opal/opal/pull/2130))
+- Object#pretty_inspect ([#2139](https://github.com/opal/opal/pull/2139))
+- Fix conversion from UTF-8 to bytes ([#2138](https://github.com/opal/opal/pull/2138))
+- Restore compatibility with Chrome 38, used by Cordova and many mobile browsers ([#2109](https://github.com/opal/opal/pull/2109))
 
 ### Changed
 
@@ -86,6 +173,12 @@ Changes are grouped as follows:
 - Change parser to 3.0 ([#2148](https://github.com/opal/opal/pull/2148))
 - Fix forwarding a rescued error to a global var: `rescue => $gvar` ([#2154](https://github.com/opal/opal/pull/2154))
 - Now using Parser v3.0 and targeting Ruby 3.0 ([#2156](https://github.com/opal/opal/pull/2156))
+- `Comparable#clamp` to support a Range argument ([#2151](https://github.com/opal/opal/pull/2151))
+- `#to_h` method to support a block (shortform for `.map(&block).to_h`) ([#2151](https://github.com/opal/opal/pull/2151))
+- BigDecimal is now a subclass of Numeric ([#2006](https://github.com/opal/opal/pull/2006))
+- PP to be rebased on upstream Ruby version ([#2083](https://github.com/opal/opal/pull/2083))
+- String to report UTF-8 encoding by default, as MRI does ([#2117](https://github.com/opal/opal/pull/2117))
+- Don't output "Failed to load WithCLexer, using pure Ruby lexer" warning unless in $DEBUG mode ([#2174](https://github.com/opal/opal/pull/2174))
 
 ### Deprecated
 
@@ -96,6 +189,7 @@ Changes are grouped as follows:
 ### Removed
 
 - Removed special compilation for the `Opal.truthy?` and `Opal.falsy?` helpers ([#2076](https://github.com/opal/opal/pull/2076))
+- Removed the deprecated `tainting` compiler config option ([#2072](https://github.com/opal/opal/pull/2072))
 
 
 

data/Gemfile

@@ -48,7 +48,3 @@ end unless ENV['CI']
 group :doc do
   gem 'redcarpet' unless RUBY_ENGINE == 'truffleruby'
 end unless ENV['CI']
-
-platforms :ruby, :mswin, :mswin64, :mingw, :x64_mingw do
-  #gem 'c_lexer', '~> 2.6' unless RUBY_ENGINE == 'truffleruby'
-end

data/HACKING.md

@@ -33,7 +33,7 @@ Before making changes to Opal source, you need to understand a little about how
 
 Navigating to `spec/ruby/core` directory, you see that it contains multiple sub-directories, usually named after the Ruby class or module. Drilling further down into `spec/ruby/core/string` you see all the spec files for the various `String` behaviors under test, usually named by a method name followed by `_spec.rb`. Opening `spec/ruby/core/string/sub_spec.rb` you finally see the code that checks the correctness of Opal's implementation of the `String#sub` method's behavior.
 
-When you execute `$ bundle exec rake`, the code in this file is executed, along with all the other specs in the entire test suite. It's a good idea to run the entire test suite when you feel you reached a certain milestone in the course of making your changes (exactly what that means is up to you), and definitely do `$ bundle exec rake` before commiting your changes to make sure they have not introduced regressions or other unintended side effects.
+When you execute `$ bundle exec rake`, the code in this file is executed, along with all the other specs in the entire test suite. It's a good idea to run the entire test suite when you feel you reached a certain milestone in the course of making your changes (exactly what that means is up to you), and definitely do `$ bundle exec rake` before committing your changes to make sure they have not introduced regressions or other unintended side effects.
 
 But you will want to run tests as often as possible, after every small change, and running the entire test suite will slow you down. You need to be able to execute a single spec that is concerned with the feature you are currently working on. To accomplish this, just add `PATTERN` to your spec invocation command, like this:
 

data/README.md

@@ -3,7 +3,7 @@
   align="center" title="Opal logo by Elia Schito" width="105" height="105" />
   <br/>
   Opal  <br/>
-  <img src="https://img.shields.io/badge/Opal-Ruby%20💛%20JavaScript-yellow.svg?logo=ruby&style=social&logoColor=777"/>
+  <img src="https://img.shields.io/badge/Opal-Ruby%20💛%20JavaScript-yellow.svg?logo=ruby&style=social&logoColor=777" alt="Opal-Ruby 💛 JavaScript"/>
 </h1>
 
 <p align="center">
@@ -16,19 +16,19 @@
   <a href="https://stackoverflow.com/questions/ask?tags=opalrb"><img src="https://img.shields.io/badge/stackoverflow-%23opalrb-orange.svg?style=flat" alt="Stack Overflow" title="" /></a>
   <a href="#backers"><img src="https://opencollective.com/opal/backers/badge.svg" alt="Backers on Open Collective" title="" /></a>
   <a href="#sponsors"><img src="https://opencollective.com/opal/sponsors/badge.svg" alt="Sponsors on Open Collective" title="" /></a>
-  <a href="https://gitter.im/opal/opal?utm_source=badge&amp;utm_medium=badge&amp;utm_campaign=pr-badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter" title="" /></a>
+  <a href="https://slack.opalrb.com/"><img src="https://img.shields.io/badge/slack-join%20chat-46BC99?logo=slack&style=flat" alt="Slack" title="Join Chat" /></a>
   <a href="https://opalrb.com/docs"><img src="https://img.shields.io/badge/docs-updated-blue.svg" alt="Documentation" title="" /></a>
   
   <br>
   <strong>Code:</strong><br>
   <a href="https://badge.fury.io/rb/opal"><img src="https://img.shields.io/gem/v/opal.svg?style=flat" alt="Gem Version" title="" /></a>
-  <a href="https://github.com/opal/opal/actions?query=workflow%3Abuild"><img alt="Build Status" src="https://github.com/opal/opal/workflows/build/badge.svg" /></a>
+  <a href="https://github.com/opal/opal/actions?query=workflow%3Abuild"><img src="https://github.com/opal/opal/workflows/build/badge.svg" alt="Build Status" /></a>
   <a href="https://codeclimate.com/github/opal/opal"><img src="https://img.shields.io/codeclimate/maintainability-percentage/opal/opal.svg" alt="Code Climate" title="" /></a>
   <a href="https://coveralls.io/github/opal/opal?branch=master"><img src="https://coveralls.io/repos/opal/opal/badge.svg?branch=master&amp;service=github" alt="Coverage Status" title="" /></a>
   
   <br>
   <strong>Sponsors:</strong>
-  <br/><a href="https://nebulab.it?utm_source=github&utm_medium=badge"><img src="https://img.shields.io/static/v1?label=Nebulab&message=Open+Source+Fridays&color=%235dbefd&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAYAAAByDd+UAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAMQSURBVHgBrZZNTxNRFIbfczsgIMQiLBCRFDaGhUr9A9iiIa5EEneIwE/AlRsNv8KlIKwFl35RTUBX8rFBdiVKAgqmXSCY0M71nJl+zJTOdKh9k6Yzc8/cZ86555x7CQE0mji5hSyGlQoNaOgIPwrnhtIArWszu4EQFudjdR8rzUV+gw8/ZMZB9IwvIwimJJGafhmjWZwFOJ7QkYzWCwTdj+qUDJGKz8Rou3RAlT4YS+hHWW2u/QdM1MNzrI6+zwyXDrg8FANStIDaSXOIJ5whLgAljOIZiglRK6U4vDfz4S2ElGGJWsEaQkCTUbhtNbV+lb+xgFY2Bs9ET0h/GzBxlfAkqnCUKY5xKfVLbsi1/R126lcF6WgCYp2ES42EBp6tvQFY+alLTUlrUxizJEVNWiVwBkVagGg7oe+CDclLYOfrgMdfTBz8PfWa1lkzbsDEsH/5FyF9YUK0zQ1xwpoZtsm9pwxMRLyA9wyi0A2Jcjl1NNqeeEFEimxYPkmWd014ikIDnDTeBb53DOweaRxnvWGyhnmYfPZWGt487sNi6lsK67/lZ1oZGOtUaD3nhtU7etXXfe0VzrzCBgLKCR68rNDX6oaJlvd0xXnklbSfgSTL/QghXF8EP980cVKyVL/Ys9UDVFJa8Tdt+1lYmcmJM3Vd4UEvWeslRf32h9ubrVRl77gBrCto85OfUU+LXTMGx+JuN2Hoin3/Zkfjj6ObBAknV+KG4jpc9BqXMEpiCMz6Z9ZQ12kvJZxb6co4Zr1W83esY8F2OYsIe+eEyfTiVXczCl7uM2wliHfMEJaRc3Wa++mLUotrF4EW7h6f94Dvh6aVFM60Fy8Xkya+BfBOjh5yUWhqY0vmKi9q1GnVxZ7sHKIWSs7FQ71yUagkRTTCfymnVY1gsgHHC5z8hbUjaz0Fr8ZanXhX0pPOw5SrV8wNGjNscMrTKpXKaj05f9twVYHnMZGPHEuwTwEBNi+3NGiNt6GRcsfEIAfhp2cAV3cQLtXoOz7q8+ZJRLx3kmxn4dy7aas1SrfiBpKraV/9A+PSJLDAXLUvAAAAAElFTkSuQmCC"></a>
+  <br/><a href="https://nebulab.it?utm_source=github&utm_medium=badge"><img src="https://img.shields.io/static/v1?label=Nebulab&message=Open+Source+Fridays&color=%235dbefd&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAYAAAByDd+UAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAMQSURBVHgBrZZNTxNRFIbfczsgIMQiLBCRFDaGhUr9A9iiIa5EEneIwE/AlRsNv8KlIKwFl35RTUBX8rFBdiVKAgqmXSCY0M71nJl+zJTOdKh9k6Yzc8/cZ86555x7CQE0mji5hSyGlQoNaOgIPwrnhtIArWszu4EQFudjdR8rzUV+gw8/ZMZB9IwvIwimJJGafhmjWZwFOJ7QkYzWCwTdj+qUDJGKz8Rou3RAlT4YS+hHWW2u/QdM1MNzrI6+zwyXDrg8FANStIDaSXOIJ5whLgAljOIZiglRK6U4vDfz4S2ElGGJWsEaQkCTUbhtNbV+lb+xgFY2Bs9ET0h/GzBxlfAkqnCUKY5xKfVLbsi1/R126lcF6WgCYp2ES42EBp6tvQFY+alLTUlrUxizJEVNWiVwBkVagGg7oe+CDclLYOfrgMdfTBz8PfWa1lkzbsDEsH/5FyF9YUK0zQ1xwpoZtsm9pwxMRLyA9wyi0A2Jcjl1NNqeeEFEimxYPkmWd014ikIDnDTeBb53DOweaRxnvWGyhnmYfPZWGt487sNi6lsK67/lZ1oZGOtUaD3nhtU7etXXfe0VzrzCBgLKCR68rNDX6oaJlvd0xXnklbSfgSTL/QghXF8EP980cVKyVL/Ys9UDVFJa8Tdt+1lYmcmJM3Vd4UEvWeslRf32h9ubrVRl77gBrCto85OfUU+LXTMGx+JuN2Hoin3/Zkfjj6ObBAknV+KG4jpc9BqXMEpiCMz6Z9ZQ12kvJZxb6co4Zr1W83esY8F2OYsIe+eEyfTiVXczCl7uM2wliHfMEJaRc3Wa++mLUotrF4EW7h6f94Dvh6aVFM60Fy8Xkya+BfBOjh5yUWhqY0vmKi9q1GnVxZ7sHKIWSs7FQ71yUagkRTTCfymnVY1gsgHHC5z8hbUjaz0Fr8ZanXhX0pPOw5SrV8wNGjNscMrTKpXKaj05f9twVYHnMZGPHEuwTwEBNi+3NGiNt6GRcsfEIAfhp2cAV3cQLtXoOz7q8+ZJRLx3kmxn4dy7aas1SrfiBpKraV/9A+PSJLDAXLUvAAAAAElFTkSuQmCC" alt="Nebulab: Open Source Fridays" /></a>
 </p>
 
 ## Usage
@@ -216,21 +216,16 @@ then we support Opera 12.1x, 19.x and 20.x but not Opera 15.x through 18.x.
 
 This project exists thanks to all the people who contribute. [![contributors](https://opencollective.com/opal/contributors.svg?width=890&button=false")](https://github.com/opal/opal/graphs/contributors)
 
+## Versioning
+
+Opal will broadly follow semver as a version policy, trying to bump the major version when introducing breaking changes.
+Being a language implementation we're also aware that there's a fine line between what can be considered breaking and what is expected to be "safe" or just "additive". Moving forward we'll attempt to better clarify what interfaces are meant to be public and what should be considered private.
 
 ## Backers
 
 Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/opal#backer)]
 
-<a href="https://opencollective.com/opal#backers" target="_blank"><img src="https://opencollective.com/opal/backers.svg?width=890"></a>
-
-
-## Sponsors
-
-### Donations
-
-Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/opal#sponsor)]
-
-<a href="https://opencollective.com/opal/sponsor/0/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/0/avatar.svg"></a>
+<a href="https://opencollective.com/opal#backers" target="_blank"><img src="https://opencollective.com/opal/backers.svg?width=890" alt="Become a Backer Button" /></a>
 <a href="https://opencollective.com/opal/sponsor/1/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/1/avatar.svg"></a>
 <a href="https://opencollective.com/opal/sponsor/2/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/2/avatar.svg"></a>
 <a href="https://opencollective.com/opal/sponsor/3/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/3/avatar.svg"></a>
@@ -241,9 +236,18 @@ Support this project by becoming a sponsor. Your logo will show up here with a l
 <a href="https://opencollective.com/opal/sponsor/8/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/8/avatar.svg"></a>
 <a href="https://opencollective.com/opal/sponsor/9/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/9/avatar.svg"></a>
 
+
+## Sponsors
+
+### Donations
+
+Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/opal#sponsor)]
+
+<a href="https://opencollective.com/opal/sponsor/0/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/0/avatar.svg" alt="Become a Sponsor Button"></a>
+
 ### Sponsored Contributions
 
-<a href="https://nebulab.it/?utm_source=github&utm_medium=sponsors" target="_blank"><img src="https://nebulab.it/assets/images/logo-586625a4.svg"></a>
+<a href="https://nebulab.it/?utm_source=github&utm_medium=sponsors" target="_blank"><img src="https://nebulab.com/assets/img/logo-nebulab_black.svg" alt="Nebulab Logo"></a>
 
 
 ## License

data/UNRELEASED.md

@@ -1,109 +1,50 @@
-### Added
 
-- Basic support for `uplevel:` keyword argument in `Kernel#warn` (#2006)
-- Added a `#respond_to_missing?` implementation for `BasicObject`, `Delegator`, `OpenStruct`, that's meant for future support in the Opal runtime, which currently ignores it (#2007)
-- `Opal::Compiler#magic_comments` that allows to access magic-comments format and converts it to a hash (#2038)
-- Use magic-comments to declare helpers required by the file (#2038)
-- `Opal.$$` is now a shortcut for `Opal.const_get_relative` (#2038)
-- `Opal.$$$` is now a shortcut for `Opal.const_get_qualified` (#2038)
-- Added support for `globalThis` as the generic global object accessor (#2047)
-- `Opal::Compiler#magic_comments` that allows to access magic-comments format and converts it to a hash
-- Use magic-comments to declare helpers required by the file
-- `Opal.$$` is now a shortcut for `Opal.const_get_relative`
-- `Opal.$$$` is now a shortcut for `Opal.const_get_qualified`
-- Source-map support for Node.js in the default runner (#2045)
-- SecureRandom#hex(n) (#2050)
-- Added a generic implementation of Kernel#caller and #warn(uplevel:) that works with sourcemaps in Node.js and Chrome (#2065)
-- Added support for numblocks `-> { _1 + _2 }.call(3, 4) # => 7` (#2149)
-- Support `<internal:…>` and `<js:…>` in stacktraces, like MRI we now distinguish internal lines from lib/app lines (#2154)
-- `Array#difference`, `Array#intersection`, `Array#union` as aliases respectively to `Array#{-,&,|}` (#2151)
-- Aliases `filter{,!}` to `select{,!}` throughout the corelib classes (#2151)
-- `Enumerable#filter_map`, `Enumerable#tally` (#2151)
-- Alias `Kernel#then` for `Kernel#yield_self` (#2151)
-- Method chaining: `{Proc,Method}#{<<,>>}` (#2151)
-- Added Integer#to_d (#2006)
-- Added a compiler option `use_strict` which can also be set by the `use_strict` magic comment (#1959)
-- Add `--rbrequire (-q)` option to `opal` command line executable (#2120)
+- Support for multiple arguments in Hash#{merge, merge!, update} (#2187)
+- Support for Ruby 3.0 forward arguments: `def a(...) puts(...) end` (#2153)
+- Support for beginless and endless ranges: `(1..)`, `(..1)` (#2150)
+- Preliminary support for `**nil` argument - see #2240 to note limitations (#2152)
+- Support for `Random::Formatters` which add methods `#{hex,base64,urlsafe_base64,uuid,random_float,random_number,alphanumeric}` to `Random` and `SecureRandom` (#2218)
+- Basic support for ObjectSpace finalizers and ObjectSpace::WeakMap (#2247)
+- A more robust support for encodings (especially binary strings) (#2235)
+- Support for `"\x80"` syntax in String literals (#2235)
+- Added `String#+@`, `String#-@` (#2235)
+- Support for `begin <CODE> end while <CONDITION>` (#2255)
+- Added Hash#except and `Hash#except!` (#2243)
+- Parser 3.0: Implement pattern matching (as part of this `{Array,Hash,Struct}#{deconstruct,deconstruct_keys} methods were added)` (#2243)
+- [experimental] Reimplement Promise to make it bridged with JS native Promise, this new implementation can be used by requiring `promise/v2` (#2220)
+
 
 ### Fixed
 
-- Array#delete_if (#2069)
-- Array#keep_if (#2069)
-- Array#reject! (#2069)
-- Array#select! (#2069)
-- Struct#dup (#1995)
-- Integer#gcdlcm (#1972)
-- Enumerable#to_h (#1979)
-- Enumerator#size (#1980)
-- Enumerable#min (#1982)
-- Enumerable#min_by (#1985)
-- Enumerable#max_by (#1985)
-- Set#intersect? (#1988)
-- Set#disjoint? (#1988)
-- Set#keep_if (#1987)
-- Set#select! (#1987)
-- Set#reject! (#1987)
-- String#unicode_normalize (#2175)
-- Module#alias_method (#1983)
-- Enumerable#minmax_by (#1981)
-- Enumerator#each_with_index (#1990)
-- Range#== (#1992)
-- Range#each (#1991)
-- Enumerable#zip (#1986)
-- String#getbyte (#2141)
-- Struct#dup not copying `$$data` (#1995)
-- Fixed usage of semicolon in single-line backticks (#2004)
-- Module#attr with multiple arguments (#2003)
-- `PathReader` used to try to read missing files instead of respecting the `missing_require_severity` configuration value (#2044)
-- Removed some unused variables from the runtime (#2052)
-- Fixed a typo in the runtime (#2054)
-- Fix Regexp interpolation, previously interpolating with other regexps was broken (#2062)
-- Set match on StringScanner#skip and StringScanner#scan_until (#2061)
-- Fix ruby 2.7 warnings (#2071)
-- Improve the --help descriptions (#2146)
-- Remove BasicObject#class (#2166)
-- Time#strftime %j leading zeros (#2161)
-- Fix `call { true or next }` producing invalid code (#2160)
-- `define_method` can now be called on the main object (#2029)
-- Fix nested for-loops (#2033)
-- Fix Number#round for Integers (#2030)
-- Fix parsing Unicode characters from Opal (#2073)
-- Integer#===: improve Integer recognition (#2089)
-- Regexp: ensure ignoreCase is never undefined (#2098)
-- Hash#delete: ensure String keys are converted to values (#2106)
-- Array#shift: improve performance on v8 >7.1 (#2115)
-- Array#pop(1): improve performance (#2130)
-- Object#pretty_inspect (#2139)
-- Fix conversion from UTF-8 to bytes (#2138)
-- Restore compatibility with Chrome 38, used by Cordova and many mobile browsers (#2109)
+- Encoding lookup was working only with uppercase names, not giving any errors for wrong ones (#2181, #2183, #2190)
+- Fix `Number#to_i` with huge number (#2191)
+- Add regexp support to `String#start_with` (#2198)
+- `String#bytes` now works in strict mode (#2194)
+- Fix nested module inclusion (#2053)
+- SecureRandom is now cryptographically secure on most platforms (#2218, #2170)
+- Fix performance regression for `Array#unshift` on v8 > 7.1 (#2116)
+- String subclasses now call `#initialize` with multiple arguments correctly (with a limitation caused by the String immutability issue, that a source string must be the first argument and `#initialize` can't change its value) (#2238, #2185)
+- Number#step is moved to Numeric (#2100)
+- Fix class Class < superclass for invalid superclasses (#2123)
+- Fix `String#unpack("U*")` on binary strings with latin1 high characters, fix performance regression on that call (#2235, #2189, #2129, #2099, #2094, #2000, #2128)
+- Fix `String#to_json` output on some edge cases (#2235)
+- Rework class variables to support inheritance correctly (#2251)
+- ISO-8859-1 and US-ASCII encodings are now separated as in MRI (#2235)
+- `String#b` no longer modifies object strings in-place (#2235)
+- Parser::Builder::Default.check_lvar_name patch (#2195)
 
 ### Changed
 
-- Updated outdated parser version (#2013)
-- Nashorn has been deprecated but GraalVM still supports it (#1997)
-- "opal/mini" now includes "opal/io" (#2002)
-- Regexps assigned to constants are now frozen (#2007)
-- `Opal.$$` changed from being the constant cache of Object to being a shortcut for `Opal.const_get_relative` (#2038)
-- Moved REPL implementation from bin/ to its own lib/ file as `opal/repl.rb` (#2048)
-- `Encoding.default_external` is now initialized with `__ENCODING__` (#2072)
-- Keep the MersenneTwister implementation private (#2108)
-- Change parser to 3.0 (#2148)
-- Fix forwarding a rescued error to a global var: `rescue => $gvar` (#2154)
-- Now using Parser v3.0 and targeting Ruby 3.0 (#2156)
-- `Comparable#clamp` to support a Range argument (#2151)
-- `#to_h` method to support a block (shortform for `.map(&block).to_h`) (#2151)
-- BigDecimal is now a subclass of Numeric (#2006)
-- PP to be rebased on upstream Ruby version (#2083)
-- String to report UTF-8 encoding by default, as MRI does (#2117)
-- Don't output "Failed to load WithCLexer, using pure Ruby lexer" warning unless in $DEBUG mode (#2174)
+- `String#unpack`, `Array#pack`, `String#chars`, `String#length`, `Number#chr`, and (only partially) `String#+` are now encoding aware (#2235)
+- `String#inspect` now uses `\x` for binary stirngs (#2235)
+- `if RUBY_ENGINE == "opal"` and friends are now outputing less JS code (#2159, #1965)
+- `Array`: `to_a`, `slice`/`[]`, `uniq`, `*`, `difference`/`-`, `intersection`/`&`, `union`/`|`, flatten now return Array, not a subclass, as Ruby 3.0 does (#2237)
+- `Array`: `difference`, `intersection`, `union` now accept multiple arguments (#2237)
 
 ### Deprecated
 
-- Requiring nodejs/stacktrace has been deprecated, source-maps are already
-  supported by the default Node.js runner or by requiring https://github.com/evanw/node-source-map-support
-  before loading code compiled by Opal (#2045)
+- Stopped testing Opal on Ruby 2.5 since it reached EOL.
 
 ### Removed
 
-- Removed special compilation for the `Opal.truthy?` and `Opal.falsy?` helpers (#2076)
-- Removed the deprecated `tainting` compiler config option (#2072)
+- Removed support for the outdated `c_lexer`, it was optional and didn't work for the last few releases of parser (#2235)