clean up docs lib sprawl

Author: mitchellh

src/app/docs/DocsPageContent.tsx

@@ -3,8 +3,8 @@ import NavTree, { type NavTreeNode } from "@/components/nav-tree";
 import ScrollToTopButton from "@/components/scroll-to-top";
 import Sidecar from "@/components/sidecar";
 import { H1, P } from "@/components/text";
-import type { DocsPageData } from "@/lib/fetch-docs";
-import { DOCS_PAGES_ROOT_PATH, GITHUB_REPO_URL } from "@/lib/docs-config";
+import { DOCS_PAGES_ROOT_PATH, GITHUB_REPO_URL } from "@/lib/docs/config";
+import type { DocsPageData } from "@/lib/docs/page";
 import { Pencil } from "lucide-react";
 import s from "./DocsPage.module.css";
 import customMdxStyles from "@/components/custom-mdx/CustomMDX.module.css";

src/app/docs/[[...path]]/page.tsx

@@ -2,15 +2,17 @@ import type { Metadata } from "next";
 import { notFound } from "next/navigation";
 import type { Breadcrumb } from "@/components/breadcrumbs";
 import type { NavTreeNode } from "@/components/nav-tree";
-import { DOCS_DIRECTORY, DOCS_PAGES_ROOT_PATH } from "@/lib/docs-config";
+import { DOCS_DIRECTORY, DOCS_PAGES_ROOT_PATH } from "@/lib/docs/config";
 import {
   type DocsPageData,
   loadAllDocsPageSlugs,
   loadDocsPage,
-} from "@/lib/fetch-docs";
-import { docsMetadataTitle } from "@/lib/docs-metadata-title";
-import { loadDocsNavTreeData } from "@/lib/fetch-nav";
-import { navTreeToBreadcrumbs } from "@/lib/nav-tree-to-breadcrumbs";
+} from "@/lib/docs/page";
+import {
+  docsMetadataTitle,
+  loadDocsNavTreeData,
+  navTreeToBreadcrumbs,
+} from "@/lib/docs/navigation";
 import DocsPageContent from "../DocsPageContent";
 
 interface DocsRouteProps {

src/app/layout.tsx

@@ -4,8 +4,8 @@ import type { SimpleLink } from "@/components/link";
 import Navbar from "@/components/navbar";
 import PreviewBanner from "@/components/preview-banner";
 import { jetbrainsMono, pretendardStdVariable } from "@/components/text";
-import { DOCS_DIRECTORY } from "@/lib/docs-config";
-import { loadDocsNavTreeData } from "@/lib/fetch-nav";
+import { DOCS_DIRECTORY } from "@/lib/docs/config";
+import { loadDocsNavTreeData } from "@/lib/docs/navigation";
 import "@/styles/globals.css";
 import classNames from "classnames";
 import type { Metadata } from "next";

src/components/custom-mdx/index.tsx

@@ -7,7 +7,7 @@ import Text from "../text";
 import s from "./JumplinkHeader.module.css";
 import { useInView } from "react-intersection-observer";
 import { isValidElement, useEffect } from "react";
-import { useStore } from "@/lib/use-store";
+import { useDocsStore } from "@/lib/docs/store";
 
 interface JumplinkHeaderProps {
   as: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
@@ -32,7 +32,9 @@ export default function JumplinkHeader({
     rootMargin: "-72px",
     threshold: 1,
   });
-  const updateHeaderIdInView = useStore((state) => state.updateHeaderIdInView);
+  const updateHeaderIdInView = useDocsStore(
+    (state) => state.updateHeaderIdInView,
+  );
   useEffect(() => {
     updateHeaderIdInView(inView, id);
   }, [inView, id, updateHeaderIdInView]);

src/components/jumplink-header/index.tsx

@@ -12,11 +12,10 @@ import NavTree, {
   type LinkNode,
   type NavTreeNode,
 } from "../nav-tree";
+import { DOCS_PAGES_ROOT_PATH } from "@/lib/docs/config";
 import GhosttyWordmark from "./ghostty-wordmark.svg";
 import s from "./Navbar.module.css";
 
-const DOCS_PAGES_ROOT_PATH = "/docs";
-
 export interface NavbarProps {
   className?: string;
   links?: SimpleLink[];

src/components/navbar/index.tsx

@@ -5,7 +5,7 @@ import { useEffect, useMemo, useRef, useState } from "react";
 import classNames from "classnames";
 import { P } from "../text";
 import s from "./Sidecar.module.css";
-import { useStore } from "@/lib/use-store";
+import { useDocsStore } from "@/lib/docs/store";
 
 interface SidecarItem {
   id: string;
@@ -33,7 +33,7 @@ export default function Sidecar({
 }: SidecarProps) {
   const activeItemRef = useRef<HTMLLIElement>(null);
   const sidecarRef = useRef<HTMLDivElement>(null);
-  const headerIdsInView = useStore((state) => state.headerIdsInView);
+  const headerIdsInView = useDocsStore((state) => state.headerIdsInView);
   const shownItems = useMemo(() => {
     return items.filter((v) => v.depth <= MAX_SIDECAR_HEADER_DEPTH);
   }, [items]);

src/components/sidecar/index.tsx

@@ -0,0 +1,8 @@
+// DOCS_DIRECTORY is the on-disk root directory that contains docs MDX and nav data.
+export const DOCS_DIRECTORY = "./docs";
+
+// DOCS_PAGES_ROOT_PATH is the URL prefix under which docs pages are served.
+export const DOCS_PAGES_ROOT_PATH = "/docs";
+
+// GITHUB_REPO_URL is the canonical repository URL used for edit links.
+export const GITHUB_REPO_URL = "https://github.com/ghostty-org/website";