create-bunspace 0.1.1 → 0.2.1

package/dist/bin.js

@@ -5184,6 +5184,11 @@ async function selectTemplate(args) {
         title: "Telegram Bot - Bot de Telegram con Telegraf y TypeScript",
         value: "telegram-bot",
         description: "Production-ready Telegram bot with polling/webhook support"
+      },
+      {
+        title: "Fumadocs - Documentaci\xF3n con Next.js + MDX + Fumadocs",
+        value: "fumadocs",
+        description: "Bilingual documentation site with GitHub Pages deployment"
       }
     ]
   }, {
@@ -5350,10 +5355,102 @@ Operation cancelled`));
     runInstall: args.noInstall ? false : response.runInstall ?? true
   };
 }
+async function promptFumadocs(args) {
+  const gitUser = await getGitUser();
+  const parsed = parseProjectArg(args.projectName);
+  const response = await import_prompts.default([
+    {
+      type: args.projectName ? null : "text",
+      name: "name",
+      message: "Project name",
+      initial: parsed.name,
+      validate: (value) => {
+        if (!value)
+          return "Project name is required";
+        if (!isValidProjectName(value)) {
+          return "Invalid name. Use lowercase letters, numbers, and hyphens only";
+        }
+        return true;
+      },
+      format: (value) => value.toLowerCase().trim()
+    },
+    {
+      type: args.description ? null : "text",
+      name: "description",
+      message: "Description",
+      initial: "Documentation site built with Fumadocs"
+    },
+    {
+      type: args.author ? null : "text",
+      name: "author",
+      message: "Author",
+      initial: gitUser || "Anonymous"
+    },
+    {
+      type: "text",
+      name: "githubRepo",
+      message: "GitHub repo (e.g., username/repo)",
+      initial: (prev) => `${gitUser || "username"}/${prev}`
+    },
+    {
+      type: "text",
+      name: "basePath",
+      message: "Base path (e.g., /my-docs or / for root)",
+      initial: (prev) => `/${prev}`
+    },
+    {
+      type: "select",
+      name: "defaultLocale",
+      message: "Default locale",
+      choices: [
+        { title: "Spanish (Espa\xF1ol)", value: "es" },
+        { title: "English", value: "en" }
+      ],
+      initial: 0
+    },
+    {
+      type: args.noGit ? null : "confirm",
+      name: "initGit",
+      message: "Initialize git repository?",
+      initial: true
+    },
+    {
+      type: args.noInstall ? null : "confirm",
+      name: "runInstall",
+      message: "Run bun install?",
+      initial: true
+    }
+  ], {
+    onCancel: () => {
+      console.log(kleur_default.red(`
+Operation cancelled`));
+      process.exit(0);
+    }
+  });
+  const name = args.projectName ? parsed.name : response.name;
+  const targetDir = args.dir || `./${name}`;
+  return {
+    template: "fumadocs",
+    name,
+    scope: "",
+    description: args.description || response.description || "",
+    author: args.author || response.author || gitUser || "Anonymous",
+    githubRepo: response.githubRepo || `${gitUser || "username"}/${name}`,
+    basePath: response.basePath || `/${name}`,
+    defaultLocale: response.defaultLocale || "es",
+    supportedLocales: "es,en",
+    targetDir,
+    initGit: args.noGit ? false : response.initGit ?? true,
+    runInstall: args.noInstall ? false : response.runInstall ?? true
+  };
+}
 async function promptUser(args, templateType) {
   if (templateType === "telegram-bot") {
     return promptTelegramBot(args);
   }
+  if (templateType === "fumadocs") {
+    return promptFumadocs(args);
+  }
   return promptMonorepo(args);
 }
 async function getDefaultsMonorepo(args) {
@@ -5389,10 +5486,32 @@ async function getDefaultsTelegramBot(args) {
     runInstall: !args.noInstall
   };
 }
+async function getDefaultsFumadocs(args) {
+  const gitUser = await getGitUser();
+  const parsed = parseProjectArg(args.projectName);
+  const targetDir = args.dir || parsed.targetDir;
+  return {
+    template: "fumadocs",
+    name: parsed.name,
+    scope: "",
+    description: args.description || "Documentation site built with Fumadocs",
+    author: args.author || gitUser || "Anonymous",
+    githubRepo: `${gitUser || "username"}/${parsed.name}`,
+    basePath: `/${parsed.name}`,
+    defaultLocale: "es",
+    supportedLocales: "es,en",
+    targetDir,
+    initGit: !args.noGit,
+    runInstall: !args.noInstall
+  };
+}
 async function getDefaults(args, templateType) {
   if (templateType === "telegram-bot") {
     return getDefaultsTelegramBot(args);
   }
+  if (templateType === "fumadocs") {
+    return getDefaultsFumadocs(args);
+  }
   return getDefaultsMonorepo(args);
 }
 
@@ -5407,6 +5526,7 @@ var TEXT_EXTENSIONS = new Set([
   ".jsx",
   ".json",
   ".md",
+  ".mdx",
   ".txt",
   ".yml",
   ".yaml",
@@ -5493,6 +5613,17 @@ function generatePlaceholders(config, templateType) {
       TG_BOT_TOKEN: config.botToken || "YOUR_BOT_TOKEN_HERE"
     };
   }
+  if (templateType === "fumadocs") {
+    return {
+      ...base,
+      PROJECT_NAME: config.name,
+      DESCRIPTION: config.description,
+      GITHUB_REPO: config.githubRepo || `${config.author}/${config.name}`,
+      BASE_PATH: config.basePath || `/${config.name}`,
+      DEFAULT_LOCALE: config.defaultLocale || "es",
+      SUPPORTED_LOCALES: config.supportedLocales || "es,en"
+    };
+  }
   throw new Error(`Unknown template: ${templateType}`);
 }
 async function copyTemplateDir(src, dest, placeholders) {
@@ -5564,7 +5695,7 @@ async function listTemplates() {
   console.log(`
 \uD83D\uDCE6 Templates Status:
 `);
-  const templates = ["monorepo", "telegram-bot"];
+  const templates = ["monorepo", "telegram-bot", "fumadocs"];
   for (const name of templates) {
     const templatePath = join2(TEMPLATES_DIR, name);
     if (!existsSync2(templatePath)) {

package/dist/templates/fumadocs/.env.example

@@ -0,0 +1,49 @@
+# ============================================
+# Fumadocs Template Configuration
+# ============================================
+# Copy this file to .env.local and set your values
+# Variables marked with {{PLACEHOLDER}} will be replaced by mks-scaffolder
+
+# --------------------------------------------
+# Project Information
+# --------------------------------------------
+PROJECT_NAME={{PROJECT_NAME}}
+DESCRIPTION={{DESCRIPTION}}
+AUTHOR={{AUTHOR}}
+KEYWORDS=docs,documentation,nextjs,fumadocs
+
+# --------------------------------------------
+# Deployment
+# --------------------------------------------
+# Base path for GitHub Pages or subdirectory deployment
+# Example: /my-project or leave empty for root domain
+BASE_PATH={{BASE_PATH}}
+
+# Full site URL (for production)
+NEXT_PUBLIC_SITE_URL=https://{{GITHUB_REPO}}
+
+# OpenGraph image (optional)
+OG_IMAGE_URL=/og.png
+
+# --------------------------------------------
+# i18n (Internationalization)
+# --------------------------------------------
+DEFAULT_LOCALE={{DEFAULT_LOCALE}}
+NEXT_PUBLIC_SUPPORTED_LOCALES={{SUPPORTED_LOCALES}}
+
+# --------------------------------------------
+# Theme & Branding
+# --------------------------------------------
+# Primary color in CSS variable format (optional)
+# PRIMARY_COLOR=var(--color-primary)
+
+# Logo configuration (optional)
+# Use SVG markup or plain text
+# LOGO_SVG=<svg viewBox="0 0 24 24">...</svg>
+# LOGO_TEXT=My Docs
+
+# --------------------------------------------
+# URL Configuration
+# --------------------------------------------
+# Enable trailing slash for all URLs (recommended for GitHub Pages)
+TRAILING_SLASH=true

package/dist/templates/fumadocs/.github/workflows/deploy.yml

@@ -0,0 +1,89 @@
+# Workflow para construir y desplegar la documentación a GitHub Pages
+name: Deploy Docs to Pages
+
+on:
+  push:
+    branches: ["main", "master"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Configure environment
+        run: |
+          # Set BASE_PATH from repository variables or use empty string
+          BASE_PATH="${{ vars.BASE_PATH }}"
+          echo "BASE_PATH=${BASE_PATH}" >> $GITHUB_ENV
+
+          # Set project name from repository name
+          REPO_NAME="${{ github.event.repository.name }}"
+          echo "REPO_NAME=${REPO_NAME}" >> $GITHUB_ENV
+
+      - name: Build with Next.js
+        run: bun run build
+        env:
+          NODE_ENV: production
+          BASE_PATH: ${{ vars.BASE_PATH }}
+
+      - name: Move files for basePath
+        run: |
+          cd out
+          # Only create subdirectory if BASE_PATH is set
+          if [ -n "$BASE_PATH" ]; then
+            # Extract the directory name from BASE_PATH (remove leading /)
+            DIR_NAME="${BASE_PATH#/}"
+            mkdir -p "$DIR_NAME"
+            # Move all files and directories except the created directory itself
+            for item in *; do
+              if [ "$item" != "$DIR_NAME" ]; then
+                mv "$item" "$DIR_NAME/"
+              fi
+            done
+            # Also move hidden files if any
+            for item in .[^.]*; do
+              if [ -e "$item" ] && [ "$item" != "." ] && [ "$item" != ".." ] && [ "$item" != ".git" ]; then
+                mv "$item" "$DIR_NAME/"
+              fi
+            done
+          fi
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./out
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/dist/templates/fumadocs/CLAUDE.md

@@ -0,0 +1,164 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## CRITICAL: Development Guidelines
+
+**ALL development MUST follow the rules in `MUST-FOLLOW-GUIDELINES.md`**
+
+Before making ANY code changes, read and understand:
+- `/MUST-FOLLOW-GUIDELINES.md` - Source of truth for coding standards
+
+**Key Rules Overview:**
+- JSDoc completo profesional obligatorio
+- Result pattern siempre (mks-fumadocs-template/utils/result)
+- Logging via mks-fumadocs-template/utils/logger (NUNCA console.log)
+- Validacion con Arktype
+- Nomenclatura: prefijo I para interfaces
+- Estructura: src/types/ y src/utils/ con barrel exports
+- Async/await preferido sobre Promise chaining
+
+## Monorepo Stack
+
+This is a Bun-based monorepo for npm packages.
+
+**Core Stack:**
+- **Runtime**: Bun (package manager & runtime)
+- **Workspaces**: Bun workspaces (`workspace:*` protocol)
+- **Bundling**: Rolldown (`rolldown` v1.0.0-beta.58)
+- **Linting**: Oxlint (OxC-based linter)
+- **Formatting**: Prettier with `prettier-plugin-organize-imports`
+- **Type Checking**: TSGO (@typescript/native-preview v7.0.0-dev)
+- **Validation**: Arktype (schema validation)
+- **Versioning**: Changesets
+
+## Commands
+
+```bash
+# Development - all workspaces
+bun run dev          # Start dev mode for all packages
+
+# Build - all workspaces
+bun run build        # Build all packages
+
+# Type checking
+bun run typecheck    # Type check all packages
+
+# Linting (Oxlint only - no ESLint)
+bun run lint         # Run oxlint
+bun run lint:fix     # Auto-fix oxlint issues
+
+# Formatting (Prettier)
+bun run format       # Format all files
+bun run format:check # Check formatting
+
+# Clean everything
+bun run clean        # Remove node_modules, dist, .turbo
+
+# Changesets (versioning)
+bun run changeset              # Create a changeset
+bun run changeset:version      # Apply changesets and bump versions
+bun run changeset:publish      # Publish packages to npm
+```
+
+## Monorepo Structure
+
+```
+├── core/
+│   └── packages/
+│       ├── utils/              # Shared utilities package
+│       │   ├── src/
+│       │   │   ├── logger.ts   # Logging wrapper (@mks2508/better-logger)
+│       │   │   ├── result.ts   # Result wrapper (@mks2508/no-throw)
+│       │   │   └── index.ts    # Barrel export
+│       │   ├── rolldown.config.ts
+│       │   └── package.json
+│       └── main/               # Main library package
+│           ├── src/
+│           └── package.json    # Depends on utils via workspace:*
+└── apps/
+    └── example/                # Example app
+        └── package.json        # Depends on utils via workspace:*
+```
+
+**Workspace Pattern:**
+- Packages in `core/packages/*` and `apps/*` are auto-discovered
+- Internal dependencies use `"mks-fumadocs-template/package": "workspace:*"`
+- Root `package.json` defines shared devDependencies
+
+## Shared Utilities Pattern
+
+The `mks-fumadocs-template/utils` package provides shared wrappers:
+
+### Logger (`mks-fumadocs-template/utils/logger`)
+
+Wrapper around `@mks2508/better-logger` with preset configured:
+```typescript
+import { createLogger } from 'mks-fumadocs-template/utils/logger';
+
+const log = createLogger('ComponentName');
+log.info('Message');
+log.success('Success!');
+```
+
+### Result (`mks-fumadocs-template/utils/result`)
+
+Wrapper around `@mks2508/no-throw` with domain-specific error codes:
+```typescript
+import { ok, tryCatch, createAppError, type Result } from 'mks-fumadocs-template/utils/result';
+
+const result: Result<string> = ok('success');
+const error = createAppError('NetworkError', 'Failed to fetch');
+```
+
+## Tool Configuration Files
+
+### Root TypeScript/TSGO (`tsconfig.json`)
+- Target: ES2022, Module: ESNext
+- Strict mode enabled
+- `moduleResolution: "bundler"`
+- Key options: `verbatimModuleSyntax: true`, `declaration: true`
+- Compiler: TSGO (@typescript/native-preview) for faster type checking
+
+### Validation (Arktype)
+Schema validation using Arktype for performance:
+```typescript
+import { type } from 'arktype';
+
+export const OptionsSchema = type({
+  url: 'string',
+  timeout: 'number.optional',
+});
+
+const result = OptionsSchema(options);
+if (result instanceof type.errors) {
+  return err(result.summary());
+}
+```
+
+### Oxlint (`oxlint.json`)
+- Categories: `correctness`, `suspicious`, `perf`, `style` -> "warn"
+- `restriction` -> "off"
+- Env: `node`, `es2021`
+
+### Prettier (`.prettierrc`)
+- 100 char width, 2 spaces, single quotes
+- Plugin: `prettier-plugin-organize-imports`
+- Trailing commas: es5
+
+## Workspace Dependencies
+
+When adding a new package dependency:
+
+1. **For shared packages**: Add to appropriate `core/packages/*/package.json`
+2. **For workspace deps**: Use `"mks-fumadocs-template/name": "workspace:*"`
+3. **For external deps**: Add to root `package.json` devDependencies if used across multiple packages
+
+```bash
+bun install              # Install/resolves workspace dependencies
+```
+
+## Build Output Patterns
+
+- **Rolldown**: Generates JS + sourcemaps, separate `tsc --emitDeclarationOnly` for types
+- Always ESM-first, CJS as optional compatibility layer

package/dist/templates/fumadocs/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MKS2508
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.