scope release-notes scss to component and reduce custom styles (#20847)

components/release-notes/GHAEReleaseNotes.tsx

@@ -1,4 +1,4 @@
-import { useState } from 'react'
+import { SyntheticEvent, useState } from 'react'
 import cx from 'classnames'
 import { ChevronDownIcon } from '@primer/octicons-react'
 import { GHAEReleaseNotePatch } from './GHAEReleaseNotePatch'
@@ -41,44 +41,11 @@ export function GHAEReleaseNotes({ context }: GitHubAEProps) {
           <ul className="list-style-none pl-0 text-bold">
             {releases.map((release) => {
               return (
-                <li key={release.version} className="border-bottom">
-                  <details
-                    className="my-0 details-reset release-notes-version-picker"
-                    aria-current="page"
-                    open
-                  >
-                    <summary className="px-3 py-4 my-0 d-flex flex-items-center flex-justify-between">
-                      {release.version}
-                      <div className="d-flex">
-                        <span className="color-text-tertiary text-mono text-small text-normal mr-1">
-                          {release.patches.length} releases
-                        </span>
-                        <ChevronDownIcon />
-                      </div>
-                    </summary>
-                    <ul className="color-bg-tertiary border-top list-style-none py-4 px-0 my-0">
-                      {release.patches.map((patch) => {
-                        const isActive = patch.version === focusedPatch
-                        return (
-                          <li
-                            key={patch.version}
-                            className={cx(
-                              'js-release-notes-patch-link px-3 my-0 py-1',
-                              isActive && 'selected'
-                            )}
-                          >
-                            <a
-                              href={`#${patch.date}`}
-                              className="d-flex flex-items-center flex-justify-between"
-                            >
-                              {patch.friendlyDate}
-                            </a>
-                          </li>
-                        )
-                      })}
-                    </ul>
-                  </details>
-                </li>
+                <CollapsibleReleaseSection
+                  key={release.version}
+                  release={release}
+                  focusedPatch={focusedPatch}
+                />
               )
             })}
           </ul>
@@ -87,3 +54,55 @@ export function GHAEReleaseNotes({ context }: GitHubAEProps) {
     </div>
   )
 }
+
+const CollapsibleReleaseSection = ({
+  release,
+  focusedPatch,
+}: {
+  release: GHAEReleaseNotesContextT['releases'][0]
+  focusedPatch: string
+}) => {
+  const defaultIsOpen = true
+  const [isOpen, setIsOpen] = useState(defaultIsOpen)
+
+  const onToggle = (e: SyntheticEvent) => {
+    const newIsOpen = (e.target as HTMLDetailsElement).open
+    setIsOpen(newIsOpen)
+  }
+
+  return (
+    <li key={release.version} className="border-bottom">
+      <details
+        className="my-0 details-reset release-notes-version-picker"
+        aria-current="page"
+        open={defaultIsOpen}
+        onToggle={onToggle}
+      >
+        <summary className="px-3 py-4 my-0 d-flex flex-items-center flex-justify-between">
+          {release.version}
+          <div className="d-flex">
+            <span className="color-text-tertiary text-mono text-small text-normal mr-1">
+              {release.patches.length} releases
+            </span>
+            <ChevronDownIcon className={isOpen ? 'rotate-180' : ''} />
+          </div>
+        </summary>
+        <ul className="color-bg-tertiary border-top list-style-none py-4 px-0 my-0">
+          {release.patches.map((patch) => {
+            const isActive = patch.version === focusedPatch
+            return (
+              <li key={patch.version} className={cx('px-3 my-0 py-1', isActive && 'color-bg-info')}>
+                <a
+                  href={`#${patch.date}`}
+                  className="d-flex flex-items-center flex-justify-between"
+                >
+                  {patch.friendlyDate}
+                </a>
+              </li>
+            )
+          })}
+        </ul>
+      </details>
+    </li>
+  )
+}

components/release-notes/GHESReleaseNotes.tsx

@@ -1,4 +1,4 @@
-import { useState } from 'react'
+import { SyntheticEvent, useState } from 'react'
 import cx from 'classnames'
 import {
   ChevronDownIcon,
@@ -103,47 +103,12 @@ export function GHESReleaseNotes({ context }: Props) {
 
               if (release.version === currentVersion.currentRelease) {
                 return (
-                  <li key={release.version} className="border-bottom">
-                    <details
-                      className="my-0 details-reset release-notes-version-picker"
-                      aria-current="page"
-                      open
-                    >
-                      <summary className="px-3 py-4 my-0 d-flex flex-items-center flex-justify-between">
-                        {release.version}
-                        <div className="d-flex">
-                          <span className="color-text-tertiary text-mono text-small text-normal mr-1">
-                            {release.patches.length} releases
-                          </span>
-                          <ChevronDownIcon />
-                        </div>
-                      </summary>
-                      <ul className="color-bg-tertiary border-top list-style-none py-4 px-0 my-0">
-                        {release.patches.map((patch) => {
-                          const isActive = patch.version === focusedPatch
-                          return (
-                            <li
-                              key={patch.version}
-                              className={cx(
-                                'js-release-notes-patch-link px-3 my-0 py-1',
-                                isActive && 'selected'
-                              )}
-                            >
-                              <Link
-                                href={`${releaseLink}#${patch.version}`}
-                                className="d-flex flex-items-center flex-justify-between"
-                              >
-                                {patch.version}
-                                <span className="color-text-tertiary text-mono text-small text-normal">
-                                  {dayjs(patch.date).format('MMMM DD, YYYY')}
-                                </span>
-                              </Link>
-                            </li>
-                          )
-                        })}
-                      </ul>
-                    </details>
-                  </li>
+                  <CollapsibleReleaseSection
+                    key={release.version}
+                    release={release}
+                    focusedPatch={focusedPatch}
+                    releaseLink={releaseLink}
+                  />
                 )
               }
 
@@ -167,3 +132,59 @@ export function GHESReleaseNotes({ context }: Props) {
     </div>
   )
 }
+
+const CollapsibleReleaseSection = ({
+  release,
+  releaseLink,
+  focusedPatch,
+}: {
+  release: GHESReleaseNotesContextT['releases'][0]
+  releaseLink: string
+  focusedPatch: string
+}) => {
+  const defaultIsOpen = true
+  const [isOpen, setIsOpen] = useState(defaultIsOpen)
+
+  const onToggle = (e: SyntheticEvent) => {
+    const newIsOpen = (e.target as HTMLDetailsElement).open
+    setIsOpen(newIsOpen)
+  }
+  return (
+    <li key={release.version} className="border-bottom">
+      <details
+        className="my-0 details-reset release-notes-version-picker"
+        aria-current="page"
+        open={defaultIsOpen}
+        onToggle={onToggle}
+      >
+        <summary className="px-3 py-4 my-0 d-flex flex-items-center flex-justify-between">
+          {release.version}
+          <div className="d-flex">
+            <span className="color-text-tertiary text-mono text-small text-normal mr-1">
+              {release.patches.length} releases
+            </span>
+            <ChevronDownIcon className={isOpen ? 'rotate-180' : ''} />
+          </div>
+        </summary>
+        <ul className="color-bg-tertiary border-top list-style-none py-4 px-0 my-0">
+          {release.patches.map((patch) => {
+            const isActive = patch.version === focusedPatch
+            return (
+              <li key={patch.version} className={cx('px-3 my-0 py-1', isActive && 'color-bg-info')}>
+                <Link
+                  href={`${releaseLink}#${patch.version}`}
+                  className="d-flex flex-items-center flex-justify-between"
+                >
+                  {patch.version}
+                  <span className="color-text-tertiary text-mono text-small text-normal">
+                    {dayjs(patch.date).format('MMMM DD, YYYY')}
+                  </span>
+                </Link>
+              </li>
+            )
+          })}
+        </ul>
+      </details>
+    </li>
+  )
+}

components/release-notes/PatchNotes.module.scss

@@ -0,0 +1,8 @@
+@import "@primer/css/layout/index.scss";
+
+.sectionHeading {
+  scroll-margin-top: 280px !important;
+  @include breakpoint(sm) {
+    scroll-margin-top: 200px !important;
+  }
+}

components/release-notes/PatchNotes.tsx

@@ -3,6 +3,8 @@ import slugger from 'github-slugger'
 import { ReleaseNotePatch } from './types'
 import { Link } from 'components/Link'
 
+import styles from './PatchNotes.module.scss'
+
 const SectionToLabelMap: Record<string, string> = {
   features: 'Features',
   bugs: 'Bug fixes',
@@ -13,6 +15,16 @@ const SectionToLabelMap: Record<string, string> = {
   backups: 'Backups',
 }
 
+const ColorMap = {
+  features: 'var(--color-auto-green-5)',
+  bugs: 'var(--color-auto-yellow-5)',
+  known_issues: 'var(--color-auto-blue-5)',
+  security_fixes: 'var(--color-auto-pink-5)',
+  changes: 'var(--color-auto-green-5)',
+  deprecations: 'var(--color-auto-purple-5)',
+  backups: 'var(--color-auto-orange-5)',
+}
+
 type Props = {
   patch: ReleaseNotePatch
   withReleaseNoteLabel?: boolean
@@ -22,11 +34,11 @@ export function PatchNotes({ patch, withReleaseNoteLabel }: Props) {
     <>
       {Object.entries(patch.sections).map(([key, sectionItems], i, arr) => {
         const isLast = i === arr.length - 1
+        const primaryColor = ColorMap[key as keyof typeof ColorMap] || ColorMap.features
         return (
           <div
             key={key}
             className={cx(
-              `release-notes-section-${key}`,
               'py-6 d-block d-xl-flex gutter-xl flex-items-baseline',
               !withReleaseNoteLabel && 'mx-6',
               !isLast && 'border-bottom'
@@ -34,41 +46,39 @@ export function PatchNotes({ patch, withReleaseNoteLabel }: Props) {
           >
             {withReleaseNoteLabel && (
               <div className="col-12 col-xl-3 mb-5">
-                <span className="px-3 py-2 text-small text-bold text-uppercase text-mono color-text-inverse release-notes-section-label">
+                <span
+                  className="px-3 py-2 text-small text-bold text-uppercase text-mono color-text-inverse"
+                  style={{ backgroundColor: primaryColor }}
+                >
                   {SectionToLabelMap[key] || 'INVALID SECTION'}
                 </span>
               </div>
             )}
-            <ul className={cx(withReleaseNoteLabel && 'col-xl-9', 'col-12 release-notes-list')}>
+            <ul className={cx(withReleaseNoteLabel && 'col-xl-9', 'col-12')}>
               {sectionItems.map((item) => {
                 if (typeof item === 'string') {
-                  return (
-                    <li
-                      key={item}
-                      className="release-notes-list-item"
-                      dangerouslySetInnerHTML={{ __html: item }}
-                    />
-                  )
+                  return <li key={item} className="f4" dangerouslySetInnerHTML={{ __html: item }} />
                 }
 
                 const slug = item.heading ? slugger.slug(item.heading) : ''
                 return (
-                  <li key={slug} className="release-notes-list-item list-style-none">
+                  <li key={slug} className="list-style-none">
                     <h4
                       id={slug}
-                      className="release-notes-section-heading text-uppercase text-bold"
+                      className={cx(styles.sectionHeading, 'text-uppercase text-bold f4')}
+                      style={{ color: !withReleaseNoteLabel ? primaryColor : '' }}
                     >
                       <Link href={`#${slug}`} className="text-inherit">
                         {item.heading}
                       </Link>
                     </h4>
 
-                    <ul className="pl-0 pb-4 mt-2 release-notes-list">
+                    <ul className="pl-0 pb-4 mt-2">
                       {item.notes.map((note) => {
                         return (
                           <li
                             key={note}
-                            className="release-notes-list-item"
+                            className="list-style-none f4"
                             dangerouslySetInnerHTML={{ __html: note }}
                           />
                         )

stylesheets/index.scss

@@ -19,7 +19,6 @@ $marketing-font-path: "/assets/fonts/inter/";
 @import "images.scss";
 @import "lists.scss";
 @import "product-sublanding.scss";
-@import "release-notes.scss";
 @import "search.scss";
 @import "shadows.scss";
 @import "summary.scss";

stylesheets/release-notes.scss

@@ -1,56 +0,0 @@
-ul.release-notes-list li.release-notes-list-item {
-  font-size: 15px !important;
-
-  &::marker {
-    // `•    `
-    content: "\2022\00a0\00a0\00a0\00a0";
-    font-size: 1.6em;
-    color: var(--color-auto-gray-4);
-  }
-
-  &.list-style-none::marker {
-    content: "";
-  }
-}
-
-.release-notes-section-heading {
-  font-size: 15px !important;
-  scroll-margin-top: 280px !important;
-  @include breakpoint(sm) {
-    scroll-margin-top: 200px !important;
-  }
-}
-
-details[open].release-notes-version-picker
-  summary
-  .octicon.octicon-chevron-down {
-  transform: rotate(180deg);
-}
-
-.js-release-notes-patch-link {
-  &.selected {
-    background-color: var(--color-auto-blue-1);
-  }
-}
-
-$colors-list: (
-  features: var(--color-auto-green-5),
-  bugs: var(--color-auto-yellow-5),
-  known_issues: var(--color-auto-blue-5),
-  security_fixes: var(--color-auto-pink-5),
-  changes: var(--color-auto-green-5),
-  deprecations: var(--color-auto-purple-5),
-  backups: var(--color-auto-orange-5),
-);
-
-@each $key, $val in $colors-list {
-  .release-notes-section-#{$key} {
-    .release-notes-section-label {
-      background-color: #{$val};
-    }
-
-    .release-notes-section-heading {
-      color: #{$val};
-    }
-  }
-}