doccupine 0.0.49 → 0.0.51

package/dist/index.js

@@ -9,7 +9,7 @@ import chalk from "chalk";
 import prompts from "prompts";
 import { envExampleTemplate } from "./templates/env.example.js";
 import { gitignoreTemplate } from "./templates/gitignore.js";
-import { eslintConfigTeamplate } from "./templates/eslint.config.js";
+import { eslintConfigTemplate } from "./templates/eslint.config.js";
 import { nextConfigTemplate } from "./templates/next.config.js";
 import { packageJsonTemplate } from "./templates/package.js";
 import { proxyTemplate } from "./templates/proxy.js";
@@ -46,7 +46,7 @@ import { iconTemplate } from "./templates/components/layout/Icon.js";
 import { pictogramsTemplate } from "./templates/components/layout/Pictograms.js";
 import { sharedStyledTemplate } from "./templates/components/layout/SharedStyles.js";
 import { staticLinksTemplate } from "./templates/components/layout/StaticLinks.js";
-import { stepsTemplate } from "./templates/components/layout/Stepts.js";
+import { stepsTemplate } from "./templates/components/layout/Steps.js";
 import { tabsTemplate } from "./templates/components/layout/Tabs.js";
 import { themeToggleTemplate } from "./templates/components/layout/ThemeToggle.js";
 import { typographyTemplate } from "./templates/components/layout/Typography.js";
@@ -86,6 +86,34 @@ import { stepsMdxTemplate } from "./templates/mdx/steps.mdx.js";
 import { tabsMdxTemplate } from "./templates/mdx/tabs.mdx.js";
 import { themeMdxTemplate } from "./templates/mdx/theme.mdx.js";
 import { updateMdxTemplate } from "./templates/mdx/update.mdx.js";
+async function findAvailablePort(startPort) {
+    const net = await import("net");
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.listen(startPort, () => {
+            server.close(() => resolve(startPort));
+        });
+        server.on("error", () => {
+            resolve(findAvailablePort(startPort + 1));
+        });
+    });
+}
+export function generateSlug(filePath) {
+    if (filePath === "index.mdx" || filePath === "./index.mdx") {
+        return "";
+    }
+    return filePath
+        .replace(/\.mdx$/, "")
+        .replace(/\\/g, "/")
+        .replace(/[^a-zA-Z0-9\/\-_]/g, "-")
+        .toLowerCase();
+}
+export function escapeTemplateContent(content) {
+    return content
+        .replace(/\\/g, "\\\\")
+        .replace(/`/g, "\\`")
+        .replace(/\$\{/g, "\\${");
+}
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
@@ -134,6 +162,10 @@ class ConfigManager {
             },
         ];
         const { watchDir, outputDir } = (await prompts(questions));
+        if (!watchDir || !outputDir) {
+            console.log(chalk.yellow("\n⚠️ Setup cancelled."));
+            process.exit(0);
+        }
         return {
             watchDir: path.resolve(process.cwd(), watchDir),
             outputDir: path.resolve(process.cwd(), outputDir),
@@ -194,98 +226,98 @@ class MDXToNextJSGenerator {
     }
     async createNextJSStructure() {
         const structure = {
-            ".env.example": this.generateEnvExample(),
-            ".gitignore": this.generateGitIgnore(),
-            "config.json": this.generateConfig(),
-            "eslint.config.mjs": this.generateESLintConfig(),
-            "links.json": this.generateLinksConfig(),
-            "navigation.json": this.generateNavigationConfig(),
-            "next.config.ts": this.generateNextConfig(),
-            "package.json": this.generatePackageJson(),
-            "proxy.ts": this.generateProxy(),
-            "theme.json": this.generateThemeConfig(),
-            "tsconfig.json": this.generateTSConfig(),
-            "app/layout.tsx": await this.generateRootLayout(),
-            "app/not-found.tsx": this.generateNotFoundPage(),
-            "app/theme.ts": this.generateTheme(),
-            "app/api/mcp/route.ts": this.generateMCPRoutes(),
-            "app/api/rag/route.ts": this.generateRagRoutes(),
-            "app/api/theme/route.ts": this.generateRoutes(),
-            "services/mcp/index.ts": this.generateMCPIndex(),
-            "services/mcp/server.ts": this.generateMCPServer(),
-            "services/mcp/tools.ts": this.generateMCPTools(),
-            "services/mcp/types.ts": this.generateMCPTypes(),
-            "services/llm/config.ts": this.generateLLMConfig(),
-            "services/llm/factory.ts": this.generateLLMFactory(),
-            "services/llm/index.ts": this.generateLLMIndex(),
-            "services/llm/types.ts": this.generateLLMTypes(),
-            "types/styled.d.ts": this.generateStyledDTypes(),
-            "utils/orderNavItems.ts": this.generateOrderNavItems(),
-            "components/Chat.tsx": this.generateChat(),
-            "components/ClickOutside.ts": this.generateClickOutside(),
-            "components/Docs.tsx": this.generateDocs(),
-            "components/DocsSideBar.tsx": this.generateDocsSideBar(),
-            "components/MDXComponents.tsx": this.generateMDXComponents(),
-            "components/SideBar.tsx": this.generateSideBar(),
-            "components/layout/Accordion.tsx": this.generateAccordion(),
-            "components/layout/ActionBar.tsx": this.generateActionBar(),
-            "components/layout/Button.tsx": this.generateButton(),
-            "components/layout/Callout.tsx": this.generateCallout(),
-            "components/layout/Card.tsx": this.generateCard(),
-            "components/layout/CherryThemeProvider.tsx": this.generateCherryThemeProvider(),
-            "components/layout/ClientThemeProvider.tsx": this.generateClientThemeProvider(),
-            "components/layout/Code.tsx": this.generateCode(),
-            "components/layout/Columns.tsx": this.generateColumns(),
-            "components/layout/DemoTheme.tsx": this.generateDemoTheme(),
-            "components/layout/DocsComponents.tsx": this.generateDocsComponents(),
-            "components/layout/DocsNavigation.tsx": this.generateDocsNavigation(),
-            "components/layout/Field.tsx": this.generateField(),
-            "components/layout/Footer.tsx": this.generateFooter(),
-            "components/layout/GlobalStyles.ts": this.generateGlobalStyles(),
-            "components/layout/Header.tsx": this.generateHeader(),
-            "components/layout/Icon.tsx": this.generateIcon(),
-            "components/layout/Pictograms.tsx": this.generatePictograms(),
-            "components/layout/SharedStyled.ts": this.generateSharedStyled(),
-            "components/layout/StaticLinks.tsx": this.generateStaticLinks(),
-            "components/layout/Steps.tsx": this.generateSteps(),
-            "components/layout/Tabs.tsx": this.generateTabs(),
-            "components/layout/ThemeToggle.tsx": this.generateThemeToggle(),
-            "components/layout/Typography.ts": this.generateTypography(),
-            "components/layout/Update.tsx": this.generateUpdate(),
+            ".env.example": envExampleTemplate,
+            ".gitignore": gitignoreTemplate,
+            "config.json": `{}`,
+            "eslint.config.mjs": eslintConfigTemplate,
+            "links.json": `[]`,
+            "navigation.json": `[]`,
+            "next.config.ts": nextConfigTemplate,
+            "package.json": packageJsonTemplate,
+            "proxy.ts": proxyTemplate,
+            "theme.json": `{}`,
+            "tsconfig.json": tsconfigTemplate,
+            "app/layout.tsx": this.generateRootLayout(),
+            "app/not-found.tsx": notFoundTemplate,
+            "app/theme.ts": themeTemplate,
+            "app/api/mcp/route.ts": mcpRoutesTemplate,
+            "app/api/rag/route.ts": ragRoutesTemplate,
+            "app/api/theme/route.ts": routesTemplate,
+            "services/mcp/index.ts": mcpIndexTemplate,
+            "services/mcp/server.ts": mcpServerTemplate,
+            "services/mcp/tools.ts": mcpToolsTemplate,
+            "services/mcp/types.ts": mcpTypesTemplate,
+            "services/llm/config.ts": llmConfigTemplate,
+            "services/llm/factory.ts": llmFactoryTemplate,
+            "services/llm/index.ts": llmIndexTemplate,
+            "services/llm/types.ts": llmTypesTemplate,
+            "types/styled.d.ts": styledDTemplate,
+            "utils/orderNavItems.ts": orderNavItemsTemplate,
+            "components/Chat.tsx": chatTemplate,
+            "components/ClickOutside.ts": clickOutsideTemplate,
+            "components/Docs.tsx": docsTemplate,
+            "components/DocsSideBar.tsx": docsSideBarTemplate,
+            "components/MDXComponents.tsx": mdxComponentsTemplate,
+            "components/SideBar.tsx": sideBarTemplate,
+            "components/layout/Accordion.tsx": accordionTemplate,
+            "components/layout/ActionBar.tsx": actionBarTemplate,
+            "components/layout/Button.tsx": buttonTemplate,
+            "components/layout/Callout.tsx": calloutTemplate,
+            "components/layout/Card.tsx": cardTemplate,
+            "components/layout/CherryThemeProvider.tsx": cherryThemeProviderTemplate,
+            "components/layout/ClientThemeProvider.tsx": clientThemeProviderTemplate,
+            "components/layout/Code.tsx": codeTemplate,
+            "components/layout/Columns.tsx": columnsTemplate,
+            "components/layout/DemoTheme.tsx": demoThemeTemplate,
+            "components/layout/DocsComponents.tsx": docsComponentsTemplate,
+            "components/layout/DocsNavigation.tsx": docsNavigationTemplate,
+            "components/layout/Field.tsx": fieldTemplate,
+            "components/layout/Footer.tsx": footerTemplate,
+            "components/layout/GlobalStyles.ts": globalStylesTemplate,
+            "components/layout/Header.tsx": headerTemplate,
+            "components/layout/Icon.tsx": iconTemplate,
+            "components/layout/Pictograms.tsx": pictogramsTemplate,
+            "components/layout/SharedStyled.ts": sharedStyledTemplate,
+            "components/layout/StaticLinks.tsx": staticLinksTemplate,
+            "components/layout/Steps.tsx": stepsTemplate,
+            "components/layout/Tabs.tsx": tabsTemplate,
+            "components/layout/ThemeToggle.tsx": themeToggleTemplate,
+            "components/layout/Typography.ts": typographyTemplate,
+            "components/layout/Update.tsx": updateTemplate,
         };
         for (const [filePath, content] of Object.entries(structure)) {
             const fullPath = path.join(this.outputDir, filePath);
             await fs.ensureDir(path.dirname(fullPath));
-            await fs.writeFile(fullPath, String(content), "utf8");
+            await fs.writeFile(fullPath, String(await content), "utf8");
         }
     }
     async createStartingDocs() {
         const structure = {
-            "accordion.mdx": this.generateAccordionMdx(),
-            "ai-assistant.mdx": this.generateAiAssistantMdx(),
-            "buttons.mdx": this.generateButtonsMdx(),
-            "callouts.mdx": this.generateCalloutsMdx(),
-            "cards.mdx": this.generateCardsMdx(),
-            "code.mdx": this.generateCodeMdx(),
-            "columns.mdx": this.generateColumnsMdx(),
-            "commands.mdx": this.generateCommandsMdx(),
-            "deployment.mdx": this.generateDeploymentMdx(),
-            "fields.mdx": this.generateFieldsMdx(),
-            "fonts.mdx": this.generateFontsMdx(),
-            "globals.mdx": this.generateGlobalsMdx(),
-            "headers-and-text.mdx": this.generateHeadersAndTextMdx(),
-            "icons.mdx": this.generateIconsMdx(),
-            "image-and-embeds.mdx": this.generateImagesAndEmbedsMdx(),
-            "index.mdx": this.generateIndexMdx(),
-            "links.mdx": this.generateLinksMdx(),
-            "lists-and-tables.mdx": this.generateListsAndTablesMdx(),
-            "media-and-assets.mdx": this.generateMediaAndAssetsMdx(),
-            "model-context-protocol.mdx": this.generateMCPMdx(),
-            "navigation.mdx": this.generateNavigationMdx(),
-            "steps.mdx": this.generateStepsMdx(),
-            "tabs.mdx": this.generateTabsMdx(),
-            "theme.mdx": this.generateThemeMdx(),
-            "update.mdx": this.generateUpdateMdx(),
+            "accordion.mdx": accordionMdxTemplate,
+            "ai-assistant.mdx": aiAssistantMdxTemplate,
+            "buttons.mdx": buttonsMdxTemplate,
+            "callouts.mdx": calloutsMdxTemplate,
+            "cards.mdx": cardsMdxTemplate,
+            "code.mdx": codeMdxTemplate,
+            "columns.mdx": columnsMdxTemplate,
+            "commands.mdx": commandsMdxTemplate,
+            "deployment.mdx": deploymentMdxTemplate,
+            "fields.mdx": fieldsMdxTemplate,
+            "fonts.mdx": fontsMdxTemplate,
+            "globals.mdx": globalsMdxTemplate,
+            "headers-and-text.mdx": headersAndTextMdxTemplate,
+            "icons.mdx": iconsMdxTemplate,
+            "image-and-embeds.mdx": imageAndEmbedsMdxTemplate,
+            "index.mdx": indexMdxTemplate,
+            "links.mdx": linksMdxTemplate,
+            "lists-and-tables.mdx": listAndTablesMdxTemplate,
+            "media-and-assets.mdx": mediaAndAssetsMdxTemplate,
+            "model-context-protocol.mdx": mcpMdxTemplate,
+            "navigation.mdx": navigationMdxTemplate,
+            "steps.mdx": stepsMdxTemplate,
+            "tabs.mdx": tabsMdxTemplate,
+            "theme.mdx": themeMdxTemplate,
+            "update.mdx": updateMdxTemplate,
         };
         const indexMdxExists = await fs.pathExists(path.join(this.watchDir, "index.mdx"));
         if (!indexMdxExists) {
@@ -372,7 +404,6 @@ class MDXToNextJSGenerator {
         try {
             await fs.copy(sourcePath, destPath);
             console.log(chalk.green(`📋 Updated ${this.fontConfigFile} in Next.js app`));
-            // Update the layout template with new font config
             await this.updateRootLayout();
             console.log(chalk.green(`✅ Layout updated with new font configuration`));
         }
@@ -387,7 +418,6 @@ class MDXToNextJSGenerator {
             if (await fs.pathExists(destPath)) {
                 await fs.remove(destPath);
                 console.log(chalk.yellow(`🗑️ Removed ${this.fontConfigFile} from Next.js app`));
-                // Update the layout template without font config
                 await this.updateRootLayout();
                 console.log(chalk.green(`✅ Layout updated without font configuration`));
             }
@@ -535,6 +565,25 @@ class MDXToNextJSGenerator {
             });
         }
     }
+    async parseMDXFile(file) {
+        const fullPath = path.join(this.watchDir, file);
+        const content = await fs.readFile(fullPath, "utf8");
+        const { data: frontmatter } = matter(content);
+        return {
+            slug: this.generateSlug(file),
+            title: frontmatter.title || "Untitled",
+            description: frontmatter.description || "",
+            date: frontmatter.date || null,
+            category: frontmatter.category || "",
+            path: file,
+            categoryOrder: frontmatter.categoryOrder || 0,
+            order: frontmatter.order || 0,
+        };
+    }
+    async buildAllPagesMeta() {
+        const files = await this.getAllMDXFiles();
+        return Promise.all(files.map((file) => this.parseMDXFile(file)));
+    }
     async handleFileChange(action, filePath) {
         console.log(chalk.cyan(`📝 File ${action}: ${filePath}`));
         const fullPath = path.join(this.watchDir, filePath);
@@ -543,8 +592,6 @@ class MDXToNextJSGenerator {
             const { data: frontmatter, content: mdxContent } = matter(content);
             if (filePath === "index.mdx" || filePath === "./index.mdx") {
                 console.log(chalk.blue("🏠 Updating homepage with index.mdx content"));
-                await this.updatePagesIndex();
-                await this.updateRootLayout();
             }
             else {
                 const mdxFile = {
@@ -554,9 +601,9 @@ class MDXToNextJSGenerator {
                     slug: this.generateSlug(filePath),
                 };
                 await this.generatePageFromMDX(mdxFile);
-                await this.updatePagesIndex();
-                await this.updateRootLayout();
             }
+            await this.updatePagesIndex();
+            await this.updateRootLayout();
             console.log(chalk.green(`✅ Generated page for: ${filePath}`));
         }
         catch (error) {
@@ -568,16 +615,14 @@ class MDXToNextJSGenerator {
         try {
             if (filePath === "index.mdx" || filePath === "./index.mdx") {
                 console.log(chalk.blue("🏠 Updating homepage - index.mdx deleted"));
-                await this.updatePagesIndex();
-                await this.updateRootLayout();
             }
             else {
                 const slug = this.generateSlug(filePath);
                 const pagePath = path.join(this.outputDir, "app", slug);
                 await fs.remove(pagePath);
-                await this.updatePagesIndex();
-                await this.updateRootLayout();
             }
+            await this.updatePagesIndex();
+            await this.updateRootLayout();
             console.log(chalk.green(`✅ Removed page for: ${filePath}`));
         }
         catch (error) {
@@ -609,90 +654,14 @@ class MDXToNextJSGenerator {
         return files;
     }
     generateSlug(filePath) {
-        if (filePath === "index.mdx" || filePath === "./index.mdx") {
-            return "";
-        }
-        return filePath
-            .replace(/\.mdx$/, "")
-            .replace(/\\/g, "/")
-            .replace(/[^a-zA-Z0-9\/\-_]/g, "-")
-            .toLowerCase();
-    }
-    generateEnvExample() {
-        return envExampleTemplate;
-    }
-    generateGitIgnore() {
-        return gitignoreTemplate;
-    }
-    generateConfig() {
-        return `{}`;
-    }
-    generateESLintConfig() {
-        return eslintConfigTeamplate;
-    }
-    generateLinksConfig() {
-        return `[]`;
-    }
-    generateNavigationConfig() {
-        return `[]`;
-    }
-    generateNextConfig() {
-        return nextConfigTemplate;
-    }
-    generatePackageJson() {
-        return packageJsonTemplate;
-    }
-    generateProxy() {
-        return proxyTemplate;
-    }
-    generateThemeConfig() {
-        return `{}`;
-    }
-    generateTSConfig() {
-        return tsconfigTemplate;
+        return generateSlug(filePath);
     }
     async generateRootLayout() {
-        const files = await this.getAllMDXFiles();
-        const pages = [];
-        for (const file of files) {
-            const fullPath = path.join(this.watchDir, file);
-            const content = await fs.readFile(fullPath, "utf8");
-            const { data: frontmatter } = matter(content);
-            pages.push({
-                slug: this.generateSlug(file),
-                title: frontmatter.title || "Untitled",
-                description: frontmatter.description || "",
-                date: frontmatter.date || null,
-                category: frontmatter.category || "",
-                path: file,
-                categoryOrder: frontmatter.categoryOrder || 0,
-                order: frontmatter.order || 0,
-            });
-        }
+        const pages = await this.buildAllPagesMeta();
         const fontConfig = await this.loadFontConfig();
         return layoutTemplate(pages, fontConfig);
     }
-    generateNotFoundPage() {
-        return notFoundTemplate;
-    }
     async generatePageFromMDX(mdxFile) {
-        const files = await this.getAllMDXFiles();
-        const pages = [];
-        for (const file of files) {
-            const fullPath = path.join(this.watchDir, file);
-            const content = await fs.readFile(fullPath, "utf8");
-            const { data: frontmatter } = matter(content);
-            pages.push({
-                slug: this.generateSlug(file),
-                title: frontmatter.title || "Untitled",
-                description: frontmatter.description || "",
-                date: frontmatter.date || null,
-                category: frontmatter.category || "",
-                path: file,
-                categoryOrder: frontmatter.categoryOrder || 0,
-                order: frontmatter.order || 0,
-            });
-        }
         const pageContent = `import { Metadata } from "next";
 import { Docs } from "@/components/Docs";
 import configData from "@/config.json";
@@ -706,7 +675,7 @@ interface Config {
 
 const config = configData as Config;
 
-const content = \`${mdxFile.content.replace(/`/g, "\\`")}\`;
+const content = \`${escapeTemplateContent(mdxFile.content)}\`;
 
 export const metadata: Metadata = {
   title: \`${mdxFile.frontmatter.title || "Generated with Doccupine"} \${config.name ? "- " + config.name : "- Doccupine"}\`,
@@ -731,21 +700,18 @@ export default function Page() {
         const files = await this.getAllMDXFiles();
         let indexMDX = null;
         for (const file of files) {
-            const fullPath = path.join(this.watchDir, file);
-            const content = await fs.readFile(fullPath, "utf8");
-            const { data: frontmatter, content: mdxContent } = matter(content);
             if (file === "index.mdx" || file === "./index.mdx") {
+                const fullPath = path.join(this.watchDir, file);
+                const content = await fs.readFile(fullPath, "utf8");
+                const { data: frontmatter, content: mdxContent } = matter(content);
                 indexMDX = {
                     content: mdxContent,
-                    frontmatter,
                     title: frontmatter.title || "Welcome",
-                    category: frontmatter.category || "",
                     description: frontmatter.description || "",
-                    categoryOrder: frontmatter.categoryOrder || 0,
-                    order: frontmatter.order || 0,
                     icon: frontmatter.icon,
                     image: frontmatter.image,
                 };
+                break;
             }
         }
         const indexContent = `import { Metadata } from "next";
@@ -761,7 +727,7 @@ interface Config {
 
 const config = configData as Config;
 
-${indexMDX ? `const content = \`${indexMDX.content.replace(/`/g, "\\`")}\`;` : `const content = null;`}
+${indexMDX ? `const content = \`${escapeTemplateContent(indexMDX.content)}\`;` : `const content = null;`}
 
 ${indexMDX
             ? `export const metadata: Metadata = {
@@ -795,216 +761,6 @@ export default function Home() {
         const layoutContent = await this.generateRootLayout();
         await fs.writeFile(path.join(this.outputDir, "app", "layout.tsx"), layoutContent, "utf8");
     }
-    generateTheme() {
-        return themeTemplate;
-    }
-    generateMCPRoutes() {
-        return mcpRoutesTemplate;
-    }
-    generateRagRoutes() {
-        return ragRoutesTemplate;
-    }
-    generateRoutes() {
-        return routesTemplate;
-    }
-    generateMCPIndex() {
-        return mcpIndexTemplate;
-    }
-    generateMCPServer() {
-        return mcpServerTemplate;
-    }
-    generateMCPTools() {
-        return mcpToolsTemplate;
-    }
-    generateMCPTypes() {
-        return mcpTypesTemplate;
-    }
-    generateLLMConfig() {
-        return llmConfigTemplate;
-    }
-    generateLLMFactory() {
-        return llmFactoryTemplate;
-    }
-    generateLLMIndex() {
-        return llmIndexTemplate;
-    }
-    generateLLMTypes() {
-        return llmTypesTemplate;
-    }
-    generateStyledDTypes() {
-        return styledDTemplate;
-    }
-    generateOrderNavItems() {
-        return orderNavItemsTemplate;
-    }
-    generateChat() {
-        return chatTemplate;
-    }
-    generateClickOutside() {
-        return clickOutsideTemplate;
-    }
-    generateDocs() {
-        return docsTemplate;
-    }
-    generateDocsSideBar() {
-        return docsSideBarTemplate;
-    }
-    generateMDXComponents() {
-        return mdxComponentsTemplate;
-    }
-    generateSideBar() {
-        return sideBarTemplate;
-    }
-    generateAccordion() {
-        return accordionTemplate;
-    }
-    generateActionBar() {
-        return actionBarTemplate;
-    }
-    generateButton() {
-        return buttonTemplate;
-    }
-    generateCallout() {
-        return calloutTemplate;
-    }
-    generateCard() {
-        return cardTemplate;
-    }
-    generateCherryThemeProvider() {
-        return cherryThemeProviderTemplate;
-    }
-    generateClientThemeProvider() {
-        return clientThemeProviderTemplate;
-    }
-    generateCode() {
-        return codeTemplate;
-    }
-    generateColumns() {
-        return columnsTemplate;
-    }
-    generateDemoTheme() {
-        return demoThemeTemplate;
-    }
-    generateDocsComponents() {
-        return docsComponentsTemplate;
-    }
-    generateDocsNavigation() {
-        return docsNavigationTemplate;
-    }
-    generateField() {
-        return fieldTemplate;
-    }
-    generateFooter() {
-        return footerTemplate;
-    }
-    generateGlobalStyles() {
-        return globalStylesTemplate;
-    }
-    generateHeader() {
-        return headerTemplate;
-    }
-    generateIcon() {
-        return iconTemplate;
-    }
-    generatePictograms() {
-        return pictogramsTemplate;
-    }
-    generateSharedStyled() {
-        return sharedStyledTemplate;
-    }
-    generateStaticLinks() {
-        return staticLinksTemplate;
-    }
-    generateSteps() {
-        return stepsTemplate;
-    }
-    generateTabs() {
-        return tabsTemplate;
-    }
-    generateThemeToggle() {
-        return themeToggleTemplate;
-    }
-    generateTypography() {
-        return typographyTemplate;
-    }
-    generateUpdate() {
-        return updateTemplate;
-    }
-    generateAccordionMdx() {
-        return accordionMdxTemplate;
-    }
-    generateAiAssistantMdx() {
-        return aiAssistantMdxTemplate;
-    }
-    generateButtonsMdx() {
-        return buttonsMdxTemplate;
-    }
-    generateCalloutsMdx() {
-        return calloutsMdxTemplate;
-    }
-    generateCardsMdx() {
-        return cardsMdxTemplate;
-    }
-    generateCodeMdx() {
-        return codeMdxTemplate;
-    }
-    generateColumnsMdx() {
-        return columnsMdxTemplate;
-    }
-    generateCommandsMdx() {
-        return commandsMdxTemplate;
-    }
-    generateDeploymentMdx() {
-        return deploymentMdxTemplate;
-    }
-    generateFieldsMdx() {
-        return fieldsMdxTemplate;
-    }
-    generateFontsMdx() {
-        return fontsMdxTemplate;
-    }
-    generateGlobalsMdx() {
-        return globalsMdxTemplate;
-    }
-    generateHeadersAndTextMdx() {
-        return headersAndTextMdxTemplate;
-    }
-    generateIconsMdx() {
-        return iconsMdxTemplate;
-    }
-    generateImagesAndEmbedsMdx() {
-        return imageAndEmbedsMdxTemplate;
-    }
-    generateIndexMdx() {
-        return indexMdxTemplate;
-    }
-    generateLinksMdx() {
-        return linksMdxTemplate;
-    }
-    generateListsAndTablesMdx() {
-        return listAndTablesMdxTemplate;
-    }
-    generateMediaAndAssetsMdx() {
-        return mediaAndAssetsMdxTemplate;
-    }
-    generateMCPMdx() {
-        return mcpMdxTemplate;
-    }
-    generateNavigationMdx() {
-        return navigationMdxTemplate;
-    }
-    generateStepsMdx() {
-        return stepsMdxTemplate;
-    }
-    generateTabsMdx() {
-        return tabsMdxTemplate;
-    }
-    generateThemeMdx() {
-        return themeMdxTemplate;
-    }
-    generateUpdateMdx() {
-        return updateMdxTemplate;
-    }
     async stop() {
         if (this.watcher) {
             await this.watcher.close();
@@ -1066,20 +822,28 @@ program
                 resolve(void 0);
             }
             else {
-                reject(new Error(`npm install failed with code ${code}`));
+                reject(new Error(`${packageManager} install failed with code ${code}`));
             }
         });
         install.on("error", reject);
     });
-    console.log(chalk.blue(`🚀 Starting Next.js dev server on port ${config.port}...`));
-    devServer = spawn("npm", ["run", "dev", "--", "--port", config.port], {
+    const port = await findAvailablePort(parseInt(config.port, 10));
+    if (port !== parseInt(config.port, 10)) {
+        console.log(chalk.yellow(`⚠️ Port ${config.port} is in use, using port ${port} instead`));
+    }
+    console.log(chalk.blue(`🚀 Starting Next.js dev server on port ${port}...`));
+    const portStr = String(port);
+    const devArgs = packageManager === "npm"
+        ? ["run", "dev", "--", "--port", portStr]
+        : ["run", "dev", "--port", portStr];
+    devServer = spawn(packageManager, devArgs, {
         cwd: config.outputDir,
         stdio: ["ignore", "pipe", "pipe"],
     });
-    devServer.stdout.on("data", (data) => {
+    devServer.stdout?.on("data", (data) => {
         const output = data.toString();
         if (output.includes("Ready") || output.includes("started")) {
-            console.log(chalk.green(`🌐 Next.js ready at http://localhost:${config.port}`));
+            console.log(chalk.green(`🌐 Next.js ready at http://localhost:${port}`));
         }
         if (output.includes("compiled") ||
             output.includes("error") ||
@@ -1087,14 +851,20 @@ program
             process.stdout.write(chalk.gray("[Next.js] ") + output);
         }
     });
-    if (options.verbose) {
-        devServer.stderr.on("data", (data) => {
-            process.stderr.write(chalk.red("[Next.js Error] ") + data.toString());
-        });
-    }
+    devServer.stderr?.on("data", (data) => {
+        const output = data.toString();
+        if (options.verbose || output.includes("Error") || output.includes("error")) {
+            process.stderr.write(chalk.red("[Next.js] ") + output);
+        }
+    });
     devServer.on("error", (error) => {
         console.error(chalk.red("❌ Error starting dev server:"), error);
     });
+    devServer.on("close", (code) => {
+        if (code && code !== 0) {
+            console.error(chalk.red(`❌ Next.js dev server exited with code ${code}`));
+        }
+    });
     await generator.startWatching();
     process.on("SIGINT", async () => {
         console.log(chalk.yellow("\n🛑 Shutting down..."));
@@ -1106,7 +876,6 @@ program
     });
     console.log(chalk.green("🎉 Generator is running! Press Ctrl+C to stop."));
     console.log(chalk.cyan(`📝 Edit your MDX files in: ${config.watchDir}`));
-    console.log(chalk.cyan(`🌐 View changes at: http://localhost:${config.port}`));
 });
 program
     .command("build")