Module: Ruflet::Colors

Defined in:
lib/ruflet_ui/ruflet/colors.rb

Constant Summary collapse

SEMANTIC_COLORS = 
{
  PRIMARY: "primary",
  ON_PRIMARY: "onprimary",
  PRIMARY_CONTAINER: "primarycontainer",
  ON_PRIMARY_CONTAINER: "onprimarycontainer",
  PRIMARY_FIXED: "primaryfixed",
  PRIMARY_FIXED_DIM: "primaryfixeddim",
  ON_PRIMARY_FIXED: "onprimaryfixed",
  ON_PRIMARY_FIXED_VARIANT: "onprimaryfixedvariant",
  SECONDARY: "secondary",
  ON_SECONDARY: "onsecondary",
  SECONDARY_CONTAINER: "secondarycontainer",
  ON_SECONDARY_CONTAINER: "onsecondarycontainer",
  SECONDARY_FIXED: "secondaryfixed",
  SECONDARY_FIXED_DIM: "secondaryfixeddim",
  ON_SECONDARY_FIXED: "onsecondaryfixed",
  ON_SECONDARY_FIXED_VARIANT: "onsecondaryfixedvariant",
  TERTIARY: "tertiary",
  ON_TERTIARY: "ontertiary",
  TERTIARY_CONTAINER: "tertiarycontainer",
  ON_TERTIARY_CONTAINER: "ontertiarycontainer",
  TERTIARY_FIXED: "tertiaryfixed",
  TERTIARY_FIXED_DIM: "tertiaryfixeddim",
  ON_TERTIARY_FIXED: "ontertiaryfixed",
  ON_TERTIARY_FIXED_VARIANT: "ontertiaryfixedvariant",
  ERROR: "error",
  ON_ERROR: "onerror",
  ERROR_CONTAINER: "errorcontainer",
  ON_ERROR_CONTAINER: "onerrorcontainer",
  SURFACE: "surface",
  ON_SURFACE: "onsurface",
  ON_SURFACE_VARIANT: "onsurfacevariant",
  SURFACE_TINT: "surfacetint",
  SURFACE_DIM: "surfacedim",
  SURFACE_BRIGHT: "surfacebright",
  SURFACE_CONTAINER: "surfacecontainer",
  SURFACE_CONTAINER_LOW: "surfacecontainerlow",
  SURFACE_CONTAINER_LOWEST: "surfacecontainerlowest",
  SURFACE_CONTAINER_HIGH: "surfacecontainerhigh",
  SURFACE_CONTAINER_HIGHEST: "surfacecontainerhighest",
  OUTLINE: "outline",
  OUTLINE_VARIANT: "outlinevariant",
  SHADOW: "shadow",
  SCRIM: "scrim",
  INVERSE_SURFACE: "inversesurface",
  ON_INVERSE_SURFACE: "oninversesurface",
  INVERSE_PRIMARY: "inverseprimary"
}.freeze
BASE_PRIMARY = 
%w[
  amber blue bluegrey brown cyan deeporange deeppurple green grey indigo lightblue
  lightgreen lime orange pink purple red teal yellow
].freeze
BASE_ACCENT = 
%w[
  amber blue cyan deeporange deeppurple green indigo lightblue lightgreen lime
  orange pink purple red teal yellow
].freeze
PRIMARY_SHADES = 
[50, 100, 200, 300, 400, 500, 600, 700, 800, 900].freeze
ACCENT_SHADES = 
[100, 200, 400, 700].freeze
FIXED_COLORS = 
{
  BLACK: "black",
  BLACK_12: "black12",
  BLACK_26: "black26",
  BLACK_38: "black38",
  BLACK_45: "black45",
  BLACK_54: "black54",
  BLACK_87: "black87",
  WHITE: "white",
  WHITE_10: "white10",
  WHITE_12: "white12",
  WHITE_24: "white24",
  WHITE_30: "white30",
  WHITE_38: "white38",
  WHITE_54: "white54",
  WHITE_60: "white60",
  WHITE_70: "white70",
  TRANSPARENT: "transparent"
}.freeze
DEPRECATED_ALIASES = 
{
  BLACK12: :BLACK_12,
  BLACK26: :BLACK_26,
  BLACK38: :BLACK_38,
  BLACK45: :BLACK_45,
  BLACK54: :BLACK_54,
  BLACK87: :BLACK_87,
  WHITE10: :WHITE_10,
  WHITE12: :WHITE_12,
  WHITE24: :WHITE_24,
  WHITE30: :WHITE_30,
  WHITE38: :WHITE_38,
  WHITE54: :WHITE_54,
  WHITE60: :WHITE_60,
  WHITE70: :WHITE_70
}.freeze
BASE_PREFIX = 
{
  "amber" => "AMBER",
  "blue" => "BLUE",
  "bluegrey" => "BLUE_GREY",
  "brown" => "BROWN",
  "cyan" => "CYAN",
  "deeporange" => "DEEP_ORANGE",
  "deeppurple" => "DEEP_PURPLE",
  "green" => "GREEN",
  "grey" => "GREY",
  "indigo" => "INDIGO",
  "lightblue" => "LIGHT_BLUE",
  "lightgreen" => "LIGHT_GREEN",
  "lime" => "LIME",
  "orange" => "ORANGE",
  "pink" => "PINK",
  "purple" => "PURPLE",
  "red" => "RED",
  "teal" => "TEAL",
  "yellow" => "YELLOW"
}.freeze

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.canonicalize(value) ⇒ Object

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.



165
166
167
168
169
170
171
172
173
 
# File 'lib/ruflet_ui/ruflet/colors.rb', line 165

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

.constant_prefix_for(base_name) ⇒ Object 



197
198
199
200
201
 
# File 'lib/ruflet_ui/ruflet/colors.rb', line 197

def self.constant_prefix_for(base_name)
  key = base_name.to_s
  return BASE_PREFIX[key] if BASE_PREFIX.key?(key)
  key.upcase
end

.normalize_color(color) ⇒ Object 



153
154
155
156
157
158
159
 
# File 'lib/ruflet_ui/ruflet/colors.rb', line 153

def self.normalize_color(color)
  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)

  canonicalize(color.to_s)
end

Instance Method Details

#all_values ⇒ Object 



127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
 
# File 'lib/ruflet_ui/ruflet/colors.rb', line 127

def all_values
  return @all_values if @all_values

  values = []
  SEMANTIC_COLORS.each_value { |v| values << v }
  FIXED_COLORS.each_value { |v| values << v }

  BASE_PRIMARY.each do |base|
    values << base
    PRIMARY_SHADES.each do |shade|
      values << "#{base}#{shade}"
    end
  end

  BASE_ACCENT.each do |base|
    values << "#{base}accent"
    ACCENT_SHADES.each do |shade|
      values << "#{base}accent#{shade}"
    end
  end

  uniq_map = {}
  values.each { |v| uniq_map[v] = true }
  @all_values = uniq_map.keys.freeze
end

#random(exclude: nil, weights: nil) ⇒ Object 



109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'lib/ruflet_ui/ruflet/colors.rb', line 109

def random(exclude: nil, weights: nil)
  choices = all_values.dup
  excluded = Array(exclude).map { |c| normalize_color(c) }
  choices.reject! { |c| excluded.include?(c) }
  return nil if choices.empty?

  if weights && !weights.empty?
    expanded = choices.flat_map do |color|
      weight = weights.fetch(color, weights.fetch(color.to_sym, 1)).to_i rescue 1
      weight = 1 if weight <= 0
      [color] * weight
    end
    return expanded.sample
  end

  choices.sample
end

#with_opacity(opacity, color) ⇒ Object

Raises:

  • (ArgumentError) 


102
103
104
105
106
107
 
# File 'lib/ruflet_ui/ruflet/colors.rb', line 102

def with_opacity(opacity, color)
  value = Float(opacity)
  raise ArgumentError, "opacity must be between 0.0 and 1.0 inclusive, got #{opacity}" unless value.between?(0.0, 1.0)

  "#{normalize_color(color)},#{value}"
end