fumadocs-core 9.1.0 → 10.0.1

package/dist/{chunk-GT3Y35O6.js → chunk-M6ZDX3QR.js}

@@ -21,12 +21,12 @@ function remarkHeading() {
     const toc = [];
     slugger.reset();
     visit(node, ["heading"], (heading) => {
-      var _a;
+      var _a, _b;
       heading.data || (heading.data = {});
       (_a = heading.data).hProperties || (_a.hProperties = {});
       const text = flattenNode(heading);
       const properties = heading.data.hProperties;
-      const id = slugger.slug(properties.id || text);
+      const id = slugger.slug((_b = properties.id) != null ? _b : text);
       properties.id = id;
       toc.push({
         title: text,

package/dist/mdx-plugins/index.js

@@ -2,7 +2,7 @@ import {
   flattenNode,
   remarkHeading,
   visit
-} from "../chunk-GT3Y35O6.js";
+} from "../chunk-M6ZDX3QR.js";
 import {
   slash
 } from "../chunk-UWEEHUJV.js";

package/dist/search/client.d.ts

@@ -8,6 +8,11 @@ interface UseDocsSearch {
         keepPreviousData: true;
     }>;
 }
-declare function useDocsSearch(locale?: string, tag?: string): UseDocsSearch;
+/**
+ * @param locale - Filter with locale
+ * @param tag - Filter with specific tag
+ * @param api - The Search API URL
+ */
+declare function useDocsSearch(locale?: string, tag?: string, api?: string): UseDocsSearch;
 
 export { useDocsSearch };

package/dist/search/client.js

@@ -21,14 +21,12 @@ function fetchDocs(api, query, locale, tag) {
     return yield res.json();
   });
 }
-function useDocsSearch(locale, tag) {
+function useDocsSearch(locale, tag, api = "/api/search") {
   const [search, setSearch] = useState("");
   const debouncedValue = useDebounce(search, 100);
   const query = useSWR(
-    ["/api/search", debouncedValue, locale, tag],
-    (_0) => __async(this, [_0], function* ([api, value]) {
-      return fetchDocs(api, value, locale, tag);
-    }),
+    [api, debouncedValue, locale, tag],
+    (args) => fetchDocs(...args),
     {
       keepPreviousData: true
     }

package/dist/search/server.js

@@ -5,7 +5,7 @@ import {
 
 // src/search/server.ts
 import { Document } from "flexsearch";
-import nextLib from "next/server";
+import { NextResponse } from "next/server";
 function createSearchAPI(type, options) {
   if (type === "simple") {
     return initSearchAPI(options);
@@ -32,7 +32,7 @@ function createI18nSearchAPI(type, options) {
         if (handler)
           return handler.GET(request);
       }
-      return nextLib.NextResponse.json([]);
+      return NextResponse.json([]);
     }
   };
 }
@@ -80,20 +80,20 @@ function initSearchAPI({ indexes, language }) {
       const { searchParams } = request.nextUrl;
       const query = searchParams.get("query");
       if (!query)
-        return nextLib.NextResponse.json([]);
+        return NextResponse.json([]);
       const results = index.search(query, 5, {
         enrich: true,
         suggest: true
       });
       if (results.length === 0)
-        return nextLib.NextResponse.json([]);
+        return NextResponse.json([]);
       const pages = results[0].result.map((page) => ({
         type: "page",
         content: page.doc.title,
         id: page.doc.url,
         url: page.doc.url
       }));
-      return nextLib.NextResponse.json(pages);
+      return NextResponse.json(pages);
     }
   };
 }
@@ -158,7 +158,7 @@ function initSearchAPIAdvanced({
       const query = request.nextUrl.searchParams.get("query");
       const paramTag = request.nextUrl.searchParams.get("tag");
       if (!query)
-        return nextLib.NextResponse.json([]);
+        return NextResponse.json([]);
       const results = index.search(query, 5, {
         enrich: true,
         tag: paramTag != null ? paramTag : void 0,
@@ -197,7 +197,7 @@ function initSearchAPIAdvanced({
         });
         sortedResult.push(...items);
       }
-      return nextLib.NextResponse.json(sortedResult);
+      return NextResponse.json(sortedResult);
     }
   };
 }

package/dist/search-algolia/client.js

@@ -49,7 +49,7 @@ function useAlgoliaSearch(index, _a = {}) {
   var _b = _a, { allowEmpty = true } = _b, options = __objRest(_b, ["allowEmpty"]);
   const [search, setSearch] = useState("");
   const query = useSWR(
-    ["/api/search", search, allowEmpty, options],
+    ["algolia-search", search, allowEmpty, options],
     () => __async(this, null, function* () {
       if (allowEmpty && search.length === 0)
         return "empty";

package/dist/search-algolia/server.d.ts

@@ -42,4 +42,4 @@ interface BaseIndex {
     content: string;
 }
 
-export { type BaseIndex, setIndexSettings, sync, updateDocuments };
+export { type BaseIndex, type SyncOptions, setIndexSettings, sync, updateDocuments };

package/dist/server/index.js

@@ -1,6 +1,6 @@
 import {
   remarkHeading
-} from "../chunk-GT3Y35O6.js";
+} from "../chunk-M6ZDX3QR.js";
 import {
   __async
 } from "../chunk-WEAGW6MQ.js";

package/dist/source/index.d.ts

@@ -1,6 +1,25 @@
 import { ReactElement } from 'react';
 import { R as Root } from '../page-tree-mLHMYx2B.js';
 
+interface FileInfo {
+    locale?: string;
+    /**
+     * Original path of file
+     */
+    path: string;
+    /**
+     * File path without extension
+     */
+    flattenedPath: string;
+    /**
+     * File name without locale and extension
+     */
+    name: string;
+    dirname: string;
+}
+declare function parseFilePath(path: string): FileInfo;
+declare function parseFolderPath(path: string): FileInfo;
+
 interface LoadOptions {
     files: VirtualFile[];
     transformers?: Transformer[];
@@ -13,13 +32,11 @@ interface VirtualFile {
     type: 'page' | 'meta';
     data: unknown;
 }
-interface LoadResult {
+type Transformer = (context: {
     storage: Storage;
     getSlugs: (info: FileInfo) => string[];
     getUrl: (slugs: string[], locale?: string) => string;
-    data: Record<string, unknown>;
-}
-declare function load(options: LoadOptions): LoadResult;
+}) => void;
 
 interface LoaderConfig {
     source: SourceConfig;
@@ -54,7 +71,7 @@ interface Source<Config extends SourceConfig> {
 }
 interface LoaderOutput<Config extends LoaderConfig> {
     pageTree: Config['i18n'] extends true ? Record<string, Root> : Root;
-    files: Node<Config['source']['metaData'], Config['source']['pageData']>[];
+    files: (Meta<Config['source']['metaData']> | Page<Config['source']['pageData']>)[];
     /**
      * Get list of pages from language, empty if language hasn't specified
      *
@@ -66,28 +83,14 @@ interface LoaderOutput<Config extends LoaderConfig> {
      */
     getPage: (slugs: string[] | undefined, language?: string) => Page<Config['source']['pageData']> | undefined;
 }
+declare function createGetUrl(baseUrl: string): (slugs: string[], locale?: string) => string;
+declare function getSlugs(info: FileInfo): string[];
 type InferSourceConfig<T> = T extends Source<infer Config> ? Config : never;
 declare function loader<Options extends LoaderOptions>(options: Options): LoaderOutput<{
     source: InferSourceConfig<Options['source']>;
     i18n: Options['languages'] extends string[] ? true : false;
 }>;
 
-interface FileInfo {
-    locale?: string;
-    /**
-     * Original path of file
-     */
-    path: string;
-    /**
-     * File path without extension
-     */
-    flattenedPath: string;
-    /**
-     * File name without locale and extension
-     */
-    name: string;
-    dirname: string;
-}
 interface MetaData {
     icon?: string;
     title?: string;
@@ -101,7 +104,6 @@ interface PageData {
 }
 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;
-type Transformer = (context: LoadResult) => void;
 
 interface Meta<Data extends MetaData = MetaData> {
     type: 'meta';
@@ -118,9 +120,8 @@ interface Page<Data extends PageData = PageData> {
 interface Folder<MD extends MetaData = MetaData, PD extends PageData = PageData> {
     type: 'folder';
     file: FileInfo;
-    children: Node<MD, PD>[];
+    children: (Meta<MD> | Page<PD> | Folder<MD, PD>)[];
 }
-type Node<MD extends MetaData = MetaData, PD extends PageData = PageData> = Meta<MD> | Page<PD> | Folder<MD, PD>;
 /**
  * A virtual file system that solves inconsistent behaviours
  *
@@ -152,12 +153,11 @@ declare class Storage {
 
 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_Node<MD extends MetaData = MetaData, PD extends PageData = PageData> = Node<MD, PD>;
 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_Node as Node, type fileSystem_Page as Page, fileSystem_Storage as Storage };
+  export { type fileSystem_Folder as Folder, type fileSystem_Meta as Meta, type fileSystem_Page as Page, fileSystem_Storage as Storage };
 }
 
 interface BuildPageTreeOptionsWithI18n {
@@ -176,4 +176,4 @@ interface CreatePageTreeBuilderOptions {
 }
 declare function createPageTreeBuilder({ storage, resolveIcon, }: CreatePageTreeBuilderOptions): PageTreeBuilder;
 
-export { type BuildPageTreeOptionsWithI18n, type CreatePageTreeBuilderOptions, type FileInfo, fileSystem as FileSystem, type InferMetaType, type InferPageType, type LoadOptions, type LoadResult, type LoaderOptions, type LoaderOutput, type MetaData, type PageData, type PageTreeBuilder, type Source, type Transformer, type VirtualFile, createPageTreeBuilder, load, loader };
+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 };

package/dist/source/index.js

@@ -49,6 +49,7 @@ function joinPaths(paths, slashMode = "none") {
 }
 
 // src/source/page-tree-builder.ts
+var external = new RegExp("\\[(?<text>.+)\\]\\((?<url>.+)\\)");
 var separator = new RegExp("---(?<name>.*?)---");
 var rest = "...";
 var extractor = new RegExp("\\.\\.\\.(?<name>.+)");
@@ -95,6 +96,17 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
       }
     ];
   }
+  const externalResult = external.exec(item);
+  if (externalResult == null ? void 0 : externalResult.groups) {
+    return [
+      {
+        type: "page",
+        name: externalResult.groups.text,
+        url: externalResult.groups.url,
+        external: true
+      }
+    ];
+  }
   const extractResult = extractor.exec(item);
   const path2 = joinPaths([
     folder.file.path,
@@ -106,7 +118,7 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
   addedNodePaths.add(itemNode.file.path);
   if (itemNode.type === "folder") {
     const node = buildFolderNode(itemNode, false, ctx);
-    return (extractResult == null ? void 0 : extractResult.groups) ? node.children : [node];
+    return extractResult ? node.children : [node];
   }
   return [buildFileNode(itemNode, ctx)];
 }
@@ -139,7 +151,7 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
     });
     children = nodes != null ? nodes : restNodes;
   }
-  return {
+  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),
@@ -147,7 +159,7 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
     defaultOpen: meta == null ? void 0 : meta.defaultOpen,
     index,
     children
-  };
+  });
 }
 function buildFileNode(page, ctx) {
   let localePage = page;
@@ -158,12 +170,12 @@ function buildFileNode(page, ctx) {
     if (result)
       localePage = result;
   }
-  return {
+  return removeUndefined({
     type: "page",
     name: localePage.data.title,
     icon: ctx.resolveIcon(localePage.data.icon),
     url: localePage.url
-  };
+  });
 }
 function build(ctx) {
   const root = ctx.storage.root();
@@ -205,6 +217,14 @@ function createPageTreeBuilder({
 function pathToName(path2) {
   return path2.slice(0, 1).toUpperCase() + path2.slice(1);
 }
+function removeUndefined(value) {
+  const obj = value;
+  Object.keys(obj).forEach((key) => {
+    if (obj[key] === void 0)
+      delete obj[key];
+  });
+  return value;
+}
 
 // src/source/load.ts
 import * as path from "path";
@@ -289,16 +309,14 @@ var Storage = class {
 function load(options) {
   const { transformers = [] } = options;
   const storage = buildStorage(options);
-  const ctx = {
-    getSlugs: options.getSlugs,
-    getUrl: options.getUrl,
-    storage,
-    data: {}
-  };
   for (const transformer of transformers) {
-    transformer(ctx);
+    transformer({
+      storage,
+      getUrl: options.getUrl,
+      getSlugs: options.getSlugs
+    });
   }
-  return ctx;
+  return { storage };
 }
 function buildStorage(options) {
   const storage = new Storage();
@@ -307,8 +325,7 @@ function buildStorage(options) {
       path.relative(options.rootDir, path.join("./", path.dirname(file.path))),
       path.basename(file.path)
     );
-    const isRelative = !relativePath.startsWith("..") && !path.isAbsolute(relativePath);
-    if (!isRelative)
+    if (relativePath.startsWith("..") || path.isAbsolute(relativePath))
       continue;
     if (file.type === "page") {
       const parsedPath = parseFilePath(relativePath);
@@ -330,26 +347,20 @@ function buildStorage(options) {
   return storage;
 }
 
-// src/source/create.ts
-function groupByLanguages(nodes, languages) {
+// src/source/loader.ts
+function groupByLanguages(storage, languages) {
   var _a, _b, _c;
-  const pageMap = /* @__PURE__ */ new Map();
-  for (const node of nodes) {
-    if (node.type === "page")
-      pageMap.set(node.file.flattenedPath, node);
-  }
   const langMap = /* @__PURE__ */ new Map();
   langMap.set("", []);
-  for (const lang of languages) {
-    langMap.set(lang, []);
-  }
-  for (const [key, node] of pageMap) {
-    if (node.file.locale)
+  for (const node of storage.list()) {
+    if (node.type !== "page" || node.file.locale)
       continue;
     (_a = langMap.get("")) == null ? void 0 : _a.push(node);
     for (const lang of languages) {
-      const v = (_b = pageMap.get(`${key}.${lang}`)) != null ? _b : node;
-      (_c = langMap.get(lang)) == null ? void 0 : _c.push(v);
+      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);
     }
   }
   return langMap;
@@ -386,7 +397,7 @@ function createOutput({
     getSlugs: slugs,
     getUrl: url
   });
-  const i18nMap = groupByLanguages(result.storage.list(), languages != null ? languages : []);
+  const i18nMap = groupByLanguages(result.storage, languages != null ? languages : []);
   const builder = createPageTreeBuilder({
     storage: result.storage,
     resolveIcon: icon
@@ -408,7 +419,10 @@ function createOutput({
 }
 export {
   file_system_exports as FileSystem,
+  createGetUrl,
   createPageTreeBuilder,
-  load,
-  loader
+  getSlugs,
+  loader,
+  parseFilePath,
+  parseFolderPath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "9.1.0",
+  "version": "10.0.1",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -44,10 +44,6 @@
       "import": "./dist/link.js",
       "types": "./dist/link.d.ts"
     },
-    "./typescript": {
-      "import": "./dist/typescript.js",
-      "types": "./dist/typescript.d.ts"
-    },
     "./middleware": {
       "import": "./dist/middleware.js",
       "types": "./dist/middleware.d.ts"
@@ -76,9 +72,6 @@
       "toc": [
         "./dist/toc.d.ts"
       ],
-      "typescript": [
-        "./dist/typescript.d.ts"
-      ],
       "search/client": [
         "./dist/search/client.d.ts"
       ],
@@ -115,40 +108,39 @@
     "dist/*"
   ],
   "dependencies": {
-    "@formatjs/intl-localematcher": "^0.5.0",
-    "@shikijs/rehype": "1.1.7",
-    "@shikijs/transformers": "1.1.7",
-    "flexsearch": "0.7.21",
+    "@formatjs/intl-localematcher": "^0.5.4",
+    "@shikijs/rehype": "^1.1.7",
+    "@shikijs/transformers": "^1.1.7",
+    "flexsearch": "^0.7.43",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.0",
     "negotiator": "^0.6.3",
-    "react-remove-scroll": "^2.5.6",
+    "react-remove-scroll": "^2.5.7",
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.0",
-    "remark-mdx": "^3.0.0",
+    "remark-mdx": "^3.0.1",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "1.1.7",
-    "swr": "^2.2.2",
+    "shiki": "^1.1.7",
+    "swr": "^2.2.5",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
-    "@algolia/client-search": "^4.20.0",
-    "@next/eslint-plugin-next": "^14.0.0",
+    "@algolia/client-search": "^4.22.1",
     "@types/flexsearch": "0.7.6",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
-    "@types/negotiator": "^0.6.1",
+    "@types/negotiator": "^0.6.3",
     "@types/node": "18.17.5",
-    "@types/react": "18.2.0",
-    "@types/react-dom": "18.2.1",
-    "algoliasearch": "^4.20.0",
-    "next": "14.1.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.1",
+    "algoliasearch": "^4.22.1",
+    "next": "^14.1.2",
     "unified": "^11.0.4",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "next": ">= 13.4",
+    "next": ">= 14.1.0",
     "react": ">= 18",
     "react-dom": ">= 18"
   },

package/dist/typescript.d.ts

@@ -1,37 +0,0 @@
-import * as ts from 'typescript';
-
-interface DocEntry {
-    name: string;
-    description: string;
-    type: string;
-    default?: string;
-}
-interface Context {
-    program: ts.Program;
-    checker: ts.TypeChecker;
-    options: Options;
-}
-interface EntryContext extends Context {
-    type: ts.Type;
-    symbol: ts.Symbol;
-}
-interface Options {
-    file: string;
-    name: string;
-    /**
-     * Modify output property entry
-     */
-    transform?: (this: EntryContext, entry: DocEntry, propertyType: ts.Type, propertySymbol: ts.Symbol) => void;
-    options?: Partial<{
-        files: string[];
-        tsconfigPath: string;
-        /** A root directory to resolve relative path entries in the config file to. e.g. outDir */
-        basePath: string;
-    }>;
-}
-/**
- * Generate documentation for properties in an exported type/interface
- */
-declare function generateDocumentation(options: Options): DocEntry[];
-
-export { type DocEntry, type Options, generateDocumentation };

package/dist/typescript.js

@@ -1,90 +0,0 @@
-import {
-  __spreadProps,
-  __spreadValues
-} from "./chunk-WEAGW6MQ.js";
-
-// src/typescript.ts
-import * as ts from "typescript";
-var cache = /* @__PURE__ */ new Map();
-function getProgram(options = {}) {
-  var _a, _b, _c;
-  const key = JSON.stringify(options);
-  const cached = cache.get(key);
-  if (cached)
-    return cached;
-  const configFile = ts.readJsonConfigFile(
-    (_a = options.tsconfigPath) != null ? _a : "./tsconfig.json",
-    (path) => ts.sys.readFile(path)
-  );
-  const parsed = ts.parseJsonSourceFileConfigFileContent(
-    configFile,
-    ts.sys,
-    (_b = options.basePath) != null ? _b : "./"
-  );
-  const program = ts.createProgram({
-    rootNames: (_c = options.files) != null ? _c : parsed.fileNames,
-    options: __spreadProps(__spreadValues({}, parsed.options), {
-      incremental: false
-    })
-  });
-  cache.set(key, program);
-  return program;
-}
-function getExportedSymbol({
-  options: { file, name },
-  checker,
-  program
-}) {
-  const sourceFile = program.getSourceFile(file);
-  if (!sourceFile)
-    return;
-  const fileSymbol = checker.getSymbolAtLocation(sourceFile);
-  if (!fileSymbol)
-    return;
-  const exports = checker.getExportsOfModule(fileSymbol);
-  return exports.find((e) => e.getEscapedName().toString() === name);
-}
-function generateDocumentation(options) {
-  const program = getProgram(options.options);
-  const checker = program.getTypeChecker();
-  const ctx = {
-    checker,
-    program,
-    options
-  };
-  const symbol = getExportedSymbol(ctx);
-  if (!symbol)
-    return [];
-  const type = checker.getDeclaredTypeOfSymbol(symbol);
-  const entryContext = __spreadProps(__spreadValues({}, ctx), {
-    type,
-    symbol
-  });
-  return type.getProperties().map(getDocEntry.bind(entryContext));
-}
-function getDocEntry(prop) {
-  var _a;
-  const subType = this.checker.getTypeOfSymbol(prop);
-  const defaultJsDocTag = prop.getJsDocTags().find((info) => ["default", "defaultValue"].includes(info.name));
-  let typeName = this.checker.typeToString(
-    subType.getNonNullableType(),
-    void 0,
-    ts.TypeFormatFlags.UseAliasDefinedOutsideCurrentScope
-  );
-  if (subType.aliasSymbol && !subType.aliasTypeArguments) {
-    typeName = subType.aliasSymbol.escapedName.toString();
-  }
-  const entry = {
-    name: prop.getName(),
-    description: ts.displayPartsToString(
-      prop.getDocumentationComment(this.checker)
-    ),
-    default: (defaultJsDocTag == null ? void 0 : defaultJsDocTag.text) ? ts.displayPartsToString(defaultJsDocTag.text) : void 0,
-    type: typeName
-  };
-  (_a = this.options.transform) == null ? void 0 : _a.call(this, entry, subType, prop);
-  return entry;
-}
-export {
-  generateDocumentation
-};