fumadocs-core 16.4.0 → 16.4.2

package/dist/toc.js

@@ -1,151 +1,138 @@
-"use client";
-import "./chunk-U67V476Y.js";
+'use client';
 
-// src/toc.tsx
-import {
-  createContext,
-  useContext,
-  useEffect,
-  useEffectEvent,
-  useLayoutEffect,
-  useMemo,
-  useRef,
-  useState
-} from "react";
+import { createContext, useContext, useEffect, useEffectEvent, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
 import scrollIntoView from "scroll-into-view-if-needed";
 
-// src/utils/merge-refs.ts
+//#region 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;
-      }
-    });
-  };
+	return (value) => {
+		refs.forEach((ref) => {
+			if (typeof ref === "function") ref(value);
+			else if (ref != null) ref.current = value;
+		});
+	};
 }
 
-// src/toc.tsx
-import { jsx } from "react/jsx-runtime";
-var ActiveAnchorContext = createContext([]);
-var ScrollContext = createContext({
-  current: null
-});
+//#endregion
+//#region src/toc.tsx
+const ActiveAnchorContext = createContext([]);
+const ScrollContext = createContext({ current: null });
+/**
+* The estimated active heading ID
+*/
 function useActiveAnchor() {
-  return useContext(ActiveAnchorContext)[0];
+	return useContext(ActiveAnchorContext)[0];
 }
+/**
+* The id of visible anchors
+*/
 function useActiveAnchors() {
-  return useContext(ActiveAnchorContext);
+	return useContext(ActiveAnchorContext);
 }
-function ScrollProvider({
-  containerRef,
-  children
-}) {
-  return /* @__PURE__ */ jsx(ScrollContext.Provider, { value: containerRef, children });
+function ScrollProvider({ containerRef, children }) {
+	return /* @__PURE__ */ jsx(ScrollContext.Provider, {
+		value: containerRef,
+		children
+	});
 }
-function AnchorProvider({
-  toc,
-  single = false,
-  children
-}) {
-  const headings = useMemo(() => {
-    return toc.map((item) => item.url.split("#")[1]);
-  }, [toc]);
-  return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: useAnchorObserver(headings, single), children });
+function AnchorProvider({ toc, single = false, children }) {
+	const headings = useMemo(() => {
+		return toc.map((item) => item.url.split("#")[1]);
+	}, [toc]);
+	return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, {
+		value: useAnchorObserver(headings, single),
+		children
+	});
 }
-function TOCItem({
-  ref,
-  onActiveChange = () => null,
-  ...props
-}) {
-  const containerRef = useContext(ScrollContext);
-  const anchorRef = useRef(null);
-  const activeOrder = useActiveAnchors().indexOf(props.href.slice(1));
-  const isActive = activeOrder !== -1;
-  const shouldScroll = activeOrder === 0;
-  const onActiveChangeEvent = useEffectEvent(onActiveChange);
-  useLayoutEffect(() => {
-    const anchor = anchorRef.current;
-    const container = containerRef.current;
-    if (container && anchor && shouldScroll)
-      scrollIntoView(anchor, {
-        behavior: "smooth",
-        block: "center",
-        inline: "center",
-        scrollMode: "always",
-        boundary: container
-      });
-  }, [containerRef, shouldScroll]);
-  useEffect(() => {
-    return () => onActiveChangeEvent(isActive);
-  }, [isActive]);
-  return /* @__PURE__ */ jsx("a", { ref: mergeRefs(anchorRef, ref), "data-active": isActive, ...props, children: props.children });
+function TOCItem({ ref, onActiveChange = () => null, ...props }) {
+	const containerRef = useContext(ScrollContext);
+	const anchorRef = useRef(null);
+	const activeOrder = useActiveAnchors().indexOf(props.href.slice(1));
+	const isActive = activeOrder !== -1;
+	const shouldScroll = activeOrder === 0;
+	const onActiveChangeEvent = useEffectEvent(onActiveChange);
+	useLayoutEffect(() => {
+		const anchor = anchorRef.current;
+		const container = containerRef.current;
+		if (container && anchor && shouldScroll) scrollIntoView(anchor, {
+			behavior: "smooth",
+			block: "center",
+			inline: "center",
+			scrollMode: "always",
+			boundary: container
+		});
+	}, [containerRef, shouldScroll]);
+	useEffect(() => {
+		return () => onActiveChangeEvent(isActive);
+	}, [isActive]);
+	return /* @__PURE__ */ jsx("a", {
+		ref: mergeRefs(anchorRef, ref),
+		"data-active": isActive,
+		...props,
+		children: props.children
+	});
 }
+/**
+* Find the active heading of page
+*
+* It selects the top heading by default, and the last item when reached the bottom of page.
+*
+* @param watch - An array of element ids to watch
+* @param single - only one active item at most
+* @returns Active anchor
+*/
 function useAnchorObserver(watch, single) {
-  const observerRef = useRef(null);
-  const [activeAnchor, setActiveAnchor] = useState(() => []);
-  const stateRef = useRef(null);
-  const onChange = useEffectEvent((entries) => {
-    stateRef.current ??= {
-      visible: /* @__PURE__ */ new Set()
-    };
-    const state = stateRef.current;
-    for (const entry of entries) {
-      if (entry.isIntersecting) {
-        state.visible.add(entry.target.id);
-      } else {
-        state.visible.delete(entry.target.id);
-      }
-    }
-    if (state.visible.size === 0) {
-      const viewTop = entries.length > 0 ? entries[0]?.rootBounds?.top ?? 0 : 0;
-      let fallback;
-      let min = -1;
-      for (const id of watch) {
-        const element = document.getElementById(id);
-        if (!element) continue;
-        const d = Math.abs(viewTop - element.getBoundingClientRect().top);
-        if (min === -1 || d < min) {
-          fallback = element;
-          min = d;
-        }
-      }
-      setActiveAnchor(fallback ? [fallback.id] : []);
-    } else {
-      const items = watch.filter((item) => state.visible.has(item));
-      setActiveAnchor(single ? items.slice(0, 1) : items);
-    }
-  });
-  useEffect(() => {
-    if (observerRef.current) return;
-    observerRef.current = new IntersectionObserver(onChange, {
-      rootMargin: "0px",
-      threshold: 0.98
-    });
-    return () => {
-      observerRef.current?.disconnect();
-      observerRef.current = null;
-    };
-  }, []);
-  useEffect(() => {
-    const observer = observerRef.current;
-    if (!observer) return;
-    const elements = watch.flatMap(
-      (heading) => document.getElementById(heading) ?? []
-    );
-    for (const element of elements) observer.observe(element);
-    return () => {
-      for (const element of elements) observer.unobserve(element);
-    };
-  }, [watch]);
-  return activeAnchor;
+	const observerRef = useRef(null);
+	const [activeAnchor, setActiveAnchor] = useState(() => []);
+	const stateRef = useRef(null);
+	const onChange = useEffectEvent((entries) => {
+		stateRef.current ??= { visible: /* @__PURE__ */ new Set() };
+		const state = stateRef.current;
+		for (const entry of entries) if (entry.isIntersecting) state.visible.add(entry.target.id);
+		else state.visible.delete(entry.target.id);
+		if (state.visible.size === 0) {
+			const viewTop = entries.length > 0 ? entries[0]?.rootBounds?.top ?? 0 : 0;
+			let fallback;
+			let min = -1;
+			for (const id of watch) {
+				const element = document.getElementById(id);
+				if (!element) continue;
+				const d = Math.abs(viewTop - element.getBoundingClientRect().top);
+				if (min === -1 || d < min) {
+					fallback = element;
+					min = d;
+				}
+			}
+			setActiveAnchor(fallback ? [fallback.id] : []);
+		} else {
+			const items = watch.filter((item) => state.visible.has(item));
+			setActiveAnchor(single ? items.slice(0, 1) : items);
+		}
+	});
+	useEffect(() => {
+		if (observerRef.current) return;
+		observerRef.current = new IntersectionObserver(onChange, {
+			rootMargin: "0px",
+			threshold: .98
+		});
+		return () => {
+			observerRef.current?.disconnect();
+			observerRef.current = null;
+		};
+	}, []);
+	useEffect(() => {
+		const observer = observerRef.current;
+		if (!observer) return;
+		const elements = watch.flatMap((heading) => document.getElementById(heading) ?? []);
+		for (const element of elements) observer.observe(element);
+		return () => {
+			for (const element of elements) observer.unobserve(element);
+		};
+	}, [watch]);
+	return activeAnchor;
 }
-export {
-  AnchorProvider,
-  ScrollProvider,
-  TOCItem,
-  useActiveAnchor,
-  useActiveAnchors
-};
+
+//#endregion
+export { AnchorProvider, ScrollProvider, TOCItem, useActiveAnchor, useActiveAnchors };
+//# sourceMappingURL=toc.js.map

package/dist/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","names":["fallback: Element | undefined"],"sources":["../src/utils/merge-refs.ts","../src/toc.tsx"],"sourcesContent":["import type * as React from 'react';\n\nexport function mergeRefs<T>(...refs: (React.Ref<T> | undefined)[]): React.RefCallback<T> {\n  return (value) => {\n    refs.forEach((ref) => {\n      if (typeof ref === 'function') {\n        ref(value);\n      } else if (ref != null) {\n        ref.current = value;\n      }\n    });\n  };\n}\n","'use client';\nimport {\n  type ComponentProps,\n  createContext,\n  type ReactNode,\n  type RefObject,\n  useContext,\n  useEffect,\n  useEffectEvent,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport scrollIntoView from 'scroll-into-view-if-needed';\nimport { mergeRefs } from '@/utils/merge-refs';\n\nexport interface TOCItemType {\n  title: ReactNode;\n  url: string;\n  depth: number;\n}\n\nexport type TableOfContents = TOCItemType[];\n\nconst ActiveAnchorContext = createContext<string[]>([]);\n\nconst ScrollContext = createContext<RefObject<HTMLElement | null>>({\n  current: null,\n});\n\n/**\n * The estimated active heading ID\n */\nexport function useActiveAnchor(): string | undefined {\n  return useContext(ActiveAnchorContext)[0];\n}\n\n/**\n * The id of visible anchors\n */\nexport function useActiveAnchors(): string[] {\n  return useContext(ActiveAnchorContext);\n}\n\nexport interface AnchorProviderProps {\n  toc: TableOfContents;\n  /**\n   * Only accept one active item at most\n   *\n   * @defaultValue false\n   */\n  single?: boolean;\n  children?: ReactNode;\n}\n\nexport interface ScrollProviderProps {\n  /**\n   * Scroll into the view of container when active\n   */\n  containerRef: RefObject<HTMLElement | null>;\n\n  children?: ReactNode;\n}\n\nexport function ScrollProvider({ containerRef, children }: ScrollProviderProps) {\n  return <ScrollContext.Provider value={containerRef}>{children}</ScrollContext.Provider>;\n}\n\nexport function AnchorProvider({ toc, single = false, children }: AnchorProviderProps) {\n  const headings = useMemo(() => {\n    return toc.map((item) => item.url.split('#')[1]);\n  }, [toc]);\n\n  return (\n    <ActiveAnchorContext.Provider value={useAnchorObserver(headings, single)}>\n      {children}\n    </ActiveAnchorContext.Provider>\n  );\n}\n\nexport interface TOCItemProps extends Omit<ComponentProps<'a'>, 'href'> {\n  href: string;\n  onActiveChange?: (v: boolean) => void;\n}\n\nexport function TOCItem({ ref, onActiveChange = () => null, ...props }: TOCItemProps) {\n  const containerRef = useContext(ScrollContext);\n  const anchorRef = useRef<HTMLAnchorElement>(null);\n  const activeOrder = useActiveAnchors().indexOf(props.href.slice(1));\n  const isActive = activeOrder !== -1;\n  const shouldScroll = activeOrder === 0;\n  const onActiveChangeEvent = useEffectEvent(onActiveChange);\n\n  useLayoutEffect(() => {\n    const anchor = anchorRef.current;\n    const container = containerRef.current;\n\n    if (container && anchor && shouldScroll)\n      scrollIntoView(anchor, {\n        behavior: 'smooth',\n        block: 'center',\n        inline: 'center',\n        scrollMode: 'always',\n        boundary: container,\n      });\n  }, [containerRef, shouldScroll]);\n\n  useEffect(() => {\n    return () => onActiveChangeEvent(isActive);\n  }, [isActive]);\n\n  return (\n    <a ref={mergeRefs(anchorRef, ref)} data-active={isActive} {...props}>\n      {props.children}\n    </a>\n  );\n}\n\n/**\n * Find the active heading of page\n *\n * It selects the top heading by default, and the last item when reached the bottom of page.\n *\n * @param watch - An array of element ids to watch\n * @param single - only one active item at most\n * @returns Active anchor\n */\nfunction useAnchorObserver(watch: string[], single: boolean): string[] {\n  const observerRef = useRef<IntersectionObserver>(null);\n  const [activeAnchor, setActiveAnchor] = useState<string[]>(() => []);\n  const stateRef = useRef<{\n    visible: Set<string>;\n  }>(null);\n\n  const onChange = useEffectEvent((entries: IntersectionObserverEntry[]) => {\n    stateRef.current ??= {\n      visible: new Set(),\n    };\n    const state = stateRef.current;\n\n    for (const entry of entries) {\n      if (entry.isIntersecting) {\n        state.visible.add(entry.target.id);\n      } else {\n        state.visible.delete(entry.target.id);\n      }\n    }\n\n    if (state.visible.size === 0) {\n      const viewTop = entries.length > 0 ? (entries[0]?.rootBounds?.top ?? 0) : 0;\n      let fallback: Element | undefined;\n      let min = -1;\n\n      for (const id of watch) {\n        const element = document.getElementById(id);\n        if (!element) continue;\n\n        const d = Math.abs(viewTop - element.getBoundingClientRect().top);\n        if (min === -1 || d < min) {\n          fallback = element;\n          min = d;\n        }\n      }\n\n      setActiveAnchor(fallback ? [fallback.id] : []);\n    } else {\n      const items = watch.filter((item) => state.visible.has(item));\n      setActiveAnchor(single ? items.slice(0, 1) : items);\n    }\n  });\n\n  useEffect(() => {\n    if (observerRef.current) return;\n    observerRef.current = new IntersectionObserver(onChange, {\n      rootMargin: '0px',\n      threshold: 0.98,\n    });\n\n    return () => {\n      observerRef.current?.disconnect();\n      observerRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    const observer = observerRef.current;\n    if (!observer) return;\n    const elements = watch.flatMap((heading) => document.getElementById(heading) ?? []);\n\n    for (const element of elements) observer.observe(element);\n    return () => {\n      for (const element of elements) observer.unobserve(element);\n    };\n  }, [watch]);\n\n  return activeAnchor;\n}\n"],"mappings":"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"}

package/dist/util-CK2ykiif.d.ts

@@ -0,0 +1,8 @@
+import { Pluggable } from "unified";
+
+//#region src/content/mdx/util.d.ts
+type Thenable<T> = T | PromiseLike<T>;
+type ResolvePlugins = Thenable<Pluggable>[] | ((v: Pluggable[]) => Thenable<Pluggable>[]);
+//#endregion
+export { ResolvePlugins as t };
+//# sourceMappingURL=util-CK2ykiif.d.ts.map

package/dist/util-CK2ykiif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util-CK2ykiif.d.ts","names":[],"sources":["../src/content/mdx/util.ts"],"sourcesContent":[],"mappings":";;;KAEK,cAAc,IAAI,YAAY;KAEvB,cAAA,GAAiB,SAAS,oBAAoB,gBAAgB,SAAS"}

package/dist/util-s9piKHsk.js

@@ -0,0 +1,10 @@
+//#region src/content/mdx/util.ts
+async function resolvePlugins(def, options = []) {
+	const list = (await Promise.all(def(Array.isArray(options) ? options : []))).filter((v) => v !== false);
+	if (typeof options === "function") return Promise.all(options(list));
+	return list;
+}
+
+//#endregion
+export { resolvePlugins as t };
+//# sourceMappingURL=util-s9piKHsk.js.map

package/dist/util-s9piKHsk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util-s9piKHsk.js","names":[],"sources":["../src/content/mdx/util.ts"],"sourcesContent":["import type { Pluggable } from 'unified';\n\ntype Thenable<T> = T | PromiseLike<T>;\n\nexport type ResolvePlugins = Thenable<Pluggable>[] | ((v: Pluggable[]) => Thenable<Pluggable>[]);\n\nexport async function resolvePlugins(\n  def: (v: Thenable<Pluggable>[]) => Thenable<Pluggable | false>[],\n  options: ResolvePlugins = [],\n): Promise<Pluggable[]> {\n  const list = (await Promise.all(def(Array.isArray(options) ? options : []))).filter(\n    (v) => v !== false,\n  );\n\n  if (typeof options === 'function') {\n    return Promise.all(options(list));\n  }\n\n  return list;\n}\n"],"mappings":";AAMA,eAAsB,eACpB,KACA,UAA0B,EAAE,EACN;CACtB,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,MAAM,QAAQ,QAAQ,GAAG,UAAU,EAAE,CAAC,CAAC,EAAE,QAC1E,MAAM,MAAM,MACd;AAED,KAAI,OAAO,YAAY,WACrB,QAAO,QAAQ,IAAI,QAAQ,KAAK,CAAC;AAGnC,QAAO"}

package/dist/utils/use-effect-event.d.ts

@@ -1,3 +1,4 @@
+//#region src/utils/use-effect-event.d.ts
 type UseEffectEvent = <F extends (...params: never[]) => unknown>(callback: F) => F;
 /**
  * Polyfill for React.js 19.2 `useEffectEvent`.
@@ -5,5 +6,6 @@ type UseEffectEvent = <F extends (...params: never[]) => unknown>(callback: F) =
  * @internal Don't use this, could be deleted anytime.
  */
 declare const useEffectEvent: UseEffectEvent;
-
+//#endregion
 export { useEffectEvent };
+//# sourceMappingURL=use-effect-event.d.ts.map

package/dist/utils/use-effect-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect-event.d.ts","names":[],"sources":["../../src/utils/use-effect-event.ts"],"sourcesContent":[],"mappings":";KAGK,cAAA,yDAAuE,MAAM;;AAOlF;;;;cAAa,gBAAgB"}

package/dist/utils/use-effect-event.js

@@ -1,16 +1,19 @@
-"use client";
-import "../chunk-U67V476Y.js";
+'use client';
 
-// src/utils/use-effect-event.ts
 import * as React from "react";
-var useEffectEvent = "useEffectEvent" in React ? { ...React }.useEffectEvent : (callback) => {
-  const ref = React.useRef(callback);
-  ref.current = callback;
-  return React.useCallback(
-    ((...params) => ref.current(...params)),
-    []
-  );
-};
-export {
-  useEffectEvent
+
+//#region src/utils/use-effect-event.ts
+/**
+* Polyfill for React.js 19.2 `useEffectEvent`.
+*
+* @internal Don't use this, could be deleted anytime.
+*/
+const useEffectEvent = "useEffectEvent" in React ? { ...React }.useEffectEvent : (callback) => {
+	const ref = React.useRef(callback);
+	ref.current = callback;
+	return React.useCallback(((...params) => ref.current(...params)), []);
 };
+
+//#endregion
+export { useEffectEvent };
+//# sourceMappingURL=use-effect-event.js.map

package/dist/utils/use-effect-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect-event.js","names":["useEffectEvent: UseEffectEvent"],"sources":["../../src/utils/use-effect-event.ts"],"sourcesContent":["'use client';\nimport * as React from 'react';\n\ntype UseEffectEvent = <F extends (...params: never[]) => unknown>(callback: F) => F;\n\n/**\n * Polyfill for React.js 19.2 `useEffectEvent`.\n *\n * @internal Don't use this, could be deleted anytime.\n */\nexport const useEffectEvent: UseEffectEvent =\n  'useEffectEvent' in React\n    ? { ...React }.useEffectEvent\n    : <F extends (...params: never[]) => unknown>(callback: F) => {\n        const ref = React.useRef(callback);\n        ref.current = callback;\n\n        return React.useCallback(((...params) => ref.current(...params)) as F, []);\n      };\n"],"mappings":";;;;;;;;;;AAUA,MAAaA,iBACX,oBAAoB,QAChB,EAAE,GAAG,OAAO,CAAC,kBAC+B,aAAgB;CAC1D,MAAM,MAAM,MAAM,OAAO,SAAS;AAClC,KAAI,UAAU;AAEd,QAAO,MAAM,cAAc,GAAG,WAAW,IAAI,QAAQ,GAAG,OAAO,GAAQ,EAAE,CAAC"}

package/dist/utils/use-media-query.d.ts

@@ -1,3 +1,5 @@
+//#region src/utils/use-media-query.d.ts
 declare function useMediaQuery(query: string, disabled?: boolean): boolean | null;
-
+//#endregion
 export { useMediaQuery };
+//# sourceMappingURL=use-media-query.d.ts.map

package/dist/utils/use-media-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.ts","names":[],"sources":["../../src/utils/use-media-query.ts"],"sourcesContent":[],"mappings":";iBAEgB,aAAA"}

package/dist/utils/use-media-query.js

@@ -1,23 +1,23 @@
-import "../chunk-U67V476Y.js";
-
-// src/utils/use-media-query.ts
 import { useEffect, useState } from "react";
+
+//#region src/utils/use-media-query.ts
 function useMediaQuery(query, disabled = false) {
-  const [isMatch, setMatch] = useState(null);
-  useEffect(() => {
-    if (disabled) return;
-    const mediaQueryList = window.matchMedia(query);
-    const handleChange = () => {
-      setMatch(mediaQueryList.matches);
-    };
-    handleChange();
-    mediaQueryList.addEventListener("change", handleChange);
-    return () => {
-      mediaQueryList.removeEventListener("change", handleChange);
-    };
-  }, [disabled, query]);
-  return isMatch;
+	const [isMatch, setMatch] = useState(null);
+	useEffect(() => {
+		if (disabled) return;
+		const mediaQueryList = window.matchMedia(query);
+		const handleChange = () => {
+			setMatch(mediaQueryList.matches);
+		};
+		handleChange();
+		mediaQueryList.addEventListener("change", handleChange);
+		return () => {
+			mediaQueryList.removeEventListener("change", handleChange);
+		};
+	}, [disabled, query]);
+	return isMatch;
 }
-export {
-  useMediaQuery
-};
+
+//#endregion
+export { useMediaQuery };
+//# sourceMappingURL=use-media-query.js.map

package/dist/utils/use-media-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.js","names":[],"sources":["../../src/utils/use-media-query.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nexport function useMediaQuery(query: string, disabled = false): boolean | null {\n  const [isMatch, setMatch] = useState<boolean | null>(null);\n\n  useEffect(() => {\n    if (disabled) return;\n    const mediaQueryList = window.matchMedia(query);\n\n    const handleChange = () => {\n      setMatch(mediaQueryList.matches);\n    };\n    handleChange();\n    mediaQueryList.addEventListener('change', handleChange);\n    return () => {\n      mediaQueryList.removeEventListener('change', handleChange);\n    };\n  }, [disabled, query]);\n\n  return isMatch;\n}\n"],"mappings":";;;AAEA,SAAgB,cAAc,OAAe,WAAW,OAAuB;CAC7E,MAAM,CAAC,SAAS,YAAY,SAAyB,KAAK;AAE1D,iBAAgB;AACd,MAAI,SAAU;EACd,MAAM,iBAAiB,OAAO,WAAW,MAAM;EAE/C,MAAM,qBAAqB;AACzB,YAAS,eAAe,QAAQ;;AAElC,gBAAc;AACd,iBAAe,iBAAiB,UAAU,aAAa;AACvD,eAAa;AACX,kBAAe,oBAAoB,UAAU,aAAa;;IAE3D,CAAC,UAAU,MAAM,CAAC;AAErB,QAAO"}

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

@@ -1,8 +1,10 @@
+//#region src/utils/use-on-change.d.ts
 /**
  * @param value - state to watch
  * @param onChange - when the state changed
  * @param isUpdated - a function that determines if the state is updated
  */
 declare function useOnChange<T>(value: T, onChange: (current: T, previous: T) => void, isUpdated?: (prev: T, current: T) => boolean): void;
-
+//#endregion
 export { useOnChange };
+//# sourceMappingURL=use-on-change.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-change.d.ts","names":[],"sources":["../../src/utils/use-on-change.ts"],"sourcesContent":[],"mappings":";;AAeA;;;;AAGoB,iBAHJ,WAGI,CAAA,CAAA,CAAA,CAAA,KAAA,EAFX,CAEW,EAAA,QAAA,EAAA,CAAA,OAAA,EADE,CACF,EAAA,QAAA,EADe,CACf,EAAA,GAAA,IAAA,EAAA,SAAA,CAAA,EAAA,CAAA,IAAA,EAAA,CAAA,EAAA,OAAA,EAAY,CAAZ,EAAA,GAAA,OAAA,CAAA,EAAA,IAAA"}

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

@@ -1,7 +1,23 @@
-import {
-  useOnChange
-} from "../chunk-EMWGTXSW.js";
-import "../chunk-U67V476Y.js";
-export {
-  useOnChange
-};
+import { useState } from "react";
+
+//#region src/utils/use-on-change.ts
+function isDifferent(a, b) {
+	if (Array.isArray(a) && Array.isArray(b)) return b.length !== a.length || a.some((v, i) => isDifferent(v, b[i]));
+	return a !== b;
+}
+/**
+* @param value - state to watch
+* @param onChange - when the state changed
+* @param isUpdated - a function that determines if the state is updated
+*/
+function useOnChange(value, onChange, isUpdated = isDifferent) {
+	const [prev, setPrev] = useState(value);
+	if (isUpdated(prev, value)) {
+		onChange(value, prev);
+		setPrev(value);
+	}
+}
+
+//#endregion
+export { useOnChange };
+//# sourceMappingURL=use-on-change.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-change.js","names":[],"sources":["../../src/utils/use-on-change.ts"],"sourcesContent":["import { useState } from 'react';\n\nfunction isDifferent(a: unknown, b: unknown): boolean {\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return b.length !== a.length || a.some((v, i) => isDifferent(v, b[i]));\n  }\n\n  return a !== b;\n}\n\n/**\n * @param value - state to watch\n * @param onChange - when the state changed\n * @param isUpdated - a function that determines if the state is updated\n */\nexport function useOnChange<T>(\n  value: T,\n  onChange: (current: T, previous: T) => void,\n  isUpdated: (prev: T, current: T) => boolean = isDifferent,\n): void {\n  const [prev, setPrev] = useState<T>(value);\n\n  if (isUpdated(prev, value)) {\n    onChange(value, prev);\n    setPrev(value);\n  }\n}\n"],"mappings":";;;AAEA,SAAS,YAAY,GAAY,GAAqB;AACpD,KAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,CACtC,QAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC;AAGxE,QAAO,MAAM;;;;;;;AAQf,SAAgB,YACd,OACA,UACA,YAA8C,aACxC;CACN,MAAM,CAAC,MAAM,WAAW,SAAY,MAAM;AAE1C,KAAI,UAAU,MAAM,MAAM,EAAE;AAC1B,WAAS,OAAO,KAAK;AACrB,UAAQ,MAAM"}

package/dist/utils-DUvi2WkD.js

@@ -0,0 +1,134 @@
+//#region src/page-tree/utils.ts
+/**
+* Flatten tree to an array of page nodes
+*/
+function flattenTree(nodes) {
+	const out = [];
+	for (const node of nodes) if (node.type === "folder") {
+		if (node.index) out.push(node.index);
+		out.push(...flattenTree(node.children));
+	} else if (node.type === "page") out.push(node);
+	return out;
+}
+/**
+* Get neighbours of a page, useful for implementing "previous & next" buttons
+*/
+function findNeighbour(tree, url, options) {
+	const { separateRoot = true } = options ?? {};
+	const roots = separateRoot ? getPageTreeRoots(tree) : [tree];
+	if (tree.fallback) roots.push(tree.fallback);
+	for (const root of roots) {
+		const list = flattenTree(root.children);
+		const idx = list.findIndex((item) => item.url === url);
+		if (idx === -1) continue;
+		return {
+			previous: list[idx - 1],
+			next: list[idx + 1]
+		};
+	}
+	return {};
+}
+function getPageTreeRoots(pageTree) {
+	const result = pageTree.children.flatMap((child) => {
+		if (child.type !== "folder") return [];
+		const roots = getPageTreeRoots(child);
+		if (child.root) roots.push(child);
+		return roots;
+	});
+	if (!("type" in pageTree)) result.push(pageTree);
+	return result;
+}
+/**
+* Get other item nodes that lives under the same parent.
+*/
+function getPageTreePeers(treeOrTrees, url) {
+	return findSiblings(treeOrTrees, url).filter((item) => item.type === "page");
+}
+/**
+* Get other tree nodes that lives under the same parent.
+*/
+function findSiblings(treeOrTrees, url) {
+	if ("children" in treeOrTrees) {
+		const parent = findParent(treeOrTrees, url);
+		if (!parent) return [];
+		return parent.children.filter((item) => item.type !== "page" || item.url !== url);
+	}
+	for (const lang in treeOrTrees) {
+		const result = getPageTreePeers(treeOrTrees[lang], url);
+		if (result) return result;
+	}
+	return [];
+}
+function findParent(from, url) {
+	let result;
+	visit(from, (node, parent) => {
+		if ("type" in node && node.type === "page" && node.url === url) {
+			result = parent;
+			return "break";
+		}
+	});
+	return result;
+}
+/**
+* Search the path of a node in the tree matched by the matcher.
+*
+* @returns The path to the target node (from starting root), or null if the page doesn't exist
+*/
+function findPath(nodes, matcher, options = {}) {
+	const { includeSeparator = true } = options;
+	function run(nodes$1) {
+		let separator;
+		for (const node of nodes$1) {
+			if (matcher(node)) {
+				const items = [];
+				if (separator) items.push(separator);
+				items.push(node);
+				return items;
+			}
+			if (node.type === "separator" && includeSeparator) {
+				separator = node;
+				continue;
+			}
+			if (node.type === "folder") {
+				const items = node.index && matcher(node.index) ? [node.index] : run(node.children);
+				if (items) {
+					items.unshift(node);
+					if (separator) items.unshift(separator);
+					return items;
+				}
+			}
+		}
+	}
+	return run(nodes) ?? null;
+}
+const VisitBreak = Symbol("VisitBreak");
+/**
+* Perform a depth-first search on page tree visiting every node.
+*
+* @param root - the root of page tree to visit.
+* @param visitor - function to receive nodes, return `skip` to skip the children of current node, `break` to stop the search entirely.
+*/
+function visit(root, visitor) {
+	function onNode(node, parent) {
+		const result = visitor(node, parent);
+		switch (result) {
+			case "skip": return node;
+			case "break": throw VisitBreak;
+			default: if (result) node = result;
+		}
+		if ("index" in node && node.index) node.index = onNode(node.index, node);
+		if ("fallback" in node && node.fallback) node.fallback = onNode(node.fallback, node);
+		if ("children" in node) for (let i = 0; i < node.children.length; i++) node.children[i] = onNode(node.children[i], node);
+		return node;
+	}
+	try {
+		return onNode(root);
+	} catch (e) {
+		if (e === VisitBreak) return root;
+		throw e;
+	}
+}
+
+//#endregion
+export { flattenTree as a, visit as c, findSiblings as i, findParent as n, getPageTreePeers as o, findPath as r, getPageTreeRoots as s, findNeighbour as t };
+//# sourceMappingURL=utils-DUvi2WkD.js.map