@brillout/docpress 0.1.9 → 0.1.11

package/src/navigation/NavigationHeader.tsx

@@ -1,97 +0,0 @@
-import React from 'react'
-import iconGithub from '../icons/github.svg'
-import iconTwitter from '../icons/twitter.svg'
-import iconDiscord from '../icons/discord.svg'
-import iconChangelog from '../icons/changelog.svg'
-import { usePageContext } from '../renderer/usePageContext'
-
-export { NavigationHeader }
-
-function NavigationHeader() {
-  const pageContext = usePageContext()
-  return (
-    <div
-      id="navigation-header"
-      style={{
-        display: 'flex',
-        flexDirection: 'column',
-        alignItems: 'center',
-        marginBottom: -5
-      }}
-    >
-      <a
-        id="navigation-header-logo"
-        style={{
-          display: 'flex',
-          alignItems: 'center',
-          color: 'inherit',
-          justifyContent: 'left',
-          textDecoration: 'none',
-          paddingTop: 12,
-          paddingBottom: 7
-        }}
-        href="/"
-      >
-        {pageContext.config.navHeader}
-      </a>
-      <Links />
-    </div>
-  )
-}
-
-function Links() {
-  const pageContext = usePageContext()
-  const { projectInfo } = pageContext.config
-  return (
-    <div
-      style={{
-        display: 'flex',
-        alignItems: 'center',
-        paddingTop: 0,
-        justifyContent: 'left'
-      }}
-    >
-      <SocialLink className="decolorize-4" icon={iconGithub} href={projectInfo.githubRepository} />
-      <SocialLink className="decolorize-6" icon={iconDiscord} href={projectInfo.discordInvite} />
-      <SocialLink className="decolorize-7" icon={iconTwitter} href={projectInfo.twitterProfile} />
-      <div id="docsearch-desktop" />
-      <ChangelogButton />
-    </div>
-  )
-}
-
-function ChangelogButton() {
-  const pageContext = usePageContext()
-  const { projectInfo } = pageContext.config
-  return (
-    <a
-      href={`${projectInfo.githubRepository}/blob/main/CHANGELOG.md`}
-      className="button colorize-on-hover"
-      style={{
-        display: 'flex',
-        alignItems: 'center',
-        padding: '1px 7px',
-        marginLeft: 2,
-        fontSize: '0.97em',
-        color: 'inherit'
-      }}
-    >
-      <span className="decolorize-7">v{projectInfo.projectVersion}</span>
-      <img className="decolorize-6" src={iconChangelog} height={16} style={{ marginLeft: 5 }} />
-    </a>
-  )
-}
-
-function SocialLink({ className, icon, href }: { className: string; icon: string; href: string }) {
-  return (
-    <>
-      <a
-        className={'colorize-on-hover ' + className}
-        href={href}
-        style={{ padding: 3, display: 'inline-block', lineHeight: 0 }}
-      >
-        <img src={icon} height="20" style={{}} />
-      </a>
-    </>
-  )
-}

package/src/navigation/navigation-fullscreen/NavigationFullscreenButton.css

@@ -1,32 +0,0 @@
-:root {
-  --navigation-fullscreen-button-width: 20px;
-}
-#navigation-fullscreen-button {
-  width: var(--navigation-fullscreen-button-width);
-  position: relative;
-  z-index: 2;
-}
-#navigation-wrapper:hover + #navigation-fullscreen-button > div > div,
-#navigation-fullscreen-button:hover > div > div {
-  left: 0px;
-}
-#navigation-fullscreen-button > div > div {
-  transition: all 0.3s ease-in-out;
-  left: -20px;
-  position: absolute;
-  height: 100%;
-  width: 100%;
-  background-color: #eee !important;
-  background: url('./chevron.svg');
-  background-repeat: no-repeat;
-  background-position: center center;
-}
-
-html:not(.navigation-fullscreen) #navigation-fullscreen-close {
-  display: none;
-}
-
-html.navigation-fullscreen #page-content {
-  /* Make `Ctrl-F` browser search only crawl the navigation menu */
-  visibility: hidden;
-}

package/src/navigation/navigation-fullscreen/NavigationFullscreenButton.tsx

@@ -1,44 +0,0 @@
-export { NavigationFullscreenButton }
-export { NavigationFullscreenClose }
-
-import React from 'react'
-import './NavigationFullscreenButton.css'
-import closeIcon from './close.svg'
-
-function NavigationFullscreenButton() {
-  return (
-    <>
-      <a id="navigation-fullscreen-button">
-        <div
-          style={{
-            position: 'fixed',
-            cursor: 'pointer',
-            height: '100vh',
-            width: 20,
-            overflow: 'hidden'
-          }}
-        >
-          <div></div>
-        </div>
-        <div
-          style={{ position: 'fixed', height: '100vh', width: 20 }}
-          aria-label="Press <Esc>"
-          data-balloon-pos="right"
-        ></div>
-      </a>
-    </>
-  )
-}
-
-function NavigationFullscreenClose() {
-  return (
-    <a
-      id="navigation-fullscreen-close"
-      style={{ position: 'fixed', top: 11, right: 15, zIndex: 10 }}
-      aria-label="Press <Esc>"
-      data-balloon-pos="left"
-    >
-      <img src={closeIcon} height={50} width={50} style={{ display: 'block' }} />
-    </a>
-  )
-}

package/src/navigation/navigation-fullscreen/initNavigationFullscreen.ts

@@ -1,115 +0,0 @@
-export { initNavigationFullscreen }
-
-import { assert } from '../../utils'
-
-let scrollPositionBeforeToggle: number = 0
-
-function initNavigationFullscreen() {
-  updateColumnWidth()
-  window.addEventListener('resize', updateColumnWidth, { passive: true })
-  document.getElementById('navigation-fullscreen-button')!.onclick = toggleNavExpend
-  document.getElementById('navigation-fullscreen-close')!.onclick = toggleNavExpend
-  document.addEventListener(
-    // We don't use keydown to not interfere with user pressing `<Esc>` for closing the browser's `<Ctrl-F>` search diablog, see https://stackoverflow.com/questions/66595035/how-to-detect-escape-key-if-search-bar-of-browser-is-open
-    'keydown',
-    (ev) => {
-      if (ev.key === 'Escape') toggleNavExpend()
-    },
-    false
-  )
-}
-
-function toggleNavExpend() {
-  const navContainer = document.getElementById('navigation-container')!
-  const scrollPos = navContainer.scrollTop
-  document.documentElement.classList.toggle('navigation-fullscreen')
-  if (scrollPositionBeforeToggle !== undefined) {
-    navContainer.scrollTop = scrollPositionBeforeToggle
-  }
-  scrollPositionBeforeToggle = scrollPos
-}
-
-function updateColumnWidth() {
-  const navMinWidth = 299
-  const navH1Groups = Array.from(document.querySelectorAll('.nav-h1-group'))
-  const numberOfColumnsMax = navH1Groups.length
-
-  const widthAvailable = getViewportWidth()
-  const numberOfColumns = Math.max(1, Math.min(numberOfColumnsMax, Math.floor(widthAvailable / navMinWidth)))
-
-  let columns = navH1Groups.map((navH1Group) => {
-    const column = [
-      {
-        element: navH1Group,
-        elementHeight: navH1Group.children.length
-      }
-    ]
-    return column
-  })
-
-  mergeColumns(columns, numberOfColumns)
-
-  const navContent = document.getElementById('navigation-content')!
-
-  Array.from(navContent.children).forEach((child) => {
-    assert(child.className === 'nav-column')
-  })
-  navContent.innerHTML = ''
-
-  columns.forEach((column) => {
-    const columnEl = document.createElement('div')
-    columnEl.className = 'nav-column'
-    column.forEach(({ element }) => {
-      columnEl.appendChild(element)
-    })
-    navContent.appendChild(columnEl)
-  })
-
-  const navItemMaxWidth = 350
-  navContent.style.maxWidth = `${numberOfColumns * navItemMaxWidth}px`
-}
-function getViewportWidth(): number {
-  // `window.innerWidth` inlcudes scrollbar width: https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes
-  return document.documentElement.clientWidth
-}
-
-function mergeColumns<T>(columns: { element: T; elementHeight: number }[][], maxNumberOfColumns: number) {
-  assert(columns.length > 0)
-  assert(maxNumberOfColumns > 0)
-  if (columns.length <= maxNumberOfColumns) {
-    return columns
-  }
-
-  let mergeCandidate = {
-    i: -1,
-    mergeHeight: Infinity
-  }
-  for (let i = 0; i <= columns.length - 2; i++) {
-    const column1 = columns[i + 0]
-    const column2 = columns[i + 1]
-    const column1Height = sum(column1.map((c) => c.elementHeight))
-    const column2Height = sum(column2.map((c) => c.elementHeight))
-    const mergeHeight = column1Height + column2Height
-    if (mergeCandidate.mergeHeight > mergeHeight) {
-      mergeCandidate = {
-        i,
-        mergeHeight
-      }
-    }
-  }
-
-  {
-    const { i } = mergeCandidate
-    assert(-1 < i && i < columns.length - 1, { i, columnsLength: columns.length, maxNumberOfColumns })
-    columns[i] = [...columns[i], ...columns[i + 1]]
-    columns.splice(i + 1, 1)
-  }
-
-  mergeColumns(columns, maxNumberOfColumns)
-}
-
-function sum(arr: number[]): number {
-  let total = 0
-  arr.forEach((n) => (total += n))
-  return total
-}

package/src/parseEmojis.ts

@@ -1,33 +0,0 @@
-export { parseEmojis }
-
-import twemoji from 'twemoji'
-
-const emojiList = {
-  // https://emojipedia.org/no-entry/
-  ':no_entry:': 0x26d4,
-  // https://emojipedia.org/warning/
-  ':warning:': 0x26a0,
-  // https://emojipedia.org/trophy/
-  ':trophy:': 0x1f3c6
-  /*
-  // https://emojipedia.org/red-heart/
-  ':heart:': 0x2764,
-  */
-}
-
-function parseEmojis(html: string) {
-  Object.entries(emojiList).forEach(([shortcode, codepoint]) => {
-    if (!html.includes(shortcode)) {
-      return
-    }
-    const emojiStr = twemoji.convert.fromCodePoint(codepoint)
-    let emojiImg: any = twemoji.parse(emojiStr, {
-      folder: 'svg',
-      ext: '.svg'
-    })
-    const style = 'height: 1.275em; width: 1.275em; vertical-align: -20%'
-    emojiImg = emojiImg.replace('<img class="emoji" ', `<img style="${style}" `)
-    html = html.split(shortcode).join(emojiImg)
-  })
-  return html
-}

package/src/renderer/_default.page.client.ts

@@ -1,7 +0,0 @@
-import '../css/index.css'
-import '../autoScrollNav'
-import '../installSectionUrlHashs'
-import '../navigation/Navigation.client'
-import '../components/P.css'
-import '../algolia/DocSearch.css'
-import '../utils/Emoji'

package/src/renderer/_default.page.server.tsx

@@ -1,69 +0,0 @@
-import ReactDOMServer from 'react-dom/server'
-import React from 'react'
-import { escapeInject, dangerouslySkipEscape } from 'vite-plugin-ssr'
-import { PageLayout } from '../PageLayout'
-import { resolvePageContext, PageContextOriginal } from '../config/resolvePageContext'
-import { getDocSearchJS, getDocSearchCSS } from '../algolia/DocSearch'
-import { parseEmojis } from '../parseEmojis'
-import { assert } from '../utils'
-
-export { render }
-
-async function render(pageContextOriginal: PageContextOriginal) {
-  const { Page } = pageContextOriginal
-  const pageContextResolved = resolvePageContext(pageContextOriginal)
-
-  const page = (
-    <PageLayout pageContext={pageContextResolved}>
-      <Page />
-    </PageLayout>
-  )
-
-  const descriptionTag = pageContextResolved.isLandingPage
-    ? dangerouslySkipEscape(`<meta name="description" content="${pageContextResolved.meta.tagline}" />`)
-    : ''
-
-  const docSearchJS = getDocSearchJS(pageContextResolved)
-  const docSearchCSS = getDocSearchCSS(pageContextResolved)
-
-  let pageHtml = ReactDOMServer.renderToString(page)
-  pageHtml = parseEmojis(pageHtml)
-
-  return escapeInject`<!DOCTYPE html>
-    <html>
-      <head>
-        <meta charset="UTF-8" />
-        <link rel="icon" href="${pageContextResolved.meta.faviconUrl}" />
-        <title>${pageContextResolved.meta.title}</title>
-        ${descriptionTag}
-        <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=no" />
-        ${docSearchCSS}
-        ${getOpenGraphTags(pageContextOriginal.urlPathname, pageContextResolved.meta)}
-      </head>
-      <body>
-        <div id="page-view">${dangerouslySkipEscape(pageHtml)}</div>
-        ${docSearchJS}
-      </body>
-    </html>`
-}
-
-function getOpenGraphTags(
-  url: string,
-  meta: { title: string; tagline: string; websiteUrl: string; twitterHandle: string; bannerUrl?: string }
-) {
-  const { title, tagline, websiteUrl, twitterHandle, bannerUrl } = meta
-
-  assert(url.startsWith('/'))
-  if (url !== '/' || !bannerUrl) return ''
-
-  // See view-source:https://vitejs.dev/
-  return escapeInject`
-    <meta property="og:type" content="website">
-    <meta property="og:title" content="${title}">
-    <meta property="og:image" content="${bannerUrl}">
-    <meta property="og:url" content="${websiteUrl}">
-    <meta property="og:description" content="${tagline}">
-    <meta name="twitter:card" content="summary_large_image">
-    <meta name="twitter:site" content="${twitterHandle}">
-  `
-}

package/src/renderer/usePageContext.tsx

@@ -1,25 +0,0 @@
-// `usePageContext` allows us to access `pageContext` in any React component.
-// More infos: https://vite-plugin-ssr.com/pageContext-anywhere
-
-import React, { useContext } from 'react'
-import type { PageContextResolved } from '../config/resolvePageContext'
-
-export { PageContextProvider }
-export { usePageContext }
-
-const Context = React.createContext<PageContextResolved>(undefined as any)
-
-function PageContextProvider({
-  pageContext,
-  children
-}: {
-  pageContext: PageContextResolved
-  children: React.ReactNode
-}) {
-  return <Context.Provider value={pageContext}>{children}</Context.Provider>
-}
-
-function usePageContext() {
-  const pageContext = useContext(Context)
-  return pageContext
-}

package/src/types.ts

@@ -1,2 +0,0 @@
-export type { Config } from './config/Config'
-export type { HeadingDefinition, HeadingWithoutLink } from './headings'

package/src/utils/Emoji/Emoji.ts

@@ -1,216 +0,0 @@
-import React from 'react'
-import { assert } from '../assert'
-
-import { iconMechanicalArm, iconCompass, iconRoadFork, iconShield, iconTypescript, iconEngine } from './assets'
-
-export { Emoji }
-export type { EmojiName }
-
-type EmojiName =
-  | 'warning'
-  | 'typescript'
-  | 'shield'
-  | 'mechanical-arm'
-  | 'mountain'
-  | 'rocket'
-  | 'wrench'
-  | 'compass'
-  | 'seedling'
-  | 'books'
-  | 'plug'
-  | 'earth'
-  | 'gear'
-  | 'red-heart'
-  | 'high-voltage'
-  | 'gem-stone'
-  | 'dizzy'
-  | 'sparkles'
-  | 'writing-hang'
-  | 'road-fork'
-  | 'engine'
-  | 'red-circle'
-  | 'sparkling-heart'
-  | 'gift'
-  | 'package'
-  | 'info'
-  | 'lab'
-  | 'trophy'
-
-function Emoji({ name, style }: { name: EmojiName; style?: React.CSSProperties }): JSX.Element {
-  const emoji =
-    // ***
-    // U+26A0
-    // https://emojipedia.org/warning/
-    // https://www.unicompat.com/26A0 => 94.1%
-    // https://www.unicompat.com/26A0-FE0F => 92.4%
-    // https://www.unicompat.com/2697 => 94.1%
-    (name === 'warning' && Unicode(0x26a0, { fontFamily: 'emoji' })) ||
-    // ***
-    // U+2697
-    // https://emojipedia.org/alembic/
-    // https://www.unicompat.com/2697 => 94.1%
-    (name === 'lab' && Unicode(0x2697)) ||
-    // ***
-    // U+2139
-    // https://emojipedia.org/information/
-    // https://www.unicompat.com/2139 => 94.8%
-    // https://www.unicompat.com/2139-FE0F => 92.4%
-    (name === 'info' && Unicode(0x2139, { fontFamily: 'emoji' })) ||
-    // ***
-    // U+1F4E6
-    // https://emojipedia.org/package/
-    // https://www.unicompat.com/1F4E6 => 94.1%
-    (name === 'package' && Unicode(0x1f4e6)) ||
-    // ***
-    // U+1F381
-    // https://emojipedia.org/wrapped-gift/
-    // https://www.unicompat.com/1F381 => 94.1%
-    (name === 'gift' && Unicode(0x1f381)) ||
-    // ***
-    // U+1F496
-    // https://emojipedia.org/sparkling-heart/
-    // https://www.unicompat.com/1F496 => 94.1%
-    (name === 'sparkling-heart' && Unicode(0x1f496)) ||
-    // ***
-    // U+2B55
-    // https://emojipedia.org/hollow-red-circle/
-    // https://www.unicompat.com/2B55 => 94.1%
-    (name === 'red-circle' && Unicode(0x2b55)) ||
-    // ***
-    (name === 'engine' && Img(iconEngine)) ||
-    // ***
-    // https://www.typescriptlang.org/branding/
-    (name === 'typescript' && Img(iconTypescript)) ||
-    // ***
-    // U+FE0F
-    // https://emojipedia.org/shield/
-    // https://www.unicompat.com/FE0F => 46.5%
-    // https://icon-sets.iconify.design/noto/shield/
-    (name === 'shield' && Img(iconShield)) ||
-    // ***
-    // Custom
-    (name === 'road-fork' && Img(iconRoadFork, '1.4em')) ||
-    // ***
-    // U+270D
-    // https://emojipedia.org/writing-hand/
-    // https://www.unicompat.com/270D => 93.8%
-    (name === 'writing-hang' && Unicode(0x270d)) ||
-    // ***
-    // U+1F4AB
-    // https://emojipedia.org/dizzy/
-    // https://www.unicompat.com/1F4AB => 94.1%
-    (name === 'dizzy' && Unicode(0x1f4ab)) ||
-    // ***
-    // U+1F9BE
-    // https://iconify.design/icon-sets/noto/mechanical-arm.html
-    // https://emojipedia.org/mechanical-arm/
-    // https://www.unicompat.com/1f9be => 65.5%
-    (name === 'mechanical-arm' && Img(iconMechanicalArm)) ||
-    // ***
-    // U+1F680
-    // https://www.unicompat.com/1F680 => 94.1
-    (name === 'rocket' && Unicode(0x1f680)) ||
-    // ***
-    // U+1F527
-    // https://emojipedia.org/wrench/
-    // https://www.unicompat.com/1F527 => 94.1%
-    (name === 'wrench' && Unicode(0x1f527)) ||
-    // ***
-    // U+1F9ED
-    // https://iconify.design/icon-sets/noto/compass.html
-    // https://www.unicompat.com/1F9ED => 67.1%
-    (name === 'compass' && Img(iconCompass, '1.4em')) ||
-    // ***
-    // U+1F331
-    // https://www.unicompat.com/1F331 => 94.1%
-    (name === 'seedling' && Unicode(0x1f331)) ||
-    // ***
-    // U+1F4DA
-    // https://www.unicompat.com/1F4DA => 94.1%
-    (name === 'books' && Unicode(0x1f4da)) ||
-    // ***
-    // U+1F50C
-    // https://www.unicompat.com/1F50C => 94.1%
-    (name === 'plug' && Unicode(0x1f50c)) ||
-    // ***
-    // U+1F30D
-    // https://www.unicompat.com/1F30D => 88.8%
-    (name === 'earth' && Unicode(0x1f30d)) ||
-    // ***
-    // U+2699
-    // https://www.unicompat.com/2699 => 94.1%
-    (name === 'gear' && Unicode(0x2699)) ||
-    // ***
-    // U+2764
-    // https://emojipedia.org/red-heart/
-    // https://www.unicompat.com/2764 => 94.4%
-    // https://www.unicompat.com/2764-FE0F => 92.4%
-    (name === 'red-heart' && Unicode(0x2764, { fontFamily: 'emoji' })) ||
-    // U+26A1
-    // https://www.unicompat.com/26A1 => 94.1%
-    (name === 'high-voltage' && Unicode(0x26a1)) ||
-    // U+2728
-    // https://emojipedia.org/sparkles/
-    // https://www.unicompat.com/2728 => 94.1%
-    (name === 'sparkles' && Unicode(0x2728)) ||
-    // ***
-    // U+1F48E
-    // https://emojipedia.org/gem-stone/
-    // https://www.unicompat.com/1F48E => 94.1%
-    (name === 'gem-stone' && Unicode(0x1f48e)) ||
-    // ***
-    // 0x1F3C6
-    // https://emojipedia.org/trophy/
-    // https://www.unicompat.com/1F3C6 => 94.1%
-    (name === 'trophy' && Unicode(0x1f3c6)) ||
-    false
-  /* ======= Unused ========
-    // ***
-    // U+1FAA8
-    // https://emojipedia.org/rock/
-    // https://www.unicompat.com/1faa8 => 20.7%
-    //
-    // ***
-    // U+26F0
-    // https://emojipedia.org/mountain/
-    // https://iconify.design/icon-sets/noto/mountain.html
-    // https://www.unicompat.com/26F0 => 89.3%
-    (name === 'mountain' && Img(iconMountain)) ||
-    //
-    // ***
-    // U+2194
-    // https://emojipedia.org/left-right-arrow/
-    // https://www.unicompat.com/2194 => 95.0%
-    // Couldn't manage to show colored version
-    (name === 'left-right-arrow' && Unicode(0x2194)) ||
-    (name === 'left-right-arrow' && Unicode(0x2194, { fontFamily: 'reset' })) ||
-    (name === 'left-right-arrow' && Unicode(0xFE0F)) ||
-    (name === 'left-right-arrow' && Unicode(0xFE0F, { fontFamily: 'reset' })) ||
-    ======================== */
-
-  assert(emoji, { name })
-
-  return emoji
-
-  function Unicode(codePoint: number, styleAddendum?: React.CSSProperties) {
-    const text = String.fromCodePoint(codePoint)
-    if (style || styleAddendum) {
-      return React.createElement('span', { style: { ...style, ...styleAddendum } }, text)
-    } else {
-      return React.createElement(React.Fragment, null, text)
-    }
-  }
-
-  function Img(imgSrc: string, width: string = '1.15em') {
-    const props = {
-      src: imgSrc,
-      style: {
-        verticalAlign: 'text-top',
-        fontSize: '1em',
-        width,
-        ...style
-      }
-    }
-    return React.createElement('img', props)
-  }
-}

package/src/utils/Emoji/assets.ts

@@ -1,9 +0,0 @@
-import iconMechanicalArm from './mechanical-arm.svg'
-//import iconMountain from './mountain.svg'
-import iconCompass from './compass.svg'
-import iconRoadFork from './road-fork.svg'
-import iconShield from './shield.svg'
-import iconTypescript from './typescript.svg'
-import iconEngine from './engine.png'
-
-export { iconMechanicalArm, iconCompass, iconRoadFork, iconShield, iconTypescript, iconEngine }

package/src/utils/Emoji/index.ts

@@ -1 +0,0 @@
-export * from './Emoji'