fumadocs-core 12.0.0 → 12.0.2

package/dist/chunk-EP2HYVJS.js

@@ -0,0 +1,50 @@
+// src/utils/merge-refs.ts
+function mergeRefs(...refs) {
+  return (value) => {
+    refs.forEach((ref) => {
+      if (typeof ref === "function") {
+        ref(value);
+      } else if (ref !== null) {
+        ref.current = value;
+      }
+    });
+  };
+}
+
+// src/utils/use-anchor-observer.ts
+import { useEffect, useState } from "react";
+function useAnchorObserver(watch) {
+  const [activeAnchor, setActiveAnchor] = useState();
+  useEffect(() => {
+    const observer = new IntersectionObserver(
+      (entries) => {
+        setActiveAnchor((f) => {
+          for (const entry of entries) {
+            const aboveHalf = window.innerHeight / 2 > entry.boundingClientRect.y;
+            const active = aboveHalf && entry.isIntersecting;
+            if (active) {
+              return entry.target.id;
+            }
+          }
+          return f != null ? f : watch[0];
+        });
+      },
+      { rootMargin: `0% 0% -80% 0%` }
+    );
+    for (const heading of watch) {
+      const element = document.getElementById(heading);
+      if (element !== null) {
+        observer.observe(element);
+      }
+    }
+    return () => {
+      observer.disconnect();
+    };
+  }, [watch]);
+  return activeAnchor;
+}
+
+export {
+  mergeRefs,
+  useAnchorObserver
+};

package/dist/toc-internal.d.ts

@@ -0,0 +1,28 @@
+import * as react from 'react';
+import { ReactNode, RefObject, AnchorHTMLAttributes } from 'react';
+import { T as TableOfContents } from './get-toc-B-AMfFKT.js';
+
+/**
+ * The id of active anchor (doesn't include hash)
+ */
+declare function useActiveAnchor(): string | undefined;
+interface AnchorProviderProps {
+    toc: TableOfContents;
+    children?: ReactNode;
+}
+interface ScrollProviderProps {
+    /**
+     * Scroll into the view of container when active
+     */
+    containerRef: RefObject<HTMLElement>;
+    children?: ReactNode;
+}
+declare function ScrollProvider({ containerRef, children, }: ScrollProviderProps): React.ReactElement;
+declare function AnchorProvider({ toc, children, }: AnchorProviderProps): React.ReactElement;
+interface TOCItemProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+    href: string;
+    onActiveChange?: (v: boolean) => void;
+}
+declare const TOCItem: react.ForwardRefExoticComponent<TOCItemProps & react.RefAttributes<HTMLAnchorElement>>;
+
+export { AnchorProvider, type AnchorProviderProps, ScrollProvider, type ScrollProviderProps, TOCItem, type TOCItemProps, useActiveAnchor };

package/dist/toc-internal.js

@@ -0,0 +1,79 @@
+import {
+  mergeRefs,
+  useAnchorObserver
+} from "./chunk-EP2HYVJS.js";
+import {
+  __objRest,
+  __spreadProps,
+  __spreadValues
+} from "./chunk-UWTMEZUM.js";
+
+// src/toc-internal.tsx
+import {
+  createContext,
+  forwardRef,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef
+} from "react";
+import scrollIntoView from "scroll-into-view-if-needed";
+import { jsx } from "react/jsx-runtime";
+var ActiveAnchorContext = createContext(void 0);
+var ScrollContext = createContext({ current: null });
+function useActiveAnchor() {
+  return useContext(ActiveAnchorContext);
+}
+function ScrollProvider({
+  containerRef,
+  children
+}) {
+  return /* @__PURE__ */ jsx(ScrollContext.Provider, { value: containerRef, children });
+}
+function AnchorProvider({
+  toc,
+  children
+}) {
+  const headings = useMemo(() => {
+    return toc.map((item) => item.url.split("#")[1]);
+  }, [toc]);
+  const activeAnchor = useAnchorObserver(headings);
+  return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: activeAnchor, children });
+}
+var TOCItem = forwardRef(
+  (_a, ref) => {
+    var _b = _a, { onActiveChange } = _b, props = __objRest(_b, ["onActiveChange"]);
+    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) => {
+      const element = anchorRef.current;
+      if (!element) return;
+      if (active && containerRef.current) {
+        scrollIntoView(element, {
+          behavior: "smooth",
+          block: "center",
+          inline: "center",
+          scrollMode: "always",
+          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 }));
+  }
+);
+TOCItem.displayName = "TOCItem";
+export {
+  AnchorProvider,
+  ScrollProvider,
+  TOCItem,
+  useActiveAnchor
+};

package/dist/toc.d.ts

@@ -8,13 +8,20 @@ interface TOCProviderProps extends HTMLAttributes<HTMLDivElement> {
 }
 declare const TOCProvider: react.ForwardRefExoticComponent<TOCProviderProps & react.RefAttributes<HTMLDivElement>>;
 interface TOCScrollProvider {
-    containerRef: RefObject<HTMLElement>;
+    /**
+     * Scroll into the view of container when active
+     */
+    containerRef?: RefObject<HTMLElement>;
     toc: TableOfContents;
     children: ReactNode;
 }
 declare function TOCScrollProvider({ toc, containerRef, children, }: TOCScrollProvider): React.ReactElement;
 interface TOCItemProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
     href: string;
+    /**
+     * Scroll into the view of container when active
+     */
+    containerRef?: RefObject<HTMLElement>;
 }
 declare const TOCItem: react.ForwardRefExoticComponent<TOCItemProps & react.RefAttributes<HTMLAnchorElement>>;
 

package/dist/toc.js

@@ -1,3 +1,7 @@
+import {
+  mergeRefs,
+  useAnchorObserver
+} from "./chunk-EP2HYVJS.js";
 import {
   __objRest,
   __spreadProps,
@@ -9,64 +13,13 @@ import {
   createContext,
   forwardRef,
   useContext,
-  useEffect as useEffect2,
+  useEffect,
   useMemo,
   useRef
 } from "react";
 import scrollIntoView from "scroll-into-view-if-needed";
-
-// src/utils/merge-refs.ts
-function mergeRefs(...refs) {
-  return (value) => {
-    refs.forEach((ref) => {
-      if (typeof ref === "function") {
-        ref(value);
-      } else if (ref !== null) {
-        ref.current = value;
-      }
-    });
-  };
-}
-
-// src/utils/use-anchor-observer.ts
-import { useEffect, useState } from "react";
-function useAnchorObserver(watch) {
-  const [activeAnchor, setActiveAnchor] = useState();
-  useEffect(() => {
-    const observer = new IntersectionObserver(
-      (entries) => {
-        setActiveAnchor((f) => {
-          for (const entry of entries) {
-            const aboveHalf = window.innerHeight / 2 > entry.boundingClientRect.y;
-            const active = aboveHalf && entry.isIntersecting;
-            if (active) {
-              return entry.target.id;
-            }
-          }
-          return f != null ? f : watch[0];
-        });
-      },
-      { rootMargin: `0% 0% -80% 0%` }
-    );
-    for (const heading of watch) {
-      const element = document.getElementById(heading);
-      if (element !== null) {
-        observer.observe(element);
-      }
-    }
-    return () => {
-      observer.disconnect();
-    };
-  }, [watch]);
-  return activeAnchor;
-}
-
-// src/toc.tsx
 import { jsx } from "react/jsx-runtime";
-var ActiveAnchorContext = createContext({
-  activeAnchor: void 0,
-  containerRef: { current: null }
-});
+var ActiveAnchorContext = createContext({});
 var useActiveAnchor = (url) => {
   const { activeAnchor } = useContext(ActiveAnchorContext);
   return activeAnchor === url.split("#")[1];
@@ -92,14 +45,15 @@ function TOCScrollProvider({
   return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: { containerRef, activeAnchor }, children });
 }
 var TOCItem = forwardRef(
-  (props, ref) => {
-    const { containerRef } = useContext(ActiveAnchorContext);
+  (_a, ref) => {
+    var _b = _a, { containerRef: container } = _b, props = __objRest(_b, ["containerRef"]);
+    const { containerRef = container } = useContext(ActiveAnchorContext);
     const active = useActiveAnchor(props.href);
     const anchorRef = useRef(null);
     const mergedRef = mergeRefs(anchorRef, ref);
-    useEffect2(() => {
+    useEffect(() => {
       const element = anchorRef.current;
-      if (active && element) {
+      if (active && element && containerRef) {
         scrollIntoView(element, {
           behavior: "smooth",
           block: "center",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "12.0.0",
+  "version": "12.0.2",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -24,6 +24,10 @@
       "import": "./dist/toc.js",
       "types": "./dist/toc.d.ts"
     },
+    "./toc-internal": {
+      "import": "./dist/toc-internal.js",
+      "types": "./dist/toc-internal.d.ts"
+    },
     "./search/client": {
       "import": "./dist/search/client.js",
       "types": "./dist/search/client.d.ts"
@@ -76,6 +80,9 @@
       "toc": [
         "./dist/toc.d.ts"
       ],
+      "toc-internal": [
+        "./dist/toc-internal.d.ts"
+      ],
       "search/client": [
         "./dist/search/client.d.ts"
       ],