'use client'; import { useEffect, useMemo } from 'react'; import makeCancellable from 'make-cancellable-promise'; import makeEventProps from 'make-event-props'; import clsx from 'clsx'; import invariant from 'tiny-invariant'; import warning from 'warning'; import OutlineContext from './OutlineContext.js'; import OutlineItem from './OutlineItem.js'; import { cancelRunningTask } from './shared/utils.js'; import useDocumentContext from './shared/hooks/useDocumentContext.js'; import useResolver from './shared/hooks/useResolver.js'; import type { PDFDocumentProxy } from 'pdfjs-dist'; import type { EventProps } from 'make-event-props'; import type { ClassName, OnItemClickArgs } from './shared/types.js'; type PDFOutline = Awaited>; export type OutlineProps = { /** * Class name(s) that will be added to rendered element along with the default `react-pdf__Outline`. * * @example 'custom-class-name-1 custom-class-name-2' * @example ['custom-class-name-1', 'custom-class-name-2'] */ className?: ClassName; /** * A prop that behaves like [ref](https://reactjs.org/docs/refs-and-the-dom.html), but it's passed to main `
` rendered by `` component. * * @example (ref) => { this.myOutline = ref; } * @example this.ref * @example ref */ inputRef?: React.Ref; /** * Function called when an outline item has been clicked. Usually, you would like to use this callback to move the user wherever they requested to. * * @example ({ dest, pageIndex, pageNumber }) => alert('Clicked an item from page ' + pageNumber + '!') */ onItemClick?: (props: OnItemClickArgs) => void; /** * Function called in case of an error while retrieving the outline. * * @example (error) => alert('Error while retrieving the outline! ' + error.message) */ onLoadError?: (error: Error) => void; /** * Function called when the outline is successfully retrieved. * * @example (outline) => alert('The outline has been successfully retrieved.') */ onLoadSuccess?: (outline: PDFOutline | null) => void; pdf?: PDFDocumentProxy | false; } & EventProps; /** * Displays an outline (table of contents). * * Should be placed inside ``. Alternatively, it can have `pdf` prop passed, which can be obtained from ``'s `onLoadSuccess` callback function. */ export default function Outline(props: OutlineProps): React.ReactElement | null { const documentContext = useDocumentContext(); const mergedProps = { ...documentContext, ...props }; const { className, inputRef, onItemClick, onLoadError: onLoadErrorProps, onLoadSuccess: onLoadSuccessProps, pdf, ...otherProps } = mergedProps; invariant( pdf, 'Attempted to load an outline, but no document was specified. Wrap in a or pass explicit `pdf` prop.', ); const [outlineState, outlineDispatch] = useResolver(); const { value: outline, error: outlineError } = outlineState; /** * Called when an outline is read successfully */ function onLoadSuccess() { if (typeof outline === 'undefined' || outline === false) { return; } if (onLoadSuccessProps) { onLoadSuccessProps(outline); } } /** * Called when an outline failed to read successfully */ function onLoadError() { if (!outlineError) { // Impossible, but TypeScript doesn't know that return; } warning(false, outlineError.toString()); if (onLoadErrorProps) { onLoadErrorProps(outlineError); } } // biome-ignore lint/correctness/useExhaustiveDependencies: useEffect intentionally triggered on pdf change useEffect( function resetOutline() { outlineDispatch({ type: 'RESET' }); }, [outlineDispatch, pdf], ); useEffect( function loadOutline() { if (!pdf) { // Impossible, but TypeScript doesn't know that return; } const cancellable = makeCancellable(pdf.getOutline()); const runningTask = cancellable; cancellable.promise .then((nextOutline) => { outlineDispatch({ type: 'RESOLVE', value: nextOutline }); }) .catch((error) => { outlineDispatch({ type: 'REJECT', error }); }); return () => cancelRunningTask(runningTask); }, [outlineDispatch, pdf], ); // biome-ignore lint/correctness/useExhaustiveDependencies: Ommitted callbacks so they are not called every time they change useEffect(() => { if (outline === undefined) { return; } if (outline === false) { onLoadError(); return; } onLoadSuccess(); }, [outline]); const childContext = useMemo( () => ({ onItemClick, }), [onItemClick], ); const eventProps = useMemo( () => makeEventProps(otherProps, () => outline), // biome-ignore lint/correctness/useExhaustiveDependencies: FIXME [otherProps, outline], ); if (!outline) { return null; } function renderOutline() { if (!outline) { return null; } return (
    {outline.map((item, itemIndex) => ( ))}
); } return (
{renderOutline()}
); }