fumadocs-core 12.5.2 → 12.5.4

package/dist/source/index.js

@@ -2,10 +2,8 @@ import {
   slash
 } from "../chunk-UWEEHUJV.js";
 import {
-  __export,
-  __objRest,
-  __spreadValues
-} from "../chunk-CWMXXUWU.js";
+  __export
+} from "../chunk-MLKGABMK.js";
 
 // src/source/path.ts
 import { parse } from "path";
@@ -61,8 +59,9 @@ function resolvePath(from, join) {
 }
 
 // src/source/page-tree-builder.ts
-var link = new RegExp("^\\[(?<text>.+)]\\((?<url>.+)\\)$");
-var separator = new RegExp("^---(?<name>.*?)---$");
+var group = /^\((?<name>.+)\)$/;
+var link = /^\[(?<text>.+)]\((?<url>.+)\)$/;
+var separator = /^---(?<name>.*?)---$/;
 var rest = "...";
 function buildAll(nodes, ctx, skipIndex) {
   const output = [];
@@ -84,18 +83,17 @@ function buildAll(nodes, ctx, skipIndex) {
   return output;
 }
 function resolveFolderItem(folder, item, ctx, addedNodePaths) {
-  var _a, _b, _c, _d, _e, _f, _g;
   if (item === rest) return "...";
   const separateResult = separator.exec(item);
-  if (separateResult == null ? void 0 : separateResult.groups) {
+  if (separateResult?.groups) {
     const node = {
       type: "separator",
       name: separateResult.groups.name
     };
-    return [(_c = (_b = (_a = ctx.options).attachSeparator) == null ? void 0 : _b.call(_a, node)) != null ? _c : node];
+    return [ctx.options.attachSeparator?.(node) ?? node];
   }
   const linkResult = link.exec(item);
-  if (linkResult == null ? void 0 : linkResult.groups) {
+  if (linkResult?.groups) {
     const { url, text } = linkResult.groups;
     const isRelative = url.startsWith("/") || url.startsWith("#") || url.startsWith(".");
     const node = {
@@ -104,7 +102,7 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
       url,
       external: !isRelative
     };
-    return [(_f = (_e = (_d = ctx.options).attachFile) == null ? void 0 : _e.call(_d, node)) != null ? _f : node];
+    return [ctx.options.attachFile?.(node) ?? node];
   }
   let filename = item;
   const isExcept = item.startsWith("!");
@@ -116,7 +114,7 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
     filename = item.slice(3);
   }
   const path = resolvePath(folder.file.path, filename);
-  const itemNode = (_g = ctx.storage.readDir(path)) != null ? _g : ctx.storage.read(path, "page");
+  const itemNode = ctx.storage.readDir(path) ?? ctx.storage.read(path, "page");
   if (!itemNode) return [];
   addedNodePaths.add(itemNode.file.path);
   if (isExcept) return [];
@@ -127,23 +125,22 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
   return [buildFileNode(itemNode, ctx)];
 }
 function buildFolderNode(folder, defaultIsRoot, ctx) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const metaPath = resolvePath(folder.file.path, "meta");
   let meta = ctx.storage.read(metaPath, "meta");
-  meta = (_a = findLocalizedFile(metaPath, "meta", ctx)) != null ? _a : meta;
+  meta = findLocalizedFile(metaPath, "meta", ctx) ?? meta;
   const indexFile = ctx.storage.read(
     resolvePath(folder.file.flattenedPath, "index"),
     "page"
   );
-  const metadata = meta == null ? void 0 : meta.data.data;
+  const metadata = meta?.data.data;
   const index = indexFile ? buildFileNode(indexFile, ctx) : void 0;
   let children;
   if (!meta) {
     children = buildAll(folder.children, ctx, !defaultIsRoot);
   } else {
-    const isRoot = (_b = metadata == null ? void 0 : metadata.root) != null ? _b : defaultIsRoot;
+    const isRoot = metadata?.root ?? defaultIsRoot;
     const addedNodePaths = /* @__PURE__ */ new Set();
-    const resolved = (_c = metadata == null ? void 0 : metadata.pages) == null ? void 0 : _c.flatMap((item) => {
+    const resolved = metadata?.pages?.flatMap((item) => {
       return resolveFolderItem(folder, item, ctx, addedNodePaths);
     });
     const restNodes = buildAll(
@@ -151,20 +148,20 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
       ctx,
       !isRoot
     );
-    const nodes = resolved == null ? void 0 : resolved.flatMap((item) => {
+    const nodes = resolved?.flatMap((item) => {
       if (item === "...") {
         return restNodes;
       }
       return item;
     });
-    children = nodes != null ? nodes : restNodes;
+    children = nodes ?? restNodes;
   }
   const node = {
     type: "folder",
-    name: (_e = (_d = metadata == null ? void 0 : metadata.title) != null ? _d : index == null ? void 0 : index.name) != null ? _e : pathToName(folder.file.name),
-    icon: (_g = (_f = ctx.options).resolveIcon) == null ? void 0 : _g.call(_f, metadata == null ? void 0 : metadata.icon),
-    root: metadata == null ? void 0 : metadata.root,
-    defaultOpen: metadata == null ? void 0 : metadata.defaultOpen,
+    name: metadata?.title ?? index?.name ?? pathToName(folder.file.name, true),
+    icon: ctx.options.resolveIcon?.(metadata?.icon),
+    root: metadata?.root,
+    defaultOpen: metadata?.defaultOpen,
     index,
     children
   };
@@ -172,20 +169,19 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
     node.id = folder.file.flattenedPath;
   }
   return removeUndefined(
-    (_j = (_i = (_h = ctx.options).attachFolder) == null ? void 0 : _i.call(_h, node, folder, meta)) != null ? _j : node
+    ctx.options.attachFolder?.(node, folder, meta) ?? node
   );
 }
 function buildFileNode(file, ctx) {
-  var _a, _b, _c, _d, _e, _f;
-  const localized = (_a = findLocalizedFile(file.file.flattenedPath, "page", ctx)) != null ? _a : file;
+  const localized = findLocalizedFile(file.file.flattenedPath, "page", ctx) ?? file;
   const data = localized.data;
   const item = {
     type: "page",
     name: data.data.title,
-    icon: (_c = (_b = ctx.options).resolveIcon) == null ? void 0 : _c.call(_b, data.data.icon),
+    icon: ctx.options.resolveIcon?.(data.data.icon),
     url: ctx.options.getUrl(data.slugs, ctx.lang)
   };
-  return removeUndefined((_f = (_e = (_d = ctx.options).attachFile) == null ? void 0 : _e.call(_d, item, file)) != null ? _f : item);
+  return removeUndefined(ctx.options.attachFile?.(item, file) ?? item);
 }
 function build(ctx) {
   const root = ctx.storage.root();
@@ -204,8 +200,7 @@ function createPageTreeBuilder() {
         storage: options.storage
       });
     },
-    buildI18n(_a) {
-      var _b = _a, { languages = [], defaultLanguage } = _b, options = __objRest(_b, ["languages", "defaultLanguage"]);
+    buildI18n({ languages = [], defaultLanguage, ...options }) {
       const entries = languages.map((lang) => {
         const tree = build({
           lang: lang === defaultLanguage ? void 0 : lang,
@@ -223,8 +218,15 @@ 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 pathToName(name, resolveGroup = false) {
+  const resolved = resolveGroup ? group.exec(name)?.[1] ?? name : name;
+  const result = [];
+  for (const c of resolved) {
+    if (result.length === 0) result.push(c.toLocaleUpperCase());
+    else if (c === "-") result.push(" ");
+    else result.push(c);
+  }
+  return result.join("");
 }
 function removeUndefined(value) {
   const obj = value;
@@ -263,21 +265,19 @@ var Storage = class {
     return this.rootFolder;
   }
   write(path, format, data) {
-    var _a;
     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.readDir(node.file.dirname)?.children.push(node);
     this.files.set(`${node.file.flattenedPath}.${node.format}`, node);
   }
   list() {
     return [...this.files.values()];
   }
   makeDir(path) {
-    var _a;
     const segments = splitPath(path);
     for (let i = 0; i < segments.length; i++) {
       const segment = segments.slice(0, i + 1).join("/");
@@ -287,17 +287,16 @@ var Storage = class {
         children: []
       };
       this.folders.set(folder.file.path, folder);
-      (_a = this.readDir(folder.file.dirname)) == null ? void 0 : _a.children.push(folder);
+      this.readDir(folder.file.dirname)?.children.push(folder);
     }
   }
 };
 
 // src/source/load-files.ts
 function loadFiles(files, options) {
-  var _a;
   const { transformers = [] } = options;
   const storage = new Storage();
-  const rootDir = normalizePath((_a = options.rootDir) != null ? _a : "");
+  const rootDir = normalizePath(options.rootDir ?? "");
   for (const file of files) {
     const normalizedPath = normalizePath(file.path);
     if (!normalizedPath.startsWith(rootDir)) continue;
@@ -327,7 +326,6 @@ function loadFiles(files, options) {
 
 // src/source/loader.ts
 function buildPageMap(storage, languages, getUrl) {
-  var _a;
   const map = /* @__PURE__ */ new Map();
   const defaultMap = /* @__PURE__ */ new Map();
   map.set("", defaultMap);
@@ -336,12 +334,12 @@ function buildPageMap(storage, languages, getUrl) {
     const page = fileToPage(file, getUrl);
     defaultMap.set(page.slugs.join("/"), page);
     for (const lang of languages) {
-      const langMap = (_a = map.get(lang)) != null ? _a : /* @__PURE__ */ new Map();
+      const langMap = map.get(lang) ?? /* @__PURE__ */ new Map();
       const localized = storage.read(
         `${file.file.flattenedPath}.${lang}`,
         "page"
       );
-      const localizedPage = fileToPage(localized != null ? localized : file, getUrl, lang);
+      const localizedPage = fileToPage(localized ?? file, getUrl, lang);
       langMap.set(localizedPage.slugs.join("/"), localizedPage);
       map.set(lang, langMap);
     }
@@ -356,7 +354,8 @@ function createGetUrl(baseUrl) {
 }
 function getSlugs(info) {
   const result = [...info.dirname.split("/"), info.name].filter(
-    (v) => v.length > 0
+    // filter empty folder names and file groups like (group_name)
+    (v) => v.length > 0 && !/^\(.+\)$/.test(v)
   );
   return result[result.length - 1] === "index" ? result.slice(0, -1) : result;
 }
@@ -383,25 +382,26 @@ function createOutput({
       getSlugs: slugsFn
     }
   );
-  const i18nMap = buildPageMap(storage, languages != null ? languages : [], getUrl);
+  const i18nMap = buildPageMap(storage, languages ?? [], getUrl);
   const builder = createPageTreeBuilder();
-  const pageTree = languages === void 0 ? builder.build(__spreadValues({
+  const pageTree = languages === void 0 ? builder.build({
     storage,
     resolveIcon,
-    getUrl
-  }, pageTreeOptions)) : builder.buildI18n(__spreadValues({
+    getUrl,
+    ...pageTreeOptions
+  }) : builder.buildI18n({
     languages,
     storage,
     resolveIcon,
     getUrl,
-    defaultLanguage
-  }, pageTreeOptions));
+    defaultLanguage,
+    ...pageTreeOptions
+  });
   return {
     pageTree,
     files: storage.list(),
     getPages(language = "") {
-      var _a, _b;
-      return Array.from((_b = (_a = i18nMap.get(language)) == null ? void 0 : _a.values()) != null ? _b : []);
+      return Array.from(i18nMap.get(language)?.values() ?? []);
     },
     getLanguages() {
       const list = [];
@@ -415,8 +415,7 @@ function createOutput({
       return list;
     },
     getPage(slugs = [], language = "") {
-      var _a;
-      return (_a = i18nMap.get(language)) == null ? void 0 : _a.get(slugs.join("/"));
+      return i18nMap.get(language)?.get(slugs.join("/"));
     }
   };
 }

package/dist/toc-internal.js

@@ -1,22 +1,14 @@
+import {
+  useOnChange
+} from "./chunk-KGMG4N3Y.js";
 import {
   mergeRefs,
   useAnchorObserver
-} from "./chunk-EP2HYVJS.js";
-import {
-  __objRest,
-  __spreadProps,
-  __spreadValues
-} from "./chunk-CWMXXUWU.js";
+} from "./chunk-V6DBK6TW.js";
+import "./chunk-MLKGABMK.js";
 
 // src/toc-internal.tsx
-import {
-  createContext,
-  forwardRef,
-  useContext,
-  useEffect,
-  useMemo,
-  useRef
-} from "react";
+import { createContext, forwardRef, useContext, useMemo, useRef } from "react";
 import scrollIntoView from "scroll-into-view-if-needed";
 import { jsx } from "react/jsx-runtime";
 var ActiveAnchorContext = createContext(void 0);
@@ -41,18 +33,16 @@ function AnchorProvider({
   return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: activeAnchor, children });
 }
 var TOCItem = forwardRef(
-  (_a, ref) => {
-    var _b = _a, { onActiveChange } = _b, props = __objRest(_b, ["onActiveChange"]);
+  ({ onActiveChange, ...props }, ref) => {
     const containerRef = useContext(ScrollContext);
     const activeAnchor = useActiveAnchor();
     const anchorRef = useRef(null);
     const mergedRef = mergeRefs(anchorRef, ref);
     const isActive = activeAnchor === props.href.split("#")[1];
-    const onActiveRef = useRef();
-    onActiveRef.current = (active) => {
+    useOnChange(isActive, (v) => {
       const element = anchorRef.current;
       if (!element) return;
-      if (active && containerRef.current) {
+      if (v && containerRef.current) {
         scrollIntoView(element, {
           behavior: "smooth",
           block: "center",
@@ -61,13 +51,9 @@ var TOCItem = forwardRef(
           boundary: containerRef.current
         });
       }
-      onActiveChange == null ? void 0 : onActiveChange(active);
-    };
-    useEffect(() => {
-      var _a2;
-      (_a2 = onActiveRef.current) == null ? void 0 : _a2.call(onActiveRef, isActive);
-    }, [isActive]);
-    return /* @__PURE__ */ jsx("a", __spreadProps(__spreadValues({ ref: mergedRef, "data-active": isActive }, props), { children: props.children }));
+      onActiveChange?.(v);
+    });
+    return /* @__PURE__ */ jsx("a", { ref: mergedRef, "data-active": isActive, ...props, children: props.children });
   }
 );
 TOCItem.displayName = "TOCItem";

package/dist/toc.js

@@ -1,12 +1,8 @@
 import {
   mergeRefs,
   useAnchorObserver
-} from "./chunk-EP2HYVJS.js";
-import {
-  __objRest,
-  __spreadProps,
-  __spreadValues
-} from "./chunk-CWMXXUWU.js";
+} from "./chunk-V6DBK6TW.js";
+import "./chunk-MLKGABMK.js";
 
 // src/toc.tsx
 import {
@@ -25,11 +21,10 @@ var useActiveAnchor = (url) => {
   return activeAnchor === url.split("#")[1];
 };
 var TOCProvider = forwardRef(
-  (_a, ref) => {
-    var _b = _a, { toc } = _b, props = __objRest(_b, ["toc"]);
+  ({ toc, ...props }, ref) => {
     const containerRef = useRef(null);
     const mergedRef = mergeRefs(containerRef, ref);
-    return /* @__PURE__ */ jsx("div", __spreadProps(__spreadValues({ ref: mergedRef }, props), { children: /* @__PURE__ */ jsx(TOCScrollProvider, { toc, containerRef, children: props.children }) }));
+    return /* @__PURE__ */ jsx("div", { ref: mergedRef, ...props, children: /* @__PURE__ */ jsx(TOCScrollProvider, { toc, containerRef, children: props.children }) });
   }
 );
 TOCProvider.displayName = "TOCProvider";
@@ -45,8 +40,7 @@ function TOCScrollProvider({
   return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: { containerRef, activeAnchor }, children });
 }
 var TOCItem = forwardRef(
-  (_a, ref) => {
-    var _b = _a, { containerRef: container } = _b, props = __objRest(_b, ["containerRef"]);
+  ({ containerRef: container, ...props }, ref) => {
     const { containerRef = container } = useContext(ActiveAnchorContext);
     const active = useActiveAnchor(props.href);
     const anchorRef = useRef(null);
@@ -63,7 +57,7 @@ var TOCItem = forwardRef(
         });
       }
     }, [active, containerRef]);
-    return /* @__PURE__ */ jsx("a", __spreadProps(__spreadValues({ ref: mergedRef, "data-active": active }, props), { children: props.children }));
+    return /* @__PURE__ */ jsx("a", { ref: mergedRef, "data-active": active, ...props, children: props.children });
   }
 );
 TOCItem.displayName = "TOCItem";

package/dist/utils/use-on-change.d.ts

@@ -0,0 +1,3 @@
+declare function useOnChange<T>(value: T, onChange: (current: T, previous: T) => void): void;
+
+export { useOnChange };

package/dist/utils/use-on-change.js

@@ -0,0 +1,7 @@
+import {
+  useOnChange
+} from "../chunk-KGMG4N3Y.js";
+import "../chunk-MLKGABMK.js";
+export {
+  useOnChange
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "12.5.2",
+  "version": "12.5.4",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -48,6 +48,10 @@
       "import": "./dist/source/index.js",
       "types": "./dist/source/index.d.ts"
     },
+    "./utils/use-on-change": {
+      "import": "./dist/utils/use-on-change.js",
+      "types": "./dist/utils/use-on-change.d.ts"
+    },
     "./link": {
       "import": "./dist/link.js",
       "types": "./dist/link.d.ts"
@@ -104,6 +108,9 @@
       "middleware": [
         "./dist/middleware.d.ts"
       ],
+      "utils/use-on-change": [
+        "./dist/utils/use-on-change.d.ts"
+      ],
       "mdx-plugins": [
         "./dist/mdx-plugins/index.d.ts"
       ],
@@ -143,7 +150,7 @@
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.3",
-    "@types/node": "20.14.10",
+    "@types/node": "20.14.11",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "algoliasearch": "^4.24.0",

package/dist/chunk-CWMXXUWU.js

@@ -1,63 +0,0 @@
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
-
-export {
-  __spreadValues,
-  __spreadProps,
-  __objRest,
-  __export,
-  __async
-};

package/dist/chunk-XB7CNOKH.js

@@ -1,40 +0,0 @@
-import {
-  __objRest,
-  __spreadProps,
-  __spreadValues
-} from "./chunk-CWMXXUWU.js";
-
-// src/link.tsx
-import Original from "next/link";
-import { forwardRef } from "react";
-import { jsx } from "react/jsx-runtime";
-var Link = forwardRef(
-  (_a, ref) => {
-    var _b = _a, {
-      href = "#",
-      external = !(href.startsWith("/") || href.startsWith("#") || href.startsWith("."))
-    } = _b, props = __objRest(_b, [
-      "href",
-      "external"
-    ]);
-    if (external) {
-      return /* @__PURE__ */ jsx(
-        "a",
-        __spreadProps(__spreadValues({
-          ref,
-          href,
-          rel: "noreferrer noopener",
-          target: "_blank"
-        }, props), {
-          children: props.children
-        })
-      );
-    }
-    return /* @__PURE__ */ jsx(Original, __spreadValues({ ref, href }, props));
-  }
-);
-Link.displayName = "Link";
-
-export {
-  Link
-};