refactor(api)!: rename toFumadocsSource() -> toDocsSource() (brand-neutral)

Renames the public doc-collection method across runtime, types, examples
and create-app templates so the API carries no upstream brand. The
internal helper and all call sites move together; fumadocs-core package
imports are untouched. Pairs with the .docs default outDir change.

BREAKING CHANGE: docs.toFumadocsSource() is now docs.toDocsSource().

Co-authored-by: Hanzo Dev <[email protected]>

.changeset/dotdocs-default-outdir.md

@@ -1,5 +1,9 @@
 ---
-"fumadocs-mdx": patch
+"fumadocs-mdx": minor
+"@fumadocs/content": minor
 ---
 
-Default `outDir` is now `.docs` (was `docs`), matching the `collections/*` → `./.docs/*` tsconfig alias used by every template and example. This makes a fresh fork resolve `import { docs } from 'collections/server'` out of the box with no `createMDX({ outDir })` override.
+Two brand-neutral / zero-config fixes:
+
+- **Default `outDir` is now `.docs`** (was `docs`), matching the `collections/*` → `./.docs/*` tsconfig alias used by every template and example. A fresh fork now resolves `import { docs } from 'collections/server'` out of the box with no `createMDX({ outDir })` override.
+- **BREAKING: the doc-collection method `toFumadocsSource()` is renamed `toDocsSource()`** to keep the public API brand-neutral. Update `lib/source.ts`: `source: docs.toDocsSource()`.

examples/base-ui/lib/source.ts

@@ -6,7 +6,7 @@ import { docsContentRoute, docsImageRoute, docsRoute } from './shared';
 // See https://fumadocs.dev/docs/headless/source-api for more info
 export const source = loader({
   baseUrl: docsRoute,
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   plugins: [lucideIconsPlugin()],
 });
 

examples/i18n/lib/source.ts

@@ -4,6 +4,6 @@ import { docs } from 'collections/server';
 
 export const source = loader({
   baseUrl: '/docs',
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   i18n,
 });

examples/next-min/lib/source.ts

@@ -3,5 +3,5 @@ import { loader } from '@hanzo/docs-core/source';
 
 export const source = loader({
   baseUrl: '/docs',
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
 });

examples/next-shadcn/lib/source.ts

@@ -3,5 +3,5 @@ import { loader } from 'fumadocs-core/source';
 
 export const source = loader({
   baseUrl: '/',
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
 });

examples/next-static/lib/source.ts

@@ -5,7 +5,7 @@ import { docsContentRoute, docsImageRoute, docsRoute } from './shared';
 // See https://fumadocs.dev/docs/headless/source-api for more info
 export const source = loader({
   baseUrl: docsRoute,
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   plugins: [],
 });
 

examples/next/lib/source.ts

@@ -6,7 +6,7 @@ import { docsContentRoute, docsImageRoute, docsRoute } from './shared';
 // See https://fumadocs.dev/docs/headless/source-api for more info
 export const source = loader({
   baseUrl: docsRoute,
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   plugins: [lucideIconsPlugin()],
 });
 

examples/obsidian/lib/source.ts

@@ -3,5 +3,5 @@ import { loader } from '@hanzo/docs-core/source';
 
 export const source = loader({
   baseUrl: '/docs',
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
 });

examples/openapi/lib/source.ts

@@ -5,7 +5,7 @@ import { openapi } from './openapi';
 
 export const source = loader(
   {
-    docs: docs.toFumadocsSource(),
+    docs: docs.toDocsSource(),
     openapi: await openapi.staticSource({
       groupBy: 'tag',
     }),

examples/python/lib/source.ts

@@ -5,5 +5,5 @@ import { loader } from '@hanzo/docs-core/source';
 export const source = loader({
   // it assigns a URL to your pages
   baseUrl: '/docs',
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
 });

examples/react-router-i18n/app/lib/source.ts

@@ -3,7 +3,7 @@ import { docs } from 'collections/server';
 import { i18n } from '@/lib/i18n';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
   i18n,
 });

examples/react-router-min/app/lib/source.ts

@@ -2,6 +2,6 @@ import { loader } from '@hanzo/docs-core/source';
 import { docs } from 'collections/server';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
 });

examples/react-router-rsc/app/lib/source.ts

@@ -2,6 +2,6 @@ import { loader } from '@hanzo/docs-core/source';
 import { docs } from 'collections/server';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
 });

examples/react-router-spa/app/lib/source.ts

@@ -3,7 +3,7 @@ import { docs } from 'collections/server';
 import { docsContentRoute, docsRoute } from './shared';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: docsRoute,
 });
 

examples/react-router/app/lib/source.ts

@@ -3,7 +3,7 @@ import { docs } from 'collections/server';
 import { docsContentRoute, docsRoute } from './shared';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: docsRoute,
 });
 

examples/stackblitz/src/lib/source.ts

@@ -4,7 +4,7 @@ import { docs } from 'collections/server';
 import { docsContentRoute, docsImageRoute, docsRoute } from './shared';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: docsRoute,
   plugins: [lucideIconsPlugin()],
 });

examples/tanstack-start-i18n/src/lib/source.ts

@@ -4,7 +4,7 @@ import { docs } from 'collections/server';
 import { i18n } from '@/lib/i18n';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
   i18n,
   icon(icon) {

examples/tanstack-start-min/src/lib/source.ts

@@ -3,7 +3,7 @@ import { docs } from 'collections/server';
 import { lucideIconsPlugin } from '@hanzo/docs-core/source/lucide-icons';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
   plugins: [lucideIconsPlugin()],
 });

examples/tanstack-start-openapi/src/lib/source.ts

@@ -6,7 +6,7 @@ import { openapi } from './openapi';
 
 export const source = loader(
   {
-    docs: docs.toFumadocsSource(),
+    docs: docs.toDocsSource(),
     openapi: await openapi.staticSource({
       baseDir: 'openapi',
     }),

examples/tanstack-start-spa/src/lib/source.ts

@@ -4,7 +4,7 @@ import { docs } from 'collections/server';
 import { docsRoute } from './shared';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: docsRoute,
   plugins: [lucideIconsPlugin()],
 });

examples/tanstack-start-story/src/lib/source.ts

@@ -3,7 +3,7 @@ import { docs } from 'collections/server';
 import { lucideIconsPlugin } from '@hanzo/docs-core/source/lucide-icons';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
   plugins: [lucideIconsPlugin()],
 });

examples/tanstack-start/src/lib/source.ts

@@ -4,7 +4,7 @@ import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons';
 import { docsRoute } from './shared';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: docsRoute,
   plugins: [lucideIconsPlugin()],
 });

examples/waku-i18n/src/lib/source.ts

@@ -3,7 +3,7 @@ import { docs } from 'collections/server';
 import { i18n } from '@/lib/i18n';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: '/docs',
   i18n,
 });

examples/waku/src/lib/source.ts

@@ -4,7 +4,7 @@ import { docs } from 'collections/server';
 import { docsContentRoute, docsImageRoute, docsRoute } from './shared';
 
 export const source = loader({
-  source: docs.toFumadocsSource(),
+  source: docs.toDocsSource(),
   baseUrl: docsRoute,
   plugins: [lucideIconsPlugin()],
 });

packages/content/src/runtime.ts

@@ -9,7 +9,7 @@ type ToPageData<T> =
       ? Frontmatter & T
       : never;
 
-export function toFumadocsSource<
+export function toDocsSource<
   Mdx extends MDXStoreData<PageData> | MDXStoreLazyData<PageData, unknown> = MDXStoreData<
     PageData,
     unknown
@@ -49,8 +49,8 @@ export function docsStore<
   Meta extends { data: MetaData } = { data: MetaData },
 >(mdxStore: FileCollectionStore<Mdx>, metaStore: FileCollectionStore<Meta>) {
   return {
-    toFumadocsSource() {
-      return toFumadocsSource(mdxStore, metaStore);
+    toDocsSource() {
+      return toDocsSource(mdxStore, metaStore);
     },
   };
 }

packages/mdx/src/runtime/server.ts

@@ -208,8 +208,8 @@ export function server<Config, TC extends InternalTypeConfig>(options: ServerOpt
       const entry = {
         docs: await this.doc(name, base, docGlob),
         meta: await this.meta(name, base, metaGlob),
-        toFumadocsSource(options) {
-          return toFumadocsSource(this.docs, this.meta, options);
+        toDocsSource(options) {
+          return toDocsSource(this.docs, this.meta, options);
         },
       } satisfies DocsCollectionEntry;
 
@@ -246,8 +246,8 @@ export function server<Config, TC extends InternalTypeConfig>(options: ServerOpt
       const entry = {
         docs: await this.docLazy(name, base, docHeadGlob, docBodyGlob),
         meta: await this.meta(name, base, metaGlob),
-        toFumadocsSource(options) {
-          return toFumadocsSource(this.docs, this.meta, options);
+        toDocsSource(options) {
+          return toDocsSource(this.docs, this.meta, options);
         },
       } satisfies AsyncDocsCollectionEntry;