@asteroidcms/core-utils 0.1.5 → 0.1.6

package/dist/client.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PropsWithChildren, ReactNode, RefObject } from 'react';
+import { PropsWithChildren, ReactNode } from 'react';
 import * as _apollo_client from '@apollo/client';
 import { InMemoryCacheConfig, ApolloClientOptions, ApolloClient } from '@apollo/client';
 import { useMutation } from '@apollo/client/react';
@@ -224,8 +224,8 @@ interface RichTextContentProps {
      */
     onReady?: (root: HTMLElement) => void;
     /**
-     * Optional ref to the wrapper element. Useful for hooks like
-     * `useTableOfContents` that need a stable reference to the rendered tree.
+     * Optional ref to the wrapper element. Useful for consumers that need a
+     * stable reference to the rendered tree (e.g. scroll observers, ToC hooks).
      */
     contentRef?: React.MutableRefObject<HTMLElement | null>;
     /**
@@ -293,42 +293,4 @@ declare function extractHeadingsFromElement(root: HTMLElement, options?: Extract
     scrollMarginTop?: number;
 }): ExtractedHeading[];
 
-interface UseTableOfContentsOptions {
-    /** Heading levels to include. Defaults to `[2, 3]`. */
-    levels?: ReadonlyArray<HeadingLevel>;
-    /**
-     * Re-collect headings whenever this value changes. Pass the article slug
-     * (or any stable identifier) so swapping content rebuilds the ToC.
-     */
-    contentKey?: string | number | null;
-    /** Pixels to subtract from heading scroll-into-view target. Default 24. */
-    scrollMarginTop?: number;
-    /**
-     * Distance from the top of the viewport (in px) at which a heading becomes
-     * "active". A heading is considered active once its top edge has scrolled
-     * past this line. Default `96` — works well with a sticky header that
-     * stands ~60–80px tall.
-     */
-    activationOffset?: number;
-}
-interface UseTableOfContentsResult {
-    items: ExtractedHeading[];
-    activeId: string;
-}
-/**
- * Build a table of contents from a rendered element and track which
- * heading is currently in view via IntersectionObserver. Resilient to
- * content swaps when `contentKey` is provided.
- *
- * Usage:
- * ```tsx
- * const ref = useRef<HTMLDivElement>(null);
- * const { items, activeId } = useTableOfContents(ref, {
- *   contentKey: article.slug,
- *   levels: [2, 3],
- * });
- * ```
- */
-declare function useTableOfContents(ref: RefObject<HTMLElement | null>, options?: UseTableOfContentsOptions): UseTableOfContentsResult;
-
-export { AsteroidCMSProvider, type AsteroidCMSProviderProps, type ExtractHeadingsOptions, type ExtractedHeading, type HeadingLevel, RichTextContent, type UseCmsContentOptions, type UseCmsMutateOptions, type UseTableOfContentsOptions, type UseTableOfContentsResult, extractHeadingsFromElement, extractHeadingsFromHtml, slugify, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate, useTableOfContents };
+export { AsteroidCMSProvider, type AsteroidCMSProviderProps, type ExtractHeadingsOptions, type ExtractedHeading, type HeadingLevel, RichTextContent, type UseCmsContentOptions, type UseCmsMutateOptions, extractHeadingsFromElement, extractHeadingsFromHtml, slugify, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PropsWithChildren, ReactNode, RefObject } from 'react';
+import { PropsWithChildren, ReactNode } from 'react';
 import * as _apollo_client from '@apollo/client';
 import { InMemoryCacheConfig, ApolloClientOptions, ApolloClient } from '@apollo/client';
 import { useMutation } from '@apollo/client/react';
@@ -224,8 +224,8 @@ interface RichTextContentProps {
      */
     onReady?: (root: HTMLElement) => void;
     /**
-     * Optional ref to the wrapper element. Useful for hooks like
-     * `useTableOfContents` that need a stable reference to the rendered tree.
+     * Optional ref to the wrapper element. Useful for consumers that need a
+     * stable reference to the rendered tree (e.g. scroll observers, ToC hooks).
      */
     contentRef?: React.MutableRefObject<HTMLElement | null>;
     /**
@@ -293,42 +293,4 @@ declare function extractHeadingsFromElement(root: HTMLElement, options?: Extract
     scrollMarginTop?: number;
 }): ExtractedHeading[];
 
-interface UseTableOfContentsOptions {
-    /** Heading levels to include. Defaults to `[2, 3]`. */
-    levels?: ReadonlyArray<HeadingLevel>;
-    /**
-     * Re-collect headings whenever this value changes. Pass the article slug
-     * (or any stable identifier) so swapping content rebuilds the ToC.
-     */
-    contentKey?: string | number | null;
-    /** Pixels to subtract from heading scroll-into-view target. Default 24. */
-    scrollMarginTop?: number;
-    /**
-     * Distance from the top of the viewport (in px) at which a heading becomes
-     * "active". A heading is considered active once its top edge has scrolled
-     * past this line. Default `96` — works well with a sticky header that
-     * stands ~60–80px tall.
-     */
-    activationOffset?: number;
-}
-interface UseTableOfContentsResult {
-    items: ExtractedHeading[];
-    activeId: string;
-}
-/**
- * Build a table of contents from a rendered element and track which
- * heading is currently in view via IntersectionObserver. Resilient to
- * content swaps when `contentKey` is provided.
- *
- * Usage:
- * ```tsx
- * const ref = useRef<HTMLDivElement>(null);
- * const { items, activeId } = useTableOfContents(ref, {
- *   contentKey: article.slug,
- *   levels: [2, 3],
- * });
- * ```
- */
-declare function useTableOfContents(ref: RefObject<HTMLElement | null>, options?: UseTableOfContentsOptions): UseTableOfContentsResult;
-
-export { AsteroidCMSProvider, type AsteroidCMSProviderProps, type ExtractHeadingsOptions, type ExtractedHeading, type HeadingLevel, RichTextContent, type UseCmsContentOptions, type UseCmsMutateOptions, type UseTableOfContentsOptions, type UseTableOfContentsResult, extractHeadingsFromElement, extractHeadingsFromHtml, slugify, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate, useTableOfContents };
+export { AsteroidCMSProvider, type AsteroidCMSProviderProps, type ExtractHeadingsOptions, type ExtractedHeading, type HeadingLevel, RichTextContent, type UseCmsContentOptions, type UseCmsMutateOptions, extractHeadingsFromElement, extractHeadingsFromHtml, slugify, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };

package/dist/client.js

@@ -1721,97 +1721,6 @@ function extractHeadingsFromElement(root, options = {}) {
   return out;
 }
 
-// src/hooks/useTableOfContents.tsx
-function useTableOfContents(ref, options = {}) {
-  const {
-    levels,
-    contentKey = null,
-    scrollMarginTop = 24,
-    activationOffset = 96
-  } = options;
-  const [items, setItems] = useState([]);
-  const [activeId, setActiveId] = useState("");
-  useEffect(() => {
-    const root = ref.current;
-    if (!root) {
-      setItems([]);
-      setActiveId("");
-      return;
-    }
-    let raf = 0;
-    const collect = () => {
-      const next = extractHeadingsFromElement(root, {
-        levels,
-        scrollMarginTop
-      });
-      setItems(next);
-      setActiveId(
-        (prev) => next.some((h) => h.id === prev) ? prev : next[0]?.id ?? ""
-      );
-    };
-    raf = requestAnimationFrame(collect);
-    const mo = new MutationObserver(() => {
-      if (raf) cancelAnimationFrame(raf);
-      raf = requestAnimationFrame(collect);
-    });
-    mo.observe(root, { childList: true, subtree: true, characterData: true });
-    return () => {
-      mo.disconnect();
-      if (raf) cancelAnimationFrame(raf);
-    };
-  }, [ref, contentKey, levels, scrollMarginTop]);
-  useEffect(() => {
-    if (items.length === 0) return;
-    const targets = items.map((it) => document.getElementById(it.id)).filter((el) => el !== null);
-    if (targets.length === 0) return;
-    let raf = 0;
-    const compute = () => {
-      raf = 0;
-      let activeIdx = 0;
-      for (let i = 0; i < items.length; i++) {
-        const el = document.getElementById(items[i].id);
-        if (!el) continue;
-        if (el.getBoundingClientRect().top - activationOffset <= 0) {
-          activeIdx = i;
-        } else {
-          break;
-        }
-      }
-      const scroller = document.scrollingElement || document.documentElement;
-      const scrollY = window.scrollY;
-      const viewportH = window.innerHeight;
-      const atBottom = scrollY + viewportH >= scroller.scrollHeight - 2;
-      if (atBottom) {
-        for (let i = items.length - 1; i > activeIdx; i--) {
-          const el = document.getElementById(items[i].id);
-          if (el && el.getBoundingClientRect().top < viewportH) {
-            activeIdx = i;
-            break;
-          }
-        }
-      }
-      setActiveId(items[activeIdx].id);
-    };
-    const schedule = () => {
-      if (raf) return;
-      raf = requestAnimationFrame(compute);
-    };
-    const io = new IntersectionObserver(schedule, {
-      rootMargin: `-${activationOffset}px 0px -${Math.max(0, window.innerHeight - activationOffset - 1)}px 0px`,
-      threshold: 0
-    });
-    targets.forEach((t) => io.observe(t));
-    window.addEventListener("resize", schedule, { passive: true });
-    compute();
-    return () => {
-      io.disconnect();
-      window.removeEventListener("resize", schedule);
-      if (raf) cancelAnimationFrame(raf);
-    };
-  }, [items, activationOffset]);
-  return { items, activeId };
-}
-
-export { AsteroidCMSProvider, RichTextContent, extractHeadingsFromElement, extractHeadingsFromHtml, slugify, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate, useTableOfContents };
+export { AsteroidCMSProvider, RichTextContent, extractHeadingsFromElement, extractHeadingsFromHtml, slugify, useAsteroidCMSConfig, useCmsContent, useCmsImage, useCmsMutate };
 //# sourceMappingURL=client.js.map
 //# sourceMappingURL=client.js.map