Class: Zui::ComponentRegistry

Inherits:
Object
  • Object
show all
Defined in:
lib/zui/component_registry.rb

Constant Summary collapse

QML_FILE = 
Object.new
NAME = 
AsciiPattern.new(min: 1, max: 64, first: LOWER, rest: LOWER + DIGITS + "_")
ITEM_PROPERTIES = 
%i[
  visible enabled opacity scale rotation z width height
  fill_width fill_height preferred_width preferred_height
  minimum_width minimum_height maximum_width maximum_height layout_alignment
].freeze

Instance Method Summary collapse

Constructor Details

#initialize ⇒ ComponentRegistry

Returns a new instance of ComponentRegistry.



47
48
49
 
# File 'lib/zui/component_registry.rb', line 47

def initialize
  @components = {}
end

Instance Method Details

#dup ⇒ Object 



93
94
95
96
97
98
99
100
101
102
 
# File 'lib/zui/component_registry.rb', line 93

def dup
  copy = self.class.new
  @components.each_value do |component|
    copy.register(component.name, qml: component.qml, properties: component.properties,
                   events: component.events, property_map: component.property_map,
                   event_map: component.event_map, container: component.container,
                   auto_bind: component.auto_bind)
  end
  copy
end

#fetch(name) ⇒ Object 



81
82
83
 
# File 'lib/zui/component_registry.rb', line 81

def fetch(name)
  @components.fetch(name.to_sym) { raise ArgumentError, "unknown component: #{name}" }
end

#key?(name) ⇒ Boolean

Returns:

  • (Boolean) 


85
86
87
 
# File 'lib/zui/component_registry.rb', line 85

def key?(name)
  @components.key?(name.to_sym)
end

#protocol_schema ⇒ Object 



89
90
91
 
# File 'lib/zui/component_registry.rb', line 89

def protocol_schema
  @components.transform_keys(&:to_s).transform_values(&:to_h)
end

#register(name, qml:, properties: [], events: [], property_map: {}, event_map: {}, container: false, auto_bind: true) ⇒ Object

Raises:

  • (ArgumentError) 


51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/zui/component_registry.rb', line 51

def register(name, qml:, properties: [], events: [], property_map: {}, event_map: {}, container: false, auto_bind: true)
  key = name.to_sym
  raise ArgumentError, "component already registered: #{key}" if @components.key?(key)
  raise ArgumentError, "invalid component name: #{name.inspect}" unless NAME.match?(key.to_s)
  raise ArgumentError, "invalid component adapter: #{qml.inspect}" unless QML_FILE.match?(qml.to_s)
  property_names = (properties.map(&:to_sym) + property_map.keys.map(&:to_sym) + ITEM_PROPERTIES).uniq
  event_names = (events.map(&:to_sym) + event_map.keys.map(&:to_sym)).uniq
  normalized_property_map = properties.to_h { |property| [property.to_sym, property.to_sym] }
  normalized_property_map.merge!(property_map.to_h { |key, value| [key.to_sym, value.to_sym] })
  normalized_event_map = events.to_h { |event| [event.to_sym, event.to_sym] }
  normalized_event_map.merge!(event_map.to_h { |key, value| [key.to_sym, value.to_sym] })
  invalid_property = property_names.find { |property| !NAME.match?(property.to_s) }
  invalid_event = event_names.find { |event| !NAME.match?(event.to_s) }
  raise ArgumentError, "invalid property name: #{invalid_property.inspect}" if invalid_property
  raise ArgumentError, "invalid event name: #{invalid_event.inspect}" if invalid_event
  invalid_target = (normalized_property_map.values + normalized_event_map.values).find { |target| !NAME.match?(target.to_s) }
  raise ArgumentError, "invalid QML member name: #{invalid_target.inspect}" if invalid_target

  @components[key] = Component.new(
    name: key,
    qml: qml.to_s,
    properties: property_names.uniq.freeze,
    events: event_names.uniq.freeze,
    property_map: normalized_property_map.freeze,
    event_map: normalized_event_map.freeze,
    container: !!container,
    auto_bind: !!auto_bind
  )
end