opal 1.5.1 → 1.6.0.rc1

data/stdlib/ruby2_keywords.rb

@@ -0,0 +1,60 @@
+# This file ended up in Opal as a port of:
+# https://github.com/ruby/ruby2_keywords/blob/master/lib/ruby2_keywords.rb
+
+class Module
+  unless private_method_defined?(:ruby2_keywords)
+    private
+    # call-seq:
+    #    ruby2_keywords(method_name, ...)
+    #
+    # Does nothing.
+    def ruby2_keywords(name, *)
+      # nil
+    end
+  end
+end
+
+main = TOPLEVEL_BINDING.eval('self')
+unless main.respond_to?(:ruby2_keywords, true)
+  # call-seq:
+  #    ruby2_keywords(method_name, ...)
+  #
+  # Does nothing.
+  def main.ruby2_keywords(name, *)
+    # nil
+  end
+end
+
+class Proc
+  unless method_defined?(:ruby2_keywords)
+    # call-seq:
+    #    proc.ruby2_keywords -> proc
+    #
+    # Does nothing and just returns the receiver.
+    def ruby2_keywords
+      self
+    end
+  end
+end
+
+class << Hash
+  unless method_defined?(:ruby2_keywords_hash?)
+    # call-seq:
+    #    Hash.ruby2_keywords_hash?(hash) -> false
+    #
+    # Returns false.
+    def ruby2_keywords_hash?(hash)
+      false
+    end
+  end
+
+  unless method_defined?(:ruby2_keywords_hash)
+    # call-seq:
+    #    Hash.ruby2_keywords_hash(hash) -> new_hash
+    #
+    # Duplicates a given hash and returns the new hash.
+    def ruby2_keywords_hash(hash)
+      hash.dup
+    end
+  end
+end

data/stdlib/set.rb

@@ -1,3 +1,4 @@
+# helpers: freeze
 # Portions Copyright (c) 2002-2013 Akinori MUSHA <knu@iDaemons.org>
 class ::Set
   include ::Enumerable
@@ -70,6 +71,19 @@ class ::Set
     replace result
   end
 
+  def compare_by_identity
+    if @hash.respond_to?(:compare_by_identity)
+      @hash.compare_by_identity
+      self
+    else
+      raise NotImplementedError, "#{self.class.name}\##{__method__} is not implemented"
+    end
+  end
+
+  def compare_by_identity?
+    @hash.respond_to?(:compare_by_identity?) && @hash.compare_by_identity?
+  end
+
   def delete(o)
     @hash.delete(o)
     self
@@ -90,6 +104,13 @@ class ::Set
     self
   end
 
+  def freeze
+    return self if frozen?
+
+    @hash.freeze
+    `$freeze(self)`
+  end
+
   def keep_if
     return enum_for(:keep_if) unless block_given?
     reject { |o| yield o }.each { |o| @hash.delete(o) }

data/tasks/performance.rake

@@ -1,6 +1,9 @@
 # A set of tasks to track performance regressions by the CI
 
-require 'opal/util'
+require_relative "#{__dir__}/../lib/opal/util"
+require_relative "#{__dir__}/../lib/opal/os"
+
+OS = Opal::OS
 
 class Timing
   def initialize(tries: 31, &block)
@@ -18,25 +21,28 @@ class Timing
 
   attr_reader :times, :tries
 
-  # Runs a block N times and returns a mean number of seconds it took to run it.
+  # Runs a block N times and returns the best number of seconds it took to run it.
   def mean_time
     @times.sort[tries/2.0.floor + 1]
   end
 
+  def best_time
+    @times.min
+  end
+
   def error
-    m = mean_time
-    @times.minmax.map { |t| (m - t).abs }.max
+    @times.max - @times.min
   end
 
   def compare_to(previous, name)
     current = self
     percent = ->(a, b) { (a / b) * 100 }
-    change = percent[(current.mean_time - previous.mean_time), previous.mean_time]
+    change = percent[(current.best_time - previous.best_time), previous.best_time]
 
-    puts ("%30s: %.3f (±%.2f%%) -> %.3f (±%.2f%%) (change: %+.2f%%)" % [
+    puts ("%30s: %.3f (+%.2f%%) -> %.3f (+%.2f%%) (change: %+.2f%%)" % [
       name,
-      previous.mean_time / 1_000_000.0, percent[previous.error, previous.mean_time],
-      current.mean_time / 1_000_000.0, percent[current.error, current.mean_time],
+      previous.best_time / 1_000_000.0, percent[previous.error, previous.best_time],
+      current.best_time / 1_000_000.0, percent[current.error, current.best_time],
       change
     ]).gsub('.000','')
 
@@ -52,7 +58,7 @@ class Size
   attr_reader :size
 
   def compare_to(previous, name)
-    change = 100 * (previous.size - size) / previous.size
+    change = 100.0 * (size - previous.size) / previous.size
     puts ("%30s: %5.2f kB -> %5.2f kB (change: %+.2f%%)" % [
       name,
       previous.size / 1_000.0,
@@ -67,35 +73,34 @@ end
 $failures = []
 
 ASCIIDOCTOR_REPO_BASE = ENV['ASCIIDOCTOR_REPO_BASE'] || 'https://github.com/asciidoctor'
-
+ASCIIDOCTOR_COMMIT = '869e8236'
+ASCIIDOCTOR_JS_COMMIT = '053fa0d3'
 # Selected asciidoctor versions were working on Aug 19 2021, feel free to update.
-ASCIIDOCTOR_PREPARE = [
-  "bundle",
-  "exec",
-  "bash",
-  "-c",
-  <<~BASH
-    mkdir -p tmp/performance
-    pushd tmp/performance
-    git clone #{ASCIIDOCTOR_REPO_BASE}/asciidoctor >/dev/null 2>&1
-    pushd asciidoctor; git checkout 869e8236 >/dev/null 2>&1; popd
-    git clone #{ASCIIDOCTOR_REPO_BASE}/asciidoctor.js >/dev/null 2>&1
-    pushd asciidoctor.js; git checkout 053fa0d3 >/dev/null 2>&1; popd
-    erb ../../tasks/performance/asciidoctor_test.rb.erb > asciidoctor_test.rb
-    popd
-  BASH
-]
-
-ASCIIDOCTOR_BUILD_OPAL = "bin/opal --no-cache -c " \
-           "-Itmp/performance/asciidoctor/lib " \
-           "-Itmp/performance/asciidoctor.js/packages/core/lib " \
-           "-sconcurrent/map -sslim/include " \
-           "tmp/performance/asciidoctor_test.rb > tmp/performance/asciidoctor_test.js"
+S = OS.path_sep
+ASCIIDOCTOR_PREPARE = OS.bash_c(
+  "pushd tmp#{S}performance",
+  "git clone #{ASCIIDOCTOR_REPO_BASE}/asciidoctor >#{OS.dev_null} 2>&1",
+  "pushd asciidoctor", "git checkout #{ASCIIDOCTOR_COMMIT} >#{OS.dev_null} 2>&1", "popd",
+  "git clone #{ASCIIDOCTOR_REPO_BASE}/asciidoctor.js >#{OS.dev_null} 2>&1",
+  "pushd asciidoctor.js", "git checkout #{ASCIIDOCTOR_JS_COMMIT} >#{OS.dev_null} 2>&1", "popd",
+  "erb ../../tasks/performance/asciidoctor_test.rb.erb > asciidoctor_test.rb",
+  "popd"
+)
+
+ASCIIDOCTOR_BUILD_OPAL = "#{'ruby ' if Gem.win_platform?}bin/opal --no-cache -c " \
+                         "-Itmp/performance/asciidoctor/lib " \
+                         "-Itmp/performance/asciidoctor.js/packages/core/lib " \
+                         "-sconcurrent/map -sslim/include " \
+                         "tmp/performance/asciidoctor_test.rb > tmp/performance/asciidoctor_test.js"
 ASCIIDOCTOR_RUN_RUBY = "bundle exec ruby -Itmp/performance/asciidoctor/lib tmp/performance/asciidoctor_test.rb"
 ASCIIDOCTOR_RUN_OPAL = "node tmp/performance/asciidoctor_test.js"
 
 # Generate V8 function optimization status report for corelib methods
-NODE_OPTSTATUS = "env NODE_OPTS=--allow-natives-syntax bin/opal tasks/performance/optimization_status.rb"
+NODE_OPTSTATUS = if Gem.win_platform?
+  "set NODE_OPTS=--allow-natives-syntax && ruby bin/opal tasks/performance/optimization_status.rb"
+else
+  "env NODE_OPTS=--allow-natives-syntax bin/opal tasks/performance/optimization_status.rb"
+end
 
 performance_stat = ->(name) {
   stat = {}
@@ -128,6 +133,7 @@ namespace :performance do
 
     # Prepare
     puts "\n* Preparing asciidoctor..."
+    FileUtils.mkdir_p("tmp/performance") unless Dir.exist?("tmp/performance")
     sh(*ASCIIDOCTOR_PREPARE)
 
     puts "\n* Running AsciiDoctor with CRuby..."
@@ -136,12 +142,12 @@ namespace :performance do
     current = performance_stat.(:current)
 
     # Prepare previous
-    sh("git checkout --recurse-submodules #{ref} && bundle install >/dev/null 2>&1")
+    sh("git checkout --recurse-submodules #{ref} && bundle install >#{OS.dev_null} 2>&1")
 
     previous = performance_stat.(:previous)
 
     # Restore current
-    sh("git checkout --recurse-submodules - && bundle install >/dev/null 2>&1")
+    sh("git checkout --recurse-submodules - && bundle install >#{OS.dev_null} 2>&1")
 
     # Summary
     puts "\n=== Summary ==="

data/tasks/releasing.rake

@@ -47,6 +47,7 @@ CHANGELOG_HEADING = <<~MARKDOWN
   - **Removed** for deprecated features removed in this release.
   - **Fixed** for any bug fixes.
   - **Security** to invite users to upgrade in case of vulnerabilities.
+  - **Performance** changes related to speed and efficiency.
 MARKDOWN
 
 desc "Update CHANGELOG.md using info from published GitHub releases (the first unreleased section is preserved)"

data/tasks/testing/mspec_special_calls.rb

@@ -35,6 +35,7 @@ class Opal::Nodes::CallNode
   end
 end
 
+require 'opal/rewriter'
 require 'opal/rewriters/rubyspec/filters_rewriter'
 
 Opal::Rewriter.use Opal::Rubyspec::FiltersRewriter

data/tasks/testing.rake

@@ -1,4 +1,8 @@
+require_relative "#{__dir__}/../lib/opal/os"
 require 'rspec/core/rake_task'
+
+OS = Opal::OS
+
 RSpec::Core::RakeTask.new(:rspec) do |t|
   t.pattern = 'spec/lib/**/*_spec.rb'
 end
@@ -249,7 +253,7 @@ module Testing
         puts 'Server ready.'
         yield self
       ensure
-        if windows?
+        if OS.windows?
           # https://blog.simplificator.com/2016/01/18/how-to-kill-processes-on-windows-using-ruby/
           # system("taskkill /f /pid #{pid}")
           Process.kill("KILL", server)
@@ -260,10 +264,6 @@ module Testing
       end
     end
 
-    def windows?
-      (/cygwin|mswin|mingw|bccwin|wince|emx/ =~ RUBY_PLATFORM) != nil
-    end
-
     def sinatra_server_running?
       puts "Connecting to localhost:4567..."
       TCPSocket.new('localhost', '4567').close
@@ -427,14 +427,15 @@ task :smoke_test do
         extend RSpec::Matchers
         expect(actual_output.lines[0]).to    eq("..\n")
         expect(actual_output.lines[1]).to    eq("\n")
-        expect(actual_output.lines[2]).to match(%r{^Finished in \d+\.\d+ seconds \(files took \d+\.\d+ seconds to load\)\n$})
-        expect(actual_output.lines[3]).to    eq("2 examples, 0 failures\n")
-        expect(actual_output.lines[4]).to    eq("\n")
-        expect(actual_output.lines[5]).to match(%r{Top 2 slowest examples \(\d+\.\d+ seconds, \d+\.\d+% of total time\):\n})
-        expect(actual_output.lines[7]).to match(%r{    \[1m\d+\.\d+\[0m \[1mseconds\[0m \n})
+        expect(actual_output.lines[2]).to match(%r{Top 2 slowest examples \(\d+\.\d+ seconds, \d+\.\d+% of total time\):\n})
+        expect(actual_output.lines[4]).to match(%r{    \[1m\d+\.\d+\[0m \[1mseconds\[0m .*deprecations_spec\.rb:7\n})
+        expect(actual_output.lines[6]).to match(%r{    \[1m\d+\.\d+\[0m \[1mseconds\[0m .*deprecations_spec\.rb:12\n})
+        expect(actual_output.lines[7]).to    eq("\n")
+        expect(actual_output.lines[8]).to match(%r{^Finished in \d+\.\d+ seconds \(files took \d+\.\d+ seconds to load\)\n$})
+        expect(actual_output.lines[9]).to    eq("2 examples, 0 failures\n")
         expect([
-          actual_output.lines[6],
-          actual_output.lines[8],
+          actual_output.lines[3],
+          actual_output.lines[5],
         ]).to contain_exactly(
           "  Opal::Deprecations defaults to warn\n",
           "  Opal::Deprecations can be set to raise\n",

data/test/nodejs/test_await.rb

@@ -9,6 +9,11 @@ class TestAwait < Test::Unit::TestCase
     require "await"
   RUBY
 
+  autoawaitheader = <<~RUBY
+    # await: *await*
+    require "await"
+  RUBY
+
   tests = {
     test_await_in_top: [<<~RUBY, 6],
       #{stdheader}
@@ -158,6 +163,39 @@ class TestAwait < Test::Unit::TestCase
       $taval = 5
       $taval = PromiseV2.value(5).__await__ + 10
     RUBY
+    # Bug before Opal 1.6: compiled autoawait expressions had wrong parentheses rules
+    test_autoawait_awaiting: [<<~RUBY, "very correct"],
+      #{autoawaitheader}
+      $taval = "incorrect"
+      $taval = PromiseV2.value("also incorrect").await.sub("also in", "")
+      $taval = PromiseV2.value("very ").await + $taval
+    RUBY
+    test_autoawait_instance_exec_await: [<<~RUBY, 2*3*5*7*11*13],
+      #{autoawaitheader}
+      # await: *await*
+      $taval = 1
+      module AutoawaitTemporary1
+        $block_with_module_self = proc do
+          # Ensure that block.$$s is generated:
+          self   
+          # AutoawaitTemporary2.$$eval should be true, block.$$s should be unset
+          `\#{AutoawaitTemporary2}.$$eval` && ($taval *= PromiseV2.value(2).await)
+          `block.$$s === null` && ($taval *= PromiseV2.value(3).await)
+        end
+        block = $block_with_module_self
+      end
+      block = $block_with_module_self
+      module AutoawaitTemporary2; end
+      # AutoawaitTemporary2.$$eval should be false, block.$$s should refer to AutoawaitTemporary1
+      `\#{AutoawaitTemporary2}.$$eval` || ($taval *= PromiseV2.value(5).await)
+      `block.$$s === \#{AutoawaitTemporary1}` && ($taval *= PromiseV2.value(7).await)
+      module AutoawaitTemporary2
+        instance_exec_await(&$block_with_module_self)
+      end
+      # both should get their values back after instance_exec_await is finished
+      `\#{AutoawaitTemporary2}.$$eval` || ($taval *= PromiseV2.value(11).await)
+      `block.$$s === \#{AutoawaitTemporary1}` && ($taval *= PromiseV2.value(13).await)
+    RUBY
   }
 
   tests.each do |name,(code,expect)|
@@ -166,4 +204,4 @@ class TestAwait < Test::Unit::TestCase
       assert_equal(expect, $taval)
     end
   end
-end
+end

data/test/nodejs/test_file.rb

@@ -175,6 +175,7 @@ class TestNodejsFile < Test::Unit::TestCase
   end if windows_platform?
 
   def test_windows_file_expand_path
+    # do not use d: because its a symlink in github actions fs, leading to unexpected results
     drive_letter = Dir.pwd.slice(0, 2)
     assert_equal(Dir.pwd + '/foo/bar.js', File.expand_path('./foo/bar.js'))
     assert_equal(drive_letter + '/foo/bar.js', File.expand_path('/foo/bar.js'))
@@ -186,8 +187,8 @@ class TestNodejsFile < Test::Unit::TestCase
     assert_equal('c:/bar.js', File.expand_path('\\..\\bar.js', 'c:\\foo\\baz\\'))
     assert_equal('c:/foo/baz/bar.js', File.expand_path('baz\\bar.js', 'c:\\foo'))
     assert_equal('c:/baz/bar.js', File.expand_path('baz\\bar.js', 'c:\\foo\\..'))
-    assert_equal('d:/', File.expand_path('d:'), 'should add a trailing slash when the path is d:')
-    assert_equal('d:/', File.expand_path('d:/'), 'should preserve the trailing slash when the path d:/')
+    assert_equal('f:/', File.expand_path('f:'), 'should add a trailing slash when the path is d:')
+    assert_equal('g:/', File.expand_path('g:/'), 'should preserve the trailing slash when the path d:/')
     assert_equal(Dir.pwd, File.expand_path(drive_letter), 'should expand to the current directory when the path is c: (and the current directory is located in the c drive)')
     assert_equal(drive_letter + '/', drive_letter + '/', 'should return c:/ when the path is c:/ because the path is absolute')
   end if windows_platform?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opal
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.6.0.rc1
 platform: ruby
 authors:
 - Elia Schito
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-20 00:00:00.000000000 Z
+date: 2022-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ast
@@ -162,16 +162,16 @@ dependencies:
   name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -204,16 +204,16 @@ dependencies:
   name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: webrick
   requirement: !ruby/object:Gem::Requirement
@@ -396,9 +396,9 @@ files:
 - docs/compiler_directives.md
 - docs/configuring_gems.md
 - docs/encoding.md
-- docs/faq.md
 - docs/getting_started.md
 - docs/headless_chrome.md
+- docs/index.md
 - docs/jquery.md
 - docs/opal_parser.md
 - docs/promises.md
@@ -439,6 +439,9 @@ files:
 - lib/opal/ast/node.rb
 - lib/opal/builder.rb
 - lib/opal/builder_processors.rb
+- lib/opal/builder_scheduler.rb
+- lib/opal/builder_scheduler/prefork.rb
+- lib/opal/builder_scheduler/sequential.rb
 - lib/opal/cache.rb
 - lib/opal/cache/file_cache.rb
 - lib/opal/cli.rb
@@ -530,6 +533,7 @@ files:
 - lib/opal/nodes/call.rb
 - lib/opal/nodes/call_special.rb
 - lib/opal/nodes/class.rb
+- lib/opal/nodes/closure.rb
 - lib/opal/nodes/constants.rb
 - lib/opal/nodes/def.rb
 - lib/opal/nodes/defined.rb
@@ -555,6 +559,7 @@ files:
 - lib/opal/nodes/while.rb
 - lib/opal/nodes/x_string.rb
 - lib/opal/nodes/yield.rb
+- lib/opal/os.rb
 - lib/opal/parser.rb
 - lib/opal/parser/default_config.rb
 - lib/opal/parser/patch.rb
@@ -570,7 +575,6 @@ files:
 - lib/opal/rewriters/base.rb
 - lib/opal/rewriters/binary_operator_assignment.rb
 - lib/opal/rewriters/block_to_iter.rb
-- lib/opal/rewriters/break_finder.rb
 - lib/opal/rewriters/dot_js_syntax.rb
 - lib/opal/rewriters/dump_args.rb
 - lib/opal/rewriters/for_rewriter.rb
@@ -585,6 +589,7 @@ files:
 - lib/opal/rewriters/pattern_matching.rb
 - lib/opal/rewriters/returnable_logic.rb
 - lib/opal/rewriters/rubyspec/filters_rewriter.rb
+- lib/opal/rewriters/thrower_finder.rb
 - lib/opal/server.rb
 - lib/opal/simple_server.rb
 - lib/opal/source_map.rb
@@ -677,6 +682,7 @@ files:
 - spec/filters/bugs/complex.rb
 - spec/filters/bugs/date.rb
 - spec/filters/bugs/datetime.rb
+- spec/filters/bugs/delegate.rb
 - spec/filters/bugs/encoding.rb
 - spec/filters/bugs/enumerable.rb
 - spec/filters/bugs/enumerator.rb
@@ -844,18 +850,20 @@ files:
 - spec/opal/core/io/read_spec.rb
 - spec/opal/core/iterable_props_spec.rb
 - spec/opal/core/kernel/at_exit_spec.rb
-- spec/opal/core/kernel/freeze_spec.rb
 - spec/opal/core/kernel/instance_variables_spec.rb
 - spec/opal/core/kernel/methods_spec.rb
 - spec/opal/core/kernel/public_methods_spec.rb
 - spec/opal/core/kernel/puts_spec.rb
 - spec/opal/core/kernel/require_tree_spec.rb
 - spec/opal/core/kernel/respond_to_spec.rb
+- spec/opal/core/language/DATA/characters_support_crlf_spec.rb
 - spec/opal/core/language/DATA/characters_support_spec.rb
 - spec/opal/core/language/DATA/empty___END___spec.rb
+- spec/opal/core/language/DATA/multiple___END___crlf_spec.rb
 - spec/opal/core/language/DATA/multiple___END___spec.rb
 - spec/opal/core/language/arguments/mlhs_arg_spec.rb
 - spec/opal/core/language/forward_args_spec.rb
+- spec/opal/core/language/if_spec.rb
 - spec/opal/core/language/infinite_range_spec.rb
 - spec/opal/core/language/keyword_arguments_spec.rb
 - spec/opal/core/language/memoization_spec.rb
@@ -1091,6 +1099,7 @@ files:
 - stdlib/racc/parser.rb
 - stdlib/rbconfig.rb
 - stdlib/rbconfig/sizeof.rb
+- stdlib/ruby2_keywords.rb
 - stdlib/securerandom.rb
 - stdlib/set.rb
 - stdlib/shellwords.rb
@@ -1160,10 +1169,10 @@ licenses:
 metadata:
   homepage_uri: https://opalrb.com/
   bug_tracker_uri: https://github.com/opal/opal/issues
-  changelog_uri: https://github.com/opal/opal/blob/v1.5.1/CHANGELOG.md
-  readme_uri: https://github.com/opal/opal/blob/v1.5.1/README.md
-  api_documentation_uri: http://opalrb.com/docs/api/v1.5.1/index.html
-  guides_uri: http://opalrb.com/docs/guides/v1.5.1/index.html
+  changelog_uri: https://github.com/opal/opal/blob/v1.6.0.rc1/CHANGELOG.md
+  readme_uri: https://github.com/opal/opal/blob/v1.6.0.rc1/README.md
+  api_documentation_uri: http://opalrb.com/docs/api/v1.6.0.rc1/index.html
+  guides_uri: http://opalrb.com/docs/guides/v1.6.0.rc1/index.html
   chat_uri: https://gitter.im/opal/opal
   source_code_uri: https://github.com/opal/opal
 post_install_message:
@@ -1177,11 +1186,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.3.13
+rubygems_version: 3.3.22
 signing_key:
 specification_version: 4
 summary: Ruby runtime and core library for JavaScript
@@ -1341,9 +1350,9 @@ test_files:
 - docs/compiler_directives.md
 - docs/configuring_gems.md
 - docs/encoding.md
-- docs/faq.md
 - docs/getting_started.md
 - docs/headless_chrome.md
+- docs/index.md
 - docs/jquery.md
 - docs/opal_parser.md
 - docs/promises.md
@@ -1384,6 +1393,9 @@ test_files:
 - lib/opal/ast/node.rb
 - lib/opal/builder.rb
 - lib/opal/builder_processors.rb
+- lib/opal/builder_scheduler.rb
+- lib/opal/builder_scheduler/prefork.rb
+- lib/opal/builder_scheduler/sequential.rb
 - lib/opal/cache.rb
 - lib/opal/cache/file_cache.rb
 - lib/opal/cli.rb
@@ -1475,6 +1487,7 @@ test_files:
 - lib/opal/nodes/call.rb
 - lib/opal/nodes/call_special.rb
 - lib/opal/nodes/class.rb
+- lib/opal/nodes/closure.rb
 - lib/opal/nodes/constants.rb
 - lib/opal/nodes/def.rb
 - lib/opal/nodes/defined.rb
@@ -1500,6 +1513,7 @@ test_files:
 - lib/opal/nodes/while.rb
 - lib/opal/nodes/x_string.rb
 - lib/opal/nodes/yield.rb
+- lib/opal/os.rb
 - lib/opal/parser.rb
 - lib/opal/parser/default_config.rb
 - lib/opal/parser/patch.rb
@@ -1515,7 +1529,6 @@ test_files:
 - lib/opal/rewriters/base.rb
 - lib/opal/rewriters/binary_operator_assignment.rb
 - lib/opal/rewriters/block_to_iter.rb
-- lib/opal/rewriters/break_finder.rb
 - lib/opal/rewriters/dot_js_syntax.rb
 - lib/opal/rewriters/dump_args.rb
 - lib/opal/rewriters/for_rewriter.rb
@@ -1530,6 +1543,7 @@ test_files:
 - lib/opal/rewriters/pattern_matching.rb
 - lib/opal/rewriters/returnable_logic.rb
 - lib/opal/rewriters/rubyspec/filters_rewriter.rb
+- lib/opal/rewriters/thrower_finder.rb
 - lib/opal/server.rb
 - lib/opal/simple_server.rb
 - lib/opal/source_map.rb
@@ -1758,6 +1772,7 @@ test_files:
 - stdlib/racc/parser.rb
 - stdlib/rbconfig.rb
 - stdlib/rbconfig/sizeof.rb
+- stdlib/ruby2_keywords.rb
 - stdlib/securerandom.rb
 - stdlib/set.rb
 - stdlib/shellwords.rb

data/docs/faq.md

@@ -1,17 +0,0 @@
-# FAQ
-
-### Why does Opal exist?
-
-To try and keep ruby relevant in a world where client-side applications are making javascript the primary development platform.
-
-### How compatible is Opal?
-
-We run opal against the [ruby spec](https://github.com/ruby/spec) as our primary testing setup. We try to make Opal as compatible as possible, whilst also taking into account restrictions of JavaScript when applicable. Opal supports the majority of ruby syntax features, as well as a very large part of the corelib implementation. We support method\_missing, modules, classes, instance\_exec, blocks, procs and lots lots more. Opal can compile and run RSpec unmodified, as well as self hosting the compiler at runtime.
-
-### What version of ruby does Opal target?
-
-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?
-
-All strings in Opal are immutable because ruby strings just get compiled directly into javascript strings, which are immutable. Wrapping ruby strings as a custom JavaScript object would add a lot of overhead as well as making interaction between ruby and javascript libraries more difficult.

data/lib/opal/rewriters/break_finder.rb

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-require 'opal/rewriter'
-
-module Opal
-  module Rewriters
-    class BreakFinder < Opal::Rewriters::Base
-      def initialize
-        @found_break = false
-      end
-
-      def found_break?
-        @found_break
-      end
-
-      def on_break(node)
-        @found_break = true
-        node
-      end
-
-      def stop_lookup(node)
-        # noop
-      end
-
-      # regular loops
-      alias on_for        stop_lookup
-      alias on_while      stop_lookup
-      alias on_while_post stop_lookup
-      alias on_until      stop_lookup
-      alias on_until_post stop_lookup
-
-      # nested block
-      alias on_block      stop_lookup
-    end
-  end
-end