docs: create docs workspace (#5174)

* docs: migrate ui docs to docs universe * created yarn workspace * added eslint and tsconfig configurations * fix eslint configurations * fixed eslint configurations * shared tailwind configurations * added shared ui package * added more shared components * migrating more components * made details components shared * move InlineCode component * moved InputText * moved Loading component * Moved Modal component * moved Select components * Moved Tooltip component * moved Search components * moved ColorMode provider * Moved Notification components and providers * used icons package * use UI colors in api-reference * moved Navbar component * used Navbar and Search in UI docs * added Feedback to UI docs * general enhancements * fix color mode * added copy colors file from ui-preset * added features and enhancements to UI docs * move Sidebar component and provider * general fixes and preparations for deployment * update docusaurus version * adjusted versions * fix output directory * remove rootDirectory property * fix yarn.lock * moved code component * added vale for all docs MD and MDX * fix tests * fix vale error * fix deployment errors * change ignore commands * add output directory * fix docs test * general fixes * content fixes * fix announcement script * added changeset * fix vale checks * added nofilter option * fix vale error
2023-09-21 20:57:15 +03:00
parent 19c5d5ba36
commit fa7c94b4cc
3209 changed files with 32188 additions and 31018 deletions
--- a/www/apps/docs/src/theme/CodeBlock/index.tsx
+++ b/www/apps/docs/src/theme/CodeBlock/index.tsx
@@ -0,0 +1,59 @@
+import React, { isValidElement, type ReactNode } from "react"
+import useIsBrowser from "@docusaurus/useIsBrowser"
+import ElementContent from "@theme/CodeBlock/Content/Element"
+import StringContent from "@theme/CodeBlock/Content/String"
+import type { Props } from "@theme/CodeBlock"
+import clsx from "clsx"
+
+/**
+ * Best attempt to make the children a plain string so it is copyable. If there
+ * are react elements, we will not be able to copy the content, and it will
+ * return `children` as-is; otherwise, it concatenates the string children
+ * together.
+ */
+function maybeStringifyChildren(children: ReactNode): ReactNode {
+  if (React.Children.toArray(children).some((el) => isValidElement(el))) {
+    return children
+  }
+  // The children is now guaranteed to be one/more plain strings
+  return Array.isArray(children) ? children.join("") : (children as string)
+}
+
+export default function CodeBlock({
+  children: rawChildren,
+  noReport = false,
+  noCopy = false,
+  ...props
+}: Props): JSX.Element {
+  // The Prism theme on SSR is always the default theme but the site theme can
+  // be in a different mode. React hydration doesn't update DOM styles that come
+  // from SSR. Hence force a re-render after mounting to apply the current
+  // relevant styles.
+  const isBrowser = useIsBrowser()
+  const children = maybeStringifyChildren(rawChildren)
+  const CodeBlockComp =
+    typeof children === "string" ? StringContent : ElementContent
+
+  const title = props.title
+  delete props.title
+
+  return (
+    <div className="code-wrapper">
+      {title && <div className="code-header">{title}</div>}
+      <CodeBlockComp
+        key={String(isBrowser)}
+        noReport={noReport}
+        noCopy={noCopy}
+        {...props}
+        className={clsx(
+          !title && "rounded",
+          title && "!rounded-t-none !rounded-b",
+          props.className
+        )}
+        showLineNumbers={true}
+      >
+        {children as string}
+      </CodeBlockComp>
+    </div>
+  )
+}