primer_view_components 0.0.17 → 0.0.22

data/app/lib/primer/classify/cache.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Primer
+  class Classify
+    # :nodoc:
+    class Cache
+      # rubocop:disable Style/MutableConstant
+      LOOKUP = {}
+      # rubocop:enable Style/MutableConstant
+
+      class <<self
+        def read(memo, key, val, breakpoint)
+          value = LOOKUP.dig(breakpoint, key, val)
+          memo[:classes] << value if value
+        end
+
+        def clear!
+          LOOKUP.clear
+        end
+
+        def preload!
+          preload(
+            keys: Primer::Classify::MARGIN_DIRECTION_KEYS,
+            values: [-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6]
+          )
+
+          preload(
+            keys: (Primer::Classify::SPACING_KEYS - Primer::Classify::MARGIN_DIRECTION_KEYS),
+            values: [0, 1, 2, 3, 4, 5, 6]
+          )
+
+          preload(
+            keys: Primer::Classify::DIRECTION_KEY,
+            values: [:row, :column]
+          )
+
+          preload(
+            keys: Primer::Classify::JUSTIFY_CONTENT_KEY,
+            values: [:flex_start, :flex_end, :center, :space_between, :space_around]
+          )
+
+          preload(
+            keys: Primer::Classify::ALIGN_ITEMS_KEY,
+            values: [:flex_start, :flex_end, :center, :baseline, :stretch]
+          )
+
+          preload(
+            keys: Primer::Classify::DISPLAY_KEY,
+            values: [:flex, :block, :inline_block, :inline_flex, :none, :table, :table_cell]
+          )
+
+          preload(
+            keys: [Primer::Classify::COLOR_KEY, Primer::Classify::BG_KEY],
+            values: [:blue, :gray_dark, :gray, :gray_light, :red, :orange, :orange_light, :yellow, :green, :purple, :white, :pink]
+          )
+
+          preload(
+            keys: Primer::Classify::VERTICAL_ALIGN_KEY,
+            values: [:baseline, :top, :middle, :bottom, :text_top, :text_bottom]
+          )
+
+          preload(
+            keys: Primer::Classify::WORD_BREAK_KEY,
+            values: [:break_all]
+          )
+
+          preload(
+            keys: :text_align,
+            values: [:left, :center, :right]
+          )
+
+          preload(
+            keys: :font_weight,
+            values: [:bold, :light, :normal]
+          )
+
+          preload(
+            keys: Primer::Classify::FLEX_KEY,
+            values: [1, :auto]
+          )
+
+          preload(
+            keys: [Primer::Classify::FLEX_GROW_KEY, Primer::Classify::FLEX_SHRINK_KEY],
+            values: [0]
+          )
+
+          preload(
+            keys: [Primer::Classify::ALIGN_SELF_KEY],
+            values: [:auto, :start, :end, :center, :baseline, :stretch]
+          )
+
+          preload(
+            keys: [Primer::Classify::WIDTH_KEY, Primer::Classify::HEIGHT_KEY],
+            values: [:fit, :fill]
+          )
+
+          preload(
+            keys: Primer::Classify::BOX_SHADOW_KEY,
+            values: [true, :medium, :large, :extra_large, :none]
+          )
+
+          preload(
+            keys: Primer::Classify::VISIBILITY_KEY,
+            values: [:hidden, :visible]
+          )
+        end
+
+        def preload(keys:, values:)
+          BREAKPOINTS.each do |breakpoint|
+            Array(keys).each do |key|
+              values.each do |value|
+                classes = { classes: [] }
+                Primer::Classify.send(:extract_value, classes, key, value, breakpoint)
+
+                LOOKUP[breakpoint] ||= {}
+                LOOKUP[breakpoint][key] ||= {}
+                LOOKUP[breakpoint][key][value] = classes[:classes].first
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/{lib → app/lib}/primer/fetch_or_fallback_helper.rb

@@ -14,6 +14,7 @@
 # fetch_or_fallback([1,2,3], 1, 2) => 1
 # fetch_or_fallback([1,2,3], nil, 2) => 2
 module Primer
+  # :nodoc:
   module FetchOrFallbackHelper
     mattr_accessor :fallback_raises, default: true
 

data/{lib → app/lib}/primer/join_style_arguments_helper.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Primer
+  # :nodoc:
   module JoinStyleArgumentsHelper
     # Join two `style` arguments
     #

data/app/lib/primer/view_helper.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Primer
+  # Module to allow shorthand calls for registered Primer components
+  #
+  # Registered components can be called with
+  # `primer(:name, **kwargs) { block }` instead of
+  # `render Primer::NameComponent.new(**kwargs) { block }`
+  module ViewHelper
+    extend ActiveSupport::Concern
+
+    class ViewHelperNotFound < StandardError; end
+
+    def primer(name, **component_args, &block)
+      component = Primer::Component.primer_helpers[name]
+
+      raise ViewHelperNotFound, "no component defined for helper #{name}" if component.blank?
+
+      render component.new(**component_args), &block
+    end
+  end
+end

data/app/lib/primer/view_helper/dsl.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module Primer
+  # :nodoc:
+  module ViewHelper
+    # DSL to allow components to register a View Helper for shorthand calls.
+    #
+    # Example:
+    #
+    # class MyComponent < ViewComponent::Base
+    #   include Primer::ViewHelper::DSL
+    #   view_helper :my_component
+    # end
+    module DSL
+      extend ActiveSupport::Concern
+
+      class ViewHelperAlreadyDefined < StandardError; end
+
+      included do
+        class_attribute :primer_helpers, instance_writer: false, default: {}
+      end
+
+      class_methods do
+        def view_helper(name)
+          raise ViewHelperAlreadyDefined, "#{name} is already defined" if primer_helpers[name].present?
+
+          primer_helpers[name] = self
+        end
+      end
+    end
+  end
+end

data/lib/primer/view_components.rb

@@ -4,6 +4,38 @@ require "primer/view_components/version"
 require "primer/view_components/engine"
 
 module Primer
+  # :nodoc:
   module ViewComponents
+    DEFAULT_STATUSES_PATH = File.expand_path("static")
+    DEFAULT_STATUS_FILE_NAME = "statuses.json"
+
+    # generate_statuses returns a hash mapping component name to
+    # the component's status sorted alphabetically by the component name.
+    def self.generate_statuses
+      statuses = Primer::Component.descendants.each_with_object({}) do |component, mem|
+        mem[component.to_s] = component.status.to_s
+      end
+
+      statuses.sort_by { |k, _v| k }.to_h
+    end
+
+    # dump_statuses generates the status hash and then serializes
+    # it as json at the given path
+    def self.dump_statuses(path: DEFAULT_STATUSES_PATH)
+      require "json"
+
+      statuses = generate_statuses
+
+      File.open(File.join(path, DEFAULT_STATUS_FILE_NAME), "w") do |f|
+        f.write(statuses.to_json)
+        f.write($INPUT_RECORD_SEPARATOR)
+      end
+    end
+
+    # read_statuses returns a JSON string matching the output of
+    # generate_statuses
+    def self.read_statuses(path: DEFAULT_STATUSES_PATH)
+      File.read(File.join(path, DEFAULT_STATUS_FILE_NAME))
+    end
   end
 end

data/lib/primer/view_components/engine.rb

@@ -1,11 +1,20 @@
 # frozen_string_literal: true
 
+require "rails/engine"
+
 module Primer
   module ViewComponents
+    # :nodoc:
     class Engine < ::Rails::Engine
       isolate_namespace Primer::ViewComponents
+      config.autoload_once_paths = %W[
+        #{root}/app/components
+        #{root}/app/lib
+      ]
+
+      initializer "primer_view_components.assets" do |app|
+        app.config.assets.precompile += %w[primer_view_components] if app.config.respond_to?(:assets)
+      end
     end
   end
 end
-
-require "#{Primer::ViewComponents::Engine.root}/app/components/primer/view_components.rb"

data/lib/primer/view_components/version.rb

@@ -5,9 +5,13 @@ module Primer
     module VERSION
       MAJOR = 0
       MINOR = 0
-      PATCH = 17
+      PATCH = 22
 
       STRING = [MAJOR, MINOR, PATCH].join(".")
     end
   end
 end
+
+# rubocop:disable Rails/Output
+puts Primer::ViewComponents::VERSION::STRING if __FILE__ == $PROGRAM_NAME
+# rubocop:enable Rails/Output

data/lib/yard/renders_many_handler.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module YARD
+  # YARD Handler to parse `renders_many` calls.
+  class RendersManyHandler < YARD::Handlers::Ruby::Base
+    handles method_call(:renders_many)
+    namespace_only
+
+    process do
+      name = statement.parameters.first.jump(:tstring_content, :ident).source
+      object = YARD::CodeObjects::MethodObject.new(namespace, name)
+      register(object)
+      parse_block(statement.last, owner: object)
+
+      object.dynamic = true
+      object[:renders_many] = true
+    end
+  end
+end

data/lib/yard/renders_one_handler.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module YARD
+  # YARD Handler to parse `renders_one` calls.
+  class RendersOneHandler < YARD::Handlers::Ruby::Base
+    handles method_call(:renders_one)
+    namespace_only
+
+    process do
+      name = statement.parameters.first.jump(:tstring_content, :ident).source
+      object = YARD::CodeObjects::MethodObject.new(namespace, name)
+      register(object)
+      parse_block(statement.last, owner: object)
+
+      object.dynamic = true
+      object[:renders_one] = true
+    end
+  end
+end

data/static/statuses.json

@@ -0,0 +1 @@
+{"Primer::AvatarComponent":"beta","Primer::AvatarStackComponent":"alpha","Primer::BaseComponent":"alpha","Primer::BlankslateComponent":"alpha","Primer::BorderBoxComponent":"beta","Primer::BoxComponent":"stable","Primer::BreadcrumbComponent":"alpha","Primer::ButtonComponent":"alpha","Primer::ButtonGroupComponent":"alpha","Primer::ButtonMarketingComponent":"alpha","Primer::CounterComponent":"beta","Primer::DetailsComponent":"alpha","Primer::Dropdown::MenuComponent":"alpha","Primer::DropdownComponent":"alpha","Primer::DropdownMenuComponent":"deprecated","Primer::FlashComponent":"beta","Primer::FlexComponent":"alpha","Primer::FlexItemComponent":"alpha","Primer::HeadingComponent":"alpha","Primer::LabelComponent":"alpha","Primer::LayoutComponent":"alpha","Primer::LinkComponent":"beta","Primer::MarkdownComponent":"alpha","Primer::MenuComponent":"alpha","Primer::OcticonComponent":"beta","Primer::PopoverComponent":"alpha","Primer::ProgressBarComponent":"alpha","Primer::SpinnerComponent":"beta","Primer::StateComponent":"beta","Primer::SubheadComponent":"alpha","Primer::TabContainerComponent":"alpha","Primer::TabNavComponent":"alpha","Primer::TabNavComponent::TabComponent":"alpha","Primer::TextComponent":"alpha","Primer::TimelineItemComponent":"alpha","Primer::TimelineItemComponent::BadgeComponent":"alpha","Primer::TooltipComponent":"alpha","Primer::TruncateComponent":"alpha","Primer::UnderlineNavComponent":"alpha"}

metadata

@@ -1,15 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: primer_view_components
 version: !ruby/object:Gem::Version
-  version: 0.0.17
+  version: 0.0.22
 platform: ruby
 authors:
 - GitHub Open Source
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-10 00:00:00.000000000 Z
+date: 2021-03-01 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: octicons_helper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 9.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 13.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 9.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 13.0.0
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -51,25 +71,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: octicons_helper
+  name: allocation_tracer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 9.0.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 12.0.0
-  type: :runtime
+        version: 0.6.3
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 9.0.0
-    - - "<"
+        version: 0.6.3
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 12.0.0
+        version: 2.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.8.4
 - !ruby/object:Gem::Dependency
   name: listen
   requirement: !ruby/object:Gem::Requirement
@@ -118,28 +146,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '0.74'
+        version: '0.82'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '0.74'
+        version: '0.82'
 - !ruby/object:Gem::Dependency
   name: rubocop-github
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: 0.16.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -192,7 +234,11 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- app/assets/javascripts/primer_view_components.js
+- app/assets/javascripts/primer_view_components.js.map
 - app/components/primer/avatar_component.rb
+- app/components/primer/avatar_stack_component.html.erb
+- app/components/primer/avatar_stack_component.rb
 - app/components/primer/base_component.rb
 - app/components/primer/blankslate_component.html.erb
 - app/components/primer/blankslate_component.rb
@@ -202,10 +248,17 @@ files:
 - app/components/primer/breadcrumb_component.html.erb
 - app/components/primer/breadcrumb_component.rb
 - app/components/primer/button_component.rb
+- app/components/primer/button_group_component.html.erb
+- app/components/primer/button_group_component.rb
+- app/components/primer/button_marketing_component.rb
 - app/components/primer/component.rb
 - app/components/primer/counter_component.rb
 - app/components/primer/details_component.html.erb
 - app/components/primer/details_component.rb
+- app/components/primer/dropdown/menu_component.html.erb
+- app/components/primer/dropdown/menu_component.rb
+- app/components/primer/dropdown_component.html.erb
+- app/components/primer/dropdown_component.rb
 - app/components/primer/dropdown_menu_component.html.erb
 - app/components/primer/dropdown_menu_component.rb
 - app/components/primer/flash_component.html.erb
@@ -217,9 +270,14 @@ files:
 - app/components/primer/layout_component.html.erb
 - app/components/primer/layout_component.rb
 - app/components/primer/link_component.rb
+- app/components/primer/markdown_component.rb
+- app/components/primer/menu_component.html.erb
+- app/components/primer/menu_component.rb
 - app/components/primer/octicon_component.rb
 - app/components/primer/popover_component.html.erb
 - app/components/primer/popover_component.rb
+- app/components/primer/primer.js
+- app/components/primer/primer.ts
 - app/components/primer/progress_bar_component.html.erb
 - app/components/primer/progress_bar_component.rb
 - app/components/primer/slot.rb
@@ -228,19 +286,31 @@ files:
 - app/components/primer/state_component.rb
 - app/components/primer/subhead_component.html.erb
 - app/components/primer/subhead_component.rb
+- app/components/primer/tab_container_component.js
+- app/components/primer/tab_container_component.rb
+- app/components/primer/tab_container_component.ts
+- app/components/primer/tab_nav_component.html.erb
+- app/components/primer/tab_nav_component.rb
 - app/components/primer/text_component.rb
 - app/components/primer/timeline_item_component.html.erb
 - app/components/primer/timeline_item_component.rb
+- app/components/primer/tooltip_component.rb
+- app/components/primer/truncate_component.rb
 - app/components/primer/underline_nav_component.html.erb
 - app/components/primer/underline_nav_component.rb
-- app/components/primer/view_components.rb
-- lib/primer/class_name_helper.rb
-- lib/primer/classify.rb
-- lib/primer/fetch_or_fallback_helper.rb
-- lib/primer/join_style_arguments_helper.rb
+- app/lib/primer/class_name_helper.rb
+- app/lib/primer/classify.rb
+- app/lib/primer/classify/cache.rb
+- app/lib/primer/fetch_or_fallback_helper.rb
+- app/lib/primer/join_style_arguments_helper.rb
+- app/lib/primer/view_helper.rb
+- app/lib/primer/view_helper/dsl.rb
 - lib/primer/view_components.rb
 - lib/primer/view_components/engine.rb
 - lib/primer/view_components/version.rb
+- lib/yard/renders_many_handler.rb
+- lib/yard/renders_one_handler.rb
+- static/statuses.json
 homepage: https://github.com/primer/view_components
 licenses:
 - MIT
@@ -254,14 +324,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: ViewComponents for the Primer Design System