openproject-primer_view_components 0.8.0 → 0.9.0

data/app/components/primer/open_project/page_header.css

@@ -0,0 +1 @@
+.PageHeader{border-bottom:var(--borderWidth-thin,max(1px,.0625rem)) solid var(--borderColor-muted,var(--color-border-muted));display:flex;flex-flow:row wrap;justify-content:flex-end;margin-bottom:var(--stack-gap-normal,1rem);padding-bottom:var(--stack-padding-condensed,.5rem)}.PageHeader-title{flex:1 1 auto;order:0}.PageHeader-description{color:var(--fgColor-muted,var(--color-fg-muted));flex:1 100%;font-size:var(--text-body-size-medium,.875rem);order:2}.PageHeader-actions{align-self:center;justify-content:flex-end;margin:var(--base-size-4,.25rem) 0 var(--base-size-4,.25rem) var(--base-size-4,.25rem);order:1}.PageHeader-actions+.PageHeader-description{margin-top:var(--base-size-4,.25rem)}

data/app/components/primer/open_project/page_header.css.json

@@ -0,0 +1,10 @@
+{
+  "name": "open_project/page_header",
+  "selectors": [
+    ".PageHeader",
+    ".PageHeader-title",
+    ".PageHeader-description",
+    ".PageHeader-actions",
+    ".PageHeader-actions+.PageHeader-description"
+  ]
+}

data/app/components/primer/open_project/page_header.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["page_header.pcss"],"names":[],"mappings":"AAEA,YAIE,gHAAqE,CAHrE,YAAa,CAIb,kBAAmB,CACnB,wBAAyB,CAHzB,0CAAsC,CADtC,mDAKF,CAGA,kBACE,aAAc,CACd,OACF,CAGA,wBAEE,gDAA2B,CAC3B,WAAY,CAFZ,8CAAuC,CAGvC,OACF,CAGA,oBAEE,iBAAkB,CAClB,wBAAyB,CAFzB,sFAAkE,CAGlE,OAKF,CAHE,4CACE,oCACF","file":"page_header.css","sourcesContent":["/* OP PageHeader */\n\n.PageHeader {\n  display: flex;\n  padding-bottom: var(--stack-padding-condensed);\n  margin-bottom: var(--stack-gap-normal);\n  border-bottom: var(--borderWidth-thin) solid var(--borderColor-muted);\n  flex-flow: row wrap;\n  justify-content: flex-end; /* Keep actions right aligned. */\n}\n\n/* <h2> sized heading with normal font weight */\n.PageHeader-title {\n  flex: 1 1 auto;\n  order: 0;\n}\n\n/* One-liner of supporting text */\n.PageHeader-description {\n  font-size: var(--text-body-size-medium);\n  color: var(--fgColor-muted);\n  flex: 1 100%;\n  order: 2;\n}\n\n/* Add 1 or 2 buttons to the right of the heading */\n.PageHeader-actions {\n  margin: var(--base-size-4) 0 var(--base-size-4) var(--base-size-4);\n  align-self: center;\n  justify-content: flex-end;\n  order: 1;\n\n  & + .PageHeader-description {\n    margin-top: var(--base-size-4);\n  }\n}\n"]}

data/app/components/primer/open_project/page_header.html.erb

@@ -0,0 +1,5 @@
+<%= render Primer::BaseComponent.new(**@system_arguments) do %>
+  <%= title %>
+  <%= description %>
+  <%= actions %>
+<% end %>

data/app/components/primer/open_project/page_header.pcss

@@ -0,0 +1,36 @@
+/* OP PageHeader */
+
+.PageHeader {
+  display: flex;
+  padding-bottom: var(--stack-padding-condensed);
+  margin-bottom: var(--stack-gap-normal);
+  border-bottom: var(--borderWidth-thin) solid var(--borderColor-muted);
+  flex-flow: row wrap;
+  justify-content: flex-end; /* Keep actions right aligned. */
+}
+
+/* <h2> sized heading with normal font weight */
+.PageHeader-title {
+  flex: 1 1 auto;
+  order: 0;
+}
+
+/* One-liner of supporting text */
+.PageHeader-description {
+  font-size: var(--text-body-size-medium);
+  color: var(--fgColor-muted);
+  flex: 1 100%;
+  order: 2;
+}
+
+/* Add 1 or 2 buttons to the right of the heading */
+.PageHeader-actions {
+  margin: var(--base-size-4) 0 var(--base-size-4) var(--base-size-4);
+  align-self: center;
+  justify-content: flex-end;
+  order: 1;
+
+  & + .PageHeader-description {
+    margin-top: var(--base-size-4);
+  }
+}

data/app/components/primer/open_project/page_header.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Primer
+  module OpenProject
+    # A ViewComponent PageHeader inspired by the primer react variant
+    class PageHeader < Primer::Component
+      HEADING_TAG_OPTIONS = [:h1, :h2, :h3, :h4, :h5, :h6].freeze
+      HEADING_TAG_FALLBACK = :h1
+
+      status :open_project
+
+      # The title of the page header
+      #
+      # @param tag [Symbol] <%= one_of(Primer::Beta::Heading::TAG_OPTIONS) %>
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      renders_one :title, lambda { |tag: :h1, **system_arguments|
+        system_arguments[:tag] = fetch_or_fallback(HEADING_TAG_OPTIONS, tag, HEADING_TAG_FALLBACK)
+        system_arguments[:classes] = class_names(system_arguments[:classes], "PageHeader-title")
+
+        Primer::BaseComponent.new(**system_arguments)
+      }
+
+      # Optional description below the title row
+      renders_one :description, lambda { |**system_arguments|
+        deny_tag_argument(**system_arguments)
+        system_arguments[:tag] = :div
+        system_arguments[:classes] = class_names(system_arguments[:classes], "PageHeader-description")
+
+        Primer::BaseComponent.new(**system_arguments)
+      }
+
+      # Actions
+      #
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      renders_one :actions, lambda { |**system_arguments|
+        deny_tag_argument(**system_arguments)
+        system_arguments[:tag] = :div
+        system_arguments[:classes] = class_names(system_arguments[:classes], "PageHeader-actions")
+
+        Primer::BaseComponent.new(**system_arguments)
+      }
+
+      def initialize(**system_arguments)
+        @system_arguments = deny_tag_argument(**system_arguments)
+
+        @system_arguments[:tag] = :header
+        @system_arguments[:classes] =
+          class_names(
+            @system_arguments[:classes],
+            "PageHeader"
+          )
+      end
+
+      def render?
+        title?
+      end
+    end
+  end
+end

data/app/components/primer/primer.pcss

@@ -40,3 +40,6 @@
 @import "./beta/timeline_item.pcss";
 @import "./truncate.pcss";
 @import "./alpha/action_bar.pcss";
+
+/* OP specifics */
+@import "./open_project/page_header.pcss";

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

@@ -21,7 +21,8 @@ module Primer
         beta: :beta,
         stable: :stable,
         deprecated: :deprecated,
-        experimental: :experimental
+        experimental: :experimental,
+        open_project: :open_project
       }.freeze
 
       class UnknownStatusError < StandardError; end

data/lib/primer/view_components/version.rb

@@ -5,7 +5,7 @@ module Primer
   module ViewComponents
     module VERSION
       MAJOR = 0
-      MINOR = 8
+      MINOR = 9
       PATCH = 0
 
       STRING = [MAJOR, MINOR, PATCH].join(".")

data/previews/primer/open_project/page_header_preview/actions.html.erb

@@ -0,0 +1,22 @@
+<%= render(Primer::OpenProject::PageHeader.new) do |component| %>
+  <% component.with_title(tag: :h1) do %>
+    A title
+  <% end %>
+  <% component.with_description do %>
+    A description with actions
+  <% end %>
+  <% component.with_actions do %>
+    <%= render(Primer::Alpha::ActionMenu.new) do |component| %>
+      <% component.with_show_button { "Menu" } %>
+      <% component.with_item(label: "Item", tag: :button, value: "") %>
+      <% component.with_item(
+           label: "Show dialog",
+           tag: :button,
+           content_arguments: { "data-show-dialog-id": "my-dialog" },
+           value: "",
+           scheme: :danger
+         ) %>
+    <% end %>
+  <% end %>
+<% end %>
+

data/previews/primer/open_project/page_header_preview.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Primer
+  module OpenProject
+    # @component Primer::OpenProject::PageHeader
+    # @label Page Header
+    class PageHeaderPreview < ViewComponent::Preview
+      # @label Default
+      # @snapshot
+      def default
+        render(Primer::OpenProject::PageHeader.new) do |header|
+          header.with_title { "Hello" }
+          header.with_description { "Last updated 5 minutes ago by XYZ." }
+        end
+      end
+
+
+      # @label Playground
+      #
+      def playground
+        render(Primer::OpenProject::PageHeader.new) do |header|
+          header.with_title { "Hello" }
+          header.with_description { "Last updated 5 minutes ago by XYZ." }
+        end
+      end
+
+      # @label With actions
+      def actions
+        render_with_template(locals: {})
+      end
+    end
+  end
+end

data/static/classes.json

@@ -411,6 +411,18 @@
   "Overlay-header": [
     "Primer::Alpha::Dialog"
   ],
+  "PageHeader": [
+    "Primer::OpenProject::PageHeader"
+  ],
+  "PageHeader-actions": [
+    "Primer::OpenProject::PageHeader"
+  ],
+  "PageHeader-description": [
+    "Primer::OpenProject::PageHeader"
+  ],
+  "PageHeader-title": [
+    "Primer::OpenProject::PageHeader"
+  ],
   "Popover": [
     "Primer::Beta::Popover"
   ],

data/static/previews.json

@@ -4432,6 +4432,53 @@
       }
     ]
   },
+  {
+    "name": "page_header",
+    "component": "PageHeader",
+    "status": "openproject",
+    "lookup_path": "primer/open_project/page_header",
+    "examples": [
+      {
+        "preview_path": "primer/open_project/page_header/playground",
+        "name": "playground",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/open_project/page_header/default",
+        "name": "default",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      },
+      {
+        "preview_path": "primer/open_project/page_header/actions",
+        "name": "actions",
+        "snapshot": "true",
+        "skip_rules": {
+          "wont_fix": [
+            "region"
+          ],
+          "will_fix": [
+            "color-contrast"
+          ]
+        }
+      }
+    ]
+  },
   {
     "name": "popover",
     "component": "Popover",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openproject-primer_view_components
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - GitHub Open Source
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-04 00:00:00.000000000 Z
+date: 2023-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -45,14 +45,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 19.6.7
+        version: 19.7.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 19.6.7
+        version: 19.7.0
 - !ruby/object:Gem::Dependency
   name: view_component
   requirement: !ruby/object:Gem::Requirement
@@ -746,6 +746,12 @@ files:
 - app/components/primer/layout_component.html.erb
 - app/components/primer/layout_component.rb
 - app/components/primer/navigation/tab_component.rb
+- app/components/primer/open_project/page_header.css
+- app/components/primer/open_project/page_header.css.json
+- app/components/primer/open_project/page_header.css.map
+- app/components/primer/open_project/page_header.html.erb
+- app/components/primer/open_project/page_header.pcss
+- app/components/primer/open_project/page_header.rb
 - app/components/primer/primer.d.ts
 - app/components/primer/primer.js
 - app/components/primer/primer.pcss
@@ -1110,6 +1116,8 @@ files:
 - previews/primer/forms_preview/single_text_field_form.html.erb
 - previews/primer/forms_preview/submit_button_form.html.erb
 - previews/primer/forms_preview/text_field_and_checkbox_form.html.erb
+- previews/primer/open_project/page_header_preview.rb
+- previews/primer/open_project/page_header_preview/actions.html.erb
 - previews/primer/url_helpers.rb
 - static/arguments.json
 - static/assets/view-components.svg