fumadocs-core 15.5.0 → 15.5.2

package/dist/{algolia-RQ5VQJAB.js → algolia-NXNLN7TR.js}

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/search/client/algolia.ts
 function groupResults(hits) {
   const grouped = [];
@@ -23,7 +21,7 @@ function groupResults(hits) {
   }
   return grouped;
 }
-async function searchDocs(query, tag, locale, { indexName, onSearch, client }) {
+async function searchDocs(query, { indexName, onSearch, client, locale, tag }) {
   if (query.length > 0) {
     const result = onSearch ? await onSearch(query, tag, locale) : await client.searchForHits({
       requests: [

package/dist/breadcrumb.js

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/breadcrumb.tsx
 import { useMemo } from "react";
 function useBreadcrumb(url, tree, options) {

package/dist/{chunk-XMCPKVJQ.js → chunk-3JSIVMCJ.js}

@@ -5,17 +5,16 @@ function splitPath(path) {
 function joinPath(...paths) {
   const out = [];
   const parsed = paths.flatMap(splitPath);
-  while (parsed.length > 0) {
-    switch (parsed[0]) {
+  for (const seg of parsed) {
+    switch (seg) {
       case "..":
         out.pop();
         break;
       case ".":
         break;
       default:
-        out.push(parsed[0]);
+        out.push(seg);
     }
-    parsed.shift();
   }
   return out.join("/");
 }

package/dist/{chunk-NNKVN7WA.js → chunk-5SU2O5AS.js}

@@ -1,6 +1,6 @@
 import {
   Link
-} from "./chunk-FVY6EZ3N.js";
+} from "./chunk-BBP7MIO4.js";
 
 // src/link.tsx
 import { forwardRef } from "react";

package/dist/chunk-7GNSIKII.js

@@ -0,0 +1,47 @@
+// src/source/path.ts
+function basename(path, ext) {
+  const idx = path.lastIndexOf("/");
+  return path.substring(
+    idx === -1 ? 0 : idx + 1,
+    ext ? path.length - ext.length : path.length
+  );
+}
+function extname(path) {
+  const dotIdx = path.lastIndexOf(".");
+  if (dotIdx !== -1) {
+    return path.substring(dotIdx);
+  }
+  return "";
+}
+function dirname(path) {
+  return path.split("/").slice(0, -1).join("/");
+}
+function parseFilePath(path) {
+  const ext = extname(path);
+  const name = basename(path, ext);
+  const dir = dirname(path);
+  return {
+    dirname: dir,
+    name,
+    ext,
+    path,
+    get flattenedPath() {
+      return [dir, name].filter((p) => p.length > 0).join("/");
+    }
+  };
+}
+function parseFolderPath(path) {
+  return {
+    dirname: dirname(path),
+    name: basename(path),
+    path
+  };
+}
+
+export {
+  basename,
+  extname,
+  dirname,
+  parseFilePath,
+  parseFolderPath
+};

package/dist/{chunk-FVY6EZ3N.js → chunk-BBP7MIO4.js}

@@ -12,24 +12,22 @@ var FrameworkContext = createContext("FrameworkContext", {
   usePathname: notImplemented
 });
 function FrameworkProvider({
-  children,
-  ...props
+  Link: Link2,
+  useRouter: useRouter2,
+  useParams: useParams2,
+  usePathname: usePathname2,
+  Image: Image2,
+  children
 }) {
   const framework = React.useMemo(
     () => ({
-      usePathname: props.usePathname,
-      useRouter: props.useRouter,
-      Link: props.Link,
-      Image: props.Image,
-      useParams: props.useParams
+      usePathname: usePathname2,
+      useRouter: useRouter2,
+      Link: Link2,
+      Image: Image2,
+      useParams: useParams2
     }),
-    [
-      props.Link,
-      props.usePathname,
-      props.useRouter,
-      props.useParams,
-      props.Image
-    ]
+    [Link2, usePathname2, useRouter2, useParams2, Image2]
   );
   return /* @__PURE__ */ jsx(FrameworkContext.Provider, { value: framework, children });
 }

package/dist/content/index.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/content/index.ts
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";

package/dist/dynamic-link.js

@@ -1,11 +1,10 @@
 "use client";
 import {
   Link
-} from "./chunk-NNKVN7WA.js";
+} from "./chunk-5SU2O5AS.js";
 import {
   useParams
-} from "./chunk-FVY6EZ3N.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-BBP7MIO4.js";
 
 // src/dynamic-link.tsx
 import { forwardRef, useMemo } from "react";

package/dist/{fetch-W5EHIBOE.js → fetch-ZSD7GUCX.js}

@@ -1,13 +1,11 @@
-import "./chunk-MLKGABMK.js";
-
 // src/search/client/fetch.ts
 var cache = /* @__PURE__ */ new Map();
-async function fetchDocs(query, locale, tag, options) {
+async function fetchDocs(query, { api = "/api/search", locale, tag }) {
   const params = new URLSearchParams();
   params.set("query", query);
   if (locale) params.set("locale", locale);
   if (tag) params.set("tag", tag);
-  const key = `${options.api ?? "/api/search"}?${params}`;
+  const key = `${api}?${params}`;
   const cached = cache.get(key);
   if (cached) return cached;
   const res = await fetch(key);

package/dist/framework/index.d.ts

@@ -29,7 +29,7 @@ interface Framework {
     }>;
     Image?: FC<ImageProps>;
 }
-declare function FrameworkProvider({ children, ...props }: Framework & {
+declare function FrameworkProvider({ Link, useRouter, useParams, usePathname, Image, children, }: Framework & {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 declare function usePathname(): string;

package/dist/framework/index.js

@@ -7,8 +7,7 @@ import {
   useParams,
   usePathname,
   useRouter
-} from "../chunk-FVY6EZ3N.js";
-import "../chunk-MLKGABMK.js";
+} from "../chunk-BBP7MIO4.js";
 export {
   FrameworkProvider,
   Image,

package/dist/framework/next.js

@@ -1,8 +1,7 @@
 "use client";
 import {
   FrameworkProvider
-} from "../chunk-FVY6EZ3N.js";
-import "../chunk-MLKGABMK.js";
+} from "../chunk-BBP7MIO4.js";
 
 // src/framework/next.tsx
 import { useParams, usePathname, useRouter } from "next/navigation";

package/dist/framework/react-router.js

@@ -1,7 +1,6 @@
 import {
   FrameworkProvider
-} from "../chunk-FVY6EZ3N.js";
-import "../chunk-MLKGABMK.js";
+} from "../chunk-BBP7MIO4.js";
 
 // src/framework/react-router.tsx
 import { useMemo } from "react";

package/dist/framework/tanstack.js

@@ -1,7 +1,6 @@
 import {
   FrameworkProvider
-} from "../chunk-FVY6EZ3N.js";
-import "../chunk-MLKGABMK.js";
+} from "../chunk-BBP7MIO4.js";
 
 // src/framework/tanstack.tsx
 import { useMemo } from "react";

package/dist/hide-if-empty.d.ts

@@ -0,0 +1,14 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * The built-in CSS `:empty` selector cannot detect if the children is hidden, classes such as `md:hidden` causes it to fail.
+ * This component is an enhancement to `empty:hidden` to fix the issue described above.
+ *
+ * This can be expensive, please avoid this whenever possible.
+ */
+declare function HideIfEmpty({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+export { HideIfEmpty };

package/dist/hide-if-empty.js

@@ -0,0 +1,63 @@
+"use client";
+
+// src/hide-if-empty.tsx
+import React from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var isEmpty = (node) => {
+  for (let i = 0; i < node.childNodes.length; i++) {
+    const child = node.childNodes.item(i);
+    if (child.nodeType === Node.TEXT_NODE || child.nodeType === Node.ELEMENT_NODE && window.getComputedStyle(child).display !== "none") {
+      return false;
+    }
+  }
+  return true;
+};
+function HideIfEmpty({ children }) {
+  const id = React.useId();
+  const [empty, setEmpty] = React.useState();
+  React.useEffect(() => {
+    const element = document.querySelector(
+      `[data-fdid="${id}"]`
+    );
+    if (!element) return;
+    const onUpdate = () => {
+      setEmpty(isEmpty(element));
+    };
+    const observer = new ResizeObserver(onUpdate);
+    observer.observe(element);
+    onUpdate();
+    return () => {
+      observer.disconnect();
+    };
+  }, [id]);
+  let child;
+  if (React.isValidElement(children)) {
+    child = React.cloneElement(children, {
+      ...children.props,
+      "data-fdid": id,
+      "data-empty": empty,
+      suppressHydrationWarning: true
+    });
+  } else {
+    child = React.Children.count(children) > 1 ? React.Children.only(null) : null;
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    child,
+    empty === void 0 && /* @__PURE__ */ jsx(
+      "script",
+      {
+        suppressHydrationWarning: true,
+        dangerouslySetInnerHTML: {
+          __html: `{
+const element = document.querySelector('[data-fdid="${id}"]')
+if (element) {
+  element.setAttribute('data-empty', String((${isEmpty.toString()})(element)))
+}}`
+        }
+      }
+    )
+  ] });
+}
+export {
+  HideIfEmpty
+};

package/dist/highlight/client.js

@@ -4,7 +4,6 @@ import {
   _renderHighlight,
   highlight
 } from "../chunk-KNWSJ4IF.js";
-import "../chunk-MLKGABMK.js";
 
 // src/highlight/client.tsx
 import {

package/dist/highlight/index.js

@@ -2,7 +2,6 @@ import {
   getHighlighter,
   highlight
 } from "../chunk-KNWSJ4IF.js";
-import "../chunk-MLKGABMK.js";
 export {
   getHighlighter,
   highlight

package/dist/i18n/index.d.ts

@@ -1,4 +1,3 @@
-import { I as I18nConfig } from '../config-Cm58P4fz.js';
 import { NextMiddleware } from 'next/dist/server/web/types';
 
 interface MiddlewareOptions extends I18nConfig {
@@ -9,4 +8,35 @@ interface MiddlewareOptions extends I18nConfig {
 }
 declare function createI18nMiddleware({ languages, defaultLanguage, format, hideLocale, }: MiddlewareOptions): NextMiddleware;
 
-export { I18nConfig, createI18nMiddleware };
+interface I18nConfig {
+    /**
+     * Supported locale codes.
+     *
+     * A page tree will be built for each language.
+     */
+    languages: string[];
+    /**
+     * Default locale if not specified
+     */
+    defaultLanguage: string;
+    /**
+     * Don't show the locale prefix on URL.
+     *
+     * - `always`: Always hide the prefix
+     * - `default-locale`: Only hide the default locale
+     * - `never`: Never hide the prefix
+     *
+     * This API uses `NextResponse.rewrite`.
+     *
+     * @defaultValue 'never'
+     */
+    hideLocale?: 'always' | 'default-locale' | 'never';
+    /**
+     * Used by `loader()`, specify the way to parse i18n file structure.
+     *
+     * @defaultValue 'dot'
+     */
+    parser?: 'dot' | 'dir';
+}
+
+export { type I18nConfig, createI18nMiddleware };

package/dist/i18n/index.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/i18n/middleware.ts
 import { match as matchLocale } from "@formatjs/intl-localematcher";
 import Negotiator from "negotiator";

package/dist/link.js

@@ -1,9 +1,8 @@
 "use client";
 import {
   Link
-} from "./chunk-NNKVN7WA.js";
-import "./chunk-FVY6EZ3N.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-5SU2O5AS.js";
+import "./chunk-BBP7MIO4.js";
 export {
   Link as default
 };

package/dist/mdx-plugins/index.js

@@ -5,12 +5,11 @@ import {
 import {
   joinPath,
   slash
-} from "../chunk-XMCPKVJQ.js";
+} from "../chunk-3JSIVMCJ.js";
 import {
   defaultThemes,
   getHighlighter
 } from "../chunk-KNWSJ4IF.js";
-import "../chunk-MLKGABMK.js";
 
 // src/mdx-plugins/index.ts
 import {

package/dist/{orama-cloud-USLSOSXS.js → orama-cloud-I4WBDIAI.js}

@@ -1,12 +1,11 @@
 import {
   removeUndefined
 } from "./chunk-KAOEMCTI.js";
-import "./chunk-MLKGABMK.js";
 
 // src/search/client/orama-cloud.ts
-async function searchDocs(query, tag, options) {
+async function searchDocs(query, options) {
   const list = [];
-  const { index = "default", client, params: extraParams = {} } = options;
+  const { index = "default", client, params: extraParams = {}, tag } = options;
   if (index === "crawler") {
     const result2 = await client.search({
       ...extraParams,

package/dist/search/algolia.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/search/algolia.ts
 async function sync(client, options) {
   const { document = "document", indexName = document, documents } = options;

package/dist/search/client.d.ts

@@ -12,21 +12,46 @@ import 'mdast-util-mdx-jsx';
 interface FetchOptions {
     /**
      * API route for search endpoint
+     *
+     * @defaultValue '/api/search'
      */
     api?: string;
+    /**
+     * Filter results with specific tag.
+     */
+    tag?: string;
+    /**
+     * Filter by locale
+     */
+    locale?: string;
 }
 
 interface StaticOptions {
     /**
      * Where to download exported search indexes (URL)
+     *
+     * @defaultValue '/api/search'
      */
     from?: string;
     initOrama?: (locale?: string) => AnyOrama | Promise<AnyOrama>;
+    /**
+     * Filter results with specific tag.
+     */
+    tag?: string;
+    /**
+     * Filter by locale (unsupported at the moment)
+     */
+    locale?: string;
 }
 
 interface AlgoliaOptions {
     indexName: string;
     client: LiteClient;
+    /**
+     * Filter results with specific tag.
+     */
+    tag?: string;
+    locale?: string;
     onSearch?: (query: string, tag?: string, locale?: string) => Promise<{
         results: SearchResponse<BaseIndex>[];
     }>;
@@ -41,6 +66,14 @@ interface OramaCloudOptions {
      */
     index?: 'default' | 'crawler';
     params?: ClientSearchParams;
+    /**
+     * Filter results with specific tag.
+     */
+    tag?: string;
+    /**
+     * Filter by locale (unsupported at the moment)
+     */
+    locale?: string;
 }
 
 interface UseDocsSearch {
@@ -62,13 +95,43 @@ type Client = ({
     type: 'orama-cloud';
 } & OramaCloudOptions);
 /**
- * @param client - search client
- * @param locale - Filter with locale
- * @param tag - Filter with specific tag
- * @param delayMs - The debounced delay for performing a search.
- * @param allowEmpty - still perform search even if query is empty
- * @param key - cache key
+ * Provide a hook to query different official search clients.
+ *
+ * Note: it will re-query when its parameters changed, make sure to use `useCallback()` on functions passed to this hook.
+ */
+declare function useDocsSearch(clientOptions: Client & {
+    /**
+     * The debounced delay for performing a search (in ms).
+     * .
+     * @defaultValue 100
+     */
+    delayMs?: number;
+    /**
+     * still perform search even if query is empty.
+     *
+     * @defaultValue false
+     */
+    allowEmpty?: boolean;
+}, 
+/**
+ * @deprecated pass to `client` object instead
+ */
+_locale?: string, 
+/**
+ * @deprecated pass to `client` object instead
+ */
+_tag?: string, 
+/**
+ * @deprecated pass to `client` object instead
+ */
+_delayMs?: number, 
+/**
+ * @deprecated pass to `client` object instead
+ */
+_allowEmpty?: boolean, 
+/**
+ * @deprecated No longer used
  */
-declare function useDocsSearch(client: Client, locale?: string, tag?: string, delayMs?: number, allowEmpty?: boolean, key?: string): UseDocsSearch;
+_key?: string): UseDocsSearch;
 
 export { type AlgoliaOptions, type Client, type FetchOptions, type OramaCloudOptions, type StaticOptions, useDocsSearch };

package/dist/search/client.js

@@ -1,7 +1,6 @@
 import {
   useOnChange
 } from "../chunk-EMWGTXSW.js";
-import "../chunk-MLKGABMK.js";
 
 // src/search/client.ts
 import { useRef as useRef2, useState as useState2 } from "react";
@@ -23,7 +22,6 @@ function useDebounce(value, delayMs = 1e3) {
 }
 
 // src/search/client.ts
-var staticClient;
 function isDifferentDeep(a, b) {
   if (Array.isArray(a) && Array.isArray(b)) {
     return b.length !== a.length || a.some((v, i) => isDifferentDeep(v, b[i]));
@@ -37,7 +35,14 @@ function isDifferentDeep(a, b) {
   }
   return a !== b;
 }
-function useDocsSearch(client, locale, tag, delayMs = 100, allowEmpty = false, key) {
+function useDocsSearch(clientOptions, _locale, _tag, _delayMs = 100, _allowEmpty = false, _key) {
+  const {
+    delayMs = _delayMs ?? 100,
+    allowEmpty = _allowEmpty ?? false,
+    ...client
+  } = clientOptions;
+  client.tag ??= _tag;
+  client.locale ??= _locale;
   const [search, setSearch] = useState2("");
   const [results, setResults] = useState2("empty");
   const [error, setError] = useState2();
@@ -45,7 +50,7 @@ function useDocsSearch(client, locale, tag, delayMs = 100, allowEmpty = false, k
   const debouncedValue = useDebounce(search, delayMs);
   const onStart = useRef2(void 0);
   useOnChange(
-    key ?? [client, debouncedValue, locale, tag],
+    [client, debouncedValue],
     () => {
       if (onStart.current) {
         onStart.current();
@@ -59,20 +64,22 @@ function useDocsSearch(client, locale, tag, delayMs = 100, allowEmpty = false, k
       async function run() {
         if (debouncedValue.length === 0 && !allowEmpty) return "empty";
         if (client.type === "fetch") {
-          const { fetchDocs } = await import("../fetch-W5EHIBOE.js");
-          return fetchDocs(debouncedValue, locale, tag, client);
+          const { fetchDocs } = await import("../fetch-ZSD7GUCX.js");
+          return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {
-          const { searchDocs } = await import("../algolia-RQ5VQJAB.js");
-          return searchDocs(debouncedValue, tag, locale, client);
+          const { searchDocs } = await import("../algolia-NXNLN7TR.js");
+          return searchDocs(debouncedValue, client);
         }
         if (client.type === "orama-cloud") {
-          const { searchDocs } = await import("../orama-cloud-USLSOSXS.js");
-          return searchDocs(debouncedValue, tag, client);
+          const { searchDocs } = await import("../orama-cloud-I4WBDIAI.js");
+          return searchDocs(debouncedValue, client);
         }
-        const { createStaticClient } = await import("../static-VESU2S64.js");
-        if (!staticClient) staticClient = createStaticClient(client);
-        return staticClient.search(debouncedValue, locale, tag);
+        if (client.type === "static") {
+          const { search: search2 } = await import("../static-QTPM5MZT.js");
+          return search2(debouncedValue, client);
+        }
+        throw new Error("unknown search client");
       }
       void run().then((res) => {
         if (interrupt) return;

package/dist/search/orama-cloud.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/search/orama-cloud.ts
 async function sync(cloudManager, options) {
   const { autoDeploy = true } = options;

package/dist/search/server.d.ts

@@ -1,11 +1,12 @@
 import { TypedDocument, Orama, Language, RawData, create, SearchParams } from '@orama/orama';
 import { S as StructuredData } from '../remark-structure-DVje0Sib.js';
 import { S as SortedResult } from '../types-Ch8gnVgO.js';
-import { I as I18nConfig } from '../config-Cm58P4fz.js';
+import { I18nConfig } from '../i18n/index.js';
 import { LoaderOutput, LoaderConfig, InferPageType } from '../source/index.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
+import 'next/dist/server/web/types';
 import 'react';
 import '../page-tree-bSt6K__E.js';
 

package/dist/search/server.js

@@ -3,7 +3,10 @@ import {
   searchSimple
 } from "../chunk-WFUH5VBX.js";
 import "../chunk-KAOEMCTI.js";
-import "../chunk-MLKGABMK.js";
+import {
+  basename,
+  extname
+} from "../chunk-7GNSIKII.js";
 
 // src/search/server.ts
 import {
@@ -150,7 +153,7 @@ function pageToIndex(page) {
   }
   const structuredData = page.data.structuredData;
   return {
-    title: page.data.title ?? page.file.name,
+    title: page.data.title ?? basename(page.path, extname(page.path)),
     description: "description" in page.data ? page.data.description : void 0,
     url: page.url,
     id: page.url,

package/dist/server/index.d.ts

@@ -8,7 +8,8 @@ import { LoaderOutput, LoaderConfig, InferPageType } from '../source/index.js';
 import 'react';
 import 'unified';
 import 'vfile';
-import '../config-Cm58P4fz.js';
+import '../i18n/index.js';
+import 'next/dist/server/web/types';
 
 /**
  * Flatten tree to an array of page nodes