admiral-tools-figma 0.0.1

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_component.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative 'figma_frame_info'
+
+class FigmaComponent
+  attr_accessor \
+    :key,
+    :file_key,
+    :node_id,
+    :name,
+    :description,
+    :containing_frame
+
+  def initialize(key:, file_key:, node_id:, name:, description:, containing_frame:)
+    @key = key
+    @file_key = file_key
+    @node_id = node_id
+    @name = name
+    @description = description
+    @containing_frame = containing_frame
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    key = hash['key']
+    file_key = hash['file_key']
+    node_id = hash['node_id']
+    name = hash['name']
+    description = hash['description']
+    containing_frame_hash = hash['containing_frame']
+    containing_frame = containing_frame_hash.nil? ? nil : FigmaFrameInfo.from_hash(containing_frame_hash)
+
+    if !key.nil? && !file_key.nil? && !node_id.nil? && !name.nil?
+      return FigmaComponent.new(
+        key: key,
+        file_key: file_key,
+        node_id: node_id,
+        name: name,
+        description: description,
+        containing_frame: containing_frame
+      )
+    end
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['key'] = key
+    hash['file_key'] = file_key
+    hash['node_id'] = node_id
+    hash['name'] = name
+    hash['description'] = description
+    hash['containing_frame'] = containing_frame.to
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_components_styles_meta.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'figma_style'
+require_relative 'figma_component'
+
+class FigmaComponentsStylesMeta
+  attr_accessor :styles, :components
+
+  def initialize(styles:, components:)
+    @styles = styles
+    @components = components
+  end
+
+  def self.from_hash(hash)
+    styles_hash = hash['styles']
+    components_hash = hash['components']
+
+    styles = styles_hash.nil? ? nil : styles_hash.map { |s| FigmaStyle.from_hash(s) }
+    components = components_hash.nil? ? nil : components_hash.map { |c| FigmaComponent.from_hash(c) }
+
+    FigmaComponentsStylesMeta.new(styles: styles, components: components)
+  end
+
+  def to_hash
+    hash = {}
+    hash['styles'] = styles.map(&:to_hash) unless styles.nil?
+    hash['components'] = components.map(&:to_hash) unless components.nil?
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_frame_info.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+class FigmaFrameInfo
+  attr_accessor \
+    :node_id,
+    :name,
+    :background_color,
+    :page_id,
+    :page_name
+
+  def initialize(node_id:, name:, background_color:, page_id:, page_name:)
+    @node_id = node_id
+    @name = name
+    @background_color = background_color
+    @page_id = page_id
+    @page_name = page_name
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    node_id = hash['nodeId']
+    name = hash['name']
+    background_color = hash['backgroundColor']
+    page_id = hash['pageId']
+    page_name = hash['pageName']
+    
+    FigmaFrameInfo.new(
+      node_id: node_id, 
+      name: name, 
+      background_color: background_color,
+      page_id: page_id,
+      page_name: page_name
+    )
+  end
+
+  def to_hash
+    hash = {}
+    hash['nodeId'] = node_id
+    hash['name'] = name
+    hash['backgroundColor'] = background_color
+    hash['pageId'] = page_id
+    hash['pageName'] = page_name
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_node.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative 'figma_paint'
+require_relative 'figma_type_style'
+
+class FigmaNode
+  attr_accessor :id, :name, :type, :style, :fills
+
+  def initialize(id:, name:, type:, style:, fills:)
+    @id = id
+    @name = name
+    @type = type
+    @style = style
+    @fills = fills
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    id = hash['id']
+    name = hash['name']
+    type = hash['type']
+    style_hash = hash['style']
+    style = style_hash.nil? ? nil : FigmaTypeStyle.from_hash(style_hash)
+    fills = (hash['fills'] || []).map { |f| FigmaPaint.from_hash(f) }.compact || []
+
+    if !id.nil? && !name.nil? && !type.nil?
+      return FigmaNode.new(id: id, name: name, type: type, style: style, fills: fills)
+    end
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['id'] = id
+    hash['name'] = name
+    hash['type'] = type
+    hash['style'] = style.to_hash unless style.nil?
+    hash['fills'] = (fills || []).map(&:to_hash)
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_paint.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative 'figma_color'
+
+class FigmaPaint
+  attr_accessor :type, :color, :opacity
+
+  def initialize(type:, color:, opacity:)
+    @type = type
+    @color = color
+    @opacity = opacity
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    type = hash['type']
+    color = FigmaColor.from_hash(hash['color'])
+    opacity = hash['opacity'] || 1.0
+
+    return FigmaPaint.new(type: type, color: color, opacity: opacity) if !type.nil? && !color.nil?
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['type'] = type
+    hash['color'] = color.to_hash unless color.nil?
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_style.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+FIGMA_STYLE_TYPE_FILL = 'FILL'
+FIGMA_STYLE_TYPE_TEXT = 'TEXT'
+
+class FigmaStyle
+  attr_accessor \
+    :name,
+    :node_id,
+    :style_type,
+    :description
+
+  def initialize(
+    name:,
+    node_id:,
+    style_type:,
+    description:
+  )
+    @name = name
+    @node_id = node_id
+    @style_type = style_type
+    @description = description
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    name = hash['name']
+    node_id = hash['node_id']
+    style_type = hash['style_type']
+    description = hash['description']
+
+    if !name.nil? && !node_id.nil? && style_type
+      return FigmaStyle.new(name: name, node_id: node_id, style_type: style_type, description: description)
+    end
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['name'] = name
+    hash['node_id'] = node_id
+    hash['style_type'] = style_type
+    hash['description'] = description
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/primitives/figma_type_style.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+class FigmaTypeStyle
+  attr_accessor \
+    :font_family,
+    :font_postscript_name,
+    :font_size,
+    :font_weight,
+    :letter_spacing
+
+  def initialize(
+    font_family:,
+    font_postscript_name:,
+    font_size:,
+    font_weight:,
+    letter_spacing:
+  )
+    @font_family = font_family
+    @font_postscript_name = font_postscript_name
+    @font_size = font_size
+    @font_weight = font_weight
+    @letter_spacing = letter_spacing
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    font_family = hash['fontFamily']
+    font_postscript_name = hash['fontPostScriptName']
+    font_size = hash['fontSize']
+    font_weight = hash['fontWeight']
+    letter_spacing = hash['letterSpacing']
+
+    if !font_family.nil? && !font_size.nil? && !font_weight.nil? && !letter_spacing.nil?
+      return FigmaTypeStyle.new(
+        font_family: font_family,
+        font_postscript_name: font_postscript_name,
+        font_size: font_size,
+        font_weight: font_weight,
+        letter_spacing: letter_spacing
+      )
+    end
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['fontFamily'] = font_family
+    hash['fontPostscriptName'] = font_postscript_name
+    hash['fontSize'] = font_size
+    hash['fontWeight'] = font_weight
+    hash['letterSpacing'] = letter_spacing
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/results/figma_components_styles_result.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative '../primitives/figma_components_styles_meta'
+
+class FigmaComponentsStylesResult
+  attr_accessor :error, :status, :meta
+
+  def initialize(error:, status:, meta:)
+    @error = error
+    @status = status
+    @meta = meta
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    error = hash['error']
+    status = hash['status']
+    meta_hash = hash['meta']
+    meta = meta_hash.nil? ? nil : FigmaComponentsStylesMeta.from_hash(meta_hash)
+
+    if !error.nil? && !status.nil? && !meta.nil?
+      return FigmaComponentsStylesResult.new(error: error, status: status, meta: meta)
+    end
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['error'] = error
+    hash['status'] = status
+    hash['meta'] = meta.to_hash unless meta.nil?
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/results/figma_images_result.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+class FigmaImagesResult
+  attr_accessor :error, :images
+
+  def initialize(error:, images:)
+    @error = error
+    @images = images || []
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    error = hash['err']
+    images = hash['images']
+    FigmaImagesResult.new(error: error, images: images)
+  end
+
+  def to_hash
+    hash = {}
+    hash['err'] = error
+    hash['images'] = images
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/api/results/figma_nodes_result.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative '../primitives/figma_node'
+
+class FigmaNodesResult
+  attr_accessor :name, :nodes
+
+  def initialize(name:, nodes:)
+    @name = name
+    @nodes = nodes
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    name = hash['name']
+    nodes = FigmaNodesResult.parse_nodes(hash: hash['nodes'])
+
+    return FigmaNodesResult.new(name: name, nodes: nodes) if !name.nil? && !nodes.nil?
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['name'] = name
+    nodes_hash = (nodes || {})
+    nodes_result_hash = {}
+
+    nodes_hash.each do |k, v|
+      node = v['document'].to_hash
+      nodes_result_hash[k] = { 'document' => node } unless node.nil?
+    end
+
+    hash['nodes'] = nodes_result_hash
+    hash
+  end
+
+  def self.parse_nodes(hash:)
+    return nil if hash.nil?
+
+    result_hash = {}
+
+    hash.each do |k, v|
+      node_hash = v['document']
+      node = FigmaNode.from_hash(node_hash)
+      result_hash[k] = { 'document' => node } unless node.nil?
+    end
+
+    result_hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/domain/converters/figma_to_domain_converter.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative '../../models'
+
+class FigmaToDomainConverter
+  def convert_figma_style(figma_style:)
+    return nil if figma_style.nil?
+
+    Style.new(
+      name: figma_style.name,
+      node_id: figma_style.node_id,
+      style_type: figma_style.style_type,
+      description: figma_style.description
+    )
+  end
+
+  def fulfill_styles(figma_nodes_result:, figma_styles_result:)
+    return [] if figma_nodes_result.nil? || figma_styles_result.nil?
+
+    styles = []
+    figma_styles = figma_styles_result&.meta&.styles || []
+    nodes = figma_nodes_result&.nodes || {}
+
+    figma_styles.each do |s|
+      style = convert_figma_style(figma_style: s)
+      node = nodes.dig(s.node_id, 'document')
+
+      case s.style_type
+      when FIGMA_STYLE_TYPE_FILL
+        fills = node&.fills
+        next if fills.nil?
+
+        figma_paint = fills[0]
+        next if figma_paint.nil?
+
+        style&.color = Color.new(
+          r: figma_paint.color.r,
+          g: figma_paint.color.g,
+          b: figma_paint.color.b,
+          a: figma_paint.opacity
+        )
+        styles.push(style)
+      when FIGMA_STYLE_TYPE_TEXT
+        type_style = node&.style
+        next if type_style.nil?
+
+        style&.font = Font.new(
+          font_family: type_style.font_family,
+          font_postscript_name: type_style.font_postscript_name,
+          font_size: type_style.font_size,
+          font_weight: type_style.font_weight,
+          letter_spacing: type_style.letter_spacing
+        )
+        styles.push(style)
+      else
+        next
+      end
+    end
+
+    styles
+  end
+
+  def fulfill_components(figma_components:, image_links_hash:, image_format:)
+    return [] if figma_components.nil? || image_links_hash.nil?
+
+    components = []
+    figma_components.each do |c|
+      component = Component.new(
+        key: c.key,
+        file_key: c.file_key,
+        node_id: c.node_id,
+        name: c.name,
+        description: c.description
+      )
+
+      component.containing_frame = FrameInfo.new(
+        node_id: c.containing_frame.node_id,
+        name: c.containing_frame.name,
+        background_color: c.containing_frame.background_color,
+        page_id: c.containing_frame.page_id,
+        page_name: c.containing_frame.page_name
+      )
+
+      image_links = []
+      image_links_hash.each do |key, link_hash|
+        link = link_hash[c.node_id]
+        if !link.nil? && !key.nil? && !image_format.nil?
+          image_link = ImageLink.new(link: link, scale: key, image_format: image_format)
+          image_links.push(image_link)
+        end
+      end
+      component.image_links = image_links
+      components.push(component)
+    end
+
+    components
+  end
+end

data/admiraltools/helper/figma/figma_client/models/domain/primitives/color.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+class Color
+  attr_accessor :r, :g, :b, :a
+
+  def hex
+    format('#%02x%02x%02x', *[r, g, b].map { |v| v.to_f * 255 }).upcase
+  end
+
+  def hex_with_alpha
+    format('#%02x%02x%02x%02x', *[a, r, g, b].map { |v| v.to_f * 255 }).upcase
+  end
+
+  def initialize(r:, g:, b:, a:)
+    @r = r
+    @g = g
+    @b = b
+    @a = a
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    r = hash['r']
+    g = hash['g']
+    b = hash['b']
+    a = hash['a']
+
+    return Color.new(r: r, g: g, b: b, a: a) if !r.nil? && !g.nil? && !b.nil? && !a.nil?
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['r'] = r
+    hash['g'] = g
+    hash['b'] = b
+    hash['a'] = a
+    hash['hex'] = hex
+    hash['hex_with_alpha'] = hex_with_alpha
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/domain/primitives/component.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative 'image_link'
+require_relative 'frame_info'
+
+class Component
+  attr_accessor \
+    :key,
+    :file_key,
+    :node_id,
+    :name,
+    :description,
+    :containing_frame,
+    :image_links
+
+  def single_scale?
+    links = image_links || []
+    return false if links.length > 1
+
+    link = links[0]
+    return false if link.nil?
+
+    image_format = link&.image_format
+    return false if image_format.nil?
+
+    scale = link.scale
+    image_format = image_format.downcase
+    scale == 1.0 && %w[svg pdf].include?(image_format)
+  end
+
+  def description_params
+    JSON.parse(description)
+  rescue StandardError
+    nil
+  end
+
+  def initialize(key:, file_key:, node_id:, name:, description:, containing_frame: nil, image_links: nil)
+    @key = key
+    @file_key = file_key
+    @node_id = node_id
+    @name = name
+    @description = description
+    @containing_frame = containing_frame
+    @image_links = image_links
+  end
+
+  def self.from_hash(hash)
+    return nil if hash.nil?
+
+    key = hash['key']
+    file_key = hash['file_key']
+    node_id = hash['node_id']
+    name = hash['name']
+    description = hash['description']
+    images_array = hash['image_links']
+    image_links = images_array&.map { |i| ImageLink.from_hash(i) }
+    containing_frame = FrameInfo.from_hash(hash['containing_frame'])
+
+    if !key.nil? && !file_key.nil? && !node_id.nil? && !name.nil?
+      return Component.new(
+        key: key,
+        file_key: file_key,
+        node_id: node_id,
+        name: name,
+        description: description,
+        containing_frame: containing_frame,
+        image_links: image_links
+      )
+    end
+
+    nil
+  end
+
+  def to_hash
+    hash = {}
+    hash['key'] = key
+    hash['file_key'] = file_key
+    hash['node_id'] = node_id
+    hash['name'] = name
+    hash['description'] = description
+    hash['image_links'] = image_links&.map { |i| i.to_hash } unless image_links.nil?
+    hash['description_params'] = description_params unless description_params.nil?
+    hash['containing_frame'] = containing_frame&.to_hash
+    hash
+  end
+end

data/admiraltools/helper/figma/figma_client/models/domain/primitives/components_list.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'json'
+require_relative 'component'
+
+class ComponentsList
+  attr_accessor :components
+
+  def initialize(components:)
+    @components = components
+  end
+
+  def self.from_hash(hash)
+    hash.map { |s| Component.from_hash(s) }
+  end
+
+  def to_hash
+    components.map(&:to_hash)
+  end
+
+  def self.from_json(json)
+    components = (JSON.parse(json) || []).map { |s| Component.from_hash(s) }
+    ComponentsList.new(components: components)
+  end
+
+  def to_json(*_args)
+    components.map(&:to_hash).to_json
+  end
+end