portosaurus 2.0.0 → 2.0.2

package/bin/portosaurus.mjs

@@ -89,7 +89,7 @@ function ensureContentDirs(projectRoot) {
   if (!fs.existsSync(notesIndex)) {
     fs.writeFileSync(
       notesIndex,
-      `---\nhide_table_of_contents: true\n---\n\nimport NoteCards from "@site/src/components/NoteIndex";\n\n# Notes\n\n<NoteCards />\n`,
+      `---\nhide_table_of_contents: true\n---\n\nimport NoteCards from "portosaurus/src/components/NoteIndex/index.js";\n\n# Notes\n\n<NoteCards />\n`,
     );
     logger.debug("Created default notes/index.mdx");
   }
@@ -191,6 +191,12 @@ program
         dependencies: {
           portosaurus: `^${packageJson.version}`,
         },
+        overrides: {
+          webpack: "5.105.4",
+        },
+        resolutions: {
+          webpack: "5.105.4",
+        },
       };
       fs.writeFileSync(
         path.join(projectPath, "package.json"),
@@ -206,6 +212,11 @@ program
       // Git init
       try {
         execSync("git init", { cwd: projectPath, stdio: "ignore" });
+        execSync("git add .", { cwd: projectPath, stdio: "ignore" });
+        execSync('git commit -m "Initialize Portosaurus project"', {
+          cwd: projectPath,
+          stdio: "ignore",
+        });
       } catch {
         logger.warn("Failed to initialize git repository.");
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portosaurus",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "private": false,
   "bin": {
     "portosaurus": "bin/portosaurus.mjs"

package/src/core/createDocuConf.mjs

@@ -115,7 +115,12 @@ function getVersion() {
 function useEnabled(items) {
   if (!Array.isArray(items)) return [];
   return items.flatMap((item) => {
-    if (item && typeof item === "object" && "enable" in item && "value" in item) {
+    if (
+      item &&
+      typeof item === "object" &&
+      "enable" in item &&
+      "value" in item
+    ) {
       return item.enable === true ? [item.value] : [];
     }
     return [item];
@@ -169,7 +174,9 @@ export function createDocuConf(rawUserConfig, projectRoot) {
   // Meta tags
   let metaTags = [];
   try {
-    const meta = require(path.resolve(portosaurusRoot, "src/config/metaTags.js"));
+    const meta = require(
+      path.resolve(portosaurusRoot, "src/config/metaTags.js"),
+    );
     metaTags = meta.metaTags || [];
   } catch {
     // OK — no meta tags
@@ -183,7 +190,7 @@ export function createDocuConf(rawUserConfig, projectRoot) {
   const userStaticDir = path.resolve(projectRoot, "static");
   const internalImgDir = path.resolve(portosaurusRoot, "src/assets");
   const staticDirectories = [userStaticDir, internalImgDir].filter((d) =>
-    fs.existsSync(d)
+    fs.existsSync(d),
   );
 
   // Pages — served from the portosaurus package
@@ -242,7 +249,8 @@ export function createDocuConf(rawUserConfig, projectRoot) {
           usrConf.about_me?.image ||
           usrConf.hero_section?.profile_pic ||
           "img/icon.png",
-        description: usrConf.about_me?.description || defaults.about_me.description,
+        description:
+          usrConf.about_me?.description || defaults.about_me.description,
         skills: usrConf.about_me?.skills || defaults.about_me.skills,
         resumeLink: usrConf.about_me?.resume_link || "",
       },
@@ -285,7 +293,14 @@ export function createDocuConf(rawUserConfig, projectRoot) {
             path: notesPath,
             sidebarPath,
             admonitions: {
-              keywords: ["note", "tip", "info", "warning", "danger", "question"],
+              keywords: [
+                "note",
+                "tip",
+                "info",
+                "warning",
+                "danger",
+                "question",
+              ],
               extendDefaults: true,
             },
           },
@@ -309,16 +324,14 @@ export function createDocuConf(rawUserConfig, projectRoot) {
       ],
     ],
 
-    // Register portosaurus's src/theme/ as a theme directory
-    // so Root.js, MDXComponents.js etc. are picked up
-    /*
+    // Register portosaurus's src/ as a theme directory
+    // so Root.js, components, and pages are all natively transpiled by Docusaurus.
     themes: [
       [
         path.resolve(portosaurusRoot, "src/core/themePlugin.mjs"),
-        { themeDir: internalThemeDir },
+        { themeDir: path.resolve(portosaurusRoot, "src") },
       ],
     ],
-    */
 
     markdown: {
       mermaid: true,
@@ -430,8 +443,29 @@ export function createDocuConf(rawUserConfig, projectRoot) {
     },
 
     plugins: [
+      function portosaurusWebpackTranspiler() {
+        return {
+          name: "portosaurus-transpile",
+          configureWebpack(config) {
+            if (config.module && config.module.rules) {
+              console.log(
+                JSON.stringify(
+                  config.module.rules,
+                  (k, v) => (typeof v === "function" ? v.toString() : v),
+                  2,
+                ),
+              );
+              process.exit(1);
+            }
+            return config;
+          },
+        };
+      },
       path.resolve(portosaurusRoot, "src/core/build-utils/generateFavicon.mjs"),
-      path.resolve(portosaurusRoot, "src/core/build-utils/generateRobotsTxt.mjs"),
+      path.resolve(
+        portosaurusRoot,
+        "src/core/build-utils/generateRobotsTxt.mjs",
+      ),
       [
         require.resolve("@easyops-cn/docusaurus-search-local"),
         {

package/src/core/packageManager.mjs

@@ -18,6 +18,18 @@ export function detectPackageManager(projectRoot) {
   if (fs.existsSync(path.join(projectRoot, "yarn.lock"))) return "yarn";
   if (fs.existsSync(path.join(projectRoot, "package-lock.json"))) return "npm";
 
+  if (process.env.npm_config_user_agent) {
+    if (process.env.npm_config_user_agent.includes("bun")) return "bun";
+    if (process.env.npm_config_user_agent.includes("pnpm")) return "pnpm";
+    if (process.env.npm_config_user_agent.includes("yarn")) return "yarn";
+  }
+  if (
+    typeof process !== "undefined" &&
+    process.versions &&
+    process.versions.bun
+  )
+    return "bun";
+
   return "npm";
 }