create-bunspace 0.1.1 → 0.2.1

package/templates/fumadocs/src/app/(home)/page.tsx

@@ -0,0 +1,132 @@
+'use client';
+
+import Link from 'next/link';
+import { ArrowRight } from 'lucide-react';
+import { useEffect, useState } from 'react';
+
+export default function HomePage() {
+  const [mounted, setMounted] = useState(false);
+
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  return (
+    <div className="min-h-screen bg-white dark:bg-black">
+      <main className="max-w-4xl mx-auto px-6 py-24">
+        {/* Header */}
+        <div className={`mb-20 transition-opacity duration-700 ${mounted ? 'opacity-100' : 'opacity-0'}`}>
+          <h1 className="text-5xl md:text-7xl font-semibold tracking-tight text-gray-900 dark:text-white mb-6">
+            Telegram Bot Manager
+          </h1>
+          <p className="text-xl text-gray-600 dark:text-gray-400 max-w-2xl leading-relaxed">
+            TypeScript library and CLI for automating Telegram bot management via @BotFather using GramJS MTProto.
+          </p>
+        </div>
+
+        {/* Code Example */}
+        <div className={`mb-20 transition-opacity duration-700 delay-200 ${mounted ? 'opacity-100' : 'opacity-0'}`}>
+          <div className="flex items-center gap-2 mb-4">
+            <div className="w-3 h-3 rounded-full border border-gray-300 dark:border-gray-700" />
+            <div className="w-3 h-3 rounded-full border border-gray-300 dark:border-gray-700" />
+            <div className="w-3 h-3 rounded-full border border-gray-300 dark:border-gray-700" />
+            <span className="ml-2 text-xs text-gray-500 dark:text-gray-500 font-mono uppercase tracking-wide">Terminal</span>
+          </div>
+          <pre className="bg-gray-50 dark:bg-gray-950 border border-gray-200 dark:border-gray-800 rounded-lg p-6 overflow-x-auto">
+            <code className="text-sm font-mono text-gray-800 dark:text-gray-200">
+              <span className="text-gray-500 dark:text-gray-500">$</span> npx @mks2508/telegram-bot-manager bootstrap
+              <br />
+              <span className="text-green-600">→</span> Creating bot via BotFather...
+              <br />
+              <span className="text-green-600">→</span> Bot created: @my_bot
+              <br />
+              <span className="text-green-600">→</span> Forum created: -1001234567890
+              <br />
+              <span className="text-green-600">→</span> Topics configured: General, Control, Logs
+              <br />
+              <span className="text-green-600">→</span> Token: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
+            </code>
+          </pre>
+        </div>
+
+        {/* Features - Simple List */}
+        <div className={`mb-20 transition-opacity duration-700 delay-400 ${mounted ? 'opacity-100' : 'opacity-0'}`}>
+          <h2 className="text-sm font-semibold text-gray-900 dark:text-white uppercase tracking-wider mb-8">
+            Features
+          </h2>
+          <div className="space-y-6">
+            <div className="flex items-start gap-4">
+              <span className="text-blue-600 dark:text-blue-500 font-mono text-sm mt-0.5">01</span>
+              <div>
+                <h3 className="font-semibold text-gray-900 dark:text-white mb-1">BotFather Automation</h3>
+                <p className="text-gray-600 dark:text-gray-400">Create bots, configure commands, set descriptions, retrieve tokens programmatically</p>
+              </div>
+            </div>
+            <div className="flex items-start gap-4">
+              <span className="text-blue-600 dark:text-blue-500 font-mono text-sm mt-0.5">02</span>
+              <div>
+                <h3 className="font-semibold text-gray-900 dark:text-white mb-1">CLI & Library</h3>
+                <p className="text-gray-600 dark:text-gray-400">Use via npx for quick automation or import as TypeScript library</p>
+              </div>
+            </div>
+            <div className="flex items-start gap-4">
+              <span className="text-blue-600 dark:text-blue-500 font-mono text-sm mt-0.5">03</span>
+              <div>
+                <h3 className="font-semibold text-gray-900 dark:text-white mb-1">Multi-Bot Support</h3>
+                <p className="text-gray-600 dark:text-gray-400">Manage multiple bots with environment-based configuration (local, staging, production)</p>
+              </div>
+            </div>
+            <div className="flex items-start gap-4">
+              <span className="text-blue-600 dark:text-blue-500 font-mono text-sm mt-0.5">04</span>
+              <div>
+                <h3 className="font-semibold text-gray-900 dark:text-white mb-1">Forum & Topics</h3>
+                <p className="text-gray-600 dark:text-gray-400">Create forum groups with custom topics, colors, and admin permissions</p>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        {/* CTA */}
+        <div className={`transition-opacity duration-700 delay-600 ${mounted ? 'opacity-100' : 'opacity-0'}`}>
+          <div className="flex flex-col sm:flex-row gap-4 items-start sm:items-center">
+            <Link
+              href="/docs/introduccion/quick-start/"
+              className="inline-flex items-center gap-2 px-6 py-3 bg-gray-900 dark:bg-white text-white dark:text-black rounded font-medium hover:opacity-90 transition-opacity"
+            >
+              Get Started
+              <ArrowRight className="w-4 h-4" />
+            </Link>
+            <span className="text-gray-500 dark:text-gray-500">or</span>
+            <Link
+              href="/docs/introduccion/"
+              className="text-blue-600 dark:text-blue-500 hover:underline font-medium"
+            >
+              Read the docs
+            </Link>
+          </div>
+        </div>
+
+        {/* Footer Links */}
+        <div className={`mt-32 pt-16 border-t border-gray-200 dark:border-gray-800 transition-opacity duration-700 delay-800 ${mounted ? 'opacity-100' : 'opacity-0'}`}>
+          <nav className="flex flex-wrap gap-x-8 gap-y-4 text-sm">
+            <Link href="/docs/introduccion/installation/" className="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
+              Installation
+            </Link>
+            <Link href="/docs/referencia-de-biblioteca/" className="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
+              API Reference
+            </Link>
+            <Link href="/docs/referencia-de-cli/" className="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
+              CLI Reference
+            </Link>
+            <Link href="/docs/configuracion/" className="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
+              Configuration
+            </Link>
+            <Link href="/en/docs/" className="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
+              English
+            </Link>
+          </nav>
+        </div>
+      </main>
+    </div>
+  );
+}

package/templates/fumadocs/src/app/api/search/route.ts

@@ -0,0 +1,9 @@
+// Search API no compatible con static export (GitHub Pages)
+// Redirigir a una página de búsqueda estática o eliminar
+import { NextResponse } from 'next/server';
+
+export const dynamic = 'force-static';
+
+export async function GET() {
+  return NextResponse.json({ message: 'Search not available in static export' }, { status: 501 });
+}

package/templates/fumadocs/src/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,62 @@
+import { getPageImage, source, getRawMarkdownContent } from '@/lib/source';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { notFound } from 'next/navigation';
+import { getMDXComponents } from '@/mdx-components';
+import { MarkdownActions } from '@/components/markdown-actions';
+import type { Metadata } from 'next';
+import { createRelativeLink } from 'fumadocs-ui/mdx';
+
+export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+  const markdownContent = await getRawMarkdownContent(page);
+
+  return (
+    <DocsPage
+      toc={page.data.toc}
+      full={page.data.full}
+      tableOfContent={{
+        header: (
+          <div className="mb-4">
+            <h3 className="text-xs font-semibold text-fd-muted-foreground uppercase">
+              Actions
+            </h3>
+            <MarkdownActions content={markdownContent} title={page.data.title} locale="es" />
+          </div>
+        ),
+      }}
+    >
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX
+          components={getMDXComponents({
+            // this allows you to link to other pages with relative file paths
+            a: createRelativeLink(source, page),
+          })}
+        />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata(props: PageProps<'/docs/[[...slug]]'>): Promise<Metadata> {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+    openGraph: {
+      images: getPageImage(page).url,
+    },
+  };
+}

package/templates/fumadocs/src/app/docs/layout.tsx

@@ -0,0 +1,11 @@
+import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: LayoutProps<'/docs'>) {
+  return (
+    <DocsLayout tree={source.getPageTree()} {...baseOptions()}>
+      {children}
+    </DocsLayout>
+  );
+}

package/templates/fumadocs/src/app/en/docs/[[...slug]]/page.tsx

@@ -0,0 +1,61 @@
+import { getPageImage, sourceEn, getRawMarkdownContent } from '@/lib/source';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/layouts/docs/page';
+import { notFound } from 'next/navigation';
+import { getMDXComponents } from '@/mdx-components';
+import { MarkdownActions } from '@/components/markdown-actions';
+import type { Metadata } from 'next';
+import { createRelativeLink } from 'fumadocs-ui/mdx';
+
+export default async function Page(props: PageProps<'/en/docs/[[...slug]]'>) {
+  const params = await props.params;
+  const page = sourceEn.getPage(params.slug);
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+  const markdownContent = await getRawMarkdownContent(page);
+
+  return (
+    <DocsPage
+      toc={page.data.toc}
+      full={page.data.full}
+      tableOfContent={{
+        header: (
+          <div className="mb-4">
+            <h3 className="text-xs font-semibold text-fd-muted-foreground uppercase">
+              Actions
+            </h3>
+            <MarkdownActions content={markdownContent} title={page.data.title} locale="en" />
+          </div>
+        ),
+      }}
+    >
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX
+          components={getMDXComponents({
+            a: createRelativeLink(sourceEn, page),
+          })}
+        />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function generateStaticParams() {
+  return sourceEn.generateParams();
+}
+
+export async function generateMetadata(props: PageProps<'/en/docs/[[...slug]]'>): Promise<Metadata> {
+  const params = await props.params;
+  const page = sourceEn.getPage(params.slug);
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+    openGraph: {
+      images: getPageImage(page).url,
+    },
+  };
+}

package/templates/fumadocs/src/app/en/docs/layout.tsx

@@ -0,0 +1,11 @@
+import { sourceEn } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { baseOptions } from '@/lib/layout.shared';
+
+export default function Layout({ children }: LayoutProps<'/en/docs'>) {
+  return (
+    <DocsLayout tree={sourceEn.getPageTree()} {...baseOptions()}>
+      {children}
+    </DocsLayout>
+  );
+}

package/templates/fumadocs/src/app/global.css

@@ -0,0 +1,3 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';

package/templates/fumadocs/src/app/layout.tsx

@@ -0,0 +1,47 @@
+import { RootProvider } from 'fumadocs-ui/provider/next';
+import './global.css';
+import { Inter } from 'next/font/google';
+import { LanguageSelector } from '@/components/language-selector';
+import { siteConfig } from '@/config/site.config';
+
+const inter = Inter({
+  subsets: ['latin'],
+});
+
+export const metadata = {
+  title: {
+    default: siteConfig.name,
+    template: `%s | ${siteConfig.name}`,
+  },
+  description: siteConfig.description,
+  keywords: process.env.KEYWORDS?.split(',') || [],
+  authors: [{ name: siteConfig.author }],
+  openGraph: {
+    type: 'website' as const,
+    url: siteConfig.url,
+    title: siteConfig.name,
+    description: siteConfig.description,
+    siteName: siteConfig.name,
+    images: siteConfig.ogImageUrl ? [siteConfig.ogImageUrl] : [],
+  },
+  twitter: {
+    card: 'summary_large_image' as const,
+    title: siteConfig.name,
+    description: siteConfig.description,
+  },
+};
+
+export default function Layout({ children }: LayoutProps<'/'>) {
+  return (
+    <html lang="es" className={inter.className} suppressHydrationWarning>
+      <body className="flex flex-col min-h-screen bg-[var(--bg-primary)] text-[var(--text-primary)]">
+        <RootProvider>
+          <nav className="fixed top-4 right-4 z-50">
+            <LanguageSelector />
+          </nav>
+          {children}
+        </RootProvider>
+      </body>
+    </html>
+  );
+}

package/templates/fumadocs/src/app/llms-full.txt/route.ts

@@ -0,0 +1,10 @@
+import { getLLMText, source } from '@/lib/source';
+
+export const revalidate = false;
+
+export async function GET() {
+  const scan = source.getPages().map(getLLMText);
+  const scanned = await Promise.all(scan);
+
+  return new Response(scanned.join('\n\n'));
+}

package/templates/fumadocs/src/app/og/docs/[...slug]/route.tsx

@@ -0,0 +1,27 @@
+import { getPageImage, source } from '@/lib/source';
+import { notFound } from 'next/navigation';
+import { ImageResponse } from 'next/og';
+import { generate as DefaultImage } from 'fumadocs-ui/og';
+
+export const revalidate = false;
+
+export async function GET(_req: Request, { params }: RouteContext<'/og/docs/[...slug]'>) {
+  const { slug } = await params;
+  const page = source.getPage(slug.slice(0, -1));
+  if (!page) notFound();
+
+  return new ImageResponse(
+    <DefaultImage title={page.data.title} description={page.data.description} site="My App" />,
+    {
+      width: 1200,
+      height: 630,
+    },
+  );
+}
+
+export function generateStaticParams() {
+  return source.getPages().map((page) => ({
+    lang: page.locale,
+    slug: getPageImage(page).segments,
+  }));
+}

package/templates/fumadocs/src/components/language-selector.tsx

@@ -0,0 +1,56 @@
+'use client';
+
+import Link from 'next/link';
+import { usePathname } from 'next/navigation';
+import { useState } from 'react';
+
+const languages = [
+  { code: 'es', name: 'Español', path: '/docs' },
+  { code: 'en', name: 'English', path: '/en/docs' },
+];
+
+export function LanguageSelector() {
+  const pathname = usePathname();
+  const [isOpen, setIsOpen] = useState(false);
+
+  // Detect current language
+  const currentLang = pathname.startsWith('/en') ? 'en' : 'es';
+
+  return (
+    <div className="relative">
+      <button
+        onClick={() => setIsOpen(!isOpen)}
+        className="flex items-center gap-2 px-3 py-1.5 rounded-lg bg-[var(--bg-secondary)] hover:bg-[var(--bg-tertiary)] transition-colors"
+      >
+        <span className="text-sm font-medium">
+          {languages.find(l => l.code === currentLang)?.name}
+        </span>
+        <svg
+          className={`w-4 h-4 transition-transform ${isOpen ? 'rotate-180' : ''}`}
+          fill="none"
+          stroke="currentColor"
+          viewBox="0 0 24 24"
+        >
+          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 9l-7 7-7-7" />
+        </svg>
+      </button>
+
+      {isOpen && (
+        <div className="absolute top-full right-0 mt-2 py-1 rounded-lg bg-[var(--bg-secondary)] border border-[var(--border-default)] shadow-lg z-50">
+          {languages.map((lang) => (
+            <Link
+              key={lang.code}
+              href={lang.path}
+              onClick={() => setIsOpen(false)}
+              className={`block px-4 py-2 text-sm hover:bg-[var(--bg-tertiary)] transition-colors ${
+                currentLang === lang.code ? 'text-[var(--color-primary)] font-medium' : 'text-[var(--text-secondary)]'
+              }`}
+            >
+              {lang.name}
+            </Link>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

package/templates/fumadocs/src/components/markdown-actions.tsx

@@ -0,0 +1,61 @@
+'use client';
+
+import { Copy, ExternalLink, Check } from 'lucide-react';
+import { useState } from 'react';
+
+interface MarkdownActionsProps {
+  content: string;
+  title: string;
+  locale: string;
+}
+
+export function MarkdownActions({ content, title, locale }: MarkdownActionsProps) {
+  const [copied, setCopied] = useState(false);
+
+  const labels = locale === 'en'
+    ? { copy: 'Copy as Markdown', open: 'Open as Markdown', copied: 'Copied!' }
+    : { copy: 'Copiar como Markdown', open: 'Abrir como Markdown', copied: '¡Copiado!' };
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(content);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch (err) {
+      console.error('Failed to copy:', err);
+    }
+  };
+
+  const handleOpen = () => {
+    const blob = new Blob([content], { type: 'text/markdown' });
+    const url = URL.createObjectURL(blob);
+    window.open(url, '_blank');
+    URL.revokeObjectURL(url);
+  };
+
+  return (
+    <div className="flex flex-col gap-2">
+      <button
+        onClick={handleCopy}
+        className="flex items-center gap-2 px-3 py-2 text-sm rounded-md
+                   text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground
+                   transition-colors"
+        aria-label={labels.copy}
+      >
+        {copied ? <Check className="w-4 h-4" /> : <Copy className="w-4 h-4" />}
+        <span>{copied ? labels.copied : labels.copy}</span>
+      </button>
+
+      <button
+        onClick={handleOpen}
+        className="flex items-center gap-2 px-3 py-2 text-sm rounded-md
+                   text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground
+                   transition-colors"
+        aria-label={labels.open}
+      >
+        <ExternalLink className="w-4 h-4" />
+        <span>{labels.open}</span>
+      </button>
+    </div>
+  );
+}

package/templates/fumadocs/src/config/site.config.ts

@@ -0,0 +1,115 @@
+/**
+ * Site configuration for Fumadocs template.
+ *
+ * This configuration object contains all site-specific values that would otherwise
+ * be hardcoded throughout the application. It uses environment variables with
+ * fallback defaults to support both template usage and production deployments.
+ *
+ * @module config/site.config
+ */
+
+/**
+ * Site configuration interface.
+ *
+ * Defines all configurable aspects of the documentation site including metadata,
+ * i18n settings, deployment configuration, and theme customization.
+ *
+ * @interface ISiteConfig
+ */
+export interface ISiteConfig {
+  /** Site name used in titles, headers, and metadata */
+  name: string;
+  /** Site description for SEO and metadata */
+  description: string;
+  /** Author name for metadata and copyright */
+  author: string;
+  /** Full URL of the site (including protocol) */
+  url: string;
+  /** Optional custom OpenGraph image URL */
+  ogImageUrl?: string;
+
+  // i18n
+  /** Default locale for the documentation ('es' | 'en') */
+  defaultLocale: 'es' | 'en';
+  /** Array of supported locale codes */
+  supportedLocales: string[];
+
+  // Deployment
+  /** Base path for GitHub Pages or subdirectory deployment (e.g., '/docs') */
+  basePath: string;
+  /** Whether to append trailing slash to all URLs */
+  trailingSlash: boolean;
+
+  // Theme
+  /** Optional primary color override (CSS variable format) */
+  primaryColor?: string;
+  /** Logo configuration with SVG markup or text fallback */
+  logo?: {
+    /** Raw SVG markup for the logo */
+    svg?: string;
+    /** Text fallback when SVG is not provided */
+    text?: string;
+  };
+}
+
+/**
+ * Site configuration instance.
+ *
+ * Reads values from environment variables with sensible defaults for local development.
+ * In production, these should be set via `.env.local` or deployment platform variables.
+ *
+ * @example
+ * ```bash
+ * # .env.local
+ * PROJECT_NAME=My Docs
+ * DESCRIPTION=Documentation for My Project
+ * AUTHOR=Your Name
+ * BASE_PATH=/my-project
+ * DEFAULT_LOCALE=en
+ * SUPPORTED_LOCALES=en,es
+ * ```
+ *
+ * @constant
+ * @type {ISiteConfig}
+ */
+export const siteConfig: ISiteConfig = {
+  name: process.env.PROJECT_NAME || 'Mi Documentación',
+  description: process.env.DESCRIPTION || 'Documentación con Fumadocs',
+  author: process.env.AUTHOR || 'Autor',
+
+  url: process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000',
+
+  ogImageUrl: process.env.OG_IMAGE_URL,
+
+  defaultLocale: (process.env.DEFAULT_LOCALE as 'es' | 'en') || 'es',
+  supportedLocales: process.env.SUPPORTED_LOCALES?.split(',') || ['es', 'en'],
+
+  basePath: process.env.BASE_PATH || '',
+  trailingSlash: process.env.TRAILING_SLASH === 'true',
+
+  primaryColor: process.env.PRIMARY_COLOR,
+  logo: process.env.LOGO_SVG
+    ? { svg: process.env.LOGO_SVG }
+    : process.env.LOGO_TEXT
+      ? { text: process.env.LOGO_TEXT }
+      : undefined,
+};
+
+/**
+ * Default site configuration values for documentation purposes.
+ *
+ * These are the fallback values used when environment variables are not set.
+ *
+ * @constant
+ * @type {ISiteConfig}
+ */
+export const defaultSiteConfig: ISiteConfig = {
+  name: 'Mi Documentación',
+  description: 'Documentación con Fumadocs',
+  author: 'Autor',
+  url: 'http://localhost:3000',
+  defaultLocale: 'es',
+  supportedLocales: ['es', 'en'],
+  basePath: '',
+  trailingSlash: false,
+};

package/templates/fumadocs/src/lib/layout.shared.tsx

@@ -0,0 +1,23 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import { siteConfig } from '@/config/site.config';
+
+/**
+ * Base layout options for Fumadocs.
+ *
+ * Provides the navigation title/branding for the documentation site.
+ * Uses siteConfig.logo if defined, otherwise falls back to siteConfig.name.
+ *
+ * @returns {BaseLayoutProps} Fumadocs base layout configuration
+ */
+export function baseOptions(): BaseLayoutProps {
+  const logoContent = siteConfig.logo?.svg
+    ? // eslint-disable-next-line react/no-danger-with-children
+    <div dangerouslySetInnerHTML={{ __html: siteConfig.logo.svg }} />
+    : siteConfig.logo?.text || siteConfig.name;
+
+  return {
+    nav: {
+      title: logoContent,
+    },
+  };
+}