ruflet_core 0.0.18 → 0.0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c28a07c8c32f3e0eca58c3d1400f06453275690b4e9f75d3a868a4507e78c74a
-  data.tar.gz: 71f044a3c2f0464571e4d16f779e1f751c42f4e16ea3aeeecb3036b596269022
+  metadata.gz: 412cca0911d7e0d196902336dff3da369a776e146713f511b4571fe3e693f99e
+  data.tar.gz: 9f07083cd60681b95aec47ec0a269c9c0ef42365ee23f8f627f2ea6795e82a66
 SHA512:
-  metadata.gz: 38de8d3745bbdf5b217e91de9a6dab2a194757964fa39f7a78bb89c83586fb4f0acee955ae7457221b12a15c4ab7fd18465e2a74af58627c8da25d6c75b62463
-  data.tar.gz: 476528dec0a5b55ca3e2a3622d4cf2691162434794a498d544a9da165efb249bca5e612f6ba8f49da52387223441ec34ebe64769f162a78916db0f27bee3dce9
+  metadata.gz: 77edfb41b260ca90eaa82cc02fd63d81f5c8212845eba2fec5289d31d8d45d1b6c6cf5b02ebf911fbce91bc070a3f591f60d4c9d6a2906f5c87f7456fed1d83c
+  data.tar.gz: 70606ebdd3a54ea6d10924b742a2821f5ce05b6ddf0ae0e8c0c23ed69d6042a40452aca569dd48d43b36fa7f85c99c96f674f22ad2722dc075bbdb5fa55f4d5f

data/README.md

@@ -1,3 +1,31 @@
-# ruflet
+# ruflet_core
 
-Part of Ruflet monorepo.
+`ruflet_core` provides Ruflet's Ruby UI API: controls, control builders, page
+operations, events, services, and application lifecycle behavior.
+
+Applications normally receive this package through a generated Ruflet project
+or through `ruflet_rails`; it is not a standalone application server.
+
+```ruby
+require "ruflet"
+
+Ruflet.run do |page|
+  page.title = "Hello"
+  page.add(
+    container(
+      bgcolor: :surface_container_high,
+      padding: 24,
+      content: text("Hello Ruflet", color: "DeepOrange500")
+    )
+  )
+end
+```
+
+Color properties accept named colors and hex values. Use Ruby-style symbols
+like `:deep_orange_500`, compact strings like `"DeepOrange500"`, spaced names
+like `"Deep Orange 500"`, semantic theme names like `:primary_container`, or
+hex strings like `"#ff6d00"`. Ruflet normalizes named colors before sending
+them to the client.
+
+Use `ruflet_server` to run a standalone server-driven application. Use
+`ruflet_rails` when the UI is hosted by Rails.

data/lib/ruflet/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ruflet
-  VERSION = "0.0.18" unless const_defined?(:VERSION)
+  VERSION = "0.0.19" unless const_defined?(:VERSION)
 end

data/lib/ruflet_ui/ruflet/page.rb

@@ -590,11 +590,13 @@ module Ruflet
     def dialog=(value)
       @dialog = value
       refresh_dialogs_container!
+      push_dialogs_update! if @dialogs_container_mounted
     end
 
     def snack_bar=(value)
       @snack_bar = value
       refresh_dialogs_container!
+      push_dialogs_update! if @dialogs_container_mounted
     end
 
     def snack_bar
@@ -608,6 +610,7 @@ module Ruflet
     def bottom_sheet=(value)
       @bottom_sheet = value
       refresh_dialogs_container!
+      push_dialogs_update! if @dialogs_container_mounted
     end
 
     def bottom_sheet
@@ -656,6 +659,9 @@ module Ruflet
       return nil unless target
 
       target.props["open"] = false
+      @dialog = nil if @dialog.equal?(target)
+      @snack_bar = nil if @snack_bar.equal?(target)
+      @bottom_sheet = nil if @bottom_sheet.equal?(target)
       refresh_dialogs_container!
       push_dialogs_update!
       target
@@ -1192,6 +1198,8 @@ module Ruflet
         patch["content"] = patch.delete("text")
       end
 
+      patch.each { |key, value| control.props[key] = value }
+
       # Keep runtime control tree aligned with incremental patches.
       if patch.key?("controls")
         control.children.clear

data/lib/ruflet_ui/ruflet/ui/control_factory.rb

@@ -15,8 +15,8 @@ module Ruflet
           .freeze
       CONSTRUCTOR_KEYWORDS_CACHE = {}
 
-      PYTHON_COMMON_ATTRIBUTES = %i[flip ref transform].freeze
-      PYTHON_ATTRIBUTE_OVERRIDES = {
+      COMMON_ATTRIBUTES = %i[flip ref transform].freeze
+      ATTRIBUTE_OVERRIDES = {
         "expansionpanellist" => %i[auto_scroll on_scroll scroll scroll_interval],
         "fletapp" => %i[assets_dir on_python_output],
         "image" => %i[
@@ -64,7 +64,7 @@ module Ruflet
 
       def normalize_constructor_props(klass, type, props)
         keywords = constructor_keywords(klass)
-        return [props, {}] if keywords.empty? && PYTHON_ATTRIBUTE_OVERRIDES[type].nil?
+        return [props, {}] if keywords.empty? && ATTRIBUTE_OVERRIDES[type].nil?
 
         allowed = keywords.map(&:to_s)
         mapped = props.each_with_object({}) { |(k, v), out| out[k.to_sym] = v }
@@ -74,7 +74,7 @@ module Ruflet
         if mapped.key?(:value) && !allowed.include?("value") && allowed.include?("text") && !mapped.key?(:text)
           mapped[:text] = mapped.delete(:value)
         end
-        supplemental_names = PYTHON_COMMON_ATTRIBUTES + PYTHON_ATTRIBUTE_OVERRIDES.fetch(type, [])
+        supplemental_names = COMMON_ATTRIBUTES + ATTRIBUTE_OVERRIDES.fetch(type, [])
         supplemental = mapped.slice(*supplemental_names)
         [mapped.reject { |key, _| supplemental_names.include?(key) }, supplemental]
       end

data/lib/ruflet_ui/ruflet/ui/controls/materials/webview_control.rb

@@ -4,11 +4,32 @@ module Ruflet
   module UI
     module Controls
       module RufletComponents
+        # WebView control — parity with Flet's WebView
+        # (https://flet.dev/docs/controls/webview/).
+        #
+        # Properties: url, bgcolor, prevent_links, plus the usual layout props.
+        # Events: on_page_started, on_page_ended, on_web_resource_error,
+        #   on_progress, on_url_change, on_scroll, on_console_message,
+        #   on_javascript_alert_dialog.
+        # Methods (invoked over the wire on a mounted control): reload, go_back,
+        #   go_forward, can_go_back, can_go_forward, run_javascript, load_html,
+        #   load_request, load_file, scroll_to, scroll_by, clear_cache,
+        #   clear_local_storage, enable_zoom, disable_zoom, set_javascript_mode,
+        #   get_current_url, get_title, get_user_agent.
+        #
+        # Platform note: the native webview runs on iOS, Android, macOS, Windows,
+        # and Linux. Linux distributions must provide WebKitGTK 4.1. On web it
+        # uses an iframe, so browser cross-origin restrictions still apply.
         class WebViewControl < Ruflet::Control
           TYPE = "WebView".freeze
           WIRE = "WebView".freeze
 
-          def initialize(id: nil, bgcolor: nil, data: nil, enable_javascript: nil, expand: nil, height: nil, key: nil, method: nil, opacity: nil, rtl: nil, tooltip: nil, url: nil, visible: nil, width: nil, on_page_ended: nil, on_page_started: nil, on_web_resource_error: nil)
+          def initialize(id: nil, bgcolor: nil, data: nil, enable_javascript: nil, expand: nil,
+                         height: nil, key: nil, method: nil, opacity: nil, prevent_links: nil,
+                         rtl: nil, tooltip: nil, url: nil, visible: nil, width: nil,
+                         on_page_ended: nil, on_page_started: nil, on_web_resource_error: nil,
+                         on_progress: nil, on_url_change: nil, on_scroll: nil,
+                         on_console_message: nil, on_javascript_alert_dialog: nil)
             props = {}
             props[:bgcolor] = bgcolor unless bgcolor.nil?
             props[:data] = data unless data.nil?
@@ -18,6 +39,7 @@ module Ruflet
             props[:key] = key unless key.nil?
             props[:method] = method unless method.nil?
             props[:opacity] = opacity unless opacity.nil?
+            props[:prevent_links] = prevent_links unless prevent_links.nil?
             props[:rtl] = rtl unless rtl.nil?
             props[:tooltip] = tooltip unless tooltip.nil?
             props[:url] = url unless url.nil?
@@ -26,8 +48,98 @@ module Ruflet
             props[:on_page_ended] = on_page_ended unless on_page_ended.nil?
             props[:on_page_started] = on_page_started unless on_page_started.nil?
             props[:on_web_resource_error] = on_web_resource_error unless on_web_resource_error.nil?
+            props[:on_progress] = on_progress unless on_progress.nil?
+            props[:on_url_change] = on_url_change unless on_url_change.nil?
+            props[:on_scroll] = on_scroll unless on_scroll.nil?
+            props[:on_console_message] = on_console_message unless on_console_message.nil?
+            props[:on_javascript_alert_dialog] = on_javascript_alert_dialog unless on_javascript_alert_dialog.nil?
             super(type: TYPE, id: id, **props)
           end
+
+          # --- Navigation --------------------------------------------------
+
+          def reload = invoke_webview_method("reload")
+          def go_back = invoke_webview_method("go_back")
+          def go_forward = invoke_webview_method("go_forward")
+
+          def can_go_back(timeout: 10, &on_result)
+            invoke_webview_method("can_go_back", timeout: timeout, on_result: on_result)
+          end
+
+          def can_go_forward(timeout: 10, &on_result)
+            invoke_webview_method("can_go_forward", timeout: timeout, on_result: on_result)
+          end
+
+          # --- Loading content ---------------------------------------------
+
+          def load_request(url, method: "get")
+            invoke_webview_method("load_request", { "url" => url.to_s, "method" => method.to_s })
+          end
+
+          def load_html(value, base_url: nil)
+            args = { "value" => value.to_s }
+            args["base_url"] = base_url.to_s unless base_url.nil?
+            invoke_webview_method("load_html", args)
+          end
+
+          def load_file(path)
+            invoke_webview_method("load_file", { "path" => path.to_s })
+          end
+
+          # --- JavaScript injection ---------------------------------------
+
+          # Run arbitrary JS inside the page — e.g. hide a node so a native
+          # control can take its place:
+          #   webview.run_javascript("document.getElementById('banner').remove()")
+          def run_javascript(value)
+            invoke_webview_method("run_javascript", { "value" => value.to_s })
+          end
+
+          def set_javascript_mode(mode)
+            invoke_webview_method("set_javascript_mode", { "mode" => mode.to_s })
+          end
+
+          # --- Scrolling ---------------------------------------------------
+
+          def scroll_to(x, y)
+            invoke_webview_method("scroll_to", { "x" => x.to_i, "y" => y.to_i })
+          end
+
+          def scroll_by(x, y)
+            invoke_webview_method("scroll_by", { "x" => x.to_i, "y" => y.to_i })
+          end
+
+          # --- Storage / zoom ----------------------------------------------
+
+          def clear_cache = invoke_webview_method("clear_cache")
+          def clear_local_storage = invoke_webview_method("clear_local_storage")
+          def enable_zoom = invoke_webview_method("enable_zoom")
+          def disable_zoom = invoke_webview_method("disable_zoom")
+
+          # --- Introspection (result delivered to the block) ---------------
+
+          def get_current_url(timeout: 10, &on_result)
+            invoke_webview_method("get_current_url", timeout: timeout, on_result: on_result)
+          end
+
+          def get_title(timeout: 10, &on_result)
+            invoke_webview_method("get_title", timeout: timeout, on_result: on_result)
+          end
+
+          def get_user_agent(timeout: 10, &on_result)
+            invoke_webview_method("get_user_agent", timeout: timeout, on_result: on_result)
+          end
+
+          private
+
+          def invoke_webview_method(name, args = nil, timeout: 10, on_result: nil)
+            page = runtime_page
+            unless page && wire_id
+              raise "WebView ##{id} is not mounted yet — add it to the page before calling #{name}."
+            end
+
+            page.invoke(self, name, args: args, timeout: timeout, on_result: on_result)
+          end
         end
       end
     end

data/lib/ruflet_ui/ruflet/ui/material_control_methods.rb

@@ -21,7 +21,7 @@ module Ruflet
 
       def view(children = nil, **props, &block)
         mapped = props.dup
-        mapped[:children] = children unless children.nil?
+        mapped[:controls] = children unless children.nil?
         build_widget(:view, **mapped, &block)
       end
       def column(children = nil, **props, &block)

data/lib/ruflet_ui/ruflet/ui/shared_control_forwarders.rb

@@ -6,7 +6,11 @@ module Ruflet
       def control(type, **props, &block) = control_delegate.control(type, **props, &block)
       def widget(type, **props, &block) = control_delegate.widget(type, **props, &block)
       def service(type, **props, &block) = control_delegate.service(type, **props, &block)
-      def view(children = nil, **props, &block) = control_delegate.view(children, **props, &block)
+      def view(children = nil, **props, &block)
+        mapped = props.dup
+        mapped[:controls] = children unless children.nil?
+        control_delegate.control(:view, **mapped, &block)
+      end
       def column(children = nil, **props, &block) = control_delegate.column(children, **props, &block)
       def center(**props, &block) = control_delegate.center(**props, &block)
       def row(children = nil, **props, &block) = control_delegate.row(children, **props, &block)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruflet_core
 version: !ruby/object:Gem::Version
-  version: 0.0.18
+  version: 0.0.19
 platform: ruby
 authors:
 - AdamMusa