move common dir

src/app/(pages)/documentation/[[...slug]]/page.tsx

@@ -1,7 +1,7 @@
-import { getDocumentation } from "@/common/documentation";
+import { getDocumentation } from "@/app/common/documentation";
 import { CustomMDX } from "@/app/components/mx-components";
 import { Metadata } from "next";
-import { generateEmbed } from "@/common/embed";
+import { generateEmbed } from "@/app/common/embed";
 
 type DocumentationPageParams = {
   params: {

src/app/(pages)/mojang/status/page.tsx

@@ -1,12 +1,12 @@
 import { Card } from "@/app/components/card";
-import { generateEmbed } from "@/common/embed";
-import { capitalizeFirstLetter } from "@/common/string-utils";
-import { cn } from "@/common/utils";
+import { generateEmbed } from "@/app/common/embed";
+import { capitalizeFirstLetter } from "@/app/common/string-utils";
+import { cn } from "@/app/common/utils";
 import { CachedEndpointStatus, getMojangEndpointStatus, Status } from "mcutils-library";
 import { Metadata, Viewport } from "next";
 import Link from "next/link";
 import { ReactElement } from "react";
-import { Colors } from "@/common/colors";
+import { Colors } from "@/app/common/colors";
 import { Title } from "@/app/components/title";
 
 /**

src/app/(pages)/player/[[...id]]/page.tsx

@@ -4,9 +4,9 @@ import { ErrorCard } from "@/app/components/error-card";
 import { LookupPlayer } from "@/app/components/player/lookup-player";
 import { PlayerView } from "@/app/components/player/player-view";
 import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuTrigger } from "@/app/components/ui/context-menu";
-import { Colors } from "@/common/colors";
-import { generateEmbed } from "@/common/embed";
-import { isValidPlayer } from "@/common/player";
+import { Colors } from "@/app/common/colors";
+import { generateEmbed } from "@/app/common/embed";
+import { isValidPlayer } from "@/app/common/player";
 import config from "@root/config.json";
 import { CachedPlayer, getPlayer, McUtilsAPIError } from "mcutils-library";
 import { Metadata, Viewport } from "next";

src/app/(pages)/server/[platform]/[[...hostname]]/page.tsx

@@ -3,11 +3,11 @@ import { ErrorCard } from "@/app/components/error-card";
 import { LookupServer } from "@/app/components/server/lookup-server";
 import { ServerView } from "@/app/components/server/server-view";
 import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuTrigger } from "@/app/components/ui/context-menu";
-import { Colors } from "@/common/colors";
-import { generateEmbed } from "@/common/embed";
-import { formatNumber } from "@/common/number-utils";
-import { isValidServer } from "@/common/server";
-import { capitalizeFirstLetter } from "@/common/string-utils";
+import { Colors } from "@/app/common/colors";
+import { generateEmbed } from "@/app/common/embed";
+import { formatNumber } from "@/app/common/number-utils";
+import { isValidServer } from "@/app/common/server";
+import { capitalizeFirstLetter } from "@/app/common/string-utils";
 import config from "@root/config.json";
 import {
   CachedBedrockMinecraftServer,

src/app/common/colors.ts

@@ -0,0 +1,8 @@
+/**
+ * Re-useable colors.
+ */
+export const Colors = {
+  green: "#0FFF50",
+  red: "#8B0000",
+  yellow: "#FFD700",
+};

src/app/common/documentation.ts

@@ -0,0 +1,99 @@
+/* eslint-disable */
+
+import * as fs from "node:fs";
+import path from "node:path";
+// @ts-ignore
+import read from "read-file";
+
+type Metadata = {
+  /**
+   * The title of the documentation page.
+   */
+  title: string;
+
+  /**
+   * The description of the documentation page.
+   */
+  description?: string;
+};
+
+/**
+ * The directory where the documentation files are stored.
+ */
+const documentationDirectory = path.join(process.cwd(), "documentation");
+
+/**
+ * Gets all the documentation files recursively.
+ *
+ * @param dirPath the directory path to search for documentation files.
+ */
+function getDocumentationFiles(dirPath: string): string[] {
+  let files: string[] = [];
+  const items = fs.readdirSync(dirPath);
+
+  items.forEach(item => {
+    const itemPath = path.join(dirPath, item);
+    const stat = fs.statSync(itemPath);
+
+    if (stat.isDirectory()) {
+      // Recursively traverse directories
+      files.push(...getDocumentationFiles(itemPath));
+    } else if (stat.isFile() && path.extname(item) === ".md") {
+      // Collect markdown files
+      files.push(itemPath);
+    }
+  });
+
+  return files;
+}
+
+/**
+ * Gets the content of a documentation file.
+ *
+ * @param file the file to get the content of.
+ */
+function getDocumentationFileContent(file: string) {
+  return read.sync(file, "utf8");
+}
+
+/**
+ * Gets all the documentation pages.
+ */
+export function getDocumentation() {
+  const files = getDocumentationFiles(documentationDirectory);
+
+  return files.map(file => {
+    const { metadata, content } = parseFrontmatter(getDocumentationFileContent(file));
+    let slug = path.relative(documentationDirectory, file).replace(/\.(md)$/, "");
+    slug = slug.replace(/\\/g, "/"); // Normalize path separators
+
+    return {
+      metadata,
+      content,
+      slug,
+    };
+  });
+}
+
+/**
+ * Parses the frontmatter of a file.
+ *
+ * @param fileContent the content of the file.
+ */
+function parseFrontmatter(fileContent: string) {
+  let frontmatterRegex = /---\s*([\s\S]*?)\s*---/;
+  let match = frontmatterRegex.exec(fileContent);
+  let frontMatterBlock = match![1];
+  let content = fileContent.replace(frontmatterRegex, "").trim();
+  let frontMatterLines = frontMatterBlock.trim().split("\n");
+  let metadata: Partial<Metadata> = {};
+
+  frontMatterLines.forEach(line => {
+    let [key, ...valueArr] = line.split(": ");
+    let value = valueArr.join(": ").trim();
+    value = value.replace(/^['"](.*)['"]$/, "$1"); // Remove quotes
+    metadata[key.trim() as keyof Metadata] = value;
+  });
+
+  return { metadata: metadata as Metadata, content };
+}

src/app/common/embed.ts

@@ -0,0 +1,60 @@
+import { Metadata } from "next";
+
+type Embed = {
+  /**
+   * The title of the embed.
+   */
+  title: string;
+
+  /**
+   * The title of the embed.
+   */
+  embedTitle?: string;
+
+  /**
+   * The description of the embed.
+   */
+  description: string;
+
+  /**
+   * The image to show as the thumbmail.
+   */
+  image?: string;
+};
+
+/**
+ * Generates metadata for a embed.
+ *
+ * @param title the title of the embed
+ * @param embedTitle the title of the embed
+ * @param description the description of the embed
+ * @param image the image to show as the thumbmail
+ * @returns the metadata for the embed
+ */
+export function generateEmbed({ title, embedTitle, description, image }: Embed): Metadata {
+  // Fall back to the title
+  if (!embedTitle) {
+    embedTitle = title;
+  }
+
+  const metadata: Metadata = {
+    title: `${title}`,
+    openGraph: {
+      title: `${title}`,
+      description: description,
+    },
+    twitter: {
+      card: "summary",
+    },
+  };
+
+  if (image) {
+    metadata.openGraph!.images = [
+      {
+        url: image || "",
+      },
+    ];
+  }
+
+  return metadata;
+}

src/app/common/number-utils.ts

@@ -0,0 +1,9 @@
+/**
+ * Formats a number using the browser's locale
+ *
+ * @param number the number to format
+ * @returns the formatted number
+ */
+export function formatNumber(number: number): string {
+  return new Intl.NumberFormat().format(number);
+}

src/app/common/player.ts

@@ -0,0 +1,16 @@
+import { getPlayer } from "mcutils-library";
+
+/**
+ * Checks if the player is valid.
+ *
+ * @param id the player's id
+ * @returns true if valid, false otherwise
+ */
+export async function isValidPlayer(id: string): Promise<boolean> {
+  try {
+    await getPlayer(id);
+    return true;
+  } catch {
+    return false;
+  }
+}

src/app/common/server.ts

@@ -0,0 +1,17 @@
+import { getServer, ServerPlatform } from "mcutils-library";
+
+/**
+ * Checks if the server is valid.
+ *
+ * @param platform the server's platform
+ * @param query the hostname for the server
+ * @returns true if valid, false otherwise
+ */
+export async function isValidServer(platform: ServerPlatform, query: string): Promise<boolean> {
+  try {
+    await getServer(platform, query);
+    return true;
+  } catch {
+    return false;
+  }
+}

src/app/common/string-utils.ts

@@ -0,0 +1,9 @@
+/**
+ * Capitalizes the first letter of a string
+ *
+ * @param str the string to change
+ * @returns the updated string
+ */
+export function capitalizeFirstLetter(str: string) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}

src/app/common/time-utils.ts

@@ -0,0 +1,11 @@
+import moment from "moment";
+
+/**
+ * Formats the time
+ *
+ * @param time the time to format
+ * @returns the formatted time
+ */
+export function formatTime(time: Date): string {
+  return moment(time).format("lll");
+}

src/app/common/use-toast.ts

@@ -0,0 +1,189 @@
+"use client";
+
+// Inspired by react-hot-toast library
+import * as React from "react";
+
+import type { ToastActionElement, ToastProps } from "@/app/components/ui/toast";
+
+const TOAST_LIMIT = 1;
+const TOAST_REMOVE_DELAY = 1000000;
+
+type ToasterToast = ToastProps & {
+  id: string;
+  title?: React.ReactNode;
+  description?: React.ReactNode;
+  action?: ToastActionElement;
+};
+
+const actionTypes = {
+  ADD_TOAST: "ADD_TOAST",
+  UPDATE_TOAST: "UPDATE_TOAST",
+  DISMISS_TOAST: "DISMISS_TOAST",
+  REMOVE_TOAST: "REMOVE_TOAST",
+} as const;
+
+let count = 0;
+
+function genId() {
+  count = (count + 1) % Number.MAX_SAFE_INTEGER;
+  return count.toString();
+}
+
+type ActionType = typeof actionTypes;
+
+type Action =
+  | {
+      type: ActionType["ADD_TOAST"];
+      toast: ToasterToast;
+    }
+  | {
+      type: ActionType["UPDATE_TOAST"];
+      toast: Partial<ToasterToast>;
+    }
+  | {
+      type: ActionType["DISMISS_TOAST"];
+      toastId?: ToasterToast["id"];
+    }
+  | {
+      type: ActionType["REMOVE_TOAST"];
+      toastId?: ToasterToast["id"];
+    };
+
+interface State {
+  toasts: ToasterToast[];
+}
+
+const toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>();
+
+const addToRemoveQueue = (toastId: string) => {
+  if (toastTimeouts.has(toastId)) {
+    return;
+  }
+
+  const timeout = setTimeout(() => {
+    toastTimeouts.delete(toastId);
+    dispatch({
+      type: "REMOVE_TOAST",
+      toastId: toastId,
+    });
+  }, TOAST_REMOVE_DELAY);
+
+  toastTimeouts.set(toastId, timeout);
+};
+
+export const reducer = (state: State, action: Action): State => {
+  switch (action.type) {
+    case "ADD_TOAST":
+      return {
+        ...state,
+        toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT),
+      };
+
+    case "UPDATE_TOAST":
+      return {
+        ...state,
+        toasts: state.toasts.map(t => (t.id === action.toast.id ? { ...t, ...action.toast } : t)),
+      };
+
+    case "DISMISS_TOAST": {
+      const { toastId } = action;
+
+      // ! Side effects ! - This could be extracted into a dismissToast() action,
+      // but I'll keep it here for simplicity
+      if (toastId) {
+        addToRemoveQueue(toastId);
+      } else {
+        state.toasts.forEach(toast => {
+          addToRemoveQueue(toast.id);
+        });
+      }
+
+      return {
+        ...state,
+        toasts: state.toasts.map(t =>
+          t.id === toastId || toastId === undefined
+            ? {
+                ...t,
+                open: false,
+              }
+            : t,
+        ),
+      };
+    }
+    case "REMOVE_TOAST":
+      if (action.toastId === undefined) {
+        return {
+          ...state,
+          toasts: [],
+        };
+      }
+      return {
+        ...state,
+        toasts: state.toasts.filter(t => t.id !== action.toastId),
+      };
+  }
+};
+
+const listeners: Array<(state: State) => void> = [];
+
+let memoryState: State = { toasts: [] };
+
+function dispatch(action: Action) {
+  memoryState = reducer(memoryState, action);
+  listeners.forEach(listener => {
+    listener(memoryState);
+  });
+}
+
+type Toast = Omit<ToasterToast, "id">;
+
+function toast({ ...props }: Toast) {
+  const id = genId();
+
+  const update = (props: ToasterToast) =>
+    dispatch({
+      type: "UPDATE_TOAST",
+      toast: { ...props, id },
+    });
+  const dismiss = () => dispatch({ type: "DISMISS_TOAST", toastId: id });
+
+  dispatch({
+    type: "ADD_TOAST",
+    toast: {
+      ...props,
+      id,
+      open: true,
+      onOpenChange: open => {
+        if (!open) dismiss();
+      },
+    },
+  });
+
+  return {
+    id: id,
+    dismiss,
+    update,
+  };
+}
+
+function useToast() {
+  const [state, setState] = React.useState<State>(memoryState);
+
+  React.useEffect(() => {
+    listeners.push(setState);
+    return () => {
+      const index = listeners.indexOf(setState);
+      if (index > -1) {
+        listeners.splice(index, 1);
+      }
+    };
+  }, [state]);
+
+  return {
+    ...state,
+    toast,
+    dismiss: (toastId?: string) => dispatch({ type: "DISMISS_TOAST", toastId }),
+  };
+}
+
+export { useToast, toast };

src/app/common/utils.ts

@@ -0,0 +1,12 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * Merge class values together
+ *
+ * @param inputs the class values
+ * @returns the merged class values
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

src/app/components/card.tsx

@@ -1,5 +1,5 @@
 import { Card as ShadcnCard, CardContent } from "@/app/components/ui/card";
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 import { ReactElement } from "react";
 import { type ClassValue } from "clsx";
 

src/app/components/copy-button.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useToast } from "@/common/use-toast";
+import { useToast } from "@/app/common/use-toast";
 import copy from "clipboard-copy";
 import { ReactElement } from "react";
 

src/app/components/href-button.tsx

@@ -1,4 +1,4 @@
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 import Link from "next/link";
 import { ReactElement } from "react";
 

src/app/components/mx-components.tsx

@@ -1,8 +1,9 @@
 import { MDXRemote } from "remote-mdx/rsc";
 import { CodeHighlighter } from "@/app/components/code-highlighter";
 import { Separator } from "@/app/components/ui/separator";
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 import Link from "next/link";
+import { ReactElement } from "react";
 
 /**
  * Create a heading component.
@@ -50,6 +51,6 @@ const components = {
   ),
 };
 
-export function CustomMDX(props: any) {
+export function CustomMDX(props: any): ReactElement {
   return <MDXRemote {...props} components={{ ...components, ...(props.components || {}) }} />;
 }

src/app/components/navbar.tsx

@@ -8,7 +8,7 @@ import Logo from "./logo";
 import { ToggleThemeButton } from "./theme-toggle-button";
 import { GithubStar } from "@/app/components/github-star";
 import { Card } from "@/app/components/card";
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 type Page = {
   /**

src/app/components/player/lookup-player.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useToast } from "@/common/use-toast";
+import { useToast } from "@/app/common/use-toast";
 import { getPlayer } from "mcutils-library";
 import { useRouter } from "next/navigation";
 import { ReactElement, useState } from "react";

src/app/components/player/skin-part-image.tsx

@@ -1,5 +1,5 @@
 /* eslint-disable @next/next/no-img-element */
-import { capitalizeFirstLetter } from "@/common/string-utils";
+import { capitalizeFirstLetter } from "@/app/common/string-utils";
 import { SkinPart } from "mcutils-library";
 import Link from "next/link";
 import { ReactElement } from "react";

src/app/components/server/lookup-server.tsx

@@ -1,7 +1,7 @@
 "use client";
 
-import { capitalizeFirstLetter } from "@/common/string-utils";
-import { useToast } from "@/common/use-toast";
+import { capitalizeFirstLetter } from "@/app/common/string-utils";
+import { useToast } from "@/app/common/use-toast";
 import { getServer, ServerPlatform } from "mcutils-library";
 import { useRouter } from "next/navigation";
 import { ReactElement, useState } from "react";

src/app/components/server/server-view.tsx

@@ -4,7 +4,7 @@ import { ReactElement } from "react";
 import { CodeDialog } from "../code-dialog";
 import { Button } from "../ui/button";
 import config from "@root/config.json";
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 import { minecraft } from "@/app/font/fonts";
 import { CacheInformation } from "@/app/components/cache-information";
 

src/app/components/ui/button.tsx

@@ -2,7 +2,7 @@ import { Slot } from "@radix-ui/react-slot";
 import { cva, type VariantProps } from "class-variance-authority";
 import * as React from "react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const buttonVariants = cva(
   "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",

src/app/components/ui/card.tsx

@@ -1,6 +1,6 @@
 import * as React from "react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const Card = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(({ className, ...props }, ref) => (
   <div ref={ref} className={cn("rounded-lg border bg-card text-card-foreground shadow-sm", className)} {...props} />

src/app/components/ui/context-menu.tsx

@@ -4,7 +4,7 @@ import * as React from "react";
 import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
 import { Check, ChevronRight, Circle } from "lucide-react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const ContextMenu = ContextMenuPrimitive.Root;
 

src/app/components/ui/dialog.tsx

@@ -4,7 +4,7 @@ import * as DialogPrimitive from "@radix-ui/react-dialog";
 import { X } from "lucide-react";
 import * as React from "react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const Dialog = DialogPrimitive.Root;
 

src/app/components/ui/input.tsx

@@ -1,6 +1,6 @@
 import * as React from "react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {}
 

src/app/components/ui/label.tsx

@@ -4,7 +4,7 @@ import * as React from "react";
 import * as LabelPrimitive from "@radix-ui/react-label";
 import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const labelVariants = cva("text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70");
 

src/app/components/ui/popover.tsx

@@ -3,7 +3,7 @@
 import * as React from "react";
 import * as PopoverPrimitive from "@radix-ui/react-popover";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const Popover = PopoverPrimitive.Root;
 

src/app/components/ui/select.tsx

@@ -4,7 +4,7 @@ import * as React from "react";
 import * as SelectPrimitive from "@radix-ui/react-select";
 import { Check, ChevronDown, ChevronUp } from "lucide-react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const Select = SelectPrimitive.Root;
 

src/app/components/ui/separator.tsx

@@ -3,7 +3,7 @@
 import * as React from "react";
 import * as SeparatorPrimitive from "@radix-ui/react-separator";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const Separator = React.forwardRef<
   React.ElementRef<typeof SeparatorPrimitive.Root>,

src/app/components/ui/table.tsx

@@ -1,4 +1,4 @@
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 import * as React from "react";
 
 const Table = React.forwardRef<HTMLTableElement, React.HTMLAttributes<HTMLTableElement>>(

src/app/components/ui/toast.tsx

@@ -5,7 +5,7 @@ import * as ToastPrimitives from "@radix-ui/react-toast";
 import { cva, type VariantProps } from "class-variance-authority";
 import { X } from "lucide-react";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const ToastProvider = ToastPrimitives.Provider;
 

src/app/components/ui/toaster.tsx

@@ -8,7 +8,7 @@ import {
   ToastTitle,
   ToastViewport,
 } from "@/app/components/ui/toast";
-import { useToast } from "@/common/use-toast";
+import { useToast } from "@/app/common/use-toast";
 
 export function Toaster() {
   const { toasts } = useToast();

src/app/components/ui/tooltip.tsx

@@ -3,7 +3,7 @@
 import * as React from "react";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 
-import { cn } from "@/common/utils";
+import { cn } from "@/app/common/utils";
 
 const TooltipProvider = TooltipPrimitive.Provider;