jsg 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 656528ab1a482268d018a12df7b3cd5fda4d74f08368926f7fb665a4f5f3621f
-  data.tar.gz: a63fec4f4c89edc7e116aa878781aa9235bcdf17967f12508ccea62ab5bcef19
+  metadata.gz: c5bbe669419df7b6181dacae7851ccf5a27b97abdf6e6a4a2a48c73e10d87632
+  data.tar.gz: c838fccba5ca6a8316d0718b097312b3760f31b94f9112eeee1bf1e7053c142f
 SHA512:
-  metadata.gz: e231cea6d1794b20a9bffc034ac38020968288177af7c49f973b7901deb4a02cf4c86fa7ec8655e5ac7c078293c9b986d9cb8fdfd712d199ed349b80ca74ef80
-  data.tar.gz: cfc908766616ad9b18026b20369caf5d01e79e7d2bde8463d8af9f619a3c1b86c5d686476b007759c15fa9dfc4dfa74e0ee375dac929bff53e9fd123e0c472ed
+  metadata.gz: 448f59e03a1e7a38c89f0ff99e5ff32ddda31fd3009bef7d712929ce93c4b7804aba3d137df8c4aff25f051f47a4bec023ad211a907da1ed06c2de4baa53c850
+  data.tar.gz: 5bfbcff342b82afd36fd558eb8a63052f8b2699e98f5d65eebdb5c5c2cb0dd67dbab2c9505fd28227ed6d2716e32070dce6aded230627ec8bbc37e0786d9fe82

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-11-05
+
+- New opt-in `require "jsg/global"`: unknown methods on the `JS` module are forwarded to `JS.global`, so `JS.document.title`, `JS.alert("Hi")` and `JS.myValue = 1` work. Names the `JS` module already answers keep their meaning (`JS.global`, `JS.eval`, and Ruby's own module methods such as `JS.name`). It loads `jsg` too. `require "jsg"` alone does not change the `JS` module.
+- The ruby.wasm tests run every test file in a fresh VM, so a file that only requires `jsg/global` is tested on its own.
+
 ## [0.2.1] - 2026-09-29
 
 - First release published from GitHub Actions with RubyGems trusted publishing (`.github/workflows/release.yml`, triggered by `v*` tags).

data/README.md

@@ -97,6 +97,29 @@ el.tap { |e| ... } # like Kernel#tap (JS::Object is a BasicObject since js 2.10)
 value == true     # comparing with true, false and nil works (JavaScript's == rules)
 ```
 
+### `JS.document` instead of `JS.global.document` (opt-in)
+
+`require "jsg/global"` forwards unknown methods on the `JS` module to `JS.global`. It loads `jsg` as well, so this one line is enough:
+
+```ruby
+require "jsg/global"
+
+JS.document.title             # JS.global.document.title
+JS.alert("Hello")             # JS.global.alert("Hello")
+JS.localStorage.getItem("k")
+JS.myValue = 1                # sets window.myValue
+JS.hidden?                    # JavaScript truthiness, like the ? methods above
+```
+
+It is not part of `require "jsg"` because it changes the `JS` module itself, which the js gem and other libraries use too. Load it when you want the shorter syntax in your own app.
+
+Only names that `JS` does not already answer are forwarded. These keep their Ruby meaning, so use `JS.global` for a browser global of the same name:
+
+- methods of the js gem: `JS.global`, `JS.eval`, `JS.try_convert`, `JS.is_a?`, ...
+- methods every Ruby module has: `JS.name` (returns `"JS"`, not `window.name`), `JS.hash`, `JS.inspect`, `JS.class`, `JS.method`, `JS.display`, `JS.freeze`, ...
+
+Private `Kernel` methods such as `open`, `print` or `format` are forwarded, because calling them with an explicit receiver (`JS.open(...)`) ends up in `method_missing`. A name that the global object does not have raises `NoMethodError` as before. `JSG.xxx` forwards to `JS`, so after `require "jsg/global"` it reaches the globals too.
+
 ## Development
 
 ```bash
@@ -107,8 +130,8 @@ bundle exec rake    # rspec, the ruby.wasm tests and rubocop
 To release a new version, update `lib/jsg/version.rb` and `CHANGELOG.md`, commit, and push a matching tag:
 
 ```bash
-git tag v0.2.1
-git push origin v0.2.1
+git tag v0.3.0
+git push origin v0.3.0
 ```
 
 The `Release` workflow runs the tests and publishes the gem to RubyGems.org with trusted publishing, so no API key is stored in GitHub.

data/lib/jsg/global.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "jsg"
+
+module JSG
+  # Opt-in shortcut: forwards unknown methods on the JS module to JS.global,
+  # so browser globals can be used without writing JS.global every time.
+  #
+  #   require "jsg/global"
+  #
+  #   JS.document.title           # JS.global.document.title
+  #   JS.alert("Hello")           # JS.global.alert("Hello")
+  #   JS.localStorage.getItem("k")
+  #   JS.myValue = 1              # sets window.myValue
+  #
+  # It is a separate file because it changes the JS module itself, which the
+  # js gem and other libraries also use. `require "jsg"` alone does not load it.
+  #
+  # Only names that JS does not already answer are forwarded. These keep their
+  # Ruby meaning, so use JS.global for the browser global of the same name:
+  #
+  # - methods of the js gem: JS.global, JS.eval, JS.try_convert, JS.is_a?, ...
+  # - methods every Ruby module has: JS.name (returns "JS", not window.name),
+  #   JS.hash, JS.inspect, JS.class, JS.method, JS.display, JS.freeze, ...
+  #
+  # Private Kernel methods such as open, print or format are forwarded, because
+  # calling them with an explicit receiver (JS.open) ends up in method_missing.
+  # A name the global object does not have raises NoMethodError as usual.
+  module Global
+    # Sends +name+ with its arguments and block to JS.global if the global
+    # object responds to it (property read, setter, method call or predicate,
+    # as handled by the jsg patch); otherwise raises NoMethodError via super.
+    def method_missing(name, ...)
+      return super unless global.respond_to?(name)
+
+      global.__send__(name, ...)
+    end
+
+    # Makes JS.respond_to?(name) true for the names method_missing forwards.
+    def respond_to_missing?(name, include_private = false)
+      global.respond_to?(name) || super
+    end
+  end
+end
+
+JS.extend(JSG::Global)

data/lib/jsg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JSG
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

data/sig/jsg.rbs

@@ -1,4 +1,9 @@
 module JSG
   VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+
+  # require "jsg/global": forwards unknown methods on the JS module to JS.global
+  module Global
+    def method_missing: (Symbol name, *untyped args) ?{ (*untyped) -> untyped } -> untyped
+    def respond_to_missing?: (Symbol name, ?bool include_private) -> bool
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jsg
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Andi
@@ -53,6 +53,7 @@ files:
 - exe/jsg
 - lib/jsg.rb
 - lib/jsg/cli.rb
+- lib/jsg/global.rb
 - lib/jsg/version.rb
 - sig/jsg.rbs
 - template/Gemfile