fumadocs-core 10.1.2 → 11.0.0

package/dist/mdx-plugins/index.d.ts

@@ -52,33 +52,6 @@ interface RemarkImageOptions {
  */
 declare function remarkImage({ placeholder, }?: RemarkImageOptions): Transformer<Root$1, Root$1>;
 
-interface RemarkDynamicContentOptions {
-    /**
-     * @defaultValue `vfile.cwd`
-     * @deprecated use the `cwd` option from remark instead
-     * */
-    cwd?: string;
-    /** @defaultValue true */
-    trim?: boolean;
-    /**
-     * Resolve reference files relative to `vfile.path`
-     * @defaultValue false
-     */
-    relative?: boolean;
-    /**
-     * Filter specific element types
-     * @defaultValue ['text','code']
-     * */
-    visit?: string[];
-}
-/**
- * Copy content from referenced file
- *
- * @example
- * |reference:../path/to/file.ts|
- */
-declare function remarkDynamicContent(options?: RemarkDynamicContentOptions): Transformer<Root$1, Root$1>;
-
 declare module 'mdast' {
     interface HeadingData extends Data {
         hProperties?: {
@@ -93,26 +66,4 @@ declare module 'mdast' {
  */
 declare function remarkHeading(): Transformer<Root$1, Root$1>;
 
-type PackageManager = (name: string) => {
-    packageManager: string;
-    command: string;
-};
-type RemarkInstallOptions = Partial<{
-    Tabs: string;
-    Tab: string;
-    packageManagers: PackageManager[];
-}>;
-/**
- * It generates the following structure from a code block with `package-install` as language
- *
- * @example
- * ```tsx
- * <Tabs items={["pnpm", "npm", "yarn"]}>
- *  <Tab value="pnpm">...</Tab>
- *  ...
- * </Tabs>
- * ```
- */
-declare function remarkInstall({ Tab, Tabs, packageManagers, }?: RemarkInstallOptions): Transformer<Root$1, Root$1>;
-
-export { type CodeBlockIcon, type RehypeCodeOptions, type RemarkDynamicContentOptions, type RemarkImageOptions, type RemarkInstallOptions, rehypeCode, rehypeCodeDefaultOptions, remarkDynamicContent, remarkHeading, remarkImage, remarkInstall, transformerIcon };
+export { type CodeBlockIcon, type RehypeCodeOptions, type RemarkImageOptions, rehypeCode, rehypeCodeDefaultOptions, remarkHeading, remarkImage, transformerIcon };

package/dist/mdx-plugins/index.js

@@ -450,42 +450,12 @@ function remarkImage({
   };
 }
 
-// src/mdx-plugins/remark-dynamic-content.ts
-import fs from "fs";
-import path2 from "path";
-import { visit as visit3 } from "unist-util-visit";
-var regex = new RegExp("^\\|reference:(?<path>.+)\\|");
-function remarkDynamicContent(options = {}) {
-  const {
-    trim = true,
-    relative = false,
-    visit: filter = ["text", "code"]
-  } = options;
-  return (tree, file) => {
-    var _a;
-    const cwd = (_a = options.cwd) != null ? _a : file.cwd;
-    visit3(tree, filter, (node) => {
-      const canReplace = "value" in node && typeof node.value === "string";
-      if (!canReplace)
-        return;
-      const result = regex.exec(node.value);
-      if (result) {
-        const dest = relative ? path2.resolve(cwd, path2.dirname(file.path), result[1]) : path2.resolve(cwd, result[1]);
-        let value = fs.readFileSync(dest).toString();
-        if (trim)
-          value = value.trim();
-        node.value = value;
-      }
-    });
-  };
-}
-
 // src/mdx-plugins/remark-structure.ts
 import Slugger from "github-slugger";
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";
 import remarkMdx from "remark-mdx";
-import { visit as visit4 } from "unist-util-visit";
+import { visit as visit3 } from "unist-util-visit";
 var slugger = new Slugger();
 function remarkStructure({
   types = ["paragraph", "blockquote", "heading"]
@@ -494,7 +464,7 @@ function remarkStructure({
     slugger.reset();
     const data = { contents: [], headings: [] };
     let lastHeading = "";
-    visit4(node, types, (element) => {
+    visit3(node, types, (element) => {
       var _a, _b;
       if (element.type === "root")
         return;
@@ -526,78 +496,13 @@ function structure(content, remarkPlugins = [], options = {}) {
   const result = remark().use(remarkGfm).use(remarkMdx).use(remarkPlugins).use(remarkStructure, options).processSync(content);
   return result.data.structuredData;
 }
-
-// src/mdx-plugins/remark-install.ts
-import { visit as visit5 } from "unist-util-visit";
-function remarkInstall({
-  Tab = "Tab",
-  Tabs = "Tabs",
-  packageManagers = [
-    (name) => ({ command: `npm install ${name}`, packageManager: "npm" }),
-    (name) => ({ command: `pnpm add ${name}`, packageManager: "pnpm" }),
-    (name) => ({ command: `yarn add ${name}`, packageManager: "yarn" })
-  ]
-} = {}) {
-  return (tree) => {
-    visit5(tree, "code", (node) => {
-      if (node.lang !== "package-install")
-        return "skip";
-      const managers = packageManagers.map((manager) => manager(node.value));
-      const insert = {
-        type: "mdxJsxFlowElement",
-        name: Tabs,
-        attributes: [
-          {
-            type: "mdxJsxAttribute",
-            name: "items",
-            value: {
-              type: "mdxJsxAttributeValueExpression",
-              data: {
-                estree: {
-                  body: [
-                    {
-                      type: "ExpressionStatement",
-                      expression: {
-                        type: "ArrayExpression",
-                        elements: managers.map(({ packageManager }) => ({
-                          type: "Literal",
-                          value: packageManager
-                        }))
-                      }
-                    }
-                  ]
-                }
-              }
-            }
-          }
-        ],
-        children: managers.map(({ command, packageManager }) => ({
-          type: "mdxJsxFlowElement",
-          name: Tab,
-          attributes: [
-            { type: "mdxJsxAttribute", name: "value", value: packageManager }
-          ],
-          children: [
-            {
-              type: "code",
-              lang: "bash",
-              value: command
-            }
-          ]
-        }))
-      };
-      Object.assign(node, insert);
-    });
-  };
-}
 export {
   rehypeCode,
   rehypeCodeDefaultOptions,
-  remarkDynamicContent,
   default2 as remarkGfm,
   remarkHeading,
   remarkImage,
-  remarkInstall,
   remarkStructure,
-  structure
+  structure,
+  transformerIcon
 };

package/dist/server/index.d.ts

@@ -1,18 +1,8 @@
-import { T as TableOfContents } from '../get-toc-YF_TdazL.js';
-export { a as TOCItemType, g as getTableOfContents } from '../get-toc-YF_TdazL.js';
+export { a as TOCItemType, T as TableOfContents, g as getTableOfContents } from '../get-toc-YF_TdazL.js';
 import { N as Node, I as Item, R as Root } from '../page-tree-mLHMYx2B.js';
 export { p as PageTree } from '../page-tree-mLHMYx2B.js';
 import 'react';
 
-/**
- * Parse TOC from portable text (Sanity)
- *
- * @param value - Blocks
- * @param slugFn - A function that generates slug from title
- * @deprecated Sanity is no longer supported
- */
-declare function getTableOfContentsFromPortableText(value: any): TableOfContents;
-
 /**
  * Flatten tree to an array of page nodes
  */
@@ -55,4 +45,4 @@ interface GetGithubLastCommitOptions {
  */
 declare function getGithubLastEdit({ repo, token, owner, path, options, params: customParams, }: GetGithubLastCommitOptions): Promise<Date | null>;
 
-export { type GetGithubLastCommitOptions, TableOfContents, findNeighbour, flattenTree, getGithubLastEdit, getTableOfContentsFromPortableText, separatePageTree };
+export { type GetGithubLastCommitOptions, findNeighbour, flattenTree, getGithubLastEdit, separatePageTree };

package/dist/server/index.js

@@ -16,50 +16,6 @@ function getTableOfContents(content) {
   });
 }
 
-// src/server/get-toc-sanity.ts
-import Slugger from "github-slugger";
-var slugger = new Slugger();
-function getTableOfContentsFromPortableText(value) {
-  if (!Array.isArray(value)) {
-    throw new Error("Invalid body type");
-  }
-  slugger.reset();
-  const result = [];
-  for (const block of value) {
-    dfs(block, result);
-  }
-  return result;
-}
-function dfs(block, list) {
-  var _a;
-  if (block.style && block.style.length === 2 && block.style.startsWith("h")) {
-    const depth = Number(block.style[1]);
-    if (Number.isNaN(depth))
-      return;
-    const text = flattenNode(block);
-    list.push({
-      title: text,
-      url: slugger.slug(text),
-      depth
-    });
-    return;
-  }
-  (_a = block.children) == null ? void 0 : _a.forEach((child) => {
-    dfs(child, list);
-  });
-}
-function flattenNode(block) {
-  var _a, _b;
-  let text = "";
-  if (block._type === "span") {
-    return (_a = block.text) != null ? _a : "";
-  }
-  (_b = block.children) == null ? void 0 : _b.forEach((child) => {
-    text += flattenNode(child);
-  });
-  return text;
-}
-
 // src/server/page-tree-utils.ts
 function flattenTree(tree) {
   return tree.flatMap((node) => {
@@ -143,6 +99,5 @@ export {
   flattenTree,
   getGithubLastEdit,
   getTableOfContents,
-  getTableOfContentsFromPortableText,
   separatePageTree
 };

package/dist/source/index.d.ts

@@ -20,24 +20,108 @@ interface FileInfo {
 declare function parseFilePath(path: string): FileInfo;
 declare function parseFolderPath(path: string): FileInfo;
 
+interface File {
+    file: FileInfo;
+    format: 'meta' | 'page';
+    data: Record<string, unknown>;
+}
+interface Folder {
+    file: FileInfo;
+    children: (File | Folder)[];
+}
+/**
+ * A virtual file system that solves inconsistent behaviours
+ *
+ * Some source providers may not provide the full file structure, this will cause inconsistent outputs for page builder and other transformers
+ */
+declare class Storage {
+    files: Map<string, File>;
+    folders: Map<string, Folder>;
+    private rootFolder;
+    constructor();
+    /**
+     * @param path - flattened path
+     */
+    read(path: string, format: string): File | undefined;
+    readDir(path: string): Folder | undefined;
+    root(): Folder;
+    write(path: string, format: 'meta' | 'page', data: Record<string, unknown>): void;
+    list(): File[];
+    makeDir(path: string): void;
+}
+
+type fileSystem_File = File;
+type fileSystem_Folder = Folder;
+type fileSystem_Storage = Storage;
+declare const fileSystem_Storage: typeof Storage;
+declare namespace fileSystem {
+  export { type fileSystem_File as File, type fileSystem_Folder as Folder, fileSystem_Storage as Storage };
+}
+
+interface BuildPageTreeOptionsWithI18n {
+    languages: string[];
+}
+interface PageTreeBuilder {
+    build: () => Root;
+    /**
+     * Build page tree and fallback to the default language if the page doesn't exist
+     */
+    buildI18n: (options?: Partial<BuildPageTreeOptionsWithI18n>) => Record<string, Root>;
+}
+interface CreatePageTreeBuilderOptions {
+    storage: Storage;
+    resolveIcon?: (icon: string) => ReactElement | undefined;
+}
+declare function createPageTreeBuilder({ storage, resolveIcon, }: CreatePageTreeBuilderOptions): PageTreeBuilder;
+
 interface LoadOptions {
-    files: VirtualFile[];
     transformers?: Transformer[];
-    rootDir: string;
+    rootDir?: string;
     getSlugs: (info: FileInfo) => string[];
     getUrl: (slugs: string[], locale?: string) => string;
 }
 interface VirtualFile {
+    /**
+     * Relative path
+     *
+     * @example `docs/page.mdx`
+     */
     path: string;
     type: 'page' | 'meta';
     data: unknown;
 }
 type Transformer = (context: {
     storage: Storage;
-    getSlugs: (info: FileInfo) => string[];
-    getUrl: (slugs: string[], locale?: string) => string;
+    options: LoadOptions;
 }) => void;
 
+interface MetaData {
+    icon?: string;
+    title?: string;
+    root?: boolean;
+    pages?: string[];
+    defaultOpen?: boolean;
+}
+interface PageData {
+    icon?: string;
+    title: string;
+}
+type InferPageType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Page<Config['source']['pageData']> : never;
+type InferMetaType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Meta<Config['source']['metaData']> : never;
+/**
+ * @internal
+ */
+interface FileData {
+    meta: {
+        data: MetaData;
+    };
+    file: {
+        url: string;
+        slugs: string[];
+        data: PageData;
+    };
+}
+
 interface LoaderConfig {
     source: SourceConfig;
     i18n: boolean;
@@ -69,9 +153,19 @@ interface Source<Config extends SourceConfig> {
     _config?: Config;
     files: VirtualFile[] | ((rootDir: string) => VirtualFile[]);
 }
+interface Page<Data = PageData> {
+    file: FileInfo;
+    slugs: string[];
+    url: string;
+    data: Data;
+}
+interface Meta<Data = MetaData> {
+    file: FileInfo;
+    data: Data;
+}
 interface LoaderOutput<Config extends LoaderConfig> {
     pageTree: Config['i18n'] extends true ? Record<string, Root> : Root;
-    files: (Meta<Config['source']['metaData']> | Page<Config['source']['pageData']>)[];
+    files: File[];
     /**
      * Get list of pages from language, empty if language hasn't specified
      *
@@ -91,89 +185,4 @@ declare function loader<Options extends LoaderOptions>(options: Options): Loader
     i18n: Options['languages'] extends string[] ? true : false;
 }>;
 
-interface MetaData {
-    icon?: string;
-    title?: string;
-    root?: boolean;
-    pages?: string[];
-    defaultOpen?: boolean;
-}
-interface PageData {
-    icon?: string;
-    title: string;
-}
-type InferPageType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Page<Config['source']['pageData']> : never;
-type InferMetaType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Meta<Config['source']['metaData']> : never;
-
-interface Meta<Data extends MetaData = MetaData> {
-    type: 'meta';
-    file: FileInfo;
-    data: Data;
-}
-interface Page<Data extends PageData = PageData> {
-    type: 'page';
-    file: FileInfo;
-    slugs: string[];
-    url: string;
-    data: Data;
-}
-interface Folder<MD extends MetaData = MetaData, PD extends PageData = PageData> {
-    type: 'folder';
-    file: FileInfo;
-    children: (Meta<MD> | Page<PD> | Folder<MD, PD>)[];
-}
-/**
- * A virtual file system that solves inconsistent behaviours
- *
- * Some source providers may not provide the full file structure, this will cause inconsistent outputs for page builder and other transformers
- */
-declare class Storage {
-    files: Map<string, Page<PageData> | Meta<MetaData>>;
-    folders: Map<string, Folder<MetaData, PageData>>;
-    private rootFolder;
-    constructor();
-    /**
-     * @param path - flattened path
-     */
-    private read;
-    /**
-     * @param path - flattened path
-     */
-    readPage(path: string): Page | undefined;
-    /**
-     * @param path - flattened path
-     */
-    readMeta(path: string): Meta | undefined;
-    readDir(path: string): Folder | undefined;
-    root(): Folder;
-    write(path: string, file: Omit<Page, 'file'> | Omit<Meta, 'file'>): void;
-    list(): (Page | Meta)[];
-    makeDir(path: string): void;
-}
-
-type fileSystem_Folder<MD extends MetaData = MetaData, PD extends PageData = PageData> = Folder<MD, PD>;
-type fileSystem_Meta<Data extends MetaData = MetaData> = Meta<Data>;
-type fileSystem_Page<Data extends PageData = PageData> = Page<Data>;
-type fileSystem_Storage = Storage;
-declare const fileSystem_Storage: typeof Storage;
-declare namespace fileSystem {
-  export { type fileSystem_Folder as Folder, type fileSystem_Meta as Meta, type fileSystem_Page as Page, fileSystem_Storage as Storage };
-}
-
-interface BuildPageTreeOptionsWithI18n {
-    languages: string[];
-}
-interface PageTreeBuilder {
-    build: () => Root;
-    /**
-     * Build page tree and fallback to the default language if the page doesn't exist
-     */
-    buildI18n: (options?: Partial<BuildPageTreeOptionsWithI18n>) => Record<string, Root>;
-}
-interface CreatePageTreeBuilderOptions {
-    storage: Storage;
-    resolveIcon?: (icon: string) => ReactElement | undefined;
-}
-declare function createPageTreeBuilder({ storage, resolveIcon, }: CreatePageTreeBuilderOptions): PageTreeBuilder;
-
-export { type BuildPageTreeOptionsWithI18n, type CreatePageTreeBuilderOptions, type FileInfo, fileSystem as FileSystem, type InferMetaType, type InferPageType, type LoadOptions, type LoaderConfig, type LoaderOptions, type LoaderOutput, type MetaData, type PageData, type PageTreeBuilder, type Source, type SourceConfig, type Transformer, type VirtualFile, createGetUrl, createPageTreeBuilder, getSlugs, loader, parseFilePath, parseFolderPath };
+export { type BuildPageTreeOptionsWithI18n, type CreatePageTreeBuilderOptions, type FileData, type FileInfo, fileSystem as FileSystem, type InferMetaType, type InferPageType, type LoadOptions, type LoaderConfig, type LoaderOptions, type LoaderOutput, type Meta, type MetaData, type Page, type PageData, type PageTreeBuilder, type Source, type SourceConfig, type Transformer, type VirtualFile, createGetUrl, createPageTreeBuilder, getSlugs, loader, parseFilePath, parseFolderPath };

package/dist/source/index.js

@@ -2,15 +2,14 @@ import {
   slash
 } from "../chunk-UWEEHUJV.js";
 import {
-  __export,
-  __spreadValues
+  __export
 } from "../chunk-WEAGW6MQ.js";
 
 // src/source/path.ts
 import { parse } from "path";
-function parseFilePath(path2) {
-  const slashedPath = slash(path2);
-  const parsed = parse(slashedPath);
+function parseFilePath(path) {
+  const normalized = normalizePath(path);
+  const parsed = parse(normalized);
   const flattenedPath = joinPaths([parsed.dir, parsed.name]);
   const [name, locale] = parsed.name.split(".");
   return {
@@ -18,26 +17,32 @@ function parseFilePath(path2) {
     name,
     flattenedPath,
     locale,
-    path: slashedPath
+    path: normalized
   };
 }
-function parseFolderPath(path2) {
-  const slashedPath = slash(path2);
-  const parsed = parse(slashedPath);
+function parseFolderPath(path) {
+  const normalized = normalizePath(path);
+  const parsed = parse(normalized);
   const [name, locale] = parsed.base.split(".");
   return {
     dirname: parsed.dir,
     name,
-    flattenedPath: slashedPath,
+    flattenedPath: normalized,
     locale,
-    path: slashedPath
+    path: normalized
   };
 }
-function splitPath(path2) {
-  return path2.split("/").filter((p) => p.length > 0);
+function normalizePath(path) {
+  const segments = splitPath(slash(path));
+  if (segments[0] === "." || segments[0] === "..")
+    throw new Error("It must not start with './' or '../'");
+  return joinPaths(segments);
+}
+function splitPath(path) {
+  return path.split("/").filter((p) => p.length > 0);
 }
 function joinPaths(paths, slashMode = "none") {
-  const joined = paths.flatMap((path2) => splitPath(path2)).join("/");
+  const joined = paths.flatMap((path) => splitPath(path)).join("/");
   switch (slashMode) {
     case "leading":
       return `/${joined}`;
@@ -58,9 +63,7 @@ function buildAll(nodes, ctx, skipIndex) {
   for (const node of [...nodes].sort(
     (a, b) => a.file.name.localeCompare(b.file.name)
   )) {
-    if (node.type === "page") {
-      if (node.file.locale)
-        continue;
+    if ("data" in node && node.format === "page" && !node.file.locale) {
       const treeNode = buildFileNode(node, ctx);
       if (node.file.name === "index") {
         if (!skipIndex)
@@ -69,20 +72,12 @@ function buildAll(nodes, ctx, skipIndex) {
       }
       output.push(treeNode);
     }
-    if (node.type === "folder") {
+    if ("children" in node) {
       output.push(buildFolderNode(node, false, ctx));
     }
   }
   return output;
 }
-function getFolderMeta(folder, ctx) {
-  var _a;
-  let meta = ctx.storage.readMeta(joinPaths([folder.file.path, "meta"]));
-  if (ctx.lang) {
-    meta = (_a = ctx.storage.readMeta(joinPaths([folder.file.path, `meta.${ctx.lang}`]))) != null ? _a : meta;
-  }
-  return meta;
-}
 function resolveFolderItem(folder, item, ctx, addedNodePaths) {
   var _a, _b, _c;
   if (item === rest)
@@ -108,15 +103,15 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
     ];
   }
   const extractResult = extractor.exec(item);
-  const path2 = joinPaths([
+  const path = joinPaths([
     folder.file.path,
     (_b = (_a = extractResult == null ? void 0 : extractResult.groups) == null ? void 0 : _a.name) != null ? _b : item
   ]);
-  const itemNode = (_c = ctx.storage.readDir(path2)) != null ? _c : ctx.storage.readPage(path2);
+  const itemNode = (_c = ctx.storage.readDir(path)) != null ? _c : ctx.storage.read(path, "page");
   if (!itemNode)
     return [];
   addedNodePaths.add(itemNode.file.path);
-  if (itemNode.type === "folder") {
+  if ("children" in itemNode) {
     const node = buildFolderNode(itemNode, false, ctx);
     return extractResult ? node.children : [node];
   }
@@ -124,18 +119,22 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
 }
 function buildFolderNode(folder, defaultIsRoot, ctx) {
   var _a, _b, _c, _d, _e;
-  const indexFile = ctx.storage.readPage(
-    joinPaths([folder.file.flattenedPath, "index"])
+  const metaPath = joinPaths([folder.file.path, "meta"]);
+  let meta = ctx.storage.read(metaPath, "meta");
+  meta = (_a = findLocalizedFile(metaPath, "meta", ctx)) != null ? _a : meta;
+  const indexFile = ctx.storage.read(
+    joinPaths([folder.file.flattenedPath, "index"]),
+    "page"
   );
+  const metadata = meta == null ? void 0 : meta.data.data;
   const index = indexFile ? buildFileNode(indexFile, ctx) : void 0;
-  const meta = (_a = getFolderMeta(folder, ctx)) == null ? void 0 : _a.data;
   let children;
   if (!meta) {
     children = buildAll(folder.children, ctx, !defaultIsRoot);
   } else {
-    const isRoot = (_b = meta.root) != null ? _b : defaultIsRoot;
+    const isRoot = (_b = metadata == null ? void 0 : metadata.root) != null ? _b : defaultIsRoot;
     const addedNodePaths = /* @__PURE__ */ new Set();
-    const resolved = (_c = meta.pages) == null ? void 0 : _c.flatMap((item) => {
+    const resolved = (_c = metadata == null ? void 0 : metadata.pages) == null ? void 0 : _c.flatMap((item) => {
       return resolveFolderItem(folder, item, ctx, addedNodePaths);
     });
     const restNodes = buildAll(
@@ -153,28 +152,23 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
   }
   return removeUndefined({
     type: "folder",
-    name: (_e = (_d = meta == null ? void 0 : meta.title) != null ? _d : index == null ? void 0 : index.name) != null ? _e : pathToName(folder.file.name),
-    icon: ctx.resolveIcon(meta == null ? void 0 : meta.icon),
-    root: meta == null ? void 0 : meta.root,
-    defaultOpen: meta == null ? void 0 : meta.defaultOpen,
+    name: (_e = (_d = metadata == null ? void 0 : metadata.title) != null ? _d : index == null ? void 0 : index.name) != null ? _e : pathToName(folder.file.name),
+    icon: ctx.resolveIcon(metadata == null ? void 0 : metadata.icon),
+    root: metadata == null ? void 0 : metadata.root,
+    defaultOpen: metadata == null ? void 0 : metadata.defaultOpen,
     index,
     children
   });
 }
-function buildFileNode(page, ctx) {
-  let localePage = page;
-  if (ctx.lang) {
-    const result = ctx.storage.readPage(
-      `${page.file.flattenedPath}.${ctx.lang}`
-    );
-    if (result)
-      localePage = result;
-  }
+function buildFileNode(file, ctx) {
+  var _a;
+  const localized = (_a = findLocalizedFile(file.file.flattenedPath, "page", ctx)) != null ? _a : file;
+  const data = localized.data;
   return removeUndefined({
     type: "page",
-    name: localePage.data.title,
-    icon: ctx.resolveIcon(localePage.data.icon),
-    url: localePage.url
+    name: data.data.title,
+    icon: ctx.resolveIcon(data.data.icon),
+    url: data.url
   });
 }
 function build(ctx) {
@@ -214,8 +208,13 @@ function createPageTreeBuilder({
     }
   };
 }
-function pathToName(path2) {
-  return path2.slice(0, 1).toUpperCase() + path2.slice(1);
+function findLocalizedFile(path, format, ctx) {
+  if (!ctx.lang)
+    return;
+  return ctx.storage.read(`${path}.${ctx.lang}`, format);
+}
+function pathToName(path) {
+  return path.slice(0, 1).toUpperCase() + path.slice(1);
 }
 function removeUndefined(value) {
   const obj = value;
@@ -226,9 +225,6 @@ function removeUndefined(value) {
   return value;
 }
 
-// src/source/load.ts
-import * as path from "path";
-
 // src/source/file-system.ts
 var file_system_exports = {};
 __export(file_system_exports, {
@@ -239,7 +235,6 @@ var Storage = class {
     this.files = /* @__PURE__ */ new Map();
     this.folders = /* @__PURE__ */ new Map();
     this.rootFolder = {
-      type: "folder",
       file: parseFolderPath(""),
       children: []
     };
@@ -248,54 +243,37 @@ var Storage = class {
   /**
    * @param path - flattened path
    */
-  read(path2, type) {
-    return this.files.get(`${path2}.${type}`);
+  read(path, format) {
+    return this.files.get(`${path}.${format}`);
   }
-  /**
-   * @param path - flattened path
-   */
-  readPage(path2) {
-    const result = this.read(path2, "page");
-    if ((result == null ? void 0 : result.type) !== "page")
-      return;
-    return result;
-  }
-  /**
-   * @param path - flattened path
-   */
-  readMeta(path2) {
-    const result = this.read(path2, "meta");
-    if ((result == null ? void 0 : result.type) !== "meta")
-      return;
-    return result;
-  }
-  readDir(path2) {
-    return this.folders.get(path2);
+  readDir(path) {
+    return this.folders.get(path);
   }
   root() {
     return this.rootFolder;
   }
-  write(path2, file) {
+  write(path, format, data) {
     var _a;
-    const node = __spreadValues({
-      file: parseFilePath(path2)
-    }, file);
+    const node = {
+      format,
+      file: parseFilePath(path),
+      data
+    };
     this.makeDir(node.file.dirname);
     (_a = this.readDir(node.file.dirname)) == null ? void 0 : _a.children.push(node);
-    this.files.set(`${node.file.flattenedPath}.${node.type}`, node);
+    this.files.set(`${node.file.flattenedPath}.${node.format}`, node);
   }
   list() {
     return [...this.files.values()];
   }
-  makeDir(path2) {
+  makeDir(path) {
     var _a;
-    const segments = splitPath(path2);
+    const segments = splitPath(path);
     for (let i = 0; i < segments.length; i++) {
       const segment = segments.slice(0, i + 1).join("/");
       if (this.folders.has(segment))
         continue;
       const folder = {
-        type: "folder",
         file: parseFolderPath(segment),
         children: []
       };
@@ -305,65 +283,64 @@ var Storage = class {
   }
 };
 
-// src/source/load.ts
-function load(options) {
+// src/source/load-files.ts
+function loadFiles(files, options) {
+  var _a;
   const { transformers = [] } = options;
-  const storage = buildStorage(options);
-  for (const transformer of transformers) {
-    transformer({
-      storage,
-      getUrl: options.getUrl,
-      getSlugs: options.getSlugs
-    });
-  }
-  return { storage };
-}
-function buildStorage(options) {
   const storage = new Storage();
-  for (const file of options.files) {
-    const relativePath = path.join(
-      path.relative(options.rootDir, path.join("./", path.dirname(file.path))),
-      path.basename(file.path)
-    );
-    if (relativePath.startsWith("..") || path.isAbsolute(relativePath))
+  const rootDir = normalizePath((_a = options.rootDir) != null ? _a : "");
+  for (const file of files) {
+    const normalizedPath = normalizePath(file.path);
+    if (!normalizedPath.startsWith(rootDir))
       continue;
+    const relativePath = normalizedPath.slice(rootDir.length);
     if (file.type === "page") {
       const parsedPath = parseFilePath(relativePath);
       const slugs = options.getSlugs(parsedPath);
-      storage.write(relativePath, {
+      storage.write(relativePath, file.type, {
         slugs,
         url: options.getUrl(slugs, parsedPath.locale),
-        type: file.type,
         data: file.data
       });
     }
     if (file.type === "meta") {
-      storage.write(relativePath, {
-        type: file.type,
+      storage.write(relativePath, file.type, {
         data: file.data
       });
     }
   }
+  for (const transformer of transformers) {
+    transformer({
+      storage,
+      options
+    });
+  }
   return storage;
 }
 
 // src/source/loader.ts
-function groupByLanguages(storage, languages) {
-  var _a, _b, _c;
-  const langMap = /* @__PURE__ */ new Map();
-  langMap.set("", []);
-  for (const node of storage.list()) {
-    if (node.type !== "page" || node.file.locale)
+function buildPageMap(storage, languages) {
+  var _a;
+  const map = /* @__PURE__ */ new Map();
+  const defaultMap = /* @__PURE__ */ new Map();
+  map.set("", defaultMap);
+  for (const file of storage.list()) {
+    if (file.format !== "page" || file.file.locale)
       continue;
-    (_a = langMap.get("")) == null ? void 0 : _a.push(node);
+    const page = fileToPage(file);
+    defaultMap.set(page.slugs.join("/"), page);
     for (const lang of languages) {
-      const list = (_b = langMap.get(lang)) != null ? _b : [];
-      const page = (_c = storage.readPage(`${node.file.flattenedPath}.${lang}`)) != null ? _c : node;
-      list.push(page);
-      langMap.set(lang, list);
+      const langMap = (_a = map.get(lang)) != null ? _a : /* @__PURE__ */ new Map();
+      const localized = storage.read(
+        `${file.file.flattenedPath}.${lang}`,
+        "page"
+      );
+      const localizedPage = localized ? fileToPage(localized) : page;
+      langMap.set(localizedPage.slugs.join("/"), localizedPage);
+      map.set(lang, langMap);
     }
   }
-  return langMap;
+  return map;
 }
 function createGetUrl(baseUrl) {
   return (slugs, locale) => {
@@ -387,36 +364,46 @@ function createOutput({
   rootDir = "",
   transformers,
   baseUrl = "/",
-  slugs = getSlugs,
-  url = createGetUrl(baseUrl)
+  slugs: slugsFn = getSlugs,
+  url: urlFn = createGetUrl(baseUrl)
 }) {
-  const result = load({
-    files: typeof source.files === "function" ? source.files(rootDir) : source.files,
-    transformers,
-    rootDir,
-    getSlugs: slugs,
-    getUrl: url
-  });
-  const i18nMap = groupByLanguages(result.storage, languages != null ? languages : []);
+  const storage = loadFiles(
+    typeof source.files === "function" ? source.files(rootDir) : source.files,
+    {
+      transformers,
+      rootDir,
+      getSlugs: slugsFn,
+      getUrl: urlFn
+    }
+  );
+  const i18nMap = buildPageMap(storage, languages != null ? languages : []);
   const builder = createPageTreeBuilder({
-    storage: result.storage,
+    storage,
     resolveIcon: icon
   });
   const pageTree = languages === void 0 ? builder.build() : builder.buildI18n({ languages });
   return {
     pageTree,
-    files: result.storage.list(),
+    files: storage.list(),
     getPages(language = "") {
-      var _a;
-      return (_a = i18nMap.get(language)) != null ? _a : [];
+      var _a, _b;
+      return Array.from((_b = (_a = i18nMap.get(language)) == null ? void 0 : _a.values()) != null ? _b : []);
     },
-    getPage(slugs_ = [], language = "") {
+    getPage(slugs = [], language = "") {
       var _a;
-      const path2 = slugs_.join("/");
-      return (_a = i18nMap.get(language)) == null ? void 0 : _a.find((page) => page.slugs.join("/") === path2);
+      return (_a = i18nMap.get(language)) == null ? void 0 : _a.get(slugs.join("/"));
     }
   };
 }
+function fileToPage(file) {
+  const data = file.data;
+  return {
+    file: file.file,
+    url: data.url,
+    slugs: data.slugs,
+    data: data.data
+  };
+}
 export {
   file_system_exports as FileSystem,
   createGetUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "10.1.2",
+  "version": "11.0.0",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -109,23 +109,24 @@
   ],
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.5.4",
-    "@shikijs/rehype": "^1.2.0",
-    "@shikijs/transformers": "^1.2.0",
+    "@shikijs/rehype": "^1.3.0",
+    "@shikijs/transformers": "^1.3.0",
     "flexsearch": "0.7.21",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.0",
     "negotiator": "^0.6.3",
+    "npm-to-yarn": "^2.2.1",
     "react-remove-scroll": "^2.5.9",
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.0",
     "remark-mdx": "^3.0.1",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^1.2.0",
+    "shiki": "^1.3.0",
     "swr": "^2.2.5",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
-    "@algolia/client-search": "^4.22.1",
+    "@algolia/client-search": "^4.23.3",
     "@mdx-js/mdx": "^3.0.1",
     "@types/flexsearch": "0.7.6",
     "@types/hast": "^3.0.4",
@@ -134,8 +135,8 @@
     "@types/node": "18.17.5",
     "@types/react": "^18.2.67",
     "@types/react-dom": "^18.2.22",
-    "algoliasearch": "^4.22.1",
-    "next": "^14.1.4",
+    "algoliasearch": "^4.23.3",
+    "next": "^14.2.1",
     "unified": "^11.0.4",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"