@brillout/docpress 0.1.20 → 0.2.1

package/dist/renderer/_default.page.server.js

@@ -0,0 +1,591 @@
+import {
+  PageContextProvider,
+  RepoLink,
+  getHeadings,
+  parseTitle,
+  usePageContext
+} from "../chunk-H5CO4N2X.js";
+import {
+  Emoji,
+  jsxToTextContent,
+  objectAssign
+} from "../chunk-7HKDCMSZ.js";
+import {
+  assert,
+  assertUsage
+} from "../chunk-G2A5MZJA.js";
+import {
+  __template
+} from "../chunk-TTLAZ2T2.js";
+
+// src/renderer/_default.page.server.tsx
+import ReactDOMServer from "react-dom/server";
+import React7 from "react";
+import { escapeInject as escapeInject2, dangerouslySkipEscape } from "vite-plugin-ssr";
+
+// src/PageLayout.tsx
+import React6 from "react";
+
+// src/navigation/Navigation.tsx
+import React3 from "react";
+
+// src/navigation/NavigationHeader.tsx
+import React from "react";
+
+// src/icons/github.svg
+var github_default = "/assets/github-P5ZSKN2N.svg";
+
+// src/icons/twitter.svg
+var twitter_default = "/assets/twitter-I7DXDN3J.svg";
+
+// src/icons/discord.svg
+var discord_default = "/assets/discord-JD33TUSF.svg";
+
+// src/icons/changelog.svg
+var changelog_default = "/assets/changelog-IPI5F42D.svg";
+
+// src/navigation/NavigationHeader.tsx
+function NavigationHeader() {
+  const pageContext = usePageContext();
+  return /* @__PURE__ */ React.createElement(
+    "div",
+    {
+      id: "navigation-header",
+      style: {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        marginBottom: -5
+      }
+    },
+    /* @__PURE__ */ React.createElement(
+      "a",
+      {
+        id: "navigation-header-logo",
+        style: {
+          display: "flex",
+          alignItems: "center",
+          color: "inherit",
+          justifyContent: "left",
+          textDecoration: "none",
+          paddingTop: 12,
+          paddingBottom: 7
+        },
+        href: "/"
+      },
+      pageContext.config.navHeader
+    ),
+    /* @__PURE__ */ React.createElement(Links, null)
+  );
+}
+function Links() {
+  const pageContext = usePageContext();
+  const { projectInfo } = pageContext.config;
+  return /* @__PURE__ */ React.createElement(
+    "div",
+    {
+      style: {
+        display: "flex",
+        alignItems: "center",
+        paddingTop: 0,
+        justifyContent: "left"
+      }
+    },
+    /* @__PURE__ */ React.createElement(SocialLink, { className: "decolorize-4", icon: github_default, href: projectInfo.githubRepository }),
+    /* @__PURE__ */ React.createElement(SocialLink, { className: "decolorize-6", icon: discord_default, href: projectInfo.discordInvite }),
+    /* @__PURE__ */ React.createElement(SocialLink, { className: "decolorize-7", icon: twitter_default, href: projectInfo.twitterProfile }),
+    /* @__PURE__ */ React.createElement("div", { id: "docsearch-desktop" }),
+    /* @__PURE__ */ React.createElement(ChangelogButton, null)
+  );
+}
+function ChangelogButton() {
+  const pageContext = usePageContext();
+  const { projectInfo } = pageContext.config;
+  return /* @__PURE__ */ React.createElement(
+    "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"
+      }
+    },
+    /* @__PURE__ */ React.createElement("span", { className: "decolorize-7" }, "v", projectInfo.projectVersion),
+    /* @__PURE__ */ React.createElement("img", { className: "decolorize-6", src: changelog_default, height: 16, style: { marginLeft: 5 } })
+  );
+}
+function SocialLink({ className, icon, href }) {
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
+    "a",
+    {
+      className: "colorize-on-hover " + className,
+      href,
+      style: { padding: 3, display: "inline-block", lineHeight: 0 }
+    },
+    /* @__PURE__ */ React.createElement("img", { src: icon, height: "20", style: {} })
+  ));
+}
+
+// src/navigation/navigation-fullscreen/NavigationFullscreenButton.tsx
+import React2 from "react";
+
+// src/navigation/navigation-fullscreen/close.svg
+var close_default = "/assets/close-IQXTDOHV.svg";
+
+// src/navigation/navigation-fullscreen/NavigationFullscreenButton.tsx
+function NavigationFullscreenButton() {
+  return /* @__PURE__ */ React2.createElement(React2.Fragment, null, /* @__PURE__ */ React2.createElement("a", { id: "navigation-fullscreen-button" }, /* @__PURE__ */ React2.createElement(
+    "div",
+    {
+      style: {
+        position: "fixed",
+        cursor: "pointer",
+        height: "100vh",
+        width: 20,
+        overflow: "hidden"
+      }
+    },
+    /* @__PURE__ */ React2.createElement("div", null)
+  ), /* @__PURE__ */ React2.createElement(
+    "div",
+    {
+      style: { position: "fixed", height: "100vh", width: 20 },
+      "aria-label": "Press <Esc>",
+      "data-balloon-pos": "right"
+    }
+  )));
+}
+function NavigationFullscreenClose() {
+  return /* @__PURE__ */ React2.createElement(
+    "a",
+    {
+      id: "navigation-fullscreen-close",
+      style: { position: "fixed", top: 11, right: 15, zIndex: 10 },
+      "aria-label": "Press <Esc>",
+      "data-balloon-pos": "left"
+    },
+    /* @__PURE__ */ React2.createElement("img", { src: close_default, height: 50, width: 50, style: { display: "block" } })
+  );
+}
+
+// src/navigation/Navigation.tsx
+function Navigation({
+  pageContext
+}) {
+  const { isDetachedPage } = pageContext;
+  return /* @__PURE__ */ React3.createElement(React3.Fragment, null, /* @__PURE__ */ React3.createElement("div", { id: "navigation-container" }, /* @__PURE__ */ React3.createElement(NavigationHeader, null), isDetachedPage && /* @__PURE__ */ React3.createElement(DetachedPageNote, null), /* @__PURE__ */ React3.createElement(NavigationContent, { pageContext }), /* @__PURE__ */ React3.createElement(NavigationFullscreenClose, null)));
+}
+function NavigationMask() {
+  return /* @__PURE__ */ React3.createElement("div", { id: "navigation-mask" });
+}
+function NavigationContent({
+  pageContext
+}) {
+  const headings = getHeadingsWithComputedProps(pageContext);
+  const headingsGrouped = groupHeadings(headings);
+  return /* @__PURE__ */ React3.createElement("div", { id: "navigation-content" }, /* @__PURE__ */ React3.createElement("div", { className: "nav-column", style: { position: "relative" } }, headingsGrouped.map((headingsH1, i) => /* @__PURE__ */ React3.createElement("div", { className: "nav-h1-group", key: i }, /* @__PURE__ */ React3.createElement(Heading, { heading: headingsH1 }), headingsH1.headings.map((heading, j) => /* @__PURE__ */ React3.createElement(Heading, { heading, key: j }))))));
+}
+function Heading({
+  heading
+}) {
+  assert([1, 2, 3, 4].includes(heading.level), heading);
+  return /* @__PURE__ */ React3.createElement(
+    "a",
+    {
+      className: [
+        "nav-item",
+        "nav-item-h" + heading.level,
+        heading.computed.isActive && " is-active",
+        heading.computed.isActiveFirst && " is-active-first",
+        heading.computed.isActiveLast && " is-active-last",
+        heading.computed.isChildOfListHeading && "nav-item-parent-is-list-heading",
+        heading.computed.isFirstOfItsKind && "nav-item-first-of-its-kind",
+        heading.computed.isLastOfItsKind && "nav-item-last-of-its-kind"
+      ].filter(Boolean).join(" "),
+      href: heading.url || void 0
+    },
+    heading.titleInNav
+  );
+}
+function groupHeadings(headings) {
+  const headingsGrouped = [];
+  headings.forEach((heading) => {
+    if (heading.level === 1) {
+      headingsGrouped.push({ ...heading, headings: [] });
+    } else {
+      headingsGrouped[headingsGrouped.length - 1].headings.push(heading);
+    }
+  });
+  return headingsGrouped;
+}
+function getHeadingsWithComputedProps(pageContext) {
+  const { headingsWithSubHeadings, urlPathname } = pageContext;
+  return headingsWithSubHeadings.map((heading, i) => {
+    var _a2;
+    assert([1, 2, 3, 4].includes(heading.level), heading);
+    const headingPrevious = headingsWithSubHeadings[i - 1];
+    const headingNext = headingsWithSubHeadings[i + 1];
+    let isActiveFirst = false;
+    let isActiveLast = false;
+    let isActive = false;
+    if (heading.url === urlPathname) {
+      assert(heading.level === 2, { urlPathname });
+      isActive = true;
+      isActiveFirst = true;
+      if ((headingNext == null ? void 0 : headingNext.level) !== 3) {
+        isActiveLast = true;
+      }
+    }
+    if (heading.level === 3) {
+      isActive = true;
+      if ((headingNext == null ? void 0 : headingNext.level) !== 3) {
+        isActiveLast = true;
+      }
+    }
+    const isFirstOfItsKind = heading.level !== (headingPrevious == null ? void 0 : headingPrevious.level);
+    const isLastOfItsKind = heading.level !== (headingNext == null ? void 0 : headingNext.level);
+    const isChildOfListHeading = !!((_a2 = heading.parentHeadings[0]) == null ? void 0 : _a2.isListTitle);
+    return {
+      ...heading,
+      computed: {
+        isActive,
+        isActiveFirst,
+        isActiveLast,
+        isFirstOfItsKind,
+        isLastOfItsKind,
+        isChildOfListHeading
+      }
+    };
+  });
+}
+function DetachedPageNote() {
+  return /* @__PURE__ */ React3.createElement(
+    "div",
+    {
+      id: "detached-note",
+      style: {
+        backgroundColor: "var(--background-color)",
+        textAlign: "left",
+        marginLeft: 10,
+        marginRight: 10,
+        marginTop: 30,
+        marginBottom: -8,
+        borderRadius: 5,
+        padding: 10
+      }
+    },
+    /* @__PURE__ */ React3.createElement(Emoji, { name: "info" }),
+    " ",
+    /* @__PURE__ */ React3.createElement("b", null, /* @__PURE__ */ React3.createElement("em", null, "Detached")),
+    /* @__PURE__ */ React3.createElement(
+      "span",
+      {
+        style: {
+          opacity: 0.8
+        }
+      },
+      " ",
+      "\u2014 this page isn't listed in the navigation menu below."
+    )
+  );
+}
+
+// src/MobileHeader.tsx
+import React4 from "react";
+function MobileHeader() {
+  const pageContext = usePageContext();
+  return /* @__PURE__ */ React4.createElement(
+    "div",
+    {
+      id: "mobile-header",
+      style: {
+        height: "var(--mobile-header-height)",
+        width: "100vw",
+        position: "relative"
+      }
+    },
+    /* @__PURE__ */ React4.createElement(
+      "div",
+      {
+        style: {
+          position: "fixed",
+          display: "flex",
+          alignItems: "center",
+          background: "white",
+          zIndex: 99,
+          top: 0,
+          left: 0,
+          height: "var(--mobile-header-height)",
+          width: "100%",
+          borderBottom: "1px solid #ddd"
+        }
+      },
+      /* @__PURE__ */ React4.createElement(MenuToggle, null),
+      /* @__PURE__ */ React4.createElement(
+        "a",
+        {
+          href: "/",
+          style: {
+            color: "inherit",
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "left",
+            textDecoration: "none"
+          }
+        },
+        pageContext.config.navHeaderMobile
+      ),
+      /* @__PURE__ */ React4.createElement("div", { id: "docsearch-mobile" })
+    )
+  );
+}
+function MenuToggle() {
+  return /* @__PURE__ */ React4.createElement("div", { style: { padding: 20, lineHeight: 0 }, id: "menu-toggle" }, /* @__PURE__ */ React4.createElement(
+    "svg",
+    {
+      style: { width: 20 },
+      className: "icon",
+      xmlns: "http://www.w3.org/2000/svg",
+      "aria-hidden": "true",
+      role: "img",
+      viewBox: "0 0 448 512"
+    },
+    /* @__PURE__ */ React4.createElement(
+      "path",
+      {
+        fill: "currentColor",
+        d: "M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"
+      }
+    )
+  ));
+}
+
+// src/components/EditPageNote.tsx
+import React5 from "react";
+function EditPageNote({ pageContext }) {
+  const text = /* @__PURE__ */ React5.createElement(React5.Fragment, null, /* @__PURE__ */ React5.createElement(Emoji, { name: "writing-hang" }), " Edit this page");
+  return /* @__PURE__ */ React5.createElement("div", { style: { marginTop: 50 } }, /* @__PURE__ */ React5.createElement(RepoLink, { path: "/docs/pages" + pageContext.urlPathname + ".page.server.mdx", text, editMode: true }));
+}
+
+// src/PageLayout.tsx
+function PageLayout({ pageContext, children }) {
+  const { isLandingPage, pageTitle } = pageContext;
+  return /* @__PURE__ */ React6.createElement(React6.StrictMode, null, /* @__PURE__ */ React6.createElement(PageContextProvider, { pageContext }, /* @__PURE__ */ React6.createElement("div", { id: "page-layout", className: isLandingPage ? "landing-page" : "doc-page" }, /* @__PURE__ */ React6.createElement("div", { id: "navigation-wrapper" }, /* @__PURE__ */ React6.createElement(Navigation, { pageContext })), /* @__PURE__ */ React6.createElement(NavigationFullscreenButton, null), /* @__PURE__ */ React6.createElement("div", { id: "page-wrapper" }, /* @__PURE__ */ React6.createElement("div", { id: "page-container" }, /* @__PURE__ */ React6.createElement(MobileHeader, null), /* @__PURE__ */ React6.createElement("div", { id: "page-content" }, pageTitle && /* @__PURE__ */ React6.createElement("h1", null, pageTitle), children, !isLandingPage && /* @__PURE__ */ React6.createElement(EditPageNote, { pageContext }))), /* @__PURE__ */ React6.createElement(NavigationMask, null)))));
+}
+
+// src/config/getConfig.ts
+function getConfig() {
+  const globResult = import.meta.glob("/**/docpress.config.*([a-zA-Z0-9])", { eager: true });
+  const files = Object.keys(globResult);
+  assertUsage(files.length >= 1, "No DocPress config file found `docpress.config.(js|ts|tsx|...)`");
+  assertUsage(
+    files.length === 1,
+    `Found multiple \`docpress.config.js\` files: ${files.map((f) => `\`${f}\``).join(", ")}. Define only one instead.`
+  );
+  const config = Object.values(globResult)[0].default;
+  assert(config);
+  return config;
+}
+
+// src/config/resolvePageContext.ts
+function resolvePageContext(pageContext) {
+  const config = getConfig();
+  const { headings, headingsWithoutLink } = getHeadings(config);
+  const activeHeading = findActiveHeading(headings, headingsWithoutLink, pageContext);
+  const headingsWithSubHeadings = getHeadingsWithSubHeadings(headings, pageContext, activeHeading);
+  const { title, isLandingPage, pageTitle, isDetachedPage } = getMetaData(
+    headingsWithoutLink,
+    activeHeading,
+    pageContext,
+    config
+  );
+  const { faviconUrl, algolia, tagline, twitterHandle, bannerUrl, websiteUrl } = config;
+  const pageContextResolved = {};
+  objectAssign(pageContextResolved, {
+    ...pageContext,
+    meta: {
+      title,
+      faviconUrl,
+      twitterHandle,
+      bannerUrl,
+      websiteUrl,
+      tagline,
+      algolia
+    },
+    headings,
+    headingsWithSubHeadings,
+    isLandingPage,
+    isDetachedPage,
+    pageTitle,
+    config
+  });
+  return pageContextResolved;
+}
+function getMetaData(headingsWithoutLink, activeHeading, pageContext, config) {
+  const url = pageContext.urlOriginal;
+  let title;
+  let pageTitle;
+  let isDetachedPage;
+  if (activeHeading) {
+    title = activeHeading.titleDocument || jsxToTextContent(activeHeading.title);
+    pageTitle = activeHeading.title;
+    isDetachedPage = false;
+  } else {
+    pageTitle = headingsWithoutLink.find((h) => h.url === url).title;
+    title = jsxToTextContent(pageTitle);
+    isDetachedPage = true;
+  }
+  const isLandingPage = url === "/";
+  if (!isLandingPage) {
+    title += " | " + config.projectInfo.projectName;
+  }
+  if (isLandingPage) {
+    pageTitle = null;
+  }
+  return { title, isLandingPage, pageTitle, isDetachedPage };
+}
+function findActiveHeading(headings, headingsWithoutLink, pageContext) {
+  let activeHeading = null;
+  assert(pageContext.urlOriginal);
+  const pageUrl = pageContext.urlOriginal;
+  headings.forEach((heading) => {
+    if (heading.url === pageUrl) {
+      activeHeading = heading;
+      assert(heading.level === 2, { pageUrl, heading });
+    }
+  });
+  const debugInfo = {
+    msg: "Heading not found for url: " + pageUrl,
+    urls: headings.map((h) => h.url),
+    url: pageUrl
+  };
+  assert(activeHeading || headingsWithoutLink.find(({ url }) => pageUrl === url), debugInfo);
+  return activeHeading;
+}
+function getHeadingsWithSubHeadings(headings, pageContext, activeHeading) {
+  const headingsWithSubHeadings = headings.slice();
+  if (activeHeading === null)
+    return headingsWithSubHeadings;
+  const activeHeadingIdx = headingsWithSubHeadings.indexOf(activeHeading);
+  assert(activeHeadingIdx >= 0);
+  const pageHeadings = pageContext.exports.headings || [];
+  pageHeadings.forEach((pageHeading, i) => {
+    const title = parseTitle(pageHeading.title);
+    const url = "#" + pageHeading.id;
+    assert(
+      pageHeading.headingLevel !== 3,
+      "Wrong page heading level `" + pageHeading.headingLevel + "` (it should be `<h2>`) for sub-heading `" + pageHeading.title + "` of page `" + pageContext.urlOriginal + "`."
+    );
+    if (pageHeading.headingLevel === 2) {
+      const heading = {
+        url,
+        title,
+        parentHeadings: [activeHeading, ...activeHeading.parentHeadings],
+        titleInNav: title,
+        level: 3
+      };
+      headingsWithSubHeadings.splice(activeHeadingIdx + 1 + i, 0, heading);
+    }
+  });
+  if (activeHeading == null ? void 0 : activeHeading.sectionTitles) {
+    activeHeading.sectionTitles.forEach((sectionTitle) => {
+      const pageHeadingTitles = pageHeadings.map((h) => h.title);
+      assert(pageHeadingTitles.includes(sectionTitle), { pageHeadingTitles, sectionTitle });
+    });
+  }
+  return headingsWithSubHeadings;
+}
+
+// src/algolia/DocSearch.ts
+import { escapeInject } from "vite-plugin-ssr";
+function getDocSearchCSS(pageContext) {
+  const docSearchCSS = !pageContext.meta.algolia ? "" : escapeInject`
+      <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@alpha" />
+    `;
+  return docSearchCSS;
+}
+var _a;
+function getDocSearchJS(pageContext) {
+  const docSearchJS = !pageContext.meta.algolia ? "" : escapeInject(_a || (_a = __template([`
+    <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/@docsearch/js@alpha"><\/script>
+    <script type="text/javascript">
+      docsearch({
+        appId: '`, "',\n        apiKey: '", "',\n        indexName: '", "',\n        container: '#docsearch-desktop',\n      })\n      docsearch({\n        appId: '", "',\n        apiKey: '", "',\n        indexName: '", "',\n        container: '#docsearch-mobile',\n      })\n    <\/script>\n  "])), pageContext.meta.algolia.appId, pageContext.meta.algolia.apiKey, pageContext.meta.algolia.indexName, pageContext.meta.algolia.appId, pageContext.meta.algolia.apiKey, pageContext.meta.algolia.indexName);
+  return docSearchJS;
+}
+
+// src/parseEmojis.ts
+import twemoji from "twemoji";
+var emojiList = {
+  ":no_entry:": 9940,
+  ":warning:": 9888,
+  ":trophy:": 127942
+};
+function parseEmojis(html) {
+  Object.entries(emojiList).forEach(([shortcode, codepoint]) => {
+    if (!html.includes(shortcode)) {
+      return;
+    }
+    const emojiStr = twemoji.convert.fromCodePoint(codepoint);
+    let emojiImg = 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;
+}
+
+// src/renderer/_default.page.server.tsx
+async function render(pageContextOriginal) {
+  const { Page } = pageContextOriginal;
+  const pageContextResolved = resolvePageContext(pageContextOriginal);
+  const page = /* @__PURE__ */ React7.createElement(PageLayout, { pageContext: pageContextResolved }, /* @__PURE__ */ React7.createElement(Page, null));
+  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 escapeInject2`<!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, meta) {
+  const { title, tagline, websiteUrl, twitterHandle, bannerUrl } = meta;
+  assert(url.startsWith("/"));
+  if (url !== "/" || !bannerUrl)
+    return "";
+  return escapeInject2`
+    <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}">
+  `;
+}
+export {
+  render
+};
+//# sourceMappingURL=_default.page.server.js.map