From d431e86dec3f080d986fcb50f404f53ff5ab9033 Mon Sep 17 00:00:00 2001
From: Kevin Heis <heiskr@users.noreply.github.com>
Date: Mon, 30 Aug 2021 13:34:14 -0700
Subject: [PATCH] Storybook lite (#21040)

* Remove storybook

* Update index.js

* Start a storybook outline

* Start a storybook outline

* Start showing errors

* Update storybook.tsx

* Typescript lint

* Name field

* Responsive

* Update storybook.tsx

* Update storybook.tsx

* Update storybook.tsx

* Add BumpLink to storybook

* Update storybook.tsx
---
 components/ui/BumpLink/BumpLink.tsx |  5 ++-
 components/ui/Callout/Callout.tsx   | 10 ++++-
 middleware/render-page.js           |  4 ++
 pages/storybook.tsx                 | 68 +++++++++++++++++++++++++++++
 4 files changed, 83 insertions(+), 4 deletions(-)
 create mode 100644 pages/storybook.tsx

diff --git a/components/ui/BumpLink/BumpLink.tsx b/components/ui/BumpLink/BumpLink.tsx
index 06492b9604..d5a69d365a 100644
--- a/components/ui/BumpLink/BumpLink.tsx
+++ b/components/ui/BumpLink/BumpLink.tsx
@@ -3,14 +3,15 @@ import cx from 'classnames'
 
 import styles from './BumpLink.module.scss'
 
-type Props = {
+export type BumpLinkPropsT = {
   children?: ReactNode
   title: ReactElement<any> | string
   href: string
   as?: ElementType<{ className?: string; href: string }>
   className?: string
 }
-export const BumpLink = ({ as, children, href, title, className }: Props) => {
+
+export const BumpLink = ({ as, children, href, title, className }: BumpLinkPropsT) => {
   const Component = as || 'a'
 
   const symbol = <span className={styles.symbol}>→</span>
diff --git a/components/ui/Callout/Callout.tsx b/components/ui/Callout/Callout.tsx
index 6d4cf50dc0..21e1d36728 100644
--- a/components/ui/Callout/Callout.tsx
+++ b/components/ui/Callout/Callout.tsx
@@ -2,13 +2,19 @@ import { DOMAttributes, ReactNode } from 'react'
 import cx from 'classnames'
 import styles from './Callout.module.scss'
 
-type Props = {
+export type CalloutPropsT = {
   dangerouslySetInnerHTML?: DOMAttributes<HTMLDivElement>['dangerouslySetInnerHTML']
   variant: 'success' | 'info' | 'warning'
   children?: ReactNode
   className?: string
 }
-export const Callout = ({ variant, className, dangerouslySetInnerHTML, children }: Props) => {
+
+export const Callout = ({
+  variant,
+  className,
+  dangerouslySetInnerHTML,
+  children,
+}: CalloutPropsT) => {
   return (
     <div
       data-testid="callout"
diff --git a/middleware/render-page.js b/middleware/render-page.js
index cfdcb32bcd..d0882d556a 100644
--- a/middleware/render-page.js
+++ b/middleware/render-page.js
@@ -6,6 +6,10 @@ import { isConnectionDropped } from './halt-on-dropped-connection.js'
 import { nextApp, nextHandleRequest } from './next.js'
 
 export default async function renderPage(req, res, next) {
+  if (req.path.startsWith('/storybook')) {
+    return nextHandleRequest(req, res)
+  }
+
   const page = req.context.page
   // render a 404 page
   if (!page) {
diff --git a/pages/storybook.tsx b/pages/storybook.tsx
new file mode 100644
index 0000000000..486b27fc3b
--- /dev/null
+++ b/pages/storybook.tsx
@@ -0,0 +1,68 @@
+import React from 'react'
+import { BumpLink, BumpLinkPropsT } from 'components/ui/BumpLink/BumpLink'
+import { Callout, CalloutPropsT } from 'components/ui/Callout/Callout'
+
+const stories = [
+  {
+    name: 'BumpLink',
+    component: BumpLink,
+    variants: [
+      { title: 'Think basic', href: 'http://example.com' } as BumpLinkPropsT,
+      {
+        title: 'Think different',
+        href: 'http://example.com',
+        children: 'This is child text',
+      } as BumpLinkPropsT,
+      {
+        as: 'div',
+        title: 'Think as div',
+        href: 'http://example.com',
+        className: 'color-bg-warning',
+      } as BumpLinkPropsT,
+    ],
+  },
+  {
+    name: 'Callout', // {component.name} gets optimized away
+    component: Callout,
+    variants: [
+      { variant: 'success', children: 'Yay you did it!', className: '' } as CalloutPropsT,
+      { variant: 'info', children: 'Captain I have information.', className: '' } as CalloutPropsT,
+      { variant: 'warning', children: 'Warning... warning...', className: '' } as CalloutPropsT,
+      { variant: 'success', children: 'I am a little font', className: 'f6' } as CalloutPropsT,
+    ],
+  },
+]
+
+export default function Storybook() {
+  return (
+    <div className="p-4 mx-auto" style={{ maxWidth: 1200 }}>
+      <h1>GitHub Docs Storybook</h1>
+      <p className="f3">This page lists React components unique to the GitHub docs.</p>
+      <div className="my-4 d-lg-flex flex-items-start">
+        <nav className="menu col-12 col-lg-3 mr-4 color-bg-secondary position-lg-sticky top-0">
+          {stories.map(({ name }) => (
+            <a className="menu-item" href={`#${name}`}>
+              {name}
+            </a>
+          ))}
+        </nav>
+        <div className="col-12 col-lg-9">
+          {stories.map(({ name, component, variants }) => (
+            <div id={name} key={name} className="mb-4">
+              <h2 className="position-sticky top-0 color-bg-primary border-bottom">{name}</h2>
+              {variants.map((props) => (
+                <div className="my-4" key={JSON.stringify(props)}>
+                  {/* @ts-ignore */}
+                  {React.createElement(component, props)}
+                  <pre className="mt-2 p-2 color-bg-tertiary border rounded-2">
+                    {JSON.stringify(props, null, 2)}
+                  </pre>
+                </div>
+              ))}
+            </div>
+          ))}
+        </div>
+      </div>
+    </div>
+  )
+}