Class: Primer::Yard::ComponentManifest

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/primer/yard/component_manifest.rb

Overview

The set of documented components (and associated metadata).

Constant Summary collapse

COMPONENTS = 
{
  Primer::Beta::RelativeTime => {},
  Primer::Beta::IconButton => {},
  Primer::Beta::Button => {},
  Primer::Alpha::SegmentedControl => {},
  Primer::Alpha::Layout => {},
  Primer::Alpha::HellipButton => {},
  Primer::Alpha::Image => {},
  Primer::Alpha::OcticonSymbols => {},
  Primer::Alpha::ImageCrop => { js: true },
  Primer::IconButton => { js: true },
  Primer::Beta::AutoComplete => { js: true },
  Primer::Beta::AutoComplete::Item => {},
  Primer::Beta::Avatar => {},
  Primer::Beta::AvatarStack => {},
  Primer::Beta::BaseButton => {},
  Primer::Alpha::Banner => { js: true },
  Primer::Beta::Blankslate => {},
  Primer::BlankslateComponent => {},
  Primer::Beta::BorderBox => {},
  Primer::Beta::BorderBox::Header => {},
  Primer::Box => {},
  Primer::Beta::Breadcrumbs => {},
  Primer::ButtonComponent => { js: true },
  Primer::Beta::ButtonGroup => {},
  Primer::Alpha::ButtonMarketing => {},
  Primer::Beta::ClipboardCopy => { js: true },
  Primer::Beta::CloseButton => {},
  Primer::Beta::Counter => {},
  Primer::Beta::Details => {},
  Primer::Alpha::Dialog => {},
  Primer::Alpha::Dropdown => { js: true },
  Primer::Beta::Flash => {},
  Primer::Beta::Heading => {},
  Primer::Alpha::HiddenTextExpander => {},
  Primer::Beta::Label => {},
  Primer::LayoutComponent => {},
  Primer::Beta::Link => { js: true },
  Primer::Beta::Markdown => {},
  Primer::Alpha::Menu => {},
  Primer::Navigation::TabComponent => {},
  Primer::Alpha::Navigation::Tab => {},
  Primer::Beta::Octicon => {},
  Primer::Beta::Popover => {},
  Primer::Beta::ProgressBar => {},
  Primer::Beta::State => {},
  Primer::Beta::Spinner => {},
  Primer::Beta::Subhead => {},
  Primer::Alpha::TabContainer => { js: true },
  Primer::Beta::Text => {},
  Primer::Beta::TimelineItem => {},
  Primer::Tooltip => {},
  Primer::Truncate => {},
  Primer::Beta::Truncate => {},
  Primer::Alpha::UnderlineNav => {},
  Primer::Alpha::UnderlinePanels => { js: true },
  Primer::Alpha::TabNav => {},
  Primer::Alpha::TabPanels => { js: true },
  Primer::Alpha::Tooltip => { js: true },
  Primer::Alpha::ToggleSwitch => { js: true },
  Primer::Alpha::Overlay => { js: true },
  Primer::Alpha::ActionMenu => { js: true },

  # Examples can be seen in the NavList docs
  Primer::Alpha::NavList => { js: true },
  Primer::Alpha::NavList::Item => { js: true, examples: false },
  Primer::Alpha::NavList::Group => { js: true, examples: false },

  Primer::Beta::NavList => { js: true },
  Primer::Beta::NavList::Item => { js: true, examples: false },
  Primer::Beta::NavList::Group => { js: true, examples: false },

  # ActionList is a base component that should not be used by itself, and thus
  # does not have examples of its own
  Primer::Alpha::ActionList => { js: true, examples: false },
  Primer::Alpha::ActionList::Divider => { examples: false },
  Primer::Alpha::ActionList::Heading => { examples: false },
  Primer::Alpha::ActionList::Item => { examples: false },

  # Forms
  Primer::Alpha::TextField => { form_component: true },
  Primer::Alpha::TextArea => { form_component: true, published: false },
  Primer::Alpha::Select => { form_component: true, published: false },
  Primer::Alpha::MultiInput => { form_component: true, js: true, published: false },
  Primer::Alpha::RadioButton => { form_component: true, published: false },
  Primer::Alpha::RadioButtonGroup => { form_component: true, published: false },
  Primer::Alpha::CheckBox => { form_component: true, published: false },
  Primer::Alpha::CheckBoxGroup => { form_component: true, published: false },
  Primer::Alpha::SubmitButton => { form_component: true, published: false },
  Primer::Alpha::FormButton => { form_component: true, published: false }
}.freeze

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(components) ⇒ ComponentManifest

Returns a new instance of ComponentManifest.



102
103
104
 
# File 'lib/primer/yard/component_manifest.rb', line 102

def initialize(components)
  @components = components
end

Class Method Details

.all ⇒ Object 



131
132
133
 
# File 'lib/primer/yard/component_manifest.rb', line 131

def all
  new(COMPONENTS.keys)
end

.ref_for(klass) ⇒ Object 



135
136
137
 
# File 'lib/primer/yard/component_manifest.rb', line 135

def ref_for(klass)
  ref_cache[klass] ||= ComponentRef.new(klass, COMPONENTS.fetch(klass, {}))
end

.where(components = COMPONENTS, **desired_attrs) ⇒ Object 



119
120
121
122
123
124
125
126
127
128
129
 
# File 'lib/primer/yard/component_manifest.rb', line 119

def where(components = COMPONENTS, **desired_attrs)
  new(
    components.each_with_object([]) do |(klass, component_attrs), memo|
      matches = desired_attrs.all? do |name, desired_value|
        component_attrs.fetch(name, ComponentRef::ATTR_DEFAULTS[name]) == desired_value
      end

      memo << klass if matches
    end
  )
end

Instance Method Details

#each ⇒ Object 



106
107
108
109
110
111
112
 
# File 'lib/primer/yard/component_manifest.rb', line 106

def each
  return to_enum(__method__) unless block_given?

  @components.each do |klass|
    yield self.class.ref_for(klass)
  end
end

#where(**attrs) ⇒ Object 



114
115
116
 
# File 'lib/primer/yard/component_manifest.rb', line 114

def where(**attrs)
  self.class.where(@components, **attrs)
end