moonwave-gitlab 1.3.3

package/src/commands/dev.ts

@@ -0,0 +1,83 @@
+import { spawn } from "child_process"
+import chokidar from "chokidar"
+import fs from "fs-extra"
+import path from "path"
+import { Args } from "../argv.js"
+import { getBinaryPath } from "../binary.js"
+import { prepareProject } from "../prepareProject.js"
+
+export default async function devCommand(args: Args) {
+  try {
+    const binaryPath = await getBinaryPath()
+
+    const { tempDir, watchPaths, projectDir } = prepareProject(process.cwd(), {
+      codePaths: args.code,
+      fresh: args.fresh,
+      install: args.install,
+      binaryPath,
+    })
+
+    console.error(
+      `Moonwave: Temporary build directory is located at ${tempDir}`
+    )
+
+    chokidar
+      .watch(projectDir, {
+        ignoreInitial: true,
+      })
+      .on("all", (event, changedPath) => {
+        if (
+          watchPaths.some((watchPath) => {
+            if (path.normalize(watchPath) === path.normalize(changedPath)) {
+              return true
+            }
+
+            const relative = path.relative(watchPath, changedPath)
+            return (
+              relative &&
+              !relative.startsWith("..") &&
+              !path.isAbsolute(relative)
+            )
+          })
+        ) {
+          if (event === "unlink" || event == "unlinkDir") {
+            const relativePath = path.relative(projectDir, changedPath)
+            const targetPath = path.join(tempDir, relativePath)
+
+            fs.removeSync(targetPath)
+          }
+
+          prepareProject(process.cwd(), {
+            codePaths: args.code,
+            fresh: false,
+            skipRootCopy: true,
+            binaryPath,
+          })
+        }
+      })
+
+    const exitCode = await new Promise((resolve) => {
+      spawn(
+        "npm" + (process.platform === "win32" ? ".cmd" : ""),
+        ["run", "start"],
+        {
+          cwd: tempDir,
+          shell: true,
+          stdio: "inherit",
+        }
+      )
+        .on("exit", resolve)
+        .on("error", console.error)
+    })
+
+    if (exitCode !== 0) {
+      throw new Error("Non-zero exit code")
+    }
+  } catch (e) {
+    console.error(typeof e === "object" && e !== null ? e.toString() : e)
+    console.error(
+      "Moonwave: It looks like something went wrong. Check the error output above."
+    )
+    process.exit(1)
+  }
+}

package/src/getDocusaurusConfig.ts

@@ -0,0 +1,168 @@
+import fs from "fs-extra"
+import path from "path"
+import { ClassOrder, Config, FoldersEnabled } from "./prepareProject.js"
+
+export interface GenerateConfigParams {
+  codePaths: string[]
+  enablePlugins: FoldersEnabled
+  config: Config
+  customCssExists: boolean
+  customSidebarExists: boolean
+  changelogExists: boolean
+  projectDir: string
+  binaryPath: string
+  classOrder: ClassOrder
+  apiCategories: string[]
+  autoSectionPath?: string
+}
+
+export default function getDocusaurusConfig({
+  codePaths,
+  enablePlugins,
+  config,
+  customCssExists,
+  customSidebarExists,
+  changelogExists,
+  projectDir,
+  binaryPath,
+  classOrder,
+  apiCategories,
+  autoSectionPath,
+}: GenerateConfigParams) {
+  const gitRepoUrl = config.gitRepoUrl
+
+  const validCodePaths = codePaths
+    .map((codePath) => path.join(process.cwd(), codePath))
+    .filter((codePath) => fs.existsSync(codePath))
+
+  return {
+    onBrokenLinks: "throw",
+    onBrokenMarkdownLinks: "warn",
+    url: `https://${config.docusaurus?.organizationName}.github.io`,
+
+    ...config.docusaurus,
+
+    customFields: {
+      bannerImage: config.home?.bannerImage,
+    },
+
+    themeConfig: {
+      prism: {
+        additionalLanguages: [
+          "lua",
+          "bash",
+          "css",
+          "javascript",
+          "diff",
+          "git",
+          "json",
+          "typescript",
+          "toml",
+        ],
+      },
+
+      navbar: {
+        ...config.navbar,
+
+        items: [
+          ...(enablePlugins.docs
+            ? [
+                {
+                  type: "doc",
+                  docId: "intro",
+                  position: "left",
+                  label: "Docs",
+                },
+              ]
+            : []),
+          ...(enablePlugins.blog
+            ? [{ to: "/blog", label: "Blog", position: "left" }]
+            : []),
+          ...(validCodePaths.length > 0
+            ? [{ to: "/api/", label: "API", position: "left" }]
+            : []),
+          ...(changelogExists
+            ? [{ to: "/changelog", label: "Changelog", position: "left" }]
+            : []),
+          ...(config?.navbar?.items || []),
+          ...(gitRepoUrl
+            ? [
+                {
+                  href: gitRepoUrl,
+                  label: "GitLab",
+                  position: "right",
+                },
+              ]
+            : []),
+        ],
+      },
+      footer: {
+        style: "dark",
+        copyright: `Copyright © ${new Date().getFullYear()} ${
+          config.docusaurus?.organizationName ?? ""
+        }. Built with Moonwave and Docusaurus.`,
+        ...config.footer,
+      },
+
+      colorMode: {
+        respectPrefersColorScheme: true,
+      },
+    },
+    plugins: [
+      [
+        "docusaurus-plugin-moonwave",
+        {
+          id: "moonwave",
+          code: validCodePaths,
+          sourceUrl: gitRepoUrl + `-/blob/${config.gitSourceBranch ?? "main"}`,
+          projectDir,
+          classOrder,
+          apiCategories,
+          binaryPath,
+          autoSectionPath,
+        },
+      ],
+      "docusaurus-lunr-search",
+    ],
+    presets: [
+      [
+        "@docusaurus/preset-classic",
+        {
+          docs: enablePlugins.docs
+            ? {
+                // Please change this to your repo.
+                editUrl: gitRepoUrl
+                  ? `${gitRepoUrl}/-/edit/${config.gitSourceBranch ?? "main"}/`
+                  : undefined, // Omitting this variable entirely will disable edit links
+                sidebarCollapsible: true,
+                sidebarPath: customSidebarExists
+                  ? "./src/sidebars.js"
+                  : undefined,
+              }
+            : false,
+          blog: enablePlugins.blog
+            ? {
+                showReadingTime: true,
+                // Please change this to your repo.
+                editUrl: gitRepoUrl
+                  ? `${gitRepoUrl}/-/edit/${config.gitSourceBranch ?? "main"}/`
+                  : undefined, // Omitting this variable entirely will disable edit links
+              }
+            : false,
+          pages: {
+            path: "pages",
+
+            //exclude any file starting with an underscore
+            exclude: ["_*.*"],
+          },
+          theme: {
+            customCss: [
+              "src/css/moonwave.css",
+              ...(customCssExists ? ["src/css/custom.css"] : []),
+            ],
+          },
+        },
+      ],
+    ],
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "./argv.js"