ruflet_core 0.0.15 → 0.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1823b100c3e97ee941849763509b25179554464310eb640d7954bb48a30d821
-  data.tar.gz: 80d3f6891f3418bf0b2b3aa2007e08e6578ca336b72bb48b9d84c54cac2397b5
+  metadata.gz: 82d5d751f2b92b2b740414e315e1b1f9e88389eb0423ec0ce7a040710e191d59
+  data.tar.gz: 728109060a0cff6ca564e2bfa5d7620e5f8182dc05cf82b571ae3280e7e0a015
 SHA512:
-  metadata.gz: e37e04ea218fbc50da5d3a456ecdfe376f12d00fc802c0869da7dff977bafb6d0abab8eecff92e223b42002f94652e40f7d91d2eb7a62f04fbec72bf1c7dd600
-  data.tar.gz: 42458a85edccff3f66fd88cdc71724a7a94dbf1853fbf080d0751da7b57e783694e0ba65091c908bb4b1f203d6a8e8725e9e594df762f7deb1996e29e1bc88ed
+  metadata.gz: bf40cdafd48b625d189f9625945350873b4936c0668916ce8556e9d07f47368584892b29e57e4fe2e4583230d7ce5c87297848b90c5d01ab1d7ddac0b60df4d2
+  data.tar.gz: 2d229699ad359fcbc5dc5640dd176227bd0dad3f01d641b9f44ea569b26ccea61926b16c465284bda7e2fb786b514215922b8fdda5aa0a6b5f6baca36c0303fe

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.15" unless const_defined?(:VERSION)
+  VERSION = "0.0.17" unless const_defined?(:VERSION)
 end

data/lib/ruflet_core.rb

@@ -10,7 +10,8 @@ module Ruflet
 
   module_function
 
-  def run(entrypoint = nil, host: "0.0.0.0", port: 8550, &block)
+  def run(entrypoint = nil, host: "0.0.0.0", port: nil, &block)
+    port = normalize_run_port(port || ENV["RUFLET_PORT"] || 8550)
     callback = entrypoint || block
     raise ArgumentError, "Ruflet.run requires a callable entrypoint or block" unless callback.respond_to?(:call)
 
@@ -37,4 +38,10 @@ module Ruflet
   ensure
     @run_interceptors_mutex.synchronize { @run_interceptors.delete(interceptor) }
   end
+
+  def normalize_run_port(value)
+    Integer(value)
+  rescue ArgumentError, TypeError
+    8550
+  end
 end

data/lib/ruflet_ui/ruflet/colors.rb

@@ -151,11 +151,57 @@ module Ruflet
     end
 
     def self.normalize_color(color)
-      return color.to_s if color.is_a?(Symbol)
-      return color if color.is_a?(String)
-      return color.to_s unless color.respond_to?(:to_s)
+      return canonicalize(color.to_s) if color.is_a?(Symbol)
+      return canonicalize(color) if color.is_a?(String)
+      return canonicalize(color.to_s) unless color.respond_to?(:to_s)
 
-      color.to_s
+      canonicalize(color.to_s)
+    end
+
+    def self.normalize_property(key, value)
+      normalize_value(value, color_key?(key))
+    end
+
+    def self.color_key?(key)
+      name = key.to_s
+      name == "color" ||
+        name == "colors" ||
+        name.end_with?("bgcolor") ||
+        name.end_with?("_color") ||
+        name.end_with?("_colors") ||
+        name == "color_scheme_seed"
+    end
+
+    def self.normalize_value(value, color_context = false)
+      case value
+      when String
+        color_context ? canonicalize(value) : value
+      when Symbol
+        color_context ? canonicalize(value.to_s) : value
+      when Array
+        value.map { |nested| normalize_value(nested, color_context) }
+      when Hash
+        value.each_with_object({}) do |(nested_key, nested_value), result|
+          result[nested_key] = normalize_value(nested_value, color_context || color_key?(nested_key))
+        end
+      else
+        value
+      end
+    end
+
+    # Canonicalizes a named color into flet's wire format. Flet color names are
+    # lowercase with no separators ("bluegrey", "deeporange", "red500"), so we
+    # strip underscores, hyphens, and whitespace before downcasing. Hex values
+    # (#... / 0x...) are downcased without separator stripping; the optional
+    # ",opacity" suffix is preserved untouched.
+    def self.canonicalize(value)
+      return value unless value.is_a?(String)
+
+      color, separator, opacity = value.partition(",")
+      color = color.strip.downcase
+      color = color.gsub(/[_\-\s]+/, "") unless color.start_with?("#") || color.start_with?("0x")
+
+      "#{color}#{separator}#{opacity}"
     end
 
     BASE_PREFIX = {

data/lib/ruflet_ui/ruflet/control.rb

@@ -5,6 +5,7 @@ require "securerandom"
 rescue LoadError
   nil
 end
+require_relative "colors"
 require_relative "icon_data"
 require_relative "icons/material_icon_lookup"
 require_relative "icons/cupertino_icon_lookup"
@@ -197,14 +198,11 @@ module Ruflet
     end
 
     def normalize_color_prop(key, value)
-      return value unless value.is_a?(String)
-      return value.downcase if color_prop_key?(key)
-
-      value
+      Ruflet::Colors.normalize_property(key, value)
     end
 
     def color_prop_key?(key)
-      key == "color" || key.end_with?("bgcolor") || key.end_with?("_color")
+      Ruflet::Colors.color_key?(key)
     end
 
     def normalize_icon_prop(key, value)

data/lib/ruflet_ui/ruflet/dsl.rb

@@ -68,6 +68,15 @@ module Ruflet
     def autocompletesuggestion(key = nil, **props) = _pending_app.autocompletesuggestion(key, **props)
     def context_menu(content = nil, **props) = _pending_app.context_menu(content, **props)
     def contextmenu(content = nil, **props) = _pending_app.contextmenu(content, **props)
+    def autofill_group(content = nil, **props) = _pending_app.autofill_group(content, **props)
+    def autofillgroup(content = nil, **props) = _pending_app.autofillgroup(content, **props)
+    def hero(content = nil, **props) = _pending_app.hero(content, **props)
+    def overlay(children = nil, **props) = _pending_app.overlay(children, **props)
+    def shader_mask(content = nil, **props) = _pending_app.shader_mask(content, **props)
+    def shadermask(content = nil, **props) = _pending_app.shadermask(content, **props)
+    def shimmer(content = nil, **props) = _pending_app.shimmer(content, **props)
+    def text_span(text = nil, **props) = _pending_app.text_span(text, **props)
+    def textspan(text = nil, **props) = _pending_app.textspan(text, **props)
     def keyboard_listener(content = nil, **props) = _pending_app.keyboard_listener(content, **props)
     def keyboardlistener(content = nil, **props) = _pending_app.keyboardlistener(content, **props)
     def gesture_detector(**props, &block) = _pending_app.gesture_detector(**props, &block)
@@ -302,6 +311,10 @@ module Ruflet
     def web_view(**props) = _pending_app.web_view(**props)
     def webview(**props) = _pending_app.webview(**props)
     def video(**props) = _pending_app.video(**props)
+    def spinkit(**variant) = _pending_app.spinkit(**variant)
+    def code_editor(value = nil, **props) = _pending_app.code_editor(value, **props)
+    def codeeditor(value = nil, **props) = _pending_app.codeeditor(value, **props)
+    def rive(src = nil, **props) = _pending_app.rive(src, **props)
     def fab(content = nil, **props) = _pending_app.fab(content, **props)
     def cupertino_button(content = nil, **props) = _pending_app.cupertino_button(content, **props)
     def cupertinobutton(content = nil, **props) = _pending_app.cupertinobutton(content, **props)

data/lib/ruflet_ui/ruflet/page.rb

@@ -183,6 +183,7 @@ module Ruflet
         id: "_dialogs",
         controls: []
       )
+      @mounted_services = []
       @invoke_waiters = {}
       @invoke_callbacks = {}
       @invoke_waiters_mutex = Mutex.new
@@ -244,6 +245,42 @@ module Ruflet
       @view_props["bgcolor"] = normalize_value("bgcolor", value)
     end
 
+    # Client-reported page properties. The Flutter client sends these in its
+    # register payload (see Protocol.normalize_register_payload), where they are
+    # stored in @client_details; expose them as readers so apps can do
+    # `page.width`, `page.platform`, etc. without reaching into client_details.
+    def width
+      client_reported_prop("width")
+    end
+
+    def height
+      client_reported_prop("height")
+    end
+
+    def platform
+      client_reported_prop("platform")
+    end
+
+    def platform_brightness
+      client_reported_prop("platform_brightness")
+    end
+
+    def web
+      client_reported_prop("web")
+    end
+
+    def pwa
+      client_reported_prop("pwa")
+    end
+
+    def wasm
+      client_reported_prop("wasm")
+    end
+
+    def media
+      client_reported_prop("media")
+    end
+
     def add(*controls, appbar: nil, bottom_appbar: nil, floating_action_button: nil, navigation_bar: nil, dialog: nil, snack_bar: nil, bottom_sheet: nil)
       controls = controls.flatten
       visited = Set.new
@@ -412,6 +449,10 @@ module Ruflet
       @page_event_handlers["view_pop"] = handler
     end
 
+    def on_resize=(handler)
+      @page_event_handlers["resize"] = handler
+    end
+
     def on(event_name, &block)
       @page_event_handlers[event_name.to_s.sub(/\Aon_/, "")] = block
       self
@@ -500,6 +541,12 @@ module Ruflet
     def bottom_sheet=(value)
       @bottom_sheet = value
       refresh_dialogs_container!
+      # Mirror dialog= / snack_bar=: once the dialogs container is mounted, push
+      # the change as an in-place patch. Without this, opening a bottom sheet
+      # after the container is already mounted (e.g. a prior dialog/snackbar)
+      # never reaches the client, since send_view_patch skips _dialogs once
+      # mounted. This is what made NativeApp's modal: sheets fail to open.
+      push_dialogs_update! if @dialogs_container_mounted
     end
 
     def bottomsheet=(value)
@@ -1239,6 +1286,12 @@ module Ruflet
           # view — the picker that "reappears after going home".
           dismiss_tracked_dialogs! if route_from_event && route_from_event != @page_props["route"]
           @page_props["route"] = route_from_event if route_from_event
+        elsif name.to_s == "resize"
+          # The client reports the live page size via the "resize" event. Store
+          # it so `page.width`/`page.height` reflect the real viewport — without
+          # this, responsive layouts collapse on clients (e.g. embedded/iOS)
+          # that don't know their size at the initial handshake.
+          store_reported_page_size(data)
         end
         dispatch_page_event(name: name, data: data)
         return
@@ -1301,6 +1354,12 @@ module Ruflet
 
     private
 
+    def client_reported_prop(name)
+      return @page_props[name] if @page_props.key?(name)
+
+      @client_details[name]
+    end
+
     def embedded_async_timeout_available?
       !Object.const_defined?(:RUFLET_EMBEDDED_FAKE_THREAD)
     end
@@ -1515,6 +1574,7 @@ module Ruflet
         raise ArgumentError, "page #{key} must use an icon name string, not #{value.inspect}"
       end
 
+      value = Ruflet::Colors.normalize_property(key, value)
       return value.value if value.is_a?(Ruflet::IconData)
       value.is_a?(Symbol) ? value.to_s : value
     end
@@ -1540,8 +1600,14 @@ module Ruflet
       query_string = route_value.to_s.split("?", 2)[1].to_s
       return {} if query_string.empty?
 
-      CGI.parse(query_string).each_with_object({}) do |(key, values), result|
-        result[key] = values.size == 1 ? values.first : values
+      query_string.split("&").each_with_object({}) do |pair, result|
+        next if pair.empty?
+
+        key, value = pair.split("=", 2)
+        key = CGI.unescape(key.to_s.tr("+", " "))
+        value = CGI.unescape(value.to_s.tr("+", " "))
+        previous = result[key]
+        result[key] = previous.nil? ? value : Array(previous) << value
       end
     end
 
@@ -1556,6 +1622,15 @@ module Ruflet
       end
     end
 
+    def store_reported_page_size(data)
+      return unless data.is_a?(Hash)
+
+      width = data["width"] || data[:width]
+      height = data["height"] || data[:height]
+      @page_props["width"] = width unless width.nil?
+      @page_props["height"] = height unless height.nil?
+    end
+
     def dispatch_page_event(name:, data:)
       handler = @page_event_handlers[name.to_s.sub(/\Aon_/, "")]
       return unless handler.respond_to?(:call)
@@ -1640,14 +1715,61 @@ module Ruflet
     def push_services_update!
       refresh_control_indexes!
 
-      if @services_container.wire_id
+      unless @services_container.wire_id
+        # First mount: the whole list ships inside the page/view patch.
+        send_view_patch
+        @mounted_services = Array(@services_container.props["_services"]).dup
+        return
+      end
+
+      current = Array(@services_container.props["_services"])
+      ops = services_patch_ops(@mounted_services, current)
+      unless ops.empty?
+        # Incrementally add/remove individual services. Re-sending the whole
+        # `_services` list as full objects (a single replace op) makes the
+        # client run Control.fromMap for EVERY service, replacing each Control
+        # instance while ServiceRegistry only binds ids it hasn't seen — so an
+        # already-mounted service (share, clipboard, haptic) keeps its old
+        # binding while controlsIndex points at the fresh, listener-less
+        # instance, and its next invoke hangs. That was the "after Copy, Share
+        # stops working" bug. Add/remove ops leave untouched services intact.
         send_message(Protocol::ACTIONS[:patch_control], {
           "id" => @services_container.wire_id,
-          "patch" => [[0], [0, 0, "_services", serialize_patch_value(@services_container.props["_services"])]]
+          "patch" => [[0, { "_services" => [1] }], *ops]
         })
-      else
-        send_view_patch
       end
+      @mounted_services = current.dup
+    end
+
+    # Diff the previously-mounted services list against the current one and emit
+    # add (1) / remove (2) ops against the `_services` list (patch node 1).
+    # Services are normally append-only; a moved entry is expressed as
+    # remove + add. Existing entries are never re-serialized, so their client
+    # Control instances (and invoke listeners) survive.
+    def services_patch_ops(previous, current)
+      ops = []
+      working = previous.dup
+
+      (working.length - 1).downto(0) do |index|
+        next if current.any? { |service| service.equal?(working[index]) }
+
+        ops << [2, 1, index]
+        working.delete_at(index)
+      end
+
+      current.each_with_index do |service, index|
+        next if working[index]&.equal?(service)
+
+        existing = working.index { |candidate| candidate.equal?(service) }
+        if existing
+          ops << [2, 1, existing]
+          working.delete_at(existing)
+        end
+        ops << [1, 1, index, serialize_patch_value(service)]
+        working.insert(index, service)
+      end
+
+      ops
     end
 
     def push_dialogs_update!
@@ -1780,6 +1902,7 @@ module Ruflet
       existing = service_by_type(type)
       return [existing, false] if existing
 
+      # `service` already syncs via add_service -> push_services_update!.
       [service(type), true]
     end
 

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

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Ruflet
+  module UI
+    module Controls
+      module RufletComponents
+        # CodeEditor control — parity with Flet's CodeEditor extension
+        # (https://flet.dev/docs/controls/codeeditor/).
+        #
+        # Properties: value, language, code_theme, text_style, padding, selection,
+        #   gutter_style, autocomplete, autocomplete_words, issues, read_only,
+        #   autofocus, plus the usual layout props.
+        # Events: on_change, on_selection_change, on_focus, on_blur.
+        # Methods (invoked over the wire on a mounted control): focus, fold_at,
+        #   fold_comment_at_line_zero, fold_imports.
+        #
+        # `language` accepts a highlight.js identifier (e.g. "python", "ruby",
+        # "javascript"); `code_theme` accepts a highlight.js theme name shared
+        # with Markdown (e.g. "atom-one-light", "atom-one-dark", "monokai-sublime").
+        class CodeEditorControl < Ruflet::Control
+          TYPE = "CodeEditor".freeze
+          WIRE = "CodeEditor".freeze
+
+          def initialize(id: nil, adaptive: nil, autocomplete: nil, autocomplete_words: nil,
+                         autofocus: nil, badge: nil, code_theme: nil, col: nil, data: nil,
+                         disabled: nil, expand: nil, expand_loose: nil, gutter_style: nil,
+                         height: nil, issues: nil, key: nil, language: nil, opacity: nil,
+                         padding: nil, read_only: nil, rtl: nil, selection: nil,
+                         text_style: nil, tooltip: nil, value: nil, visible: nil, width: nil,
+                         on_blur: nil, on_change: nil, on_focus: nil, on_selection_change: nil)
+            props = {}
+            props[:adaptive] = adaptive unless adaptive.nil?
+            props[:autocomplete] = autocomplete unless autocomplete.nil?
+            props[:autocomplete_words] = autocomplete_words unless autocomplete_words.nil?
+            props[:autofocus] = autofocus unless autofocus.nil?
+            props[:badge] = badge unless badge.nil?
+            props[:code_theme] = code_theme unless code_theme.nil?
+            props[:col] = col unless col.nil?
+            props[:data] = data unless data.nil?
+            props[:disabled] = disabled unless disabled.nil?
+            props[:expand] = expand unless expand.nil?
+            props[:expand_loose] = expand_loose unless expand_loose.nil?
+            props[:gutter_style] = gutter_style unless gutter_style.nil?
+            props[:height] = height unless height.nil?
+            props[:issues] = issues unless issues.nil?
+            props[:key] = key unless key.nil?
+            props[:language] = language unless language.nil?
+            props[:opacity] = opacity unless opacity.nil?
+            props[:padding] = padding unless padding.nil?
+            props[:read_only] = read_only unless read_only.nil?
+            props[:rtl] = rtl unless rtl.nil?
+            props[:selection] = selection unless selection.nil?
+            props[:text_style] = text_style unless text_style.nil?
+            props[:tooltip] = tooltip unless tooltip.nil?
+            props[:value] = value unless value.nil?
+            props[:visible] = visible unless visible.nil?
+            props[:width] = width unless width.nil?
+            props[:on_blur] = on_blur unless on_blur.nil?
+            props[:on_change] = on_change unless on_change.nil?
+            props[:on_focus] = on_focus unless on_focus.nil?
+            props[:on_selection_change] = on_selection_change unless on_selection_change.nil?
+            super(type: TYPE, id: id, **props)
+          end
+
+          # Request focus for the editor.
+          def focus = invoke_editor_method("focus")
+
+          # Fold the code block that starts at the given line number.
+          def fold_at(line_number)
+            invoke_editor_method("fold_at", { "line_number" => line_number.to_i })
+          end
+
+          # Fold the comment block at line 0 (e.g. a license header).
+          def fold_comment_at_line_zero = invoke_editor_method("fold_comment_at_line_zero")
+
+          # Fold all import sections.
+          def fold_imports = invoke_editor_method("fold_imports")
+
+          private
+
+          def invoke_editor_method(name, args = nil, timeout: 10, on_result: nil)
+            page = runtime_page
+            unless page && wire_id
+              raise "CodeEditor ##{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
+  end
+end

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

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Ruflet
+  module UI
+    module Controls
+      module RufletComponents
+        # Rive control — parity with Flet's Rive extension
+        # (https://flet.dev/docs/controls/rive/). Renders a Rive
+        # (https://rive.app) animation from a `.riv` file.
+        #
+        # Properties: src, placeholder, artboard, alignment, enable_antialiasing,
+        #   use_artboard_size, fit, speed_multiplier, animations, state_machines,
+        #   headers, clip_rect, plus the usual layout props.
+        # No events or methods — playback is driven by `animations` /
+        #   `state_machines` and `speed_multiplier`.
+        #
+        # `src` is required and may be a network URL (e.g.
+        # "https://cdn.rive.app/animations/vehicles.riv") or a bundled asset path.
+        #
+        # Note: the Flet API names the artboard property `artboard`, but the
+        # underlying renderer reads `art_board` / `use_art_board_size` on the wire.
+        # Both spellings are accepted here and normalized to the wire keys.
+        class RiveControl < Ruflet::Control
+          TYPE = "Rive".freeze
+          WIRE = "Rive".freeze
+
+          def initialize(id: nil, adaptive: nil, alignment: nil, animate_offset: nil,
+                         animate_opacity: nil, animate_position: nil, animate_rotation: nil,
+                         animate_scale: nil, animations: nil, art_board: nil, artboard: nil,
+                         aspect_ratio: nil, badge: nil, bottom: nil, clip_rect: nil, col: nil,
+                         data: nil, disabled: nil, enable_antialiasing: nil, expand: nil,
+                         expand_loose: nil, fit: nil, headers: nil, height: nil, key: nil,
+                         left: nil, offset: nil, opacity: nil, placeholder: nil, right: nil,
+                         rotate: nil, rtl: nil, scale: nil, speed_multiplier: nil, src: nil,
+                         state_machines: nil, tooltip: nil, top: nil, use_art_board_size: nil,
+                         use_artboard_size: nil, visible: nil, width: nil)
+            # Accept both the Flet-style names and the wire keys.
+            art_board = artboard if art_board.nil?
+            use_art_board_size = use_artboard_size if use_art_board_size.nil?
+
+            props = {}
+            props[:adaptive] = adaptive unless adaptive.nil?
+            props[:alignment] = alignment unless alignment.nil?
+            props[:animate_offset] = animate_offset unless animate_offset.nil?
+            props[:animate_opacity] = animate_opacity unless animate_opacity.nil?
+            props[:animate_position] = animate_position unless animate_position.nil?
+            props[:animate_rotation] = animate_rotation unless animate_rotation.nil?
+            props[:animate_scale] = animate_scale unless animate_scale.nil?
+            props[:animations] = animations unless animations.nil?
+            props[:art_board] = art_board unless art_board.nil?
+            props[:aspect_ratio] = aspect_ratio unless aspect_ratio.nil?
+            props[:badge] = badge unless badge.nil?
+            props[:bottom] = bottom unless bottom.nil?
+            props[:clip_rect] = clip_rect unless clip_rect.nil?
+            props[:col] = col unless col.nil?
+            props[:data] = data unless data.nil?
+            props[:disabled] = disabled unless disabled.nil?
+            props[:enable_antialiasing] = enable_antialiasing unless enable_antialiasing.nil?
+            props[:expand] = expand unless expand.nil?
+            props[:expand_loose] = expand_loose unless expand_loose.nil?
+            props[:fit] = fit unless fit.nil?
+            props[:headers] = headers unless headers.nil?
+            props[:height] = height unless height.nil?
+            props[:key] = key unless key.nil?
+            props[:left] = left unless left.nil?
+            props[:offset] = offset unless offset.nil?
+            props[:opacity] = opacity unless opacity.nil?
+            props[:placeholder] = placeholder unless placeholder.nil?
+            props[:right] = right unless right.nil?
+            props[:rotate] = rotate unless rotate.nil?
+            props[:rtl] = rtl unless rtl.nil?
+            props[:scale] = scale unless scale.nil?
+            props[:speed_multiplier] = speed_multiplier unless speed_multiplier.nil?
+            props[:src] = src unless src.nil?
+            props[:state_machines] = state_machines unless state_machines.nil?
+            props[:tooltip] = tooltip unless tooltip.nil?
+            props[:top] = top unless top.nil?
+            props[:use_art_board_size] = use_art_board_size unless use_art_board_size.nil?
+            props[:visible] = visible unless visible.nil?
+            props[:width] = width unless width.nil?
+            super(type: TYPE, id: id, **props)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -15,6 +15,7 @@ require_relative "card_control"
 require_relative "checkbox_control"
 require_relative "chip_control"
 require_relative "circleavatar_control"
+require_relative "codeeditor_control"
 require_relative "container_control"
 require_relative "contextmenu_control"
 require_relative "datacell_control"
@@ -57,6 +58,7 @@ require_relative "radio_control"
 require_relative "radiogroup_control"
 require_relative "rangeslider_control"
 require_relative "reorderablelistview_control"
+require_relative "rive_control"
 require_relative "searchbar_control"
 require_relative "segment_control"
 require_relative "segmentedbutton_control"
@@ -120,6 +122,8 @@ module Ruflet
             "chip" => RufletComponents::ChipControl,
             "circle_avatar" => RufletComponents::CircleAvatarControl,
             "circleavatar" => RufletComponents::CircleAvatarControl,
+            "code_editor" => RufletComponents::CodeEditorControl,
+            "codeeditor" => RufletComponents::CodeEditorControl,
             "container" => RufletComponents::ContainerControl,
             "context_menu" => RufletComponents::ContextMenuControl,
             "contextmenu" => RufletComponents::ContextMenuControl,
@@ -235,6 +239,7 @@ module Ruflet
             "rangeslider" => RufletComponents::RangeSliderControl,
             "reorderable_list_view" => RufletComponents::ReorderableListViewControl,
             "reorderablelistview" => RufletComponents::ReorderableListViewControl,
+            "rive" => RufletComponents::RiveControl,
             "search_bar" => RufletComponents::SearchBarControl,
             "searchbar" => RufletComponents::SearchBarControl,
             "segment" => RufletComponents::SegmentControl,

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

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Ruflet
+  module UI
+    module Controls
+      module RufletComponents
+        # Base for every flet_spinkit variant (https://flet.dev/docs/controls/spinkit/).
+        # Each concrete spinner is a LayoutControl with its own wire name
+        # ("SpinKitRotatingCircle", "SpinKitWave", ...). The Dart widget reads
+        # color/size/duration for all of them plus the optional line_width /
+        # border_width / item_count / wave_type used by a few variants, so those
+        # are accepted on every spinner (the client ignores the ones a variant
+        # doesn't use, matching the upstream implementation).
+        class SpinKitControl < Ruflet::Control
+          def initialize(id: nil, align: nil, animate_align: nil, animate_offset: nil, animate_opacity: nil, animate_position: nil, animate_rotation: nil, animate_scale: nil, animate_size: nil, aspect_ratio: nil, badge: nil, border_width: nil, bottom: nil, col: nil, color: nil, data: nil, disabled: nil, duration: nil, expand: nil, expand_loose: nil, height: nil, item_count: nil, key: nil, left: nil, line_width: nil, offset: nil, opacity: nil, right: nil, rotate: nil, rtl: nil, scale: nil, size: nil, tooltip: nil, top: nil, visible: nil, wave_type: nil, width: nil, on_animation_end: nil)
+            raise ArgumentError, "spinkit size must be greater than or equal to 0" unless size.nil? || size >= 0
+
+            props = {}
+            props[:align] = align unless align.nil?
+            props[:animate_align] = animate_align unless animate_align.nil?
+            props[:animate_offset] = animate_offset unless animate_offset.nil?
+            props[:animate_opacity] = animate_opacity unless animate_opacity.nil?
+            props[:animate_position] = animate_position unless animate_position.nil?
+            props[:animate_rotation] = animate_rotation unless animate_rotation.nil?
+            props[:animate_scale] = animate_scale unless animate_scale.nil?
+            props[:animate_size] = animate_size unless animate_size.nil?
+            props[:aspect_ratio] = aspect_ratio unless aspect_ratio.nil?
+            props[:badge] = badge unless badge.nil?
+            props[:border_width] = border_width unless border_width.nil?
+            props[:bottom] = bottom unless bottom.nil?
+            props[:col] = col unless col.nil?
+            props[:color] = color unless color.nil?
+            props[:data] = data unless data.nil?
+            props[:disabled] = disabled unless disabled.nil?
+            props[:duration] = duration unless duration.nil?
+            props[:expand] = expand unless expand.nil?
+            props[:expand_loose] = expand_loose unless expand_loose.nil?
+            props[:height] = height unless height.nil?
+            props[:item_count] = item_count unless item_count.nil?
+            props[:key] = key unless key.nil?
+            props[:left] = left unless left.nil?
+            props[:line_width] = line_width unless line_width.nil?
+            props[:offset] = offset unless offset.nil?
+            props[:opacity] = opacity unless opacity.nil?
+            props[:right] = right unless right.nil?
+            props[:rotate] = rotate unless rotate.nil?
+            props[:rtl] = rtl unless rtl.nil?
+            props[:scale] = scale unless scale.nil?
+            props[:size] = size unless size.nil?
+            props[:tooltip] = tooltip unless tooltip.nil?
+            props[:top] = top unless top.nil?
+            props[:visible] = visible unless visible.nil?
+            props[:wave_type] = wave_type unless wave_type.nil?
+            props[:width] = width unless width.nil?
+            props[:on_animation_end] = on_animation_end unless on_animation_end.nil?
+            super(type: self.class::TYPE, id: id, **props)
+          end
+        end
+
+        # wire name ("_c") => ruflet type key. Mirrors flet_spinkit's 30 controls.
+        SPINKIT_WIRE_TO_TYPE = {
+          "SpinKitRotatingCircle" => "spinkit_rotating_circle",
+          "SpinKitRotatingPlain" => "spinkit_rotating_plain",
+          "SpinKitDoubleBounce" => "spinkit_double_bounce",
+          "SpinKitWave" => "spinkit_wave",
+          "SpinKitWanderingCubes" => "spinkit_wandering_cubes",
+          "SpinKitFadingFour" => "spinkit_fading_four",
+          "SpinKitFadingCube" => "spinkit_fading_cube",
+          "SpinKitPulse" => "spinkit_pulse",
+          "SpinKitChasingDots" => "spinkit_chasing_dots",
+          "SpinKitThreeBounce" => "spinkit_three_bounce",
+          "SpinKitCircle" => "spinkit_circle",
+          "SpinKitCubeGrid" => "spinkit_cube_grid",
+          "SpinKitFadingCircle" => "spinkit_fading_circle",
+          "SpinKitFoldingCube" => "spinkit_folding_cube",
+          "SpinKitPumpingHeart" => "spinkit_pumping_heart",
+          "SpinKitHourGlass" => "spinkit_hour_glass",
+          "SpinKitPouringHourGlass" => "spinkit_pouring_hour_glass",
+          "SpinKitPouringHourGlassRefined" => "spinkit_pouring_hour_glass_refined",
+          "SpinKitFadingGrid" => "spinkit_fading_grid",
+          "SpinKitRing" => "spinkit_ring",
+          "SpinKitRipple" => "spinkit_ripple",
+          "SpinKitDualRing" => "spinkit_dual_ring",
+          "SpinKitSpinningCircle" => "spinkit_spinning_circle",
+          "SpinKitSpinningLines" => "spinkit_spinning_lines",
+          "SpinKitSquareCircle" => "spinkit_square_circle",
+          "SpinKitThreeInOut" => "spinkit_three_in_out",
+          "SpinKitDancingSquare" => "spinkit_dancing_square",
+          "SpinKitPianoWave" => "spinkit_piano_wave",
+          "SpinKitPulsingGrid" => "spinkit_pulsing_grid",
+          "SpinKitWaveSpinner" => "spinkit_wave_spinner"
+        }.freeze
+
+        # type key => control class, e.g. "spinkit_wave" => SpinKitWaveControl.
+        SPINKIT_CONTROLS = {}
+
+        SPINKIT_WIRE_TO_TYPE.each do |wire, type_key|
+          klass = Class.new(SpinKitControl)
+          klass.const_set(:TYPE, type_key)
+          klass.const_set(:WIRE, wire)
+          const_set("#{wire}Control", klass)
+          SPINKIT_CONTROLS[type_key] = klass
+        end
+
+        SPINKIT_CONTROLS.freeze
+      end
+    end
+  end
+end

data/lib/ruflet_ui/ruflet/ui/controls/ruflet_controls.rb

@@ -39,6 +39,7 @@ require_relative "materials/card_control"
 require_relative "materials/checkbox_control"
 require_relative "materials/chip_control"
 require_relative "materials/circleavatar_control"
+require_relative "materials/codeeditor_control"
 require_relative "materials/container_control"
 require_relative "materials/contextmenu_control"
 require_relative "materials/datacell_control"
@@ -58,6 +59,7 @@ require_relative "materials/filledbutton_control"
 require_relative "materials/fillediconbutton_control"
 require_relative "materials/filledtonalbutton_control"
 require_relative "materials/filledtonaliconbutton_control"
+require_relative "materials/spinkit_controls"
 require_relative "materials/floatingactionbutton_control"
 require_relative "materials/iconbutton_control"
 require_relative "materials/listtile_control"
@@ -81,6 +83,7 @@ require_relative "materials/radio_control"
 require_relative "materials/radiogroup_control"
 require_relative "materials/rangeslider_control"
 require_relative "materials/reorderablelistview_control"
+require_relative "materials/rive_control"
 require_relative "materials/searchbar_control"
 require_relative "materials/segment_control"
 require_relative "materials/segmentedbutton_control"
@@ -206,6 +209,8 @@ module Ruflet
           "circle" => RufletComponents::CircleControl,
           "circle_avatar" => RufletComponents::CircleAvatarControl,
           "circleavatar" => RufletComponents::CircleAvatarControl,
+          "code_editor" => RufletComponents::CodeEditorControl,
+          "codeeditor" => RufletComponents::CodeEditorControl,
           "color" => RufletComponents::ColorControl,
           "column" => RufletComponents::ColumnControl,
           "container" => RufletComponents::ContainerControl,
@@ -408,6 +413,7 @@ module Ruflet
           "reorderable_list_view" => RufletComponents::ReorderableListViewControl,
           "reorderabledraghandle" => RufletComponents::ReorderableDragHandleControl,
           "reorderablelistview" => RufletComponents::ReorderableListViewControl,
+          "rive" => RufletComponents::RiveControl,
           "responsive_row" => RufletComponents::ResponsiveRowControl,
           "responsiverow" => RufletComponents::ResponsiveRowControl,
           "row" => RufletComponents::RowControl,
@@ -464,7 +470,7 @@ module Ruflet
           "window" => RufletComponents::WindowControl,
           "window_drag_area" => RufletComponents::WindowDragAreaControl,
           "windowdragarea" => RufletComponents::WindowDragAreaControl,
-        }.freeze
+        }.merge(RufletComponents::SPINKIT_CONTROLS).freeze
       end
     end
   end

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

@@ -81,6 +81,39 @@ module Ruflet
         build_widget(:contextmenu, **mapped)
       end
       def contextmenu(content = nil, **props) = context_menu(content, **props)
+      def autofill_group(content = nil, **props)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:autofillgroup, **mapped)
+      end
+      def autofillgroup(content = nil, **props) = autofill_group(content, **props)
+      def hero(content = nil, **props)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:hero, **mapped)
+      end
+      def overlay(children = nil, **props)
+        mapped = props.dup
+        mapped[:controls] = children unless children.nil?
+        build_widget(:overlay, **mapped)
+      end
+      def shader_mask(content = nil, **props)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:shadermask, **mapped)
+      end
+      def shadermask(content = nil, **props) = shader_mask(content, **props)
+      def shimmer(content = nil, **props)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:shimmer, **mapped)
+      end
+      def text_span(text = nil, **props)
+        mapped = props.dup
+        mapped[:text] = text unless text.nil?
+        build_widget(:textspan, **mapped)
+      end
+      def textspan(text = nil, **props) = text_span(text, **props)
       def keyboard_listener(content = nil, **props)
         mapped = props.dup
         mapped[:content] = content unless content.nil?
@@ -606,6 +639,31 @@ module Ruflet
       def webview(**props) = web_view(**props)
       def video(**props) = build_widget(:video, **props)
 
+      # spinkit(wave: { color: "red", size: 50 }) — one variant keyword whose
+      # value is the props hash. See https://flet.dev/docs/controls/spinkit/
+      def spinkit(**variant)
+        raise ArgumentError, "spinkit expects exactly one variant, e.g. spinkit(wave: { color: ... })" unless variant.size == 1
+
+        name, props = variant.first
+        props ||= {}
+        raise ArgumentError, "spinkit #{name} options must be a Hash" unless props.is_a?(Hash)
+
+        build_widget(:"spinkit_#{name}", **props)
+      end
+
+      def code_editor(value = nil, **props)
+        mapped = props.dup
+        mapped[:value] = value unless value.nil?
+        build_widget(:codeeditor, **mapped)
+      end
+      def codeeditor(value = nil, **props) = code_editor(value, **props)
+
+      def rive(src = nil, **props)
+        mapped = props.dup
+        mapped[:src] = src unless src.nil?
+        build_widget(:rive, **mapped)
+      end
+
       def fab(content = nil, **props)
         mapped = normalize_fab_props(props.dup, content)
         build_widget(:floatingactionbutton, **mapped)

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

@@ -26,6 +26,15 @@ module Ruflet
       def autocompletesuggestion(key = nil, **props) = control_delegate.autocompletesuggestion(key, **props)
       def context_menu(content = nil, **props) = control_delegate.context_menu(content, **props)
       def contextmenu(content = nil, **props) = control_delegate.contextmenu(content, **props)
+      def autofill_group(content = nil, **props) = control_delegate.autofill_group(content, **props)
+      def autofillgroup(content = nil, **props) = control_delegate.autofillgroup(content, **props)
+      def hero(content = nil, **props) = control_delegate.hero(content, **props)
+      def overlay(children = nil, **props) = control_delegate.overlay(children, **props)
+      def shader_mask(content = nil, **props) = control_delegate.shader_mask(content, **props)
+      def shadermask(content = nil, **props) = control_delegate.shadermask(content, **props)
+      def shimmer(content = nil, **props) = control_delegate.shimmer(content, **props)
+      def text_span(text = nil, **props) = control_delegate.text_span(text, **props)
+      def textspan(text = nil, **props) = control_delegate.textspan(text, **props)
       def keyboard_listener(content = nil, **props) = control_delegate.keyboard_listener(content, **props)
       def keyboardlistener(content = nil, **props) = control_delegate.keyboardlistener(content, **props)
       def gesture_detector(**props, &block) = control_delegate.gesture_detector(**props, &block)
@@ -261,6 +270,10 @@ module Ruflet
       def web_view(**props) = control_delegate.web_view(**props)
       def webview(**props) = control_delegate.webview(**props)
       def video(**props) = control_delegate.video(**props)
+      def spinkit(**variant) = control_delegate.spinkit(**variant)
+      def code_editor(value = nil, **props) = control_delegate.code_editor(value, **props)
+      def codeeditor(value = nil, **props) = control_delegate.codeeditor(value, **props)
+      def rive(src = nil, **props) = control_delegate.rive(src, **props)
       def cupertino_button(content = nil, **props) = control_delegate.cupertino_button(content, **props)
       def cupertinobutton(content = nil, **props) = control_delegate.cupertinobutton(content, **props)
       def cupertino_filled_button(content = nil, **props) = control_delegate.cupertino_filled_button(content, **props)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruflet_core
 version: !ruby/object:Gem::Version
-  version: 0.0.15
+  version: 0.0.17
 platform: ruby
 authors:
 - AdamMusa
@@ -83,6 +83,7 @@ files:
 - lib/ruflet_ui/ruflet/ui/controls/materials/checkbox_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/chip_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/circleavatar_control.rb
+- lib/ruflet_ui/ruflet/ui/controls/materials/codeeditor_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/container_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/contextmenu_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/datacell_control.rb
@@ -125,6 +126,7 @@ files:
 - lib/ruflet_ui/ruflet/ui/controls/materials/radiogroup_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/rangeslider_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/reorderablelistview_control.rb
+- lib/ruflet_ui/ruflet/ui/controls/materials/rive_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/ruflet_controls.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/searchbar_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/segment_control.rb
@@ -132,6 +134,7 @@ files:
 - lib/ruflet_ui/ruflet/ui/controls/materials/selectionarea_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/slider_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/snackbar_control.rb
+- lib/ruflet_ui/ruflet/ui/controls/materials/spinkit_controls.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/submenubutton_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/switch_control.rb
 - lib/ruflet_ui/ruflet/ui/controls/materials/tab_control.rb
@@ -233,7 +236,8 @@ files:
 - lib/ruflet_ui/ruflet/ui/shared_control_forwarders.rb
 - lib/ruflet_ui/ruflet/ui/widget_builder.rb
 homepage: https://github.com/AdamMusa/Ruflet
-licenses: []
+licenses:
+- MIT
 metadata: {}
 rdoc_options: []
 require_paths:
@@ -249,7 +253,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.11
 specification_version: 4
 summary: Ruflet core runtime package.
 test_files: []