create-bunspace 0.1.0 → 0.2.0

package/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/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/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"
+  ]
+}