opal-vite 0.3.12 → 0.3.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9090275c2e356c56f2251c8553177f531703d22f134ce8fa8b68e11893f2ee29
-  data.tar.gz: 2d329e601b63709562865683389d41fe63250e1bc380f4c293a9342b900b84c6
+  metadata.gz: 70f625bc74c24b95f12fb5fbfddd5f5aee028c1f1953affb73d9bfab639deedf
+  data.tar.gz: 416c5805372e4ff28a55005ec0d0fc0cb23e2d2d76cfe81db04e1da5131ac4d5
 SHA512:
-  metadata.gz: ba6714e48e3df9aa55671f9bce896b786443c34a9de6efc82b00955edb7fb2f5247a35c3de98e8ad2cad37bf0bf2e2931221e2276dec8128629a1a147554de85
-  data.tar.gz: 41cc25cdaa6b11f66a95082bc56828284a43b20fb2beac8c8ee043fb8b65e2637c1d68c07faa2ac1e5cb832b90216cf59ed0c67dde1e18b11425b5fadfebd8ea
+  metadata.gz: 97ecab260b4b8284f5a07a5bdbb9ede917e5708193348d40c77b2d953be852b3f6b97a5a7405082ce2aec62c3abae0561c9a04960f599d622af8ea1ce801edc0
+  data.tar.gz: d51d3a7602afbbc9e3d5cc3898f31f95a9f0c731635074e3d9fe88ae731aadf676f6a9d8e39f5ece06cedca44998fac708983311068fcb38c8c5f2f2a11dc679

data/lib/opal/vite/version.rb

@@ -1,5 +1,5 @@
 module Opal
   module Vite
-    VERSION = "0.3.12"
+    VERSION = "0.3.14"
   end
 end

data/opal/opal_vite/concerns/v1/action_cable_helpers.rb

@@ -318,7 +318,7 @@ module OpalVite
           json_str = cable_data(data, key)
           return nil if json_str.nil?
           `JSON.parse(#{json_str})`
-        rescue
+        rescue Exception
           nil
         end
 

data/opal/opal_vite/concerns/v1/base64_helpers.rb

@@ -29,7 +29,7 @@ module OpalVite
         # @return [String] Base64 encoded string
         def base64_encode(str)
           `btoa(#{str})`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -38,7 +38,7 @@ module OpalVite
         # @return [String] Decoded string
         def base64_decode(str)
           `atob(#{str})`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -81,7 +81,7 @@ module OpalVite
         def base64_encode_unicode(str)
           # Convert to UTF-8 bytes, then encode
           `btoa(unescape(encodeURIComponent(#{str})))`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -90,7 +90,7 @@ module OpalVite
         # @return [String] Decoded Unicode string
         def base64_decode_unicode(str)
           `decodeURIComponent(escape(atob(#{str})))`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -108,7 +108,7 @@ module OpalVite
             }
             return btoa(binary);
           `
-        rescue
+        rescue Exception
           nil
         end
 
@@ -124,7 +124,7 @@ module OpalVite
             }
             return bytes;
           `
-        rescue
+        rescue Exception
           nil
         end
 
@@ -202,7 +202,7 @@ module OpalVite
           return nil unless payload_json
 
           `JSON.parse(#{payload_json})`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -264,7 +264,9 @@ module OpalVite
 
           len = str.length
           padding = str.end_with?('==') ? 2 : (str.end_with?('=') ? 1 : 0)
-          (len * 3 / 4) - padding
+          # Use integer division: in Opal `len * 3 / 4` is JS float division, so
+          # unpadded/URL-safe input (len % 4 == 2 or 3) would yield e.g. 16.5.
+          ((len * 3) / 4).floor - padding
         end
       end
     end

data/opal/opal_vite/concerns/v1/component.rb

@@ -0,0 +1,112 @@
+# backtick_javascript: true
+
+module OpalVite
+  module Concerns
+    module V1
+      # Component - a lightweight, framework-agnostic UI component base class.
+      #
+      # opal-rails users coming from hand-written opal-jquery DOM code (or
+      # Hyperstack) usually just want "a base class that holds state and
+      # re-renders". This provides exactly that, with no React/Vue dependency,
+      # using only the native DOM. Because it is Sprockets-independent it runs
+      # unchanged under Vite.
+      #
+      # @example
+      #   class Counter < OpalComponent
+      #     def initial_state
+      #       { count: 0 }
+      #     end
+      #
+      #     def render
+      #       "<button>count: #{state[:count]}</button>"
+      #     end
+      #
+      #     def after_render
+      #       on('button', 'click') { set_state(count: state[:count] + 1) }
+      #     end
+      #   end
+      #
+      #   Counter.new.mount('#app')
+      class Component
+        attr_reader :state, :props, :el
+
+        # @param props [Hash] immutable inputs passed from the parent/caller
+        def initialize(props = {})
+          @props = props
+          @state = initial_state
+          @el = nil
+        end
+
+        # Override to provide the initial state hash. Defaults to empty.
+        def initial_state
+          {}
+        end
+
+        # Override to return the component's HTML as a String.
+        def render
+          ''
+        end
+
+        # Optional hook run after every render. Attach event listeners here
+        # (the DOM produced by #render only exists after rendering).
+        def after_render; end
+
+        # Mount the component into a DOM element.
+        # @param target [String, Native] a CSS selector or a native element
+        # @return [self]
+        def mount(target)
+          @el = resolve_el(target)
+          raise "OpalComponent#mount: target not found: #{target}" if `#{@el} == null`
+
+          do_render
+          self
+        end
+
+        # Merge +partial+ into the current state and re-render (if mounted).
+        # @param partial [Hash]
+        # @return [Hash] the new state
+        def set_state(partial)
+          unless partial.is_a?(Hash)
+            raise ArgumentError, "OpalComponent#set_state expects a Hash, got #{partial.class}"
+          end
+
+          @state = @state.merge(partial)
+          do_render if @el
+          @state
+        end
+
+        # querySelector scoped to this component's element.
+        def query(selector)
+          `#{@el}.querySelector(#{selector})`
+        end
+
+        # Attach an event listener to a descendant matched by +selector+.
+        # The block receives the native DOM event.
+        def on(selector, event, &block)
+          node = query(selector)
+          return if `#{node} == null`
+
+          `#{node}.addEventListener(#{event}, #{block})`
+        end
+
+        private
+
+        def do_render
+          `#{@el}.innerHTML = #{render}`
+          after_render
+        end
+
+        def resolve_el(target)
+          if target.is_a?(String)
+            `document.querySelector(#{target})`
+          else
+            target
+          end
+        end
+      end
+    end
+  end
+end
+
+# Friendly top-level alias (the base class users subclass).
+OpalComponent = OpalVite::Concerns::V1::Component

data/opal/opal_vite/concerns/v1/react_helpers.rb

@@ -275,7 +275,10 @@ module OpalVite
 
         # Stringify to JSON
         def to_json(object)
-          `JSON.stringify(#{object})`
+          # Convert Ruby Hash/Array to a native JS value first; passing a raw
+          # Opal Hash to JSON.stringify serializes to "{}" (silent data loss).
+          native = object.respond_to?(:to_n) ? object.to_n : object
+          `JSON.stringify(#{native})`
         end
 
         # ===================

data/opal/opal_vite/concerns/v1/storable.rb

@@ -11,7 +11,7 @@ module OpalVite
 
         begin
           `JSON.parse(stored)`
-        rescue
+        rescue Exception
           nil
         end
       end

data/opal/opal_vite/concerns/v1/turbo_helpers.rb

@@ -356,7 +356,13 @@ module OpalVite
         #   source = turbo_stream_from("/notifications/stream")
         #   # Turbo will automatically process incoming streams
         def turbo_stream_from(url)
-          `window.Turbo.connectStreamSource(new EventSource(#{url}))`
+          # Keep a reference to the EventSource and return it: connectStreamSource
+          # returns undefined, so returning its result would make the documented
+          # `turbo_stream_disconnect(source)` call `undefined.close()` and leak
+          # the SSE connection.
+          source = `new EventSource(#{url})`
+          `window.Turbo.connectStreamSource(#{source})`
+          source
         end
 
         # Disconnect a Turbo Stream SSE source

data/opal/opal_vite/concerns/v1/uri_helpers.rb

@@ -27,7 +27,7 @@ module OpalVite
         # @return [Native] JavaScript URL object
         def parse_url(url_string)
           `new URL(#{url_string})`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -37,7 +37,7 @@ module OpalVite
         # @return [Native] JavaScript URL object
         def parse_url_with_base(url_string, base)
           `new URL(#{url_string}, #{base})`
-        rescue
+        rescue Exception
           nil
         end
 
@@ -225,7 +225,7 @@ module OpalVite
         # @return [String] Decoded string
         def decode_uri_component(str)
           `decodeURIComponent(#{str})`
-        rescue
+        rescue Exception
           str
         end
 
@@ -241,7 +241,7 @@ module OpalVite
         # @return [String] Decoded URI
         def decode_uri(str)
           `decodeURI(#{str})`
-        rescue
+        rescue Exception
           str
         end
 

data/opal/opal_vite/concerns/v1/vue_helpers.rb

@@ -315,7 +315,10 @@ module OpalVite
 
         # Stringify to JSON
         def to_json_string(object)
-          `JSON.stringify(#{object})`
+          # Convert Ruby Hash/Array to a native JS value first; passing a raw
+          # Opal Hash to JSON.stringify serializes to "{}" (silent data loss).
+          native = object.respond_to?(:to_n) ? object.to_n : object
+          `JSON.stringify(#{native})`
         end
 
         # ===================

data/opal/opal_vite/concerns/v1.rb

@@ -12,3 +12,4 @@ require 'opal_vite/concerns/v1/base64_helpers'
 require 'opal_vite/concerns/v1/debug_helpers'
 require 'opal_vite/concerns/v1/action_cable_helpers'
 require 'opal_vite/concerns/v1/turbo_helpers'
+require 'opal_vite/concerns/v1/component'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opal-vite
 version: !ruby/object:Gem::Version
-  version: 0.3.12
+  version: 0.3.14
 platform: ruby
 authors:
 - stofu1234
@@ -122,6 +122,7 @@ files:
 - opal/opal_vite/concerns/v1.rb
 - opal/opal_vite/concerns/v1/action_cable_helpers.rb
 - opal/opal_vite/concerns/v1/base64_helpers.rb
+- opal/opal_vite/concerns/v1/component.rb
 - opal/opal_vite/concerns/v1/debug_helpers.rb
 - opal/opal_vite/concerns/v1/dom_helpers.rb
 - opal/opal_vite/concerns/v1/functional_component.rb