ruby_wasm 2.5.0 → 2.5.2

data/lib/ruby_wasm/build/product/crossruby.rb

@@ -5,11 +5,12 @@ module RubyWasm
   class CrossRubyExtProduct < BuildProduct
     attr_reader :name
 
-    def initialize(srcdir, toolchain, ext_relative_path: nil)
+    def initialize(srcdir, toolchain, features:, ext_relative_path: nil)
       @srcdir, @toolchain = srcdir, toolchain
       # ext_relative_path is relative path from build dir
       # e.g. cgi-0.3.6/ext/cgi/escape
       @ext_relative_path = ext_relative_path || File.basename(srcdir)
+      @features = features
       @name = @ext_relative_path
     end
 
@@ -37,7 +38,6 @@ module RubyWasm
       make_args << "AR=#{@toolchain.ar}"
       make_args << "RANLIB=#{@toolchain.ranlib}"
 
-      make_args << "DESTDIR=#{crossruby.dest_dir}"
       make_args
     end
 
@@ -45,12 +45,15 @@ module RubyWasm
       objdir = product_build_dir crossruby
       executor.mkdir_p objdir
       do_extconf executor, crossruby
+
+      executor.system "make", "-C", objdir, *make_args(crossruby), "clean"
+      build_target = crossruby.target.pic? ? "install-so" : "static"
       executor.system "make",
                       "-j#{executor.process_count}",
                       "-C",
                       "#{objdir}",
                       *make_args(crossruby),
-                      "static"
+                      build_target
       # A ext can provide link args by link.filelist. It contains only built archive file by default.
       unless File.exist?(linklist(crossruby))
         executor.write(
@@ -61,9 +64,28 @@ module RubyWasm
     end
 
     def do_extconf(executor, crossruby)
+      unless crossruby.target.pic?
+        self.do_legacy_extconf(executor, crossruby)
+        return
+      end
+      objdir = product_build_dir crossruby
+      source = crossruby.source
+      rbconfig_rb = Dir.glob(File.join(crossruby.dest_dir, "usr/local/lib/ruby/*/wasm32-wasi/rbconfig.rb")).first
+      raise "rbconfig.rb not found" unless rbconfig_rb
+      extconf_args = [
+        "-C", objdir,
+        "#{@srcdir}/extconf.rb",
+        "--target-rbconfig=#{rbconfig_rb}",
+      ]
+      extconf_args << "--enable-component-model" if @features.support_component_model?
+      executor.system Gem.ruby, *extconf_args
+    end
+
+    def do_legacy_extconf(executor, crossruby)
       objdir = product_build_dir crossruby
       source = crossruby.source
       extconf_args = [
+        "-C", objdir,
         "--disable=gems",
         # HACK: top_srcdir is required to find ruby headers
         "-e",
@@ -71,9 +93,6 @@ module RubyWasm
         # HACK: extout is required to find config.h
         "-e",
         %Q($extout="#{crossruby.build_dir}/.ext"),
-        # HACK: skip have_devel check since ruby is not installed yet
-        "-e",
-        "$have_devel = true",
         # HACK: force static ext build by imitating extmk
         "-e",
         "$static = true; trace_var(:$static) {|v| $static = true }",
@@ -88,12 +107,13 @@ module RubyWasm
         # like "cgi/escape" instead of "escape"
         "-e",
         %Q(require "json"; File.write("#{metadata_json(crossruby)}", JSON.dump({target: $target}))),
-        "-I#{crossruby.build_dir}"
+        "-I#{crossruby.build_dir}",
+        "--",
       ]
+      extconf_args << "--enable-component-model" if @features.support_component_model?
       # Clear RUBYOPT to avoid loading unrelated bundle setup
       executor.system crossruby.baseruby_path,
                       *extconf_args,
-                      chdir: objdir,
                       env: {
                         "RUBYOPT" => ""
                       }
@@ -118,7 +138,7 @@ module RubyWasm
   end
 
   class CrossRubyProduct < AutoconfProduct
-    attr_reader :source, :toolchain
+    attr_reader :target, :source, :toolchain
     attr_accessor :user_exts,
                   :wasmoptflags,
                   :cppflags,
@@ -155,6 +175,14 @@ module RubyWasm
       executor.system "make", "rbconfig.rb", chdir: build_dir
     end
 
+    def need_exts_build?
+      @user_exts.any?
+    end
+
+    def need_extinit_obj?
+      need_exts_build? && !@target.pic?
+    end
+
     def build_exts(executor)
       @user_exts.each do |prod|
         executor.begin_section prod.class, prod.name, "Building"
@@ -168,6 +196,7 @@ module RubyWasm
       executor.mkdir_p build_dir
       @toolchain.install
       [@source, @baseruby, @libyaml, @zlib, @openssl, @wasi_vfs].each do |prod|
+        next unless prod
         executor.begin_section prod.class, prod.name, "Building"
         prod.build(executor)
         executor.end_section prod.class, prod.name
@@ -176,17 +205,20 @@ module RubyWasm
       configure(executor, reconfigure: reconfigure)
       executor.end_section self.class, name
 
-      build_exts(executor)
+      build_exts(executor) if need_exts_build?
 
       executor.begin_section self.class, name, "Building"
-      executor.mkdir_p File.dirname(extinit_obj)
-      executor.system "ruby",
-                      extinit_c_erb,
-                      *@user_exts.map { |ext| ext.feature_name(self) },
-                      "--cc",
-                      toolchain.cc,
-                      "--output",
-                      extinit_obj
+
+      if need_extinit_obj?
+        executor.mkdir_p File.dirname(extinit_obj)
+        executor.system "ruby",
+                        extinit_c_erb,
+                        *@user_exts.map { |ext| ext.feature_name(self) },
+                        "--cc",
+                        toolchain.cc,
+                        "--output",
+                        extinit_obj
+      end
       install_dir = File.join(build_dir, "install")
       if !File.exist?(install_dir) || remake || reconfigure
         executor.system "make",
@@ -216,7 +248,7 @@ module RubyWasm
     end
 
     def cache_key(digest)
-      digest << @params.target
+      @params.target.cache_key(digest)
       digest << @params.default_exts
       @wasmoptflags.each { |f| digest << f }
       @cppflags.each { |f| digest << f }
@@ -229,11 +261,11 @@ module RubyWasm
     end
 
     def build_dir
-      File.join(@build_dir, @params.target, name)
+      File.join(@build_dir, @params.target.to_s, name)
     end
 
     def ext_build_dir
-      File.join(@build_dir, @params.target, name + "-ext")
+      File.join(@build_dir, @params.target.to_s, name + "-ext")
     end
 
     def with_libyaml(libyaml)
@@ -274,14 +306,14 @@ module RubyWasm
     end
 
     def configure_args(build_triple, toolchain)
-      target = @params.target
+      target = @params.target.triple
       default_exts = @params.default_exts
 
       ldflags = @ldflags.dup
       xldflags = @xldflags.dup
 
       args = self.system_triplet_args + ["--build", build_triple]
-      args << "--with-static-linked-ext"
+      args << "--with-static-linked-ext" unless @params.target.pic?
       args << %Q(--with-ext=#{default_exts})
       args << %Q(--with-libyaml-dir=#{@libyaml.install_root})
       args << %Q(--with-zlib-dir=#{@zlib.install_root})
@@ -289,7 +321,7 @@ module RubyWasm
       args << %Q(--with-baseruby=#{baseruby_path})
 
       case target
-      when "wasm32-unknown-wasi"
+      when /^wasm32-unknown-wasi/
         xldflags << @wasi_vfs.lib_wasi_vfs_a if @wasi_vfs
         # TODO: Find a way to force cast or update API
         # @type var wasi_sdk_path: untyped
@@ -308,8 +340,9 @@ module RubyWasm
 
       args.concat(self.tools_args)
       (@user_exts || []).each { |lib| xldflags << "@#{lib.linklist(self)}" }
-      xldflags << extinit_obj
+      xldflags << extinit_obj if need_extinit_obj?
 
+      cflags = @cflags.dup
       xcflags = @xcflags.dup
       xcflags << "-DWASM_SETJMP_STACK_BUFFER_SIZE=24576"
       xcflags << "-DWASM_FIBER_STACK_BUFFER_SIZE=24576"
@@ -317,6 +350,7 @@ module RubyWasm
 
       args << %Q(LDFLAGS=#{ldflags.join(" ")})
       args << %Q(XLDFLAGS=#{xldflags.join(" ")})
+      args << %Q(CFLAGS=#{cflags.join(" ")})
       args << %Q(XCFLAGS=#{xcflags.join(" ")})
       args << %Q(debugflags=#{@debugflags.join(" ")})
       args << %Q(cppflags=#{@cppflags.join(" ")})

data/lib/ruby_wasm/build/product/libyaml.rb

@@ -13,7 +13,7 @@ module RubyWasm
     end
 
     def product_build_dir
-      File.join(@build_dir, target, "yaml-#{LIBYAML_VERSION}")
+      File.join(@build_dir, target.to_s, "yaml-#{LIBYAML_VERSION}")
     end
 
     def destdir
@@ -52,12 +52,14 @@ module RubyWasm
       executor.system "curl",
                       "-o",
                       "#{product_build_dir}/config/config.guess",
-                      "https://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD"
+                      "https://cdn.jsdelivr.net/gh/gcc-mirror/gcc@master/config.guess"
       executor.system "curl",
                       "-o",
                       "#{product_build_dir}/config/config.sub",
-                      "https://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.sub;hb=HEAD"
+                      "https://cdn.jsdelivr.net/gh/gcc-mirror/gcc@master/config.sub"
 
+      configure_args = self.configure_args.dup
+      configure_args << "CFLAGS=-fPIC" if target.pic?
       executor.system "./configure", *configure_args, chdir: product_build_dir
       executor.system "make",
                       "install",

data/lib/ruby_wasm/build/product/openssl.rb

@@ -13,7 +13,7 @@ module RubyWasm
     end
 
     def product_build_dir
-      File.join(@build_dir, target, "openssl-#{OPENSSL_VERSION}")
+      File.join(@build_dir, target.to_s, "openssl-#{OPENSSL_VERSION}")
     end
 
     def destdir
@@ -42,7 +42,7 @@ module RubyWasm
         --libdir=lib
         -Wl,--allow-undefined
       ]
-      if @target == "wasm32-unknown-wasi"
+      if @target.triple.start_with?("wasm32-unknown-wasi")
         args.concat %w[
                       -D_WASI_EMULATED_SIGNAL
                       -D_WASI_EMULATED_PROCESS_CLOCKS
@@ -52,6 +52,11 @@ module RubyWasm
                       -DHAVE_FORK=0
                     ]
       end
+
+      if @target.pic?
+        args << "-fPIC"
+      end
+
       args + tools_args
     end
 

data/lib/ruby_wasm/build/product/product.rb

@@ -12,13 +12,13 @@ module RubyWasm
     end
     def system_triplet_args
       args = []
-      case @target
-      when "wasm32-unknown-wasi"
+      case @target.triple
+      when /^wasm32-unknown-wasi/
         args.concat(%W[--host wasm32-wasi])
       when "wasm32-unknown-emscripten"
         args.concat(%W[--host wasm32-emscripten])
       else
-        raise "unknown target: #{@target}"
+        raise "unknown target: #{@target.triple}"
       end
       args
     end

data/lib/ruby_wasm/build/product/ruby_source.rb

@@ -19,7 +19,7 @@ module RubyWasm
       when "tarball"
         digest << @params[:url]
       when "local"
-        digest << File.mtime(@params[:src]).to_i.to_s
+        digest << File.mtime(@params[:path]).to_i.to_s
       else
         raise "unknown source type: #{@params[:type]}"
       end
@@ -75,12 +75,12 @@ module RubyWasm
         )
       when "local"
         executor.mkdir_p File.dirname(src_dir)
-        executor.cp_r @params[:src], src_dir
+        executor.ln_s File.expand_path(@params[:path]), src_dir
       else
         raise "unknown source type: #{@params[:type]}"
       end
       (@params[:patches] || []).each do |patch_path|
-        executor.system "patch", "-p1", patch_path, chdir: src_dir
+        executor.system "patch", "-p1", "-i", patch_path, chdir: src_dir
       end
     end
 

data/lib/ruby_wasm/build/product/wasi_vfs.rb

@@ -12,7 +12,7 @@ module RubyWasm
     def lib_product_build_dir
       File.join(
         @build_dir,
-        "wasm32-unknown-wasi",
+        "wasm32-unknown-wasip1",
         "wasi-vfs-#{WASI_VFS_VERSION}"
       )
     end

data/lib/ruby_wasm/build/product/zlib.rb

@@ -13,7 +13,7 @@ module RubyWasm
     end
 
     def product_build_dir
-      File.join(@build_dir, target, "zlib-#{ZLIB_VERSION}")
+      File.join(@build_dir, target.to_s, "zlib-#{ZLIB_VERSION}")
     end
 
     def destdir
@@ -54,6 +54,8 @@ module RubyWasm
                       product_build_dir,
                       "--strip-components=1"
 
+      configure_args = self.configure_args.dup
+      configure_args << "CFLAGS=-fPIC" if target.pic?
       executor.system "env",
                       *configure_args,
                       "./configure",

data/lib/ruby_wasm/build/target.rb

@@ -0,0 +1,24 @@
+module RubyWasm
+  # A build target representation
+  class Target
+    attr_reader :triple
+
+    def initialize(triple, pic: false)
+      @triple = triple
+      @pic = pic
+    end
+
+    def pic?
+      @pic
+    end
+
+    def to_s
+      "#{@triple}#{@pic ? "-pic" : ""}"
+    end
+
+    def cache_key(digest)
+      digest << @triple
+      digest << "pic" if @pic
+    end
+  end
+end

data/lib/ruby_wasm/build/toolchain/wit_bindgen.rb

@@ -4,10 +4,10 @@ module RubyWasm
 
     def initialize(
       build_dir:,
-      revision: "251e84b89121751f79ac268629e9285082b2596d"
+      revision: "v0.24.0"
     )
       @build_dir = build_dir
-      @tool_dir = File.join(@build_dir, "toolchain", "wit-bindgen")
+      @tool_dir = File.join(@build_dir, "toolchain", "wit-bindgen-#{revision}")
       @bin_path = File.join(@tool_dir, "bin", "wit-bindgen")
       @revision = revision
     end

data/lib/ruby_wasm/build/toolchain.rb

@@ -18,7 +18,7 @@ module RubyWasm
 
     def self.get(target, build_dir = nil)
       case target
-      when "wasm32-unknown-wasi"
+      when /^wasm32-unknown-wasi/
         return RubyWasm::WASISDK.new(build_dir: build_dir)
       when "wasm32-unknown-emscripten"
         return RubyWasm::Emscripten.new

data/lib/ruby_wasm/build.rb

@@ -2,6 +2,7 @@ require_relative "build/build_params"
 require_relative "build/product"
 require_relative "build/toolchain"
 require_relative "build/executor"
+require_relative "build/target"
 
 class RubyWasm::Build
   # Source to build from.
@@ -36,6 +37,7 @@ class RubyWasm::Build
     toolchain:,
     build_dir:,
     rubies_dir:,
+    wasi_vfs: :default,
     **options
   )
     @target = target
@@ -45,7 +47,7 @@ class RubyWasm::Build
 
     @libyaml = RubyWasm::LibYAMLProduct.new(@build_dir, @target, @toolchain)
     @zlib = RubyWasm::ZlibProduct.new(@build_dir, @target, @toolchain)
-    @wasi_vfs = RubyWasm::WasiVfsProduct.new(@build_dir)
+    @wasi_vfs = wasi_vfs == :default ? RubyWasm::WasiVfsProduct.new(@build_dir) : wasi_vfs
     @source = RubyWasm::BuildSource.new(src, @build_dir)
     @baseruby = RubyWasm::BaseRubyProduct.new(@build_dir, @source)
     @openssl = RubyWasm::OpenSSLProduct.new(@build_dir, @target, @toolchain)
@@ -78,11 +80,13 @@ class RubyWasm::Build
     @crossruby.cache_key(digest)
     digest << @build_dir
     digest << @rubies_dir
-    digest << @target
+    @target.cache_key(digest)
     digest << @toolchain.name
     digest << @libyaml.name
     digest << @zlib.name
     digest << @openssl.name
-    digest << @wasi_vfs.name
+    if wasi_vfs = @wasi_vfs
+      digest << wasi_vfs.name
+    end
   end
 end

data/lib/ruby_wasm/cli.rb

@@ -42,7 +42,7 @@ module RubyWasm
     end
 
     def build(args)
-      # @type var options: Hash[Symbol, untyped]
+      # @type var options: cli_options
       options = {
         save_temps: false,
         optimize: false,
@@ -50,14 +50,16 @@ module RubyWasm
         reconfigure: false,
         clean: false,
         ruby_version: "3.3",
-        target_triplet: "wasm32-unknown-wasi",
+        target_triplet: "wasm32-unknown-wasip1",
         profile: "full",
         stdlib: true,
-        disable_gems: false
+        disable_gems: false,
+        gemfile: nil,
+        patches: [],
       }
       OptionParser
         .new do |opts|
-          opts.banner = "Usage: rbwasm componentize [options]"
+          opts.banner = "Usage: rbwasm build [options]"
           opts.on("-h", "--help", "Prints this help") do
             @stdout.puts opts
             exit
@@ -106,6 +108,10 @@ module RubyWasm
             options[:disable_gems] = true
           end
 
+          opts.on("-p", "--patch PATCH", "Apply a patch") do |patch|
+            options[:patches] << patch
+          end
+
           opts.on("--format FORMAT", "Output format") do |format|
             options[:format] = format
           end
@@ -116,8 +122,19 @@ module RubyWasm
         end
         .parse!(args)
 
+      __skip__ = if defined?(Bundler)
+        Bundler.settings.temporary(force_ruby_platform: true) do
+          do_build_with_force_ruby_platform(options)
+        end
+      else
+        do_build_with_force_ruby_platform(options)
+      end
+    end
+
+    def do_build_with_force_ruby_platform(options)
       verbose = RubyWasm.logger.level == :debug
       executor = RubyWasm::BuildExecutor.new(verbose: verbose)
+
       packager = self.derive_packager(options)
 
       if options[:print_ruby_cache_key]
@@ -152,10 +169,12 @@ module RubyWasm
     private
 
     def build_config(options)
-      config = { target: options[:target_triplet], src: options[:ruby_version] }
+      build_source, all_default_exts = compute_build_source(options)
+      # @type var config: Packager::build_config
+      config = { target: options[:target_triplet], src: build_source }
       case options[:profile]
       when "full"
-        config[:default_exts] = RubyWasm::Packager::ALL_DEFAULT_EXTS
+        config[:default_exts] = all_default_exts || ""
         env_additional_exts = ENV["RUBY_WASM_ADDITIONAL_EXTS"] || ""
         unless env_additional_exts.empty?
           config[:default_exts] += "," + env_additional_exts
@@ -170,12 +189,129 @@ module RubyWasm
       config
     end
 
-    def derive_packager(options)
+    def compute_build_source(options)
+      src_name = options[:ruby_version]
+      aliases = self.class.build_source_aliases(root)
+      source = aliases[src_name]
+      if source.nil?
+        if File.directory?(src_name)
+          # Treat as a local source if the given name is a source directory.
+          RubyWasm.logger.debug "Using local source: #{src_name}"
+          if options[:patches].any?
+            RubyWasm.logger.warn "Patches specified through --patch are ignored for local sources"
+          end
+          # @type var local_source: RubyWasm::Packager::build_source_local
+          local_source = { type: "local", path: src_name }
+          # @type var local_source: RubyWasm::Packager::build_source
+          local_source = local_source.merge(name: "local", patches: [])
+          return [local_source, nil]
+        end
+        # Otherwise, it's an unknown source.
+        raise(
+          "Unknown Ruby source: #{src_name} (available: #{aliases.keys.join(", ")} or a local directory)"
+        )
+      end
+      # Apply user-specified patches in addition to bundled patches.
+      source[:patches].concat(options[:patches])
+      # @type var all_default_exts: String
+      __skip__ = all_default_exts = source[:all_default_exts]
+      [source, all_default_exts]
+    end
+
+    # Retrieves the alias definitions for the Ruby sources.
+    def self.build_source_aliases(root)
+      # @type var sources: Hash[string, RubyWasm::Packager::build_source]
+      sources = {
+        "head" => {
+          type: "github",
+          repo: "ruby/ruby",
+          rev: "master",
+          all_default_exts: RubyWasm::Packager::ALL_DEFAULT_EXTS,
+        },
+        "3.3" => {
+          type: "tarball",
+          url: "https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.1.tar.gz",
+          all_default_exts: "bigdecimal,cgi/escape,continuation,coverage,date,dbm,digest/bubblebabble,digest,digest/md5,digest/rmd160,digest/sha1,digest/sha2,etc,fcntl,fiber,gdbm,json,json/generator,json/parser,nkf,objspace,pathname,psych,racc/cparse,rbconfig/sizeof,ripper,stringio,strscan,monitor,zlib,openssl",
+        },
+        "3.2" => {
+          type: "tarball",
+          url: "https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.4.tar.gz",
+          all_default_exts: "bigdecimal,cgi/escape,continuation,coverage,date,dbm,digest/bubblebabble,digest,digest/md5,digest/rmd160,digest/sha1,digest/sha2,etc,fcntl,fiber,gdbm,json,json/generator,json/parser,nkf,objspace,pathname,psych,racc/cparse,rbconfig/sizeof,ripper,stringio,strscan,monitor,zlib,openssl",
+        }
+      }
+
+      # Apply bundled and user-specified `<root>/patches` directories.
+      sources.each do |name, source|
+        source[:name] = name
+        patches_dirs = [bundled_patches_path, File.join(root, "patches")]
+        source[:patches] = patches_dirs.flat_map do |patches_dir|
+          Dir[File.join(patches_dir, name, "*.patch")]
+            .map { |p| File.expand_path(p) }
+        end
+      end
+
+      build_manifest = File.join(root, "build_manifest.json")
+      if File.exist?(build_manifest)
+        begin
+          manifest = JSON.parse(File.read(build_manifest))
+          manifest["ruby_revisions"].each do |name, rev|
+            source = sources[name]
+            next unless source[:type] == "github"
+            # @type var source: RubyWasm::Packager::build_source_github
+            source[:rev] = rev
+          end
+        rescue StandardError => e
+          RubyWasm.logger.warn "Failed to load build_manifest.json: #{e}"
+        end
+      end
+      sources
+    end
+
+    # Retrieves the root directory of the Ruby project.
+    def root
       __skip__ =
-        if defined?(Bundler) && !options[:disable_gems]
+        @root ||=
+          begin
+            if explicit = ENV["RUBY_WASM_ROOT"]
+              File.expand_path(explicit)
+            elsif defined?(Bundler)
+              Bundler.root
+            else
+              Dir.pwd
+            end
+          rescue Bundler::GemfileNotFound
+            Dir.pwd
+          end
+    end
+
+    # Path to the directory containing the bundled patches, which is shipped
+    # as part of ruby_wasm gem to backport fixes or try experimental features
+    # before landing them to the ruby/ruby repository.
+    def self.bundled_patches_path
+      dir = __dir__
+      raise "Unexpected directory structure, no __dir__!??" unless dir
+      lib_source_root = File.join(dir, "..", "..")
+      File.join(lib_source_root, "patches")
+    end
+
+    def derive_packager(options)
+      __skip__ = definition = nil
+      __skip__ = if defined?(Bundler) && !options[:disable_gems]
+        begin
+          # Silence Bundler UI if --print-ruby-cache-key is specified not to bother the JSON output.
+          level = options[:print_ruby_cache_key] ? :silent : Bundler.ui.level
+          old_level = Bundler.ui.level
+          Bundler.ui.level = level
           definition = Bundler.definition
+        ensure
+          Bundler.ui.level = old_level
         end
-      RubyWasm::Packager.new(build_config(options), definition)
+      end
+      RubyWasm.logger.info "Using Gemfile: #{definition.gemfiles}" if definition
+      RubyWasm::Packager.new(
+        root, build_config(options), definition,
+        features: RubyWasm::FeatureSet.derive_from_env
+      )
     end
 
     def do_print_ruby_cache_key(packager)
@@ -197,9 +333,9 @@ module RubyWasm
       RubyWasm.logger.info "Size: #{SizeFormatter.format(wasm_bytes.size)}"
       case options[:output]
       when "-"
-        @stdout.write wasm_bytes.pack("C*")
+        @stdout.write wasm_bytes
       else
-        File.binwrite(options[:output], wasm_bytes.pack("C*"))
+        File.binwrite(options[:output], wasm_bytes)
         RubyWasm.logger.debug "Wrote #{options[:output]}"
       end
     end

data/lib/ruby_wasm/feature_set.rb

@@ -0,0 +1,30 @@
+##
+# A set of feature flags that can be used to enable or disable experimental features.
+class RubyWasm::FeatureSet
+  def initialize(features)
+    @features = features
+  end
+
+  # Maps the feature to the environment variable.
+  FEATURES = {
+    dynamic_linking: "RUBY_WASM_EXPERIMENTAL_DYNAMIC_LINKING",
+    component_model: "RUBY_WASM_EXPERIMENTAL_COMPONENT_MODEL",
+  }.freeze
+  private_constant :FEATURES
+
+  # Derives the feature set from the environment variables. A feature
+  # is enabled if the corresponding environment variable is set to "1",
+  # otherwise it is disabled.
+  def self.derive_from_env
+    values = FEATURES.transform_values { |key| ENV[key] == "1" }
+    new(values)
+  end
+
+  def support_dynamic_linking?
+    @features[:dynamic_linking]
+  end
+
+  def support_component_model?
+    @features[:component_model] || @features[:dynamic_linking]
+  end
+end