humid 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8a07ab8d934750bbdb01dc4596426d02edd7733d7bf87093b8ca36d5abbbb33
-  data.tar.gz: d3c9f28d92d637d8d4eb20e78676a0eacf09d7c922c0583448f3aacc1befe4fa
+  metadata.gz: 4dace2fdf5d12412e01d86b520b5d77fd3fd04dd207b2815d93d0473283fa6a8
+  data.tar.gz: d8c40b486faa9f905c04c3d31c4eabd0cd304d0ad98d1666b1d76ad2aae32e0c
 SHA512:
-  metadata.gz: 311cdf7125016802906bc28b7545c80c22e01709ebe679ead307f68783bab051a9e30bc634b777ce41802ad9d6564288305c593aee5da05a40e853b8a7ce31f2
-  data.tar.gz: 43777369d6c7b2525957d11117be0b1df56e960dbea0ca7be822ebb1b0d7c1e9af5f406fea47619d7f50829e203f610fb1074b1435b6ccce310453f1db04bf05
+  metadata.gz: afc89db87f4b324b01b08a1f907ae74fd88a420b8c275095b9e7e44b8cf21e711b31dc18dbc0b021d85d8debca4e50986be1a16a2b43eec2a27ad1de6cc668c2
+  data.tar.gz: 1564ce03048d337b38891607afbbc360e47e5898601cb78a984ce4a003aafe1b3ff95dc6dc0a3faa70a6b6703446b11d7ddb86185250ad68e36e65401bf3dcb8

data/README.md

@@ -78,6 +78,13 @@ Humid.configure do |config|
   #
   # Defaults to `nil`
   config.logger = Rails.env.local? ? Rails.logger : nil
+
+  # Path to a JavaScript file to eval into the MiniRacer context
+  # before the application bundle. Use this to provide globals that
+  # bare V8 doesn't have (TextEncoder, URL, MessageChannel, etc.).
+  #
+  # Optional. Defaults to nil (no prepend).
+  # config.prepend = Rails.root.join("path/to/shim.js")
 end
 
 if Rails.env.local?
@@ -269,11 +276,44 @@ moving the `require` to `useEffect` in your component.
   }, [])
 ```
 
-## Polyfills
+## MiniRacer Shim
+
+MiniRacer runs bare V8 — no browser APIs, no Node APIs. React SSR and
+libraries like `whatwg-url` expect globals that don't exist. Humid ships
+a pre-built shim in [`shim/dist/shim.js`](./shim/) that provides:
+
+- **TextEncoder / TextDecoder** — real implementation from `text-encoding`
+  (not stubs — `whatwg-url` needs them to actually encode strings)
+- **URL / URLSearchParams** — from `whatwg-url`
+- **MessageChannel** — stub (React's scheduler references it)
+- **navigator** — stub with `language: 'en-us'`
+- **source-map-support** — rewrites JS stack traces using source maps,
+  so Humid errors show original filenames and line numbers
+  (`app/views/posts/show.html.tsx:42`) instead of bundled positions
+  (`server_rendering.js:12345`)
+
+Use it with the `prepend` config option:
+
+```ruby
+Humid.configure do |config|
+  config.prepend = Rails.root.join("path/to/shim.js")
+end
+```
+
+The shim is eval'd into the MiniRacer context before your SSR bundle,
+so all globals are available when your code initializes.
+
+To rebuild the shim (e.g., after updating dependencies):
+
+```sh
+cd shim
+npm install
+npm run build
+# outputs shim/dist/shim.js
+```
 
-React SSR may import node.js dependencies that you need to polyfill for. See
-a sample esbuild [build script](./sample/build.mjs) and a [shim.js](./sample/shim.js)
-to get around these issues.
+See the [shim README](./shim/README.md) for details on the two-stage
+build process.
 
 ## Telemetry
 

data/lib/humid/version.rb

@@ -1,3 +1,3 @@
 module Humid
-  VERSION = "1.0.0".freeze
+  VERSION = "1.1.0".freeze
 end

data/lib/humid.rb

@@ -44,6 +44,11 @@ module Humid
       ctx.attach("console.warn", proc { |*args| logger.warn(fmt.call(:warn, *args)) })
     end
 
+    prepend_path = effective_config.prepend
+    if prepend_path
+      ctx.eval(File.read(prepend_path))
+    end
+
     js = remove_functions + renderer
     ctx.eval(js)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: humid
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Johny Ho