fumadocs-mdx 13.0.7 → 14.0.0

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, P as PostprocessOptions, d as defineCollections, e as defineConfig, c as defineDocs, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../core-HkAVGq_a.js';
+export { A as AnyCollection, B as BaseCollection, a as CollectionSchema, f as DefaultMDXOptions, D as DocCollection, b as DocsCollection, G as GlobalConfig, g as MDXPresetOptions, M as MetaCollection, P as PostprocessOptions, h as applyMdxPreset, d as defineCollections, e as defineConfig, c as defineDocs, i as frontmatterSchema, m as metaSchema } from '../index-D7JdSMpp.js';
 import { Processor, Transformer } from 'unified';
 import { Root } from 'mdast';
 import '@mdx-js/mdx';
@@ -6,6 +6,7 @@ import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';
 import 'zod';
 import 'chokidar';
+import 'vfile';
 
 declare function remarkInclude(this: Processor): Transformer<Root, Root>;
 

package/dist/config/index.js

@@ -1,9 +1,9 @@
-import {
-  getDefaultMDXOptions
-} from "../chunk-FSZMKRVH.js";
 import {
   remarkInclude
-} from "../chunk-K5ZLPEIQ.js";
+} from "../chunk-FBLMK4RS.js";
+import {
+  applyMdxPreset
+} from "../chunk-E5DJTSIM.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/config/zod-4.ts
@@ -52,11 +52,11 @@ function defineConfig(config = {}) {
   return config;
 }
 export {
+  applyMdxPreset,
   defineCollections,
   defineConfig,
   defineDocs,
   frontmatterSchema,
-  getDefaultMDXOptions,
   metaSchema,
   remarkInclude
 };

package/dist/index-BlVBvy-z.d.ts

@@ -0,0 +1,8 @@
+import { C as CoreOptions } from './index-D7JdSMpp.js';
+
+interface WebpackLoaderOptions extends CoreOptions {
+    compiledConfigPath: string;
+    isDev: boolean;
+}
+
+export type { WebpackLoaderOptions as W };

package/dist/{core-HkAVGq_a.d.cts → index-D7JdSMpp.d.cts}

@@ -1,30 +1,10 @@
 import { ProcessorOptions } from '@mdx-js/mdx';
 import { StandardSchemaV1 } from '@standard-schema/spec';
-import * as plugins from 'fumadocs-core/mdx-plugins';
 import { Pluggable } from 'unified';
+import * as Plugins from 'fumadocs-core/mdx-plugins';
 import { z } from 'zod';
 import { FSWatcher } from 'chokidar';
-
-interface ExtractedReference {
-    href: string;
-}
-interface PostprocessOptions {
-    _format: 'md' | 'mdx';
-    /**
-     * Properties to export from `vfile.data`
-     */
-    valueToExport?: string[];
-    /**
-     * stringify MDAST and export via `_markdown`.
-     */
-    includeProcessedMarkdown?: boolean;
-    /**
-     * store MDAST and export via `_mdast`.
-     */
-    includeMDAST?: boolean | {
-        removePosition?: boolean;
-    };
-}
+import { VFile } from 'vfile';
 
 type ResolvePlugins = Pluggable[] | ((v: Pluggable[]) => Pluggable[]);
 type DefaultMDXOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | 'remarkPlugins' | '_ctx'> & {
@@ -34,15 +14,22 @@ type DefaultMDXOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | '
      * Properties to export from `vfile.data`
      */
     valueToExport?: string[];
-    remarkStructureOptions?: plugins.StructureOptions | false;
-    remarkHeadingOptions?: plugins.RemarkHeadingOptions;
-    remarkImageOptions?: plugins.RemarkImageOptions | false;
-    remarkCodeTabOptions?: plugins.RemarkCodeTabOptions | false;
-    remarkNpmOptions?: plugins.RemarkNpmOptions | false;
-    rehypeCodeOptions?: plugins.RehypeCodeOptions | false;
-    _withoutBundler?: boolean;
+    remarkStructureOptions?: Plugins.StructureOptions | false;
+    remarkHeadingOptions?: Plugins.RemarkHeadingOptions;
+    remarkImageOptions?: Plugins.RemarkImageOptions | false;
+    remarkCodeTabOptions?: Plugins.RemarkCodeTabOptions | false;
+    remarkNpmOptions?: Plugins.RemarkNpmOptions | false;
+    rehypeCodeOptions?: Plugins.RehypeCodeOptions | false;
 };
-declare function getDefaultMDXOptions({ valueToExport, rehypeCodeOptions, remarkImageOptions, remarkHeadingOptions, remarkStructureOptions, remarkCodeTabOptions, remarkNpmOptions, _withoutBundler, ...mdxOptions }: DefaultMDXOptions): ProcessorOptions;
+type MDXPresetOptions = ({
+    preset?: 'fumadocs';
+} & DefaultMDXOptions) | ({
+    preset: 'minimal';
+} & ProcessorOptions);
+/**
+ * apply MDX processor presets
+ */
+declare function applyMdxPreset(options?: MDXPresetOptions): (environment: BuildEnvironment) => Promise<ProcessorOptions>;
 
 /**
  * Zod 4 schema
@@ -66,13 +53,38 @@ declare const frontmatterSchema: z.ZodObject<{
     _openapi: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strip>;
 
+interface ExtractedReference {
+    href: string;
+}
+interface PostprocessOptions {
+    _format: 'md' | 'mdx';
+    /**
+     * Properties to export from `vfile.data`
+     */
+    valueToExport?: string[];
+    /**
+     * stringify MDAST and export via `_markdown`.
+     */
+    includeProcessedMarkdown?: boolean;
+    /**
+     * extract link references, export via `extractedReferences`.
+     */
+    extractLinkReferences?: boolean;
+    /**
+     * store MDAST and export via `_mdast`.
+     */
+    includeMDAST?: boolean | {
+        removePosition?: boolean;
+    };
+}
+
 type CollectionSchema<Schema extends StandardSchemaV1, Context> = Schema | ((ctx: Context) => Schema);
 type AnyCollection = DocsCollection | DocCollection | MetaCollection;
 interface BaseCollection {
     /**
-     * Directories to scan
+     * Directory to scan
      */
-    dir: string | string[];
+    dir: string;
     /**
      * what files to include/exclude (glob patterns)
      *
@@ -87,44 +99,37 @@ interface MetaCollection<Schema extends StandardSchemaV1 = StandardSchemaV1> ext
         source: string;
     }>;
 }
-interface DocCollection<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = boolean> extends BaseCollection {
+interface DocCollection<Schema extends StandardSchemaV1 = StandardSchemaV1> extends BaseCollection {
     type: 'doc';
     postprocess?: Partial<PostprocessOptions>;
-    mdxOptions?: ProcessorOptions;
+    mdxOptions?: ProcessorOptions | ((environment: BuildEnvironment) => Promise<ProcessorOptions>);
     /**
      * Load files with async
      */
-    async?: Async;
+    async?: boolean;
+    /**
+     * Compile files on-demand
+     */
+    dynamic?: boolean;
     schema?: CollectionSchema<Schema, {
         path: string;
         source: string;
     }>;
 }
-interface DocsCollection<DocSchema extends StandardSchemaV1 = StandardSchemaV1, MetaSchema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = boolean> {
+interface DocsCollection<DocSchema extends StandardSchemaV1 = StandardSchemaV1, MetaSchema extends StandardSchemaV1 = StandardSchemaV1> {
     type: 'docs';
     dir: string;
-    docs: DocCollection<DocSchema, Async>;
+    docs: DocCollection<DocSchema>;
     meta: MetaCollection<MetaSchema>;
 }
-type GlobalConfigMDXOptions = ({
-    preset?: 'fumadocs';
-} & DefaultMDXOptions) | ({
-    preset: 'minimal';
-} & ProcessorOptions);
 interface GlobalConfig {
-    collections?: Record<string, AnyCollection>;
     plugins?: PluginOption[];
     /**
      * Configure global MDX options
      *
-     * @remarks `GlobalConfigMDXOptions`
-     */
-    mdxOptions?: GlobalConfigMDXOptions | (() => Promise<GlobalConfigMDXOptions>);
-    /**
-     * Fetch last modified time with specified version control
-     * @defaultValue 'none'
+     * @remarks `MDXPresetOptions`
      */
-    lastModifiedTime?: 'git' | 'none';
+    mdxOptions?: MDXPresetOptions | (() => Promise<MDXPresetOptions>);
     /**
      * specify a directory to access & store cache (disabled during development mode).
      *
@@ -132,25 +137,26 @@ interface GlobalConfig {
      */
     experimentalBuildCache?: string;
 }
-declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = false>(options: DocCollection<Schema, Async>): DocCollection<Schema, Async>;
+declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1>(options: DocCollection<Schema>): DocCollection<Schema>;
 declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1>(options: MetaCollection<Schema>): MetaCollection<Schema>;
-declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema, Async extends boolean = false>(options: {
+declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema>(options: {
     /**
      * The content directory to scan files
      *
      *  @defaultValue 'content/docs'
      */
     dir?: string;
-    docs?: Omit<DocCollection<DocSchema, Async>, 'dir' | 'type'>;
+    docs?: Omit<DocCollection<DocSchema>, 'dir' | 'type'>;
     meta?: Omit<MetaCollection<MetaSchema>, 'dir' | 'type'>;
-}): DocsCollection<DocSchema, MetaSchema, Async>;
+}): DocsCollection<DocSchema, MetaSchema>;
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
+type BuildEnvironment = 'bundler' | 'runtime';
 interface LoadedConfig {
     collectionList: CollectionItem[];
     getCollection(name: string): CollectionItem | undefined;
     global: GlobalConfig;
-    getDefaultMDXOptions(mode?: 'default' | 'remote'): Promise<ProcessorOptions>;
+    getMDXOptions(collection?: DocCollectionItem, environment?: BuildEnvironment): ProcessorOptions | Promise<ProcessorOptions>;
 }
 type CollectionItem = MetaCollectionItem | DocCollectionItem | DocsCollectionItem;
 type PrimitiveCollectionItem<T extends DocCollection | MetaCollection> = Omit<T, 'files'> & {
@@ -165,8 +171,8 @@ interface DocsCollectionItem extends DocsCollection {
     name: string;
     meta: MetaCollectionItem;
     docs: DocCollectionItem;
+    hasFile: (filePath: string) => boolean;
 }
-declare function buildConfig(config: Record<string, unknown>): LoadedConfig;
 
 type Awaitable<T> = T | Promise<T>;
 interface EmitEntry {
@@ -179,6 +185,12 @@ interface EmitEntry {
 interface PluginContext extends CoreOptions {
     core: Core;
 }
+type CompilationContext<Collection> = PluginContext & TransformOptions<Collection>;
+interface TransformOptions<Collection> {
+    collection: Collection;
+    filePath: string;
+    source: string;
+}
 interface Plugin {
     name?: string;
     /**
@@ -193,8 +205,24 @@ interface Plugin {
      * Configure Fumadocs dev server
      */
     configureServer?: (this: PluginContext, server: ServerContext) => Awaitable<void>;
+    meta?: {
+        /**
+         * Transform metadata
+         */
+        transform?: (this: CompilationContext<MetaCollectionItem>, data: unknown) => Awaitable<unknown | void>;
+    };
+    doc?: {
+        /**
+         * Transform frontmatter
+         */
+        frontmatter?: (this: CompilationContext<DocCollectionItem>, data: Record<string, unknown>) => Awaitable<Record<string, unknown> | void>;
+        /**
+         * Transform `vfile` on compilation stage
+         */
+        vfile?: (this: CompilationContext<DocCollectionItem>, file: VFile) => Awaitable<VFile | void>;
+    };
 }
-type PluginOption = Awaitable<Plugin | Plugin[] | false>;
+type PluginOption = Awaitable<Plugin | PluginOption[] | false>;
 interface ServerContext {
     /**
      * the file watcher, by default all content files are watched, along with other files.
@@ -214,10 +242,12 @@ interface EmitOptions {
      */
     filterPlugin?: (plugin: Plugin) => boolean;
 }
-declare function findConfigFile(): string;
+declare const _Defaults: {
+    configPath: string;
+    outDir: string;
+};
 declare function createCore(options: CoreOptions, defaultPlugins?: PluginOption[]): {
     _options: CoreOptions;
-    getPluginContext(): PluginContext;
     /**
      * Convenient cache store, reset when config changes
      */
@@ -226,9 +256,17 @@ declare function createCore(options: CoreOptions, defaultPlugins?: PluginOption[
         config: Awaitable<LoadedConfig>;
     }): Promise</*elided*/ any>;
     getConfig(): LoadedConfig;
+    /**
+     * The file path of compiled config file, the file may not exist (e.g. on Vite, or still compiling)
+     */
+    getCompiledConfigPath(): string;
     initServer(server: ServerContext): Promise<void>;
-    emitAndWrite({ filterPlugin, }?: EmitOptions): Promise<void>;
+    emit({ filterPlugin }?: EmitOptions): Promise<EmitEntry[]>;
+    emitAndWrite(emitOptions?: EmitOptions): Promise<void>;
+    transformMeta(options: TransformOptions<MetaCollectionItem>, data: unknown): Promise<unknown>;
+    transformFrontmatter(options: TransformOptions<DocCollectionItem>, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    transformVFile(options: TransformOptions<DocCollectionItem>, file: VFile): Promise<VFile>;
 };
 type Core = ReturnType<typeof createCore>;
 
-export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type ExtractedReference as E, type GlobalConfig as G, type LoadedConfig as L, type MetaCollection as M, type PostprocessOptions as P, type ServerContext as S, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, type CoreOptions as h, type Plugin as i, buildConfig as j, type EmitEntry as k, type PluginContext as l, metaSchema as m, type PluginOption as n, type EmitOptions as o, findConfigFile as p, createCore as q, type Core as r };
+export { type AnyCollection as A, type BaseCollection as B, type CoreOptions as C, type DocCollection as D, type ExtractedReference as E, type GlobalConfig as G, type MetaCollection as M, type PostprocessOptions as P, type ServerContext as S, type TransformOptions as T, _Defaults as _, type CollectionSchema as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, type DefaultMDXOptions as f, type MDXPresetOptions as g, applyMdxPreset as h, frontmatterSchema as i, type Plugin as j, type EmitEntry as k, type PluginContext as l, metaSchema as m, type CompilationContext as n, type PluginOption as o, type EmitOptions as p, createCore as q, type Core as r };

package/dist/{core-HkAVGq_a.d.ts → index-D7JdSMpp.d.ts}

@@ -1,30 +1,10 @@
 import { ProcessorOptions } from '@mdx-js/mdx';
 import { StandardSchemaV1 } from '@standard-schema/spec';
-import * as plugins from 'fumadocs-core/mdx-plugins';
 import { Pluggable } from 'unified';
+import * as Plugins from 'fumadocs-core/mdx-plugins';
 import { z } from 'zod';
 import { FSWatcher } from 'chokidar';
-
-interface ExtractedReference {
-    href: string;
-}
-interface PostprocessOptions {
-    _format: 'md' | 'mdx';
-    /**
-     * Properties to export from `vfile.data`
-     */
-    valueToExport?: string[];
-    /**
-     * stringify MDAST and export via `_markdown`.
-     */
-    includeProcessedMarkdown?: boolean;
-    /**
-     * store MDAST and export via `_mdast`.
-     */
-    includeMDAST?: boolean | {
-        removePosition?: boolean;
-    };
-}
+import { VFile } from 'vfile';
 
 type ResolvePlugins = Pluggable[] | ((v: Pluggable[]) => Pluggable[]);
 type DefaultMDXOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | 'remarkPlugins' | '_ctx'> & {
@@ -34,15 +14,22 @@ type DefaultMDXOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | '
      * Properties to export from `vfile.data`
      */
     valueToExport?: string[];
-    remarkStructureOptions?: plugins.StructureOptions | false;
-    remarkHeadingOptions?: plugins.RemarkHeadingOptions;
-    remarkImageOptions?: plugins.RemarkImageOptions | false;
-    remarkCodeTabOptions?: plugins.RemarkCodeTabOptions | false;
-    remarkNpmOptions?: plugins.RemarkNpmOptions | false;
-    rehypeCodeOptions?: plugins.RehypeCodeOptions | false;
-    _withoutBundler?: boolean;
+    remarkStructureOptions?: Plugins.StructureOptions | false;
+    remarkHeadingOptions?: Plugins.RemarkHeadingOptions;
+    remarkImageOptions?: Plugins.RemarkImageOptions | false;
+    remarkCodeTabOptions?: Plugins.RemarkCodeTabOptions | false;
+    remarkNpmOptions?: Plugins.RemarkNpmOptions | false;
+    rehypeCodeOptions?: Plugins.RehypeCodeOptions | false;
 };
-declare function getDefaultMDXOptions({ valueToExport, rehypeCodeOptions, remarkImageOptions, remarkHeadingOptions, remarkStructureOptions, remarkCodeTabOptions, remarkNpmOptions, _withoutBundler, ...mdxOptions }: DefaultMDXOptions): ProcessorOptions;
+type MDXPresetOptions = ({
+    preset?: 'fumadocs';
+} & DefaultMDXOptions) | ({
+    preset: 'minimal';
+} & ProcessorOptions);
+/**
+ * apply MDX processor presets
+ */
+declare function applyMdxPreset(options?: MDXPresetOptions): (environment: BuildEnvironment) => Promise<ProcessorOptions>;
 
 /**
  * Zod 4 schema
@@ -66,13 +53,38 @@ declare const frontmatterSchema: z.ZodObject<{
     _openapi: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strip>;
 
+interface ExtractedReference {
+    href: string;
+}
+interface PostprocessOptions {
+    _format: 'md' | 'mdx';
+    /**
+     * Properties to export from `vfile.data`
+     */
+    valueToExport?: string[];
+    /**
+     * stringify MDAST and export via `_markdown`.
+     */
+    includeProcessedMarkdown?: boolean;
+    /**
+     * extract link references, export via `extractedReferences`.
+     */
+    extractLinkReferences?: boolean;
+    /**
+     * store MDAST and export via `_mdast`.
+     */
+    includeMDAST?: boolean | {
+        removePosition?: boolean;
+    };
+}
+
 type CollectionSchema<Schema extends StandardSchemaV1, Context> = Schema | ((ctx: Context) => Schema);
 type AnyCollection = DocsCollection | DocCollection | MetaCollection;
 interface BaseCollection {
     /**
-     * Directories to scan
+     * Directory to scan
      */
-    dir: string | string[];
+    dir: string;
     /**
      * what files to include/exclude (glob patterns)
      *
@@ -87,44 +99,37 @@ interface MetaCollection<Schema extends StandardSchemaV1 = StandardSchemaV1> ext
         source: string;
     }>;
 }
-interface DocCollection<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = boolean> extends BaseCollection {
+interface DocCollection<Schema extends StandardSchemaV1 = StandardSchemaV1> extends BaseCollection {
     type: 'doc';
     postprocess?: Partial<PostprocessOptions>;
-    mdxOptions?: ProcessorOptions;
+    mdxOptions?: ProcessorOptions | ((environment: BuildEnvironment) => Promise<ProcessorOptions>);
     /**
      * Load files with async
      */
-    async?: Async;
+    async?: boolean;
+    /**
+     * Compile files on-demand
+     */
+    dynamic?: boolean;
     schema?: CollectionSchema<Schema, {
         path: string;
         source: string;
     }>;
 }
-interface DocsCollection<DocSchema extends StandardSchemaV1 = StandardSchemaV1, MetaSchema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = boolean> {
+interface DocsCollection<DocSchema extends StandardSchemaV1 = StandardSchemaV1, MetaSchema extends StandardSchemaV1 = StandardSchemaV1> {
     type: 'docs';
     dir: string;
-    docs: DocCollection<DocSchema, Async>;
+    docs: DocCollection<DocSchema>;
     meta: MetaCollection<MetaSchema>;
 }
-type GlobalConfigMDXOptions = ({
-    preset?: 'fumadocs';
-} & DefaultMDXOptions) | ({
-    preset: 'minimal';
-} & ProcessorOptions);
 interface GlobalConfig {
-    collections?: Record<string, AnyCollection>;
     plugins?: PluginOption[];
     /**
      * Configure global MDX options
      *
-     * @remarks `GlobalConfigMDXOptions`
-     */
-    mdxOptions?: GlobalConfigMDXOptions | (() => Promise<GlobalConfigMDXOptions>);
-    /**
-     * Fetch last modified time with specified version control
-     * @defaultValue 'none'
+     * @remarks `MDXPresetOptions`
      */
-    lastModifiedTime?: 'git' | 'none';
+    mdxOptions?: MDXPresetOptions | (() => Promise<MDXPresetOptions>);
     /**
      * specify a directory to access & store cache (disabled during development mode).
      *
@@ -132,25 +137,26 @@ interface GlobalConfig {
      */
     experimentalBuildCache?: string;
 }
-declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = false>(options: DocCollection<Schema, Async>): DocCollection<Schema, Async>;
+declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1>(options: DocCollection<Schema>): DocCollection<Schema>;
 declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1>(options: MetaCollection<Schema>): MetaCollection<Schema>;
-declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema, Async extends boolean = false>(options: {
+declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema>(options: {
     /**
      * The content directory to scan files
      *
      *  @defaultValue 'content/docs'
      */
     dir?: string;
-    docs?: Omit<DocCollection<DocSchema, Async>, 'dir' | 'type'>;
+    docs?: Omit<DocCollection<DocSchema>, 'dir' | 'type'>;
     meta?: Omit<MetaCollection<MetaSchema>, 'dir' | 'type'>;
-}): DocsCollection<DocSchema, MetaSchema, Async>;
+}): DocsCollection<DocSchema, MetaSchema>;
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
+type BuildEnvironment = 'bundler' | 'runtime';
 interface LoadedConfig {
     collectionList: CollectionItem[];
     getCollection(name: string): CollectionItem | undefined;
     global: GlobalConfig;
-    getDefaultMDXOptions(mode?: 'default' | 'remote'): Promise<ProcessorOptions>;
+    getMDXOptions(collection?: DocCollectionItem, environment?: BuildEnvironment): ProcessorOptions | Promise<ProcessorOptions>;
 }
 type CollectionItem = MetaCollectionItem | DocCollectionItem | DocsCollectionItem;
 type PrimitiveCollectionItem<T extends DocCollection | MetaCollection> = Omit<T, 'files'> & {
@@ -165,8 +171,8 @@ interface DocsCollectionItem extends DocsCollection {
     name: string;
     meta: MetaCollectionItem;
     docs: DocCollectionItem;
+    hasFile: (filePath: string) => boolean;
 }
-declare function buildConfig(config: Record<string, unknown>): LoadedConfig;
 
 type Awaitable<T> = T | Promise<T>;
 interface EmitEntry {
@@ -179,6 +185,12 @@ interface EmitEntry {
 interface PluginContext extends CoreOptions {
     core: Core;
 }
+type CompilationContext<Collection> = PluginContext & TransformOptions<Collection>;
+interface TransformOptions<Collection> {
+    collection: Collection;
+    filePath: string;
+    source: string;
+}
 interface Plugin {
     name?: string;
     /**
@@ -193,8 +205,24 @@ interface Plugin {
      * Configure Fumadocs dev server
      */
     configureServer?: (this: PluginContext, server: ServerContext) => Awaitable<void>;
+    meta?: {
+        /**
+         * Transform metadata
+         */
+        transform?: (this: CompilationContext<MetaCollectionItem>, data: unknown) => Awaitable<unknown | void>;
+    };
+    doc?: {
+        /**
+         * Transform frontmatter
+         */
+        frontmatter?: (this: CompilationContext<DocCollectionItem>, data: Record<string, unknown>) => Awaitable<Record<string, unknown> | void>;
+        /**
+         * Transform `vfile` on compilation stage
+         */
+        vfile?: (this: CompilationContext<DocCollectionItem>, file: VFile) => Awaitable<VFile | void>;
+    };
 }
-type PluginOption = Awaitable<Plugin | Plugin[] | false>;
+type PluginOption = Awaitable<Plugin | PluginOption[] | false>;
 interface ServerContext {
     /**
      * the file watcher, by default all content files are watched, along with other files.
@@ -214,10 +242,12 @@ interface EmitOptions {
      */
     filterPlugin?: (plugin: Plugin) => boolean;
 }
-declare function findConfigFile(): string;
+declare const _Defaults: {
+    configPath: string;
+    outDir: string;
+};
 declare function createCore(options: CoreOptions, defaultPlugins?: PluginOption[]): {
     _options: CoreOptions;
-    getPluginContext(): PluginContext;
     /**
      * Convenient cache store, reset when config changes
      */
@@ -226,9 +256,17 @@ declare function createCore(options: CoreOptions, defaultPlugins?: PluginOption[
         config: Awaitable<LoadedConfig>;
     }): Promise</*elided*/ any>;
     getConfig(): LoadedConfig;
+    /**
+     * The file path of compiled config file, the file may not exist (e.g. on Vite, or still compiling)
+     */
+    getCompiledConfigPath(): string;
     initServer(server: ServerContext): Promise<void>;
-    emitAndWrite({ filterPlugin, }?: EmitOptions): Promise<void>;
+    emit({ filterPlugin }?: EmitOptions): Promise<EmitEntry[]>;
+    emitAndWrite(emitOptions?: EmitOptions): Promise<void>;
+    transformMeta(options: TransformOptions<MetaCollectionItem>, data: unknown): Promise<unknown>;
+    transformFrontmatter(options: TransformOptions<DocCollectionItem>, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    transformVFile(options: TransformOptions<DocCollectionItem>, file: VFile): Promise<VFile>;
 };
 type Core = ReturnType<typeof createCore>;
 
-export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type ExtractedReference as E, type GlobalConfig as G, type LoadedConfig as L, type MetaCollection as M, type PostprocessOptions as P, type ServerContext as S, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, type CoreOptions as h, type Plugin as i, buildConfig as j, type EmitEntry as k, type PluginContext as l, metaSchema as m, type PluginOption as n, type EmitOptions as o, findConfigFile as p, createCore as q, type Core as r };
+export { type AnyCollection as A, type BaseCollection as B, type CoreOptions as C, type DocCollection as D, type ExtractedReference as E, type GlobalConfig as G, type MetaCollection as M, type PostprocessOptions as P, type ServerContext as S, type TransformOptions as T, _Defaults as _, type CollectionSchema as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, type DefaultMDXOptions as f, type MDXPresetOptions as g, applyMdxPreset as h, frontmatterSchema as i, type Plugin as j, type EmitEntry as k, type PluginContext as l, metaSchema as m, type CompilationContext as n, type PluginOption as o, type EmitOptions as p, createCore as q, type Core as r };

package/dist/index-P2NNUkHn.d.cts

@@ -0,0 +1,8 @@
+import { C as CoreOptions } from './index-D7JdSMpp.cjs';
+
+interface WebpackLoaderOptions extends CoreOptions {
+    compiledConfigPath: string;
+    isDev: boolean;
+}
+
+export type { WebpackLoaderOptions as W };