ruflet_core 0.0.14 → 0.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d10c0b00cedaedd9a12709dd513e56aef545f9ba61b5756481e50b270ca647ce
-  data.tar.gz: 9a247d9aefdee2f5c667c3c5ae55235d17eb1a709c4dc402b0c794ecd5f0a752
+  metadata.gz: 888ec7addc07079a2ef3b649047b8747d031b446489d3015fb96cb5c2101b339
+  data.tar.gz: 342aac065292f59865cf01ace0347531803b41692eac2d3453fe5751c773fe0a
 SHA512:
-  metadata.gz: 18548e0fe324df386b50cb0d5320e70283d64385244f8cf2101c0add56dd62e9a2ae5a8a29fccb86bc058eef18ccd511efc8218305121d58dba7ba40de73639d
-  data.tar.gz: da7f855ee5f0721dbfb9ac249b6f34a7857e4a1e5e9ad2846fbb5954ae92b7c528aea6551796e6f1bcc2cec5ef7ad47aa75a7bdda48d18da3d82f6c94f9ceb56
+  metadata.gz: 2ef5114b3cc6389dafae6ab528990b7be92c0bc2367c62fc2eb0920feaec0dccc17400df7961df5b162bfbc539c2489818f77ac1dd91a040ebb87e1964016906
+  data.tar.gz: 9ad45dc326587bb2a601733b3c1efef6199c9d38424e8a82979d7b9f357fa44ffb579f19de30a3e2c8b2dd78681baf867b7555e9c21883f1f60dd44b7f4f50e0

data/README.md

@@ -1,3 +1,19 @@
-# 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(text("Hello Ruflet"))
+end
+```
+
+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.14" unless const_defined?(:VERSION)
+  VERSION = "0.0.16" 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_protocol/ruflet/protocol.rb

@@ -39,6 +39,12 @@ module Ruflet
         "height" => page["height"],
         "platform" => page["platform"],
         "platform_brightness" => page["platform_brightness"],
+        # The Flutter client reports the host OS in "platform" even inside a
+        # browser, so "web" is the only reliable way to tell a web client from a
+        # native one. (pwa/wasm passed through for completeness.)
+        "web" => page["web"],
+        "pwa" => page["pwa"],
+        "wasm" => page["wasm"],
         "media" => page["media"] || {}
       }
     end
@@ -97,7 +103,8 @@ module Ruflet
       }
     end
 
-    def register_response(session_id:, page_patch: {}, error: nil)
+    def register_response(session_id:, page_patch: nil, error: nil)
+      page_patch ||= {}
       {
         "session_id" => session_id,
         "page_patch" => page_patch,

data/lib/ruflet_ui/ruflet/colors.rb

@@ -151,11 +151,25 @@ 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
+
+    # Canonicalizes a named color into flet's wire format. Flet color names are
+    # lowercase with no separators ("bluegrey", "deeporange", "red500"), so we
+    # strip underscores/whitespace and downcase. Hex values (#... / 0x...) and
+    # the optional ",opacity" suffix are preserved untouched.
+    def self.canonicalize(value)
+      return value unless value.is_a?(String)
+
+      color, separator, opacity = value.partition(",")
+      color = color.strip.downcase
+      color = color.delete("_ \t\n") 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"
@@ -47,6 +48,37 @@ module Ruflet
       @handlers.key?(normalized_event_name(event_name))
     end
 
+    # Read a prop by name: control["value"] or control[:value].
+    def [](key)
+      @props[key.to_s]
+    end
+
+    # Write a prop by name: control["value"] = "x".
+    def []=(key, value)
+      @props[key.to_s] = value
+    end
+
+    # Convenience dot access to props, mirroring Flet-style controls:
+    #   control.value            # => @props["value"] (reads an existing prop)
+    #   control.value = "hello"  # => sets @props["value"]
+    # Reads only resolve props that exist, so typos still raise NoMethodError
+    # instead of silently returning nil. Defined methods (type, id, props,
+    # children, on, emit, to_patch, …) are never shadowed.
+    def method_missing(name, *args, &block)
+      key = name.to_s
+      if key.end_with?("=")
+        return @props[key[0..-2]] = args.first
+      end
+      return @props[key] if args.empty? && @props.key?(key)
+
+      super
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      key = name.to_s
+      key.end_with?("=") || @props.key?(key) || super
+    end
+
     def to_patch
       wire_type = schema_wire_type_for_class
       if wire_type.nil?
@@ -167,7 +199,7 @@ module Ruflet
 
     def normalize_color_prop(key, value)
       return value unless value.is_a?(String)
-      return value.downcase if color_prop_key?(key)
+      return Ruflet::Colors.canonicalize(value) if color_prop_key?(key)
 
       value
     end

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

@@ -244,6 +244,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 +448,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
@@ -533,7 +573,7 @@ module Ruflet
       call_id = "call_#{Ruflet::Control.generate_id}"
       if on_result.respond_to?(:call)
         @invoke_waiters_mutex.synchronize { @invoke_callbacks[call_id] = on_result }
-        unless timeout.nil?
+        if embedded_async_timeout_available? && !timeout.nil?
           Thread.new(call_id, timeout.to_f) do |pending_call_id, invoke_timeout|
             sleep([invoke_timeout, 0.0].max + 0.1)
             callback = @invoke_waiters_mutex.synchronize { @invoke_callbacks.delete(pending_call_id) }
@@ -1157,12 +1197,15 @@ module Ruflet
     def close_dialog(dialog_control)
       return self unless dialog_control
 
-      before_dialog_count = @dialogs_container.props["controls"].length
       dialog_control.props["open"] = false
       @dialog = nil if @dialog.equal?(dialog_control)
       remove_dialog_tracking(dialog_control)
       refresh_dialogs_container!
-      push_dialogs_update!(force_view: @dialogs_container.props["controls"].length < before_dialog_count)
+      # Patch the dialogs container in place. Forcing a full view re-render
+      # here would remount the whole overlay — fatal while another dialog
+      # (e.g. the form behind a nested picker) is still open. The empty case
+      # is handled inside push_dialogs_update!.
+      push_dialogs_update!
       self
     end
 
@@ -1231,7 +1274,17 @@ module Ruflet
       if page_control_target?(target)
         if name.to_s == "route_change"
           route_from_event = extract_route(data)
+          # Dialogs (including pickers) belong to the view that opened them.
+          # Navigating away must dismiss them, or they ghost onto the next
+          # 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
@@ -1240,11 +1293,16 @@ module Ruflet
       control = @wire_index[target.to_i] || @control_index[target.to_s]
       return unless control
 
-      event = Event.new(name: name, target: target, raw_data: data, page: self, control: control)
+      event = Ruflet::Event.new(name: name, target: target, raw_data: data, page: self, control: control)
       apply_event_value_to_control(control, event) if %w[change select select_change].include?(name.to_s)
-      before_dialog_count = @dialogs_container.props["controls"].length
+      # Material/Cupertino pickers dismiss themselves on the client once a
+      # value is confirmed, but only send a value event — never a close. Mark
+      # the dialog closed here so show_dialog can reopen it next time.
+      mark_picker_dialog_closed(control, name)
       if dialog_close_event?(control, name) && remove_dialog_tracking(control)
-        push_dialogs_update!(force_view: @dialogs_container.props["controls"].length < before_dialog_count)
+        # Patch the container in place; never force a full view re-render that
+        # would remount a still-open parent dialog (the nested-picker case).
+        push_dialogs_update!
       end
 
       control.emit(name, event)
@@ -1289,6 +1347,16 @@ 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
+
     def invoke_and_wait(control_or_id, method_name, args: nil, timeout: 10)
       control_id =
         if page_control_target?(control_or_id)
@@ -1540,6 +1608,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)
@@ -1634,15 +1711,15 @@ module Ruflet
       end
     end
 
-    def push_dialogs_update!(force_view: false)
+    def push_dialogs_update!
       refresh_control_indexes!
 
-      if force_view || @dialogs_container.props["controls"].empty?
-        @dialogs_container_mounted = false
-        send_view_patch
-        return
-      end
-
+      # Once the dialogs container is mounted, every change — opening, closing,
+      # even down to no dialogs at all — is an in-place patch of its controls
+      # list. Re-sending the view (or the container as a whole object) would
+      # replace the live container instance on the Flutter side, detaching its
+      # listeners and breaking any other dialog still open. Only the very first
+      # dialog, before the container has a wire id, needs a view patch to mount.
       if @dialogs_container.wire_id
         send_message(Protocol::ACTIONS[:patch_control], {
           "id" => @dialogs_container.wire_id,
@@ -1670,6 +1747,36 @@ module Ruflet
       name == "dismiss" || (%w[change select select_change].include?(name) && @dialogs.include?(control) && control.props["open"] == false)
     end
 
+    # Picker dialogs that auto-dismiss on the client after a selection. Their
+    # confirm sends a value event (change/select), not a close, so the server
+    # must flip `open` to false or show_dialog's open-guard blocks reopening.
+    PICKER_DIALOG_TYPES = %w[
+      datepicker daterangepicker timepicker
+      cupertinodatepicker cupertinotimerpicker
+    ].freeze
+
+    def picker_dialog?(control)
+      PICKER_DIALOG_TYPES.include?(control.type.to_s.tr("_", "").downcase)
+    end
+
+    def mark_picker_dialog_closed(control, name)
+      return unless picker_dialog?(control)
+      return unless %w[change select select_change dismiss].include?(name.to_s)
+
+      control.props["open"] = false
+    end
+
+    # Close and untrack every dialog currently shown. Called on navigation so
+    # a dialog opened in one view does not linger as an overlay on the next.
+    def dismiss_tracked_dialogs!
+      return if @dialogs.empty?
+
+      @dialogs.each { |dialog| dialog.props["open"] = false }
+      @dialogs.clear
+      refresh_dialogs_container!
+      push_dialogs_update! if @dialogs_container_mounted
+    end
+
     def remove_dialog_tracking(control)
       return false unless @dialogs.include?(control)
 
@@ -1734,6 +1841,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
 
@@ -1821,7 +1929,7 @@ module Ruflet
       call_id = "call_#{Ruflet::Control.generate_id}"
       if on_result.respond_to?(:call)
         @invoke_waiters_mutex.synchronize { @invoke_callbacks[call_id] = on_result }
-        unless timeout.nil?
+        if embedded_async_timeout_available? && !timeout.nil?
           Thread.new(call_id, timeout.to_f) do |pending_call_id, invoke_timeout|
             sleep([invoke_timeout, 0.0].max + 0.1)
             callback = @invoke_waiters_mutex.synchronize { @invoke_callbacks.delete(pending_call_id) }

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/materials/webview_control.rb

@@ -4,11 +4,33 @@ 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 (and therefore run_javascript and the
+        # events/methods) runs on iOS, Android and macOS. On web it falls back to
+        # an <iframe>, which cannot run the methods and which most external sites
+        # block via X-Frame-Options/CSP — embed your own same-origin pages there.
         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 +40,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 +49,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/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/controls/shared/window_control.rb

@@ -50,10 +50,28 @@ module Ruflet
             super(type: TYPE, id: id, **props)
           end
 
-          %w[wait_until_ready_to_show to_front center close destroy start_dragging].each do |method_name|
-            define_method(method_name) do |timeout: 10, on_result: nil|
-              runtime_page&.invoke(self, method_name, timeout: timeout, on_result: on_result)
-            end
+          def wait_until_ready_to_show(timeout: 10, on_result: nil)
+            invoke_window_method("wait_until_ready_to_show", timeout: timeout, on_result: on_result)
+          end
+
+          def to_front(timeout: 10, on_result: nil)
+            invoke_window_method("to_front", timeout: timeout, on_result: on_result)
+          end
+
+          def center(timeout: 10, on_result: nil)
+            invoke_window_method("center", timeout: timeout, on_result: on_result)
+          end
+
+          def close(timeout: 10, on_result: nil)
+            invoke_window_method("close", timeout: timeout, on_result: on_result)
+          end
+
+          def destroy(timeout: 10, on_result: nil)
+            invoke_window_method("destroy", timeout: timeout, on_result: on_result)
+          end
+
+          def start_dragging(timeout: 10, on_result: nil)
+            invoke_window_method("start_dragging", timeout: timeout, on_result: on_result)
           end
 
           def start_resizing(edge, timeout: 10, on_result: nil)
@@ -65,6 +83,12 @@ module Ruflet
               on_result: on_result
             )
           end
+
+          private
+
+          def invoke_window_method(method_name, timeout:, on_result:)
+            runtime_page&.invoke(self, method_name, timeout: timeout, on_result: on_result)
+          end
         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/services/ruflet/audio_recorder_control.rb

@@ -8,7 +8,8 @@ module Ruflet
           TYPE = "audiorecorder".freeze
           WIRE = "AudioRecorder".freeze
 
-          def initialize(id: nil, configuration: {}, data: nil, key: nil, on_state_change: nil, on_stream: nil, on_upload: nil)
+          def initialize(id: nil, configuration: nil, data: nil, key: nil, on_state_change: nil, on_stream: nil, on_upload: nil)
+            configuration ||= {}
             props = {}
             props[:configuration] = configuration unless configuration.nil?
             props[:data] = data unless data.nil?
@@ -43,7 +44,8 @@ module Ruflet
             )
           end
 
-          def start_recording(output_path: nil, configuration: {}, upload: nil, timeout: 10, on_result: nil)
+          def start_recording(output_path: nil, configuration: nil, upload: nil, timeout: 10, on_result: nil)
+            configuration ||= {}
             invoke_audio_recorder(
               "start_recording",
               args: compact_args(

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)

data/lib/ruflet_ui.rb

@@ -140,7 +140,7 @@ module Ruflet
       private
 
       def control_delegate
-        Ruflet::DSL
+        Ruflet::WidgetBuilder.new
       end
     end
   end
@@ -154,8 +154,12 @@ module Kernel
   def app(**opts, &block) = Ruflet::DSL.app(**opts, &block)
   def page(**props, &block) = Ruflet::DSL.page(**props, &block)
 
+  # Bare widget helpers (view, text, container, …) build real controls anywhere
+  # — top-level scripts and Ruflet.run blocks — with no builder to instantiate.
+  # The framework owns this plumbing so dev code stays free of it; a fresh
+  # builder per call keeps the helpers stateless.
   def control_delegate
-    Ruflet::DSL
+    Ruflet::WidgetBuilder.new
   end
 
   if Ruflet::UI::SharedControlForwarders.respond_to?(:instance_methods)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruflet_core
 version: !ruby/object:Gem::Version
-  version: 0.0.14
+  version: 0.0.16
 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: