isomorfeus-preact 10.9.0 → 22.9.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fd60ca53a616be371c66eb5cf584563df83c595dcab068a393db00e0f47d921
-  data.tar.gz: 36943fe176fd85721fa2fe2c13a13a630c3fd963d3d5a4b63a0105b8fecd54ee
+  metadata.gz: f03a9caab0b34f6c66cc1b321a6b7ab89a42af5b5ffb58f775ed5ac2d5bf2a14
+  data.tar.gz: f31916a7ca1e982c0f24f7fde58b0ae09aa834e14a3d872086842f802ffe0c45
 SHA512:
-  metadata.gz: 7628277342dbd37726bb660c0583cc295230d4b9b1078fa7615a1b5983a62f5b202e6aee99caa44b70cb807107008dfc948f78bab154b83c8c39eac99748e940
-  data.tar.gz: 72731c0e8f8355730492e35d23d60affd906141578338c49c64042fdb3713418c403293f28aab560b6e47d68a3ac130c8424ef0eecf1ff239d8db85c0d433b3d
+  metadata.gz: d301859c505f127332372ab4c5ace3eb01d8357d581baa38c2f187e5564c41dbee9cef90cb4fc1d1ad47c3665bf6b415bf2f76adce43b9490dcfaae02da3e443
+  data.tar.gz: aa70516de11b90de247423429e78def56967e780cb13bcd761d8d4de653310d7247d2ebd2ed87e66143ea31e3851136694df6effc9379d2f87738369ef55e518

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018-2019 Jan Biedermann
+Copyright (c) 2018-present Jan Biedermann
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -20,7 +20,8 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-Files in lib/browser directory originally taken from https://github.com/clearwater-rb/bowser, version 1.1.0:
+
+Files in lib/browser directory originally taken from https://github.com/clearwater-rb/bowser:
 
 MIT License
 
@@ -28,7 +29,17 @@ Copyright (c) 2015 Jamie Gaskins
 
 (as above)
 
-Javascript in file lib/nano_css.rb taken from https://github.com/streamich/nano-css:
+
+Javascript in file lib/preact.rb originally taken from https://github.com/preactjs/preact:
+
+MIT License
+
+Copyright (c) 2015-present Jason Miller
+
+(as above)
+
+
+Javascript in file lib/nano_css.rb originally taken from https://github.com/streamich/nano-css:
 
 This is free and unencumbered software released into the public domain.
 

data/README.md

@@ -1,5 +1,5 @@
 <h1 align="center">
-  <img src="https://github.com/isomorfeus/isomorfeus-preact/blob/master/Logo.png?raw=true" align="center" width="234" height="125" />
+  <img src="https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/Logo.png?raw=true" align="center" width="234" height="125" />
   <br/>
 Isomorfeus Preact<br/>
 </h1>
@@ -10,52 +10,36 @@ Develop Preact components for Opal Ruby along with very easy to use and advanced
 At the [Isomorfeus Framework Project](https://isomorfeus.com)
 
 ## Versioning and Compatibility
-isomorfeus-preact version follows the Preact version which features and API it implements.
+As of version 22.8 isomorfeus-preact implements its own preact and preact-render-to-string versions, adapted to work directly with ruby classes or ported to ruby.
 
 ### Preact
-Isomorfeus-preact 10.5.x implements features and the API of Preact 10.5.y and should be used with Preact 10.5.y
+
+Isomorfeus-preact implements a Preact Class Components API in Ruby.
 
 ## Documentation
 
 Because isomorfeus-preact follows closely the Preact principles/implementation/API and Documentation, most things of the official Preact documentation
-apply, but in the Ruby way, see:
-- [https://preactjs.com/guide/v10/getting-started](https://preactjs.com/guide/v10/getting-started)
-
-Component Types:
-- [Class Component](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/class_component.md)
-- [Function and Memo Component](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/function_component.md)
-- [Lucid App, Lucid Component](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/lucid_component.md)
-- [Lucid Func (for use with Hooks)](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/lucid_func_component.md)
-- [Preact Javascript Components and Preact Elements](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/javascript_component.md)
-
-Which component to use?
-- Usually LucidApp and LucidComponent.
-
-Specific to Class, Lucid and LucidMaterial Components:
-- [Events](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/events.md)
-- [Lifecycle Callbacks](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/lifecycle_callbacks.md)
-- [Props](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/props.md)
-- [State](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/state.md)
-
-For all Components:
-- [Accessibility](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/accessibility.md)
-- [Render Blocks](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/render_blocks.md)
-- [Rendering HTML or SVG Elements](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/rendering_elements.md)
-
-Special Preact Features:
-- [Context](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/context.md)
-- [Fragments](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/fragments.md)
-- [Refs](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/refs.md)
+apply, but in the Ruby way. (Except for Function components and Hooks, which are not supported). See the Preact Class Component documentation:
+- [https://preactjs.com/guide/v10/components#class-components](https://preactjs.com/guide/v10/components#class-components)
+- The base class in Ruby to inherit from and implement components is `Preact::Component`
+
+Components:
+- [Lucid App, Lucid Component](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/lucid_component.md)
+- [Events](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/events.md)
+- [Props](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/props.md)
+- [State](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/state.md)
+- [Accessibility](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/accessibility.md)
+- [Render Blocks](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/render_blocks.md)
+- [Rendering HTML or SVG Elements](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/rendering_elements.md)
+- [Context](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/context.md)
+- [Fragments](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/fragments.md)
+- [Refs](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/refs.md)
 
 Other Features:
-- [Hot Module Reloading](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/hot_module_reloading.md)
-- [Server Side Rendering](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/server_side_rendering.md)
-- [Using Wouter as Router](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/wouter.md)
-- [Isomorfeus Helpers](https://github.com/isomorfeus/isomorfeus-preact/blob/master/docs/isomorfeus_helpers.md)
-
-### Development Tools
-The Preact Devtools allow for analyzing, debugging and profiling components. A very helpful toolset and working very nice with isomorfeus-preact:
-[https://preactjs.github.io/preact-devtools/](https://preactjs.github.io/preact-devtools/)
+- [Hot Module Reloading](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/hot_module_reloading.md)
+- [Server Side Rendering](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/server_side_rendering.md)
+- [Using Router](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/router.md)
+- [Isomorfeus Helpers](https://github.com/isomorfeus/isomorfeus-project/blob/master/isomorfeus-preact/docs/isomorfeus_helpers.md)
 
 ### Specs and Benchmarks
 - clone repo

data/lib/browser/delegate_native.rb

@@ -1,72 +1,94 @@
-module Browser
-  module DelegateNative
-    # Provides a default initializer. This should be overridden in all but the
-    # simplest cases.
-    def initialize native
-      @native = native
-    end
-
-    # Fall back to native properties. If the message sent to this element is not
-    # recognized, it checks to see if it is a property of the native element. It
-    # also checks for variations of the message name, such as:
-    #
-    #   :supported? => [:supported, :isSupported]
-    #
-    # If a property with the specified message name is found and it is a
-    # function, that function is invoked with `args`. Otherwise, the property
-    # is returned as is.
-    def method_missing message, *args, &block
-      if message.end_with? '='
-        message = message.chop
-        property_name = property_for_message(message)
-        return `#@native[#{property_name}] = args[0]`
-      else
-        property_name = property_for_message(message)
-
-        %x{
-          let value = #@native[#{property_name}];
-          let type = typeof(value);
-          try {
-            if (type === 'function') {
-              return value.apply(#@native, args);
-            } else if (type === 'object' && (value instanceof HTMLCollection)) {
-              let a = [];
-              for(let i=0; i<value.length; i++) {
-                a[i] = #{Browser::Element.new(`value.item(i)`)};
-              }
-              value = a;
-            } else if (type === 'object' && (value instanceof HTMLElement)) {
-              value = #{Browser::Element.new(`value`)};
-            } else if (value === null || type === 'undefined' || (type === 'number' && isNaN(value))) {
-              return nil;
-            }
-            return value;
-          } catch { return value; }
-        }
-      end
-    end
-
-    def respond_to_missing? message, include_all
-      message = message.chop if message.end_with? '='
-      property_name = property_for_message(message)
-      return true unless `#{property_name} in #@native`
-      false
-    end
-
-    def property_for_message(message)
-      %x{
-        let camel_cased_message;
-        if (typeof(#@native[message]) !== 'undefined') { camel_cased_message = message; }
-        else { camel_cased_message = Opal.Preact.lower_camelize(message) }
-
-        if (camel_cased_message.endsWith('?')) {
-          camel_cased_message = camel_cased_message.substring(0, camel_cased_message.length - 2);
-          if (typeof(#@native[camel_cased_message]) === 'undefined') {
-            camel_cased_message = 'is' + camel_cased_message[0].toUpperCase() + camel_cased_message.substring(0, camel_cased_message.length - 1);
-          }
-        }
-        return camel_cased_message
-      }
-    end
-  end
-end
+module Browser
+  module DelegateNative
+    # Provides a default initializer. This should be overridden in all but the
+    # simplest cases.
+    def initialize native
+      @native = native
+    end
+
+    def [](property)
+      method_missing(property)
+    end
+
+    # Fall back to native properties. If the message sent to this element is not
+    # recognized, it checks to see if it is a property of the native element. It
+    # also checks for variations of the message name, such as:
+    #
+    #   :supported? => [:supported, :isSupported]
+    #
+    # If a property with the specified message name is found and it is a
+    # function, that function is invoked with `args`. Otherwise, the property
+    # is returned as is.
+    def method_missing message, *args, &block
+      if message.end_with? '='
+        message = message.chop
+        property_name = property_for_message(message)
+        arg = args[0]
+        arg = if `arg && typeof arg.$to_n === 'function'`
+                arg.to_n
+              else
+                arg
+              end
+        return `#@native[#{property_name}] = args[0]`
+      else
+        property_name = property_for_message(message)
+
+        %x{
+          let value = #@native[#{property_name}];
+          let type = typeof(value);
+          try {
+            if (type === 'function') {
+              #{
+                args.map! do |arg|
+                  if `arg && typeof arg.$to_n === 'function'`
+                    arg.to_n
+                  else
+                    arg
+                  end
+                end
+              }
+              value = value.apply(#@native, args);
+            }
+            if (value instanceof HTMLCollection || value instanceof NodeList) {
+              let a = [];
+              for(let i=0; i<value.length; i++) {
+                a[i] = #{Browser::Element.new(`value.item(i)`)};
+              }
+              value = a;
+            } else if (value instanceof HTMLElement || value instanceof SVGElement) {
+              value = #{Browser::Element.new(`value`)};
+            } else if (value instanceof Event) {
+              value = #{Browser::Event.new(`value`)};
+            } else if (value === null || type === 'undefined' || (type === 'number' && isNaN(value))) {
+              value = nil;
+            }
+            return value;
+          } catch { return value; }
+        }
+      end
+    end
+
+    def respond_to_missing? message, include_all
+      message = message.chop if message.end_with? '='
+      property_name = property_for_message(message)
+      return true unless `#{property_name} in #@native`
+      false
+    end
+
+    def property_for_message(message)
+      %x{
+        let camel_cased_message;
+        if (typeof(#@native[message]) !== 'undefined') { camel_cased_message = message; }
+        else { camel_cased_message = #{message.camelize(:lower)} }
+
+        if (camel_cased_message.endsWith('?')) {
+          camel_cased_message = camel_cased_message.substring(0, camel_cased_message.length - 2);
+          if (typeof(#@native[camel_cased_message]) === 'undefined') {
+            camel_cased_message = 'is' + camel_cased_message[0].toUpperCase() + camel_cased_message.substring(0, camel_cased_message.length - 1);
+          }
+        }
+        return camel_cased_message
+      }
+    end
+  end
+end

data/lib/browser/document.rb

@@ -0,0 +1,38 @@
+module Browser
+  module Document
+    extend DelegateNative
+    extend EventTarget
+
+    @native = `document`
+
+    module_function
+
+    # @return [Browser::Element] the head element of the current document
+    def head
+      @head ||= Element.new(`#@native.head`)
+    end
+
+    # @return [Browser::Element] the body element of the current document
+    def body
+      @body ||= Element.new(`#@native.body`)
+    end
+
+    # @return [Browser::Element?] the first element that matches the given CSS
+    #   selector or `nil` if no elements match
+    def [] css
+      native = `#@native.querySelector(css)`
+      if `#{native} === null`
+        nil
+      else
+        Element.new(native)
+      end
+    end
+  end
+
+  module_function
+
+  # @return [Document] the browser's document object
+  def document
+    Document
+  end
+end