ruflet_core 0.0.21 → 0.0.23

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

@@ -19,6 +19,28 @@ module Ruflet
         Array(value).map { |coordinates| map_coordinates(coordinates) }
       end
 
+      def base_page(**props, &block) = build_widget(:base_page, **props, &block)
+      def basepage(**props, &block) = base_page(**props, &block)
+      def dialogs(controls = nil, **props)
+        mapped = props.dup
+        mapped[:controls] = controls unless controls.nil?
+        build_widget(:dialogs, **mapped)
+      end
+      def pagelet(content = nil, **props, &block)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:pagelet, **mapped, &block)
+      end
+      def ruflet_app(**props) = build_widget(:ruflet_app, **props)
+      def rufletapp(**props) = ruflet_app(**props)
+      def service_registry(services = nil, **props)
+        mapped = props.dup
+        mapped[:services] = services unless services.nil?
+        build_widget(:service_registry, **mapped)
+      end
+      def serviceregistry(services = nil, **props) = service_registry(services, **props)
+      def window(**props) = build_widget(:window, **props)
+
       def view(children = nil, **props, &block)
         mapped = props.dup
         mapped[:controls] = children unless children.nil?
@@ -77,7 +99,31 @@ module Ruflet
         Ruflet::Animation.new(duration: duration, **props)
       end
       def animation_style(**props) = Ruflet::AnimationStyle.new(**props)
-      def audio(**props) = build_widget(:audio, **props)
+      def accelerometer(**props) = build_service(:accelerometer, **props)
+      def audio(**props) = build_service(:audio, **props)
+      def audio_recorder(**props) = build_service(:audio_recorder, **props)
+      def barometer(**props) = build_service(:barometer, **props)
+      def battery(**props) = build_service(:battery, **props)
+      def browser_context_menu(**props) = build_service(:browser_context_menu, **props)
+      def camera(**props) = build_widget(:camera, **props)
+      def connectivity(**props) = build_service(:connectivity, **props)
+      def file_picker(**props) = build_service(:file_picker, **props)
+      def flashlight(**props) = build_service(:flashlight, **props)
+      def geolocator(**props) = build_service(:geolocator, **props)
+      def gyroscope(**props) = build_service(:gyroscope, **props)
+      def haptic_feedback(**props) = build_service(:haptic_feedback, **props)
+      def magnetometer(**props) = build_service(:magnetometer, **props)
+      def permission_handler(**props) = build_service(:permission_handler, **props)
+      def screen_brightness(**props) = build_service(:screen_brightness, **props)
+      def secure_storage(**props) = build_service(:secure_storage, **props)
+      def semantics_service(**props) = build_service(:semantics_service, **props)
+      def shake_detector(**props) = build_service(:shake_detector, **props)
+      def share(**props) = build_service(:share, **props)
+      def shared_preferences(**props) = build_service(:shared_preferences, **props)
+      def storage_paths(**props) = build_service(:storage_paths, **props)
+      def url_launcher(**props) = build_service(:url_launcher, **props)
+      def user_accelerometer(**props) = build_service(:user_accelerometer, **props)
+      def wakelock(**props) = build_service(:wakelock, **props)
       def auto_complete(suggestions = nil, **props)
         mapped = props.dup
         mapped[:suggestions] = suggestions unless suggestions.nil?
@@ -246,6 +292,26 @@ module Ruflet
       def polygonmarker(**props) = polygon_marker(**props)
       def simple_attribution(**props) = build_widget(:simpleattribution, **props)
       def simpleattribution(**props) = simple_attribution(**props)
+      def map_layer(**props) = build_widget(:maplayer, **props)
+      def maplayer(**props) = map_layer(**props)
+      def rich_attribution(attributions = nil, **props)
+        mapped = props.dup
+        mapped[:attributions] = attributions unless attributions.nil?
+        build_widget(:richattribution, **mapped)
+      end
+      def richattribution(attributions = nil, **props) = rich_attribution(attributions, **props)
+      def image_source_attribution(image = nil, **props)
+        mapped = props.dup
+        mapped[:image] = image unless image.nil?
+        build_widget(:imagesourceattribution, **mapped)
+      end
+      def imagesourceattribution(image = nil, **props) = image_source_attribution(image, **props)
+      def text_source_attribution(text = nil, **props)
+        mapped = props.dup
+        mapped[:text] = text unless text.nil?
+        build_widget(:textsourceattribution, **mapped)
+      end
+      def textsourceattribution(text = nil, **props) = text_source_attribution(text, **props)
       def list_view(children = nil, **props)
         mapped = props.dup
         mapped[:children] = children unless children.nil?
@@ -313,6 +379,29 @@ module Ruflet
         build_widget(:datacell, **mapped)
       end
       def datacell(content = nil, **props) = data_cell(content, **props)
+      def option(key = nil, **props)
+        mapped = props.dup
+        mapped[:key] = key unless key.nil?
+        build_widget(:option, **mapped)
+      end
+      def data_table2(columns = nil, **props)
+        mapped = props.dup
+        mapped[:columns] = columns unless columns.nil?
+        build_widget(:data_table2, **mapped)
+      end
+      def datatable2(columns = nil, **props) = data_table2(columns, **props)
+      def data_column2(label = nil, **props)
+        mapped = props.dup
+        mapped[:label] = label unless label.nil?
+        build_widget(:data_column2, **mapped)
+      end
+      def datacolumn2(label = nil, **props) = data_column2(label, **props)
+      def data_row2(cells = nil, **props)
+        mapped = props.dup
+        mapped[:cells] = cells unless cells.nil?
+        build_widget(:data_row2, **mapped)
+      end
+      def datarow2(cells = nil, **props) = data_row2(cells, **props)
       def expansion_tile(children = nil, **props)
         mapped = props.dup
         mapped[:children] = children unless children.nil?
@@ -339,9 +428,7 @@ module Ruflet
       end
       def dropdownoption(key = nil, **props) = dropdown_option(key, **props)
       def dropdown_m2(options = nil, **props)
-        mapped = props.dup
-        mapped[:options] = options unless options.nil?
-        build_widget(:dropdownm2, **mapped)
+        dropdown(options, **props)
       end
       def dropdownm2(options = nil, **props) = dropdown_m2(options, **props)
       def progress_bar(**props) = build_widget(:progressbar, **props)
@@ -611,8 +698,7 @@ module Ruflet
 
       def app_bar(**props) = build_widget(:appbar, **props)
       def appbar(**props) = app_bar(**props)
-      def url_launcher(**props) = build_widget(:url_launcher, **props)
-      def clipboard(**props) = build_widget(:clipboard, **props)
+      def clipboard(**props) = build_service(:clipboard, **props)
       def floating_action_button(**props) = build_widget(:floatingactionbutton, **props)
       def floatingactionbutton(**props) = floating_action_button(**props)
       def tabs(content = nil, **props, &block)
@@ -696,6 +782,24 @@ module Ruflet
       def web_view(**props) = build_widget(:webview, **props)
       def webview(**props) = web_view(**props)
       def video(**props) = build_widget(:video, **props)
+      def block_picker(**props) = build_widget(:block_picker, **props)
+      def blockpicker(**props) = block_picker(**props)
+      def color_picker(**props) = build_widget(:color_picker, **props)
+      def colorpicker(**props) = color_picker(**props)
+      def hue_ring_picker(**props) = build_widget(:hue_ring_picker, **props)
+      def hueringpicker(**props) = hue_ring_picker(**props)
+      def material_picker(**props) = build_widget(:material_picker, **props)
+      def materialpicker(**props) = material_picker(**props)
+      def multiple_choice_block_picker(**props) = build_widget(:multiple_choice_block_picker, **props)
+      def multiplechoiceblockpicker(**props) = multiple_choice_block_picker(**props)
+      def slide_picker(**props) = build_widget(:slide_picker, **props)
+      def slidepicker(**props) = slide_picker(**props)
+      def banner_ad(**props) = build_widget(:banner_ad, **props)
+      def bannerad(**props) = banner_ad(**props)
+      def interstitial_ad(**props) = build_widget(:interstitial_ad, **props)
+      def interstitialad(**props) = interstitial_ad(**props)
+      def native_ad(**props) = build_widget(:native_ad, **props)
+      def nativead(**props) = native_ad(**props)
       def code_editor(value = nil, **props)
         mapped = props.dup
         mapped[:value] = value unless value.nil?

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

@@ -93,6 +93,12 @@ module Ruflet
         "url_launcher" => "UrlLauncher",
         "clipboard" => "Clipboard",
         "audio" => "Audio",
+        "bannerad" => "BannerAd",
+        "banner_ad" => "BannerAd",
+        "interstitialad" => "InterstitialAd",
+        "interstitial_ad" => "InterstitialAd",
+        "nativead" => "NativeAd",
+        "native_ad" => "NativeAd",
         "video" => "Video",
         "map" => "Map",
         "tilelayer" => "TileLayer",
@@ -114,19 +120,28 @@ module Ruflet
         "polygon_marker" => "PolygonMarker",
         "simpleattribution" => "SimpleAttribution",
         "simple_attribution" => "SimpleAttribution",
+        "maplayer" => "MapLayer",
+        "map_layer" => "MapLayer",
+        "richattribution" => "RichAttribution",
+        "rich_attribution" => "RichAttribution",
+        "imagesourceattribution" => "ImageSourceAttribution",
+        "image_source_attribution" => "ImageSourceAttribution",
+        "textsourceattribution" => "TextSourceAttribution",
+        "text_source_attribution" => "TextSourceAttribution",
         "codeeditor" => "CodeEditor",
         "code_editor" => "CodeEditor",
         "lottie" => "Lottie",
+        "rive" => "Rive",
         "flashlight" => "Flashlight",
         "barchart" => "BarChart",
-        "barchartgroup" => "group",
-        "barchartrod" => "rod",
-        "barchartrodstackitem" => "stack_item",
+        "barchartgroup" => "BarChartGroup",
+        "barchartrod" => "BarChartRod",
+        "barchartrodstackitem" => "BarChartRodStackItem",
         "linechart" => "LineChart",
-        "linechartdata" => "data",
-        "linechartdatapoint" => "p",
+        "linechartdata" => "LineChartData",
+        "linechartdatapoint" => "LineChartDataPoint",
         "piechart" => "PieChart",
-        "piechartsection" => "section",
+        "piechartsection" => "PieChartSection",
         "candlestickchart" => "CandlestickChart",
         "candlestickchartspot" => "CandlestickChartSpot",
         "radarchart" => "RadarChart",
@@ -135,8 +150,8 @@ module Ruflet
         "radardatasetentry" => "RadarDataSetEntry",
         "scatterchart" => "ScatterChart",
         "scatterchartspot" => "ScatterChartSpot",
-        "chartaxis" => "axis",
-        "chartaxislabel" => "l",
+        "chartaxis" => "ChartAxis",
+        "chartaxislabel" => "ChartAxisLabel",
         "datacell" => "c",
         "datacolumn" => "c",
         "datarow" => "r",

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

@@ -0,0 +1,392 @@
+# frozen_string_literal: true
+
+require_relative "controls/ruflet_controls"
+
+module Ruflet
+  module UI
+    # One Ruby protocol contract for controls whose visual implementation is
+    # selected by the Flet client. These schemas deliberately accept the union
+    # of the Material and Cupertino properties: Ruby describes intent and the
+    # platform renderer decides how that intent looks.
+    module PlatformControlContracts
+      module Components
+        class PlatformControl < Ruflet::Control
+          def initialize(id: nil, **props)
+            props = platform_defaults.merge(props)
+            validate_platform_props!(props)
+            compact = {}
+            props.each do |key, value|
+              raise ArgumentError, "unknown keyword: :#{key}" unless self.class::KEYWORDS.include?(key)
+
+              value = normalize_platform_prop(key, value)
+              compact[key] = value unless value.nil?
+            end
+            super(type: self.class::TYPE, id: id, **compact)
+          end
+
+          private
+
+          def platform_defaults = {}
+          def validate_platform_props!(_props); end
+          def normalize_platform_prop(_key, value) = value
+
+          def require_control_prop!(props, name)
+            value = props[name]
+            raise ArgumentError, "#{self.class::TYPE} requires #{name}" if value.nil?
+          end
+        end
+
+        class ButtonControl < PlatformControl
+          TYPE = "button".freeze
+          WIRE = "Button".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::ButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoButtonControl::KEYWORDS +
+            %i[default destructive]
+          ).uniq.freeze
+
+        end
+
+        class FilledButtonControl < PlatformControl
+          TYPE = "filledbutton".freeze
+          WIRE = "FilledButton".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::FilledButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoFilledButtonControl::KEYWORDS
+          ).uniq.freeze
+
+          private
+
+          def platform_defaults = { autofocus: false, clip_behavior: "none" }
+        end
+
+        class FilledTonalButtonControl < PlatformControl
+          TYPE = "filledtonalbutton".freeze
+          WIRE = "FilledTonalButton".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::FilledTonalButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoTintedButtonControl::KEYWORDS
+          ).uniq.freeze
+
+          private
+
+          def platform_defaults = { autofocus: false, clip_behavior: "none" }
+        end
+
+        class OutlinedButtonControl < PlatformControl
+          TYPE = "outlinedbutton".freeze
+          WIRE = "OutlinedButton".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::OutlinedButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoButtonControl::KEYWORDS
+          ).uniq.freeze
+
+          private
+
+          def platform_defaults = { autofocus: false, clip_behavior: "none" }
+        end
+
+        class TextButtonControl < PlatformControl
+          TYPE = "textbutton".freeze
+          WIRE = "TextButton".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::TextButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoButtonControl::KEYWORDS
+          ).uniq.freeze
+
+          private
+
+          def platform_defaults = { autofocus: false, clip_behavior: "none" }
+        end
+
+        class TextFieldControl < PlatformControl
+          TYPE = "textfield".freeze
+          WIRE = "TextField".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::TextFieldControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoTextFieldControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class CheckboxControl < PlatformControl
+          TYPE = "checkbox".freeze
+          WIRE = "Checkbox".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::CheckboxControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoCheckboxControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class RadioControl < PlatformControl
+          TYPE = "radio".freeze
+          WIRE = "Radio".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::RadioControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoRadioControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class SliderControl < PlatformControl
+          TYPE = "slider".freeze
+          WIRE = "Slider".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::SliderControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoSliderControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class SwitchControl < PlatformControl
+          TYPE = "switch".freeze
+          WIRE = "Switch".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::SwitchControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoSwitchControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class AlertDialogControl < PlatformControl
+          TYPE = "alertdialog".freeze
+          WIRE = "AlertDialog".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::AlertDialogControl::KEYWORDS +
+            %i[inset_animation]
+          ).uniq.freeze
+        end
+
+        class BottomSheetControl < PlatformControl
+          TYPE = "bottomsheet".freeze
+          WIRE = "BottomSheet".freeze
+          KEYWORDS = %i[
+            adaptive animation_style badge barrier_color bgcolor clip_behavior col content data
+            disabled dismissible draggable elevation expand expand_loose fullscreen height key
+            maintain_bottom_view_insets_padding modal opacity open padding rtl scrollable shape
+            show_drag_handle size_constraints tooltip use_safe_area visible on_dismiss
+          ].freeze
+
+          private
+
+          def validate_platform_props!(props) = require_control_prop!(props, :content)
+        end
+
+        class AppBarControl < PlatformControl
+          TYPE = "appbar".freeze
+          WIRE = "AppBar".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::AppBarControl::KEYWORDS + %i[
+              automatic_background_visibility automatically_imply_title border brightness
+              enable_background_filter_blur large padding previous_page_title trailing
+              transition_between_routes
+            ]
+          ).uniq.freeze
+        end
+
+        class ListTileControl < PlatformControl
+          TYPE = "listtile".freeze
+          WIRE = "ListTile".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::ListTileControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoListTileControl::KEYWORDS
+          ).uniq.freeze
+
+          private
+
+          def validate_platform_props!(props) = require_control_prop!(props, :title)
+        end
+
+        class NavigationBarControl < PlatformControl
+          TYPE = "navigationbar".freeze
+          WIRE = "NavigationBar".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::NavigationBarControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoNavigationBarControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class ProgressRingControl < PlatformControl
+          TYPE = "progressring".freeze
+          WIRE = "ProgressRing".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::ProgressRingControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoActivityIndicatorControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class SegmentedButtonControl < PlatformControl
+          TYPE = "segmentedbutton".freeze
+          WIRE = "SegmentedButton".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::SegmentedButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoSegmentedButtonControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoSlidingSegmentedButtonControl::KEYWORDS
+          ).uniq.freeze
+        end
+
+        class ContextMenuControl < PlatformControl
+          TYPE = "contextmenu".freeze
+          WIRE = "ContextMenu".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::ContextMenuControl::KEYWORDS +
+            %i[actions adaptive enable_haptic_feedback]
+          ).uniq.freeze
+
+          def open(position: nil, timeout: 10, on_result: nil)
+            args = {}
+            args["position"] = stringify_hash_keys(position) unless position.nil?
+            runtime_page&.invoke(self, "open", args: args, timeout: timeout, on_result: on_result)
+          end
+
+          private
+
+          def validate_platform_props!(props) = require_control_prop!(props, :content)
+
+          def stringify_hash_keys(value)
+            return value.map { |item| stringify_hash_keys(item) } if value.is_a?(Array)
+            if value.is_a?(Hash)
+              return value.each_with_object({}) do |(key, child), result|
+                result[key.to_s] = stringify_hash_keys(child)
+              end
+            end
+
+            value
+          end
+        end
+
+        class ContextMenuActionControl < PlatformControl
+          TYPE = "contextmenuaction".freeze
+          WIRE = "ContextMenuAction".freeze
+          KEYWORDS = %i[
+            adaptive align animate_align animate_margin animate_offset animate_opacity
+            animate_position animate_rotation animate_scale animate_size aspect_ratio badge bottom
+            checked col content data default destructive disabled expand expand_loose height icon key
+            left margin mouse_cursor offset opacity right rotate rtl scale size_change_interval
+            tooltip top trailing_icon value visible width on_animation_end on_click on_size_change
+          ].freeze
+
+          private
+
+          def validate_platform_props!(props) = require_control_prop!(props, :content)
+        end
+
+        class ActionSheetControl < PlatformControl
+          TYPE = "actionsheet".freeze
+          WIRE = "ActionSheet".freeze
+          KEYWORDS = Controls::RufletComponents::CupertinoActionSheetControl::KEYWORDS
+        end
+
+        class ActionSheetActionControl < PlatformControl
+          TYPE = "actionsheetaction".freeze
+          WIRE = "ActionSheetAction".freeze
+          KEYWORDS = Controls::RufletComponents::CupertinoActionSheetActionControl::KEYWORDS
+
+          private
+
+          def validate_platform_props!(props) = require_control_prop!(props, :content)
+        end
+
+        class DatePickerControl < PlatformControl
+          TYPE = "datepicker".freeze
+          WIRE = "DatePicker".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::DatePickerControl::KEYWORDS +
+            Controls::RufletComponents::CupertinoDatePickerControl::KEYWORDS
+          ).uniq.freeze
+
+          private
+
+          def normalize_platform_prop(key, value)
+            return value unless %i[value first_date last_date current_date].include?(key)
+
+            Ruflet::Protocol.date_time(value)
+          end
+        end
+
+        class PickerControl < PlatformControl
+          TYPE = "picker".freeze
+          WIRE = "Picker".freeze
+          KEYWORDS = Controls::RufletComponents::CupertinoPickerControl::KEYWORDS
+        end
+
+        class TimerPickerControl < PlatformControl
+          TYPE = "timerpicker".freeze
+          WIRE = "TimerPicker".freeze
+          KEYWORDS = Controls::RufletComponents::CupertinoTimerPickerControl::KEYWORDS
+        end
+
+        class DropdownControl < PlatformControl
+          TYPE = "dropdown".freeze
+          WIRE = "Dropdown".freeze
+          KEYWORDS = (
+            Controls::RufletComponents::DropdownControl::KEYWORDS +
+            Controls::RufletComponents::Dropdown2Control::KEYWORDS
+          ).uniq.freeze
+        end
+      end
+
+      CANONICAL_CLASS_MAP = {
+        %w[button elevated_button elevatedbutton] => Components::ButtonControl,
+        %w[filled_button filledbutton] => Components::FilledButtonControl,
+        %w[filled_tonal_button filledtonalbutton] => Components::FilledTonalButtonControl,
+        %w[outlined_button outlinedbutton] => Components::OutlinedButtonControl,
+        %w[text_button textbutton] => Components::TextButtonControl,
+        %w[text_field textfield] => Components::TextFieldControl,
+        %w[checkbox] => Components::CheckboxControl,
+        %w[radio] => Components::RadioControl,
+        %w[slider] => Components::SliderControl,
+        %w[switch] => Components::SwitchControl,
+        %w[alert_dialog alertdialog] => Components::AlertDialogControl,
+        %w[bottom_sheet bottomsheet] => Components::BottomSheetControl,
+        %w[app_bar appbar] => Components::AppBarControl,
+        %w[list_tile listtile] => Components::ListTileControl,
+        %w[navigation_bar navigationbar] => Components::NavigationBarControl,
+        %w[progress_ring progressring] => Components::ProgressRingControl,
+        %w[segmented_button segmentedbutton] => Components::SegmentedButtonControl,
+        %w[context_menu contextmenu] => Components::ContextMenuControl,
+        %w[context_menu_action contextmenuaction] => Components::ContextMenuActionControl,
+        %w[action_sheet actionsheet] => Components::ActionSheetControl,
+        %w[action_sheet_action actionsheetaction] => Components::ActionSheetActionControl,
+        %w[date_picker datepicker] => Components::DatePickerControl,
+        %w[picker] => Components::PickerControl,
+        %w[timer_picker timerpicker] => Components::TimerPickerControl,
+        %w[dropdown dropdown_m2 dropdownm2] => Components::DropdownControl,
+      }.each_with_object({}) do |(names, klass), map|
+        names.each { |name| map[name] = klass }
+      end.freeze
+
+      LEGACY_CLASS_MAP = {
+        %w[cupertino_button cupertinobutton] => Controls::RufletComponents::CupertinoButtonControl,
+        %w[cupertino_filled_button cupertinofilledbutton] => Controls::RufletComponents::CupertinoFilledButtonControl,
+        %w[cupertino_tinted_button cupertinotintedbutton] => Controls::RufletComponents::CupertinoTintedButtonControl,
+        %w[cupertino_text_field cupertinotextfield] => Controls::RufletComponents::CupertinoTextFieldControl,
+        %w[cupertino_checkbox cupertinocheckbox] => Controls::RufletComponents::CupertinoCheckboxControl,
+        %w[cupertino_radio cupertinoradio] => Controls::RufletComponents::CupertinoRadioControl,
+        %w[cupertino_slider cupertinoslider] => Controls::RufletComponents::CupertinoSliderControl,
+        %w[cupertino_switch cupertinoswitch] => Controls::RufletComponents::CupertinoSwitchControl,
+        %w[cupertino_alert_dialog cupertinoalertdialog] => Controls::RufletComponents::CupertinoAlertDialogControl,
+        %w[cupertino_bottom_sheet cupertinobottomsheet] => Controls::RufletComponents::CupertinoBottomSheetControl,
+        %w[cupertino_app_bar cupertinoappbar] => Controls::RufletComponents::CupertinoAppBarControl,
+        %w[cupertino_list_tile cupertinolisttile] => Controls::RufletComponents::CupertinoListTileControl,
+        %w[cupertino_navigation_bar cupertinonavigationbar] => Controls::RufletComponents::CupertinoNavigationBarControl,
+        %w[cupertino_activity_indicator cupertinoactivityindicator] => Controls::RufletComponents::CupertinoActivityIndicatorControl,
+        %w[cupertino_segmented_button cupertinosegmentedbutton] => Controls::RufletComponents::CupertinoSegmentedButtonControl,
+        %w[cupertino_sliding_segmented_button cupertinoslidingsegmentedbutton] => Controls::RufletComponents::CupertinoSlidingSegmentedButtonControl,
+        %w[cupertino_context_menu cupertinocontextmenu] => Controls::RufletComponents::CupertinoContextMenuControl,
+        %w[cupertino_context_menu_action cupertinocontextmenuaction] => Controls::RufletComponents::CupertinoContextMenuActionControl,
+        %w[cupertino_action_sheet cupertinoactionsheet] => Controls::RufletComponents::CupertinoActionSheetControl,
+        %w[cupertino_action_sheet_action cupertinoactionsheetaction] => Controls::RufletComponents::CupertinoActionSheetActionControl,
+        %w[cupertino_date_picker cupertinodatepicker] => Controls::RufletComponents::CupertinoDatePickerControl,
+        %w[cupertino_picker cupertinopicker] => Controls::RufletComponents::CupertinoPickerControl,
+        %w[cupertino_timer_picker cupertinotimerpicker] => Controls::RufletComponents::CupertinoTimerPickerControl,
+        %w[cupertino_dialog_action cupertinodialogaction] => Controls::RufletComponents::CupertinoDialogActionControl,
+        %w[popup_menu_item popupmenuitem] => Controls::RufletComponents::PopupMenuItemControl
+      }.each_with_object({}) do |(names, klass), map|
+        names.each { |name| map[name] = klass }
+      end.freeze
+
+      CLASS_MAP = CANONICAL_CLASS_MAP.merge(LEGACY_CLASS_MAP).freeze
+
+      TYPE_MAP = CLASS_MAP.each_with_object({}) do |(name, klass), map|
+        map[name] = klass::WIRE
+      end.freeze
+    end
+  end
+end

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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Ruflet
+  module UI
+    # Canonical DSL entry points for controls whose renderer is selected by
+    # the Flet client. There is no design-system choice in this API.
+    module PlatformControlMethods
+      def context_menu_action(content = nil, **props)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:contextmenuaction, **mapped)
+      end
+      def contextmenuaction(content = nil, **props) = context_menu_action(content, **props)
+
+      def action_sheet(**props) = build_widget(:actionsheet, **props)
+      def actionsheet(**props) = action_sheet(**props)
+
+      def action_sheet_action(content = nil, **props)
+        mapped = props.dup
+        mapped[:content] = content unless content.nil?
+        build_widget(:actionsheetaction, **mapped)
+      end
+      def actionsheetaction(content = nil, **props) = action_sheet_action(content, **props)
+
+      def picker(children = nil, **props)
+        mapped = props.dup
+        mapped[:controls] = children unless children.nil?
+        build_widget(:picker, **mapped)
+      end
+
+      def timer_picker(**props) = build_widget(:timerpicker, **props)
+      def timerpicker(**props) = timer_picker(**props)
+    end
+  end
+end