create-bunspace 0.1.1 → 0.2.1

package/dist/templates/fumadocs/src/lib/source.ts

@@ -0,0 +1,91 @@
+import { docs, docsEn } from 'fumadocs-mdx:collections/server';
+import { type InferPageType, loader } from 'fumadocs-core/source';
+import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons';
+import { siteConfig } from '@/config/site.config';
+
+/**
+ * Base URL prefix computed from basePath.
+ * Combines the basePath (e.g., '/telegram-bot-manager') with the docs path.
+ */
+const basePrefix = siteConfig.basePath;
+
+/**
+ * Source loader for Spanish documentation (default locale).
+ *
+ * @see {@link https://fumadocs.vercel.app/docs/headless/source Fumadocs Source}
+ */
+export const source = loader({
+  baseUrl: `${basePrefix}/docs`,
+  source: docs.toFumadocsSource(),
+  plugins: [lucideIconsPlugin()],
+});
+
+/**
+ * Source loader for English documentation.
+ *
+ * @see {@link https://fumadocs.vercel.app/docs/headless/source Fumadocs Source}
+ */
+export const sourceEn = loader({
+  baseUrl: `${basePrefix}/en/docs`,
+  source: docsEn.toFumadocsSource(),
+  plugins: [lucideIconsPlugin()],
+});
+
+/**
+ * Generates OpenGraph image metadata for a page.
+ *
+ * @param page - Page instance from source loader
+ * @returns Object with segments and URL for OG image
+ * @example
+ * ```typescript
+ * const image = getPageImage(page);
+ * // { segments: ['introduction', 'image.png'], url: '/og/docs/introduction/image.png' }
+ * ```
+ */
+export function getPageImage(page: InferPageType<typeof source>) {
+  const segments = [...page.slugs, 'image.png'];
+
+  return {
+    segments,
+    url: `${basePrefix}/og/docs/${segments.join('/')}`,
+  };
+}
+
+/**
+ * Retrieves the raw markdown content for LLM consumption.
+ *
+ * @param page - Page instance from source loader
+ * @returns Markdown string with title and processed content
+ * @deprecated Use {@link getRawMarkdownContent} instead
+ */
+export async function getLLMText(page: InferPageType<typeof source>) {
+  const processed = await page.data.getText('processed');
+
+  return `# ${page.data.title}
+
+${processed}`;
+}
+
+/**
+ * Retrieves the raw markdown content for copying/viewing.
+ *
+ * Formats the page content as raw markdown with the title as a heading.
+ * Used by the MarkdownActions component for "Copy as Markdown" functionality.
+ *
+ * @param page - Page instance from either source loader
+ * @returns Complete markdown string with title and content
+ * @example
+ * ```typescript
+ * const markdown = await getRawMarkdownContent(page);
+ * // "# My Page\n\nContent here..."
+ * ```
+ */
+export async function getRawMarkdownContent(
+  page: InferPageType<typeof source> | InferPageType<typeof sourceEn>
+) {
+  const processed = await page.data.getText('processed');
+
+  return `# ${page.data.title}
+
+${processed}`;
+}

package/dist/templates/fumadocs/src/mdx-components.tsx

@@ -0,0 +1,14 @@
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+import { Steps } from 'fumadocs-ui/components/steps';
+import { Tabs, Tab } from 'fumadocs-ui/components/tabs';
+import type { MDXComponents } from 'mdx/types';
+
+export function getMDXComponents(components?: MDXComponents): MDXComponents {
+  return {
+    Steps,
+    Tabs,
+    Tab,
+    ...defaultMdxComponents,
+    ...components,
+  };
+}

package/dist/templates/fumadocs/tsconfig.json

@@ -0,0 +1,46 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "target": "ESNext",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ],
+      "fumadocs-mdx:collections/*": [
+        ".source/*"
+      ]
+    },
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bunspace",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "type": "module",
   "description": "Multi-template project scaffolder for Bun",
   "author": "MKS2508",

package/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/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/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/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.