From d375e5c9f162cbd84a6e6462977db56519d09f75 Mon Sep 17 00:00:00 2001
From: Armand Philippot <git@armandphilippot.com>
Date: Thu, 7 Dec 2023 18:48:53 +0100
Subject: refactor(pages): refine Project pages

* refactor ProjectOverview component to let consumers handle the value
* extract project overview depending on Github to avoid fetching
Github API if the project is not on Github
* wrap dynamic import in a useMemo hook to avoid infinite rerender
* fix table of contents by adding a useMutationObserver hook to refresh
headings tree (without it useHeadingsTree is not retriggered once the
dynamic import is done)
* add Cypress tests
---
 .../use-mutation-observer/use-mutation-observer.ts | 35 ++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 src/utils/hooks/use-mutation-observer/use-mutation-observer.ts

(limited to 'src/utils/hooks/use-mutation-observer/use-mutation-observer.ts')

diff --git a/src/utils/hooks/use-mutation-observer/use-mutation-observer.ts b/src/utils/hooks/use-mutation-observer/use-mutation-observer.ts
new file mode 100644
index 0000000..6043055
--- /dev/null
+++ b/src/utils/hooks/use-mutation-observer/use-mutation-observer.ts
@@ -0,0 +1,35 @@
+import { type RefObject, useEffect } from 'react';
+import type { Nullable } from '../../../types';
+
+type UseMutationObserverProps<T extends Nullable<HTMLElement>> = {
+  /**
+   * A callback to execute when mutations are observed.
+   */
+  callback: MutationCallback;
+  /**
+   * The options passed to mutation observer.
+   */
+  options: MutationObserverInit;
+  /**
+   * A reference to the DOM node to observe.
+   */
+  ref: RefObject<T>;
+};
+
+export const useMutationObserver = <T extends Nullable<HTMLElement>>({
+  callback,
+  options,
+  ref,
+}: UseMutationObserverProps<T>) => {
+  useEffect(() => {
+    if (!ref.current) return undefined;
+
+    const observer = new MutationObserver(callback);
+
+    observer.observe(ref.current, options);
+
+    return () => {
+      observer.disconnect();
+    };
+  }, [callback, options, ref]);
+};
-- 
cgit v1.2.3