@osdk/react-components 0.2.0-beta.21 → 0.2.0-beta.23

package/build/esm/pdf-viewer/hooks/usePdfOutline.js

@@ -0,0 +1,268 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useEffect, useState } from "react";
+import { OUTLINE_HEADING_SIZE_RATIO, OUTLINE_MAX_HEADING_LENGTH } from "../constants.js";
+const EMPTY_OUTLINE = [];
+export function usePdfOutline(document) {
+  const [outlineItems, setOutlineItems] = useState(EMPTY_OUTLINE);
+  useEffect(function () {
+    if (document == null) {
+      setOutlineItems(EMPTY_OUTLINE);
+      return;
+    }
+    let cancelled = false;
+    void (async () => {
+      try {
+        // Try embedded bookmarks first
+        const outline = await document.getOutline();
+        if (cancelled) return;
+        if (outline != null && outline.length > 0) {
+          const items = await resolveBookmarkOutline(document, outline);
+          if (!cancelled) {
+            setOutlineItems(items);
+          }
+          return;
+        }
+
+        // Fall back to extracting headings from text content
+        const items = await extractHeadingsFromText(document);
+        if (!cancelled) {
+          setOutlineItems(items.length > 0 ? items : EMPTY_OUTLINE);
+        }
+      } catch {
+        // If extraction fails entirely, leave outline empty
+        if (!cancelled) {
+          setOutlineItems(EMPTY_OUTLINE);
+        }
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [document]);
+  return outlineItems;
+}
+async function resolveBookmarkOutline(document, outline) {
+  const items = [];
+  const resolveItems = async (nodes, depth) => {
+    for (const node of nodes) {
+      let pageNumber = 1;
+      try {
+        if (typeof node.dest === "string") {
+          const dest = await document.getDestination(node.dest);
+          if (dest != null) {
+            const pageIndex = await document.getPageIndex(dest[0]);
+            pageNumber = pageIndex + 1;
+          }
+        } else if (Array.isArray(node.dest) && node.dest.length > 0) {
+          const pageIndex = await document.getPageIndex(node.dest[0]);
+          pageNumber = pageIndex + 1;
+        }
+      } catch {
+        // If destination resolution fails, default to page 1
+      }
+      items.push({
+        title: node.title,
+        depth,
+        pageNumber,
+        bold: node.bold,
+        italic: node.italic
+      });
+      if (node.items.length > 0) {
+        await resolveItems(node.items, depth + 1);
+      }
+    }
+  };
+  await resolveItems(outline, 0);
+  return items;
+}
+function isTextItem(item) {
+  return "str" in item && "transform" in item;
+}
+function roundFontSize(size) {
+  return Math.round(size * 10) / 10;
+}
+
+/**
+ * Extract the font size from a pdfjs TextItem.
+ * Prefer `height` when available, otherwise derive from the transform matrix.
+ * The transform is [scaleX, skewY, skewX, scaleY, translateX, translateY].
+ * Font size = sqrt(skewX² + scaleY²), which handles rotated text too.
+ */
+function getFontSize(item) {
+  if (item.height > 0) {
+    return item.height;
+  }
+  const transform = item.transform;
+  if (Array.isArray(transform) && transform.length >= 4) {
+    return Math.sqrt(transform[2] * transform[2] + transform[3] * transform[3]);
+  }
+  return 0;
+}
+async function extractHeadingsFromText(document) {
+  const numPages = document.numPages;
+
+  // Fetch all pages' text content in parallel
+  const pageContents = await Promise.all(Array.from({
+    length: numPages
+  }, (_, i) => document.getPage(i + 1).then(page => page.getTextContent())));
+
+  // Collect font size frequencies across all pages
+  const sizeCounts = new Map();
+  for (const textContent of pageContents) {
+    for (const rawItem of textContent.items) {
+      const item = rawItem;
+      if (!isTextItem(item) || item.str.trim().length === 0) {
+        continue;
+      }
+      const fontSize = getFontSize(item);
+      if (fontSize > 0) {
+        const rounded = roundFontSize(fontSize);
+        sizeCounts.set(rounded, (sizeCounts.get(rounded) ?? 0) + 1);
+      }
+    }
+  }
+
+  // Find the most common font size (body text)
+  let bodySize = 0;
+  let maxCount = 0;
+  for (const [size, count] of sizeCounts) {
+    if (count > maxCount) {
+      maxCount = count;
+      bodySize = size;
+    }
+  }
+  if (bodySize === 0) {
+    return [];
+  }
+
+  // Heading threshold: text significantly larger than body text
+  const headingThreshold = bodySize * OUTLINE_HEADING_SIZE_RATIO;
+
+  // Collect all unique heading sizes above threshold
+  const headingSizes = new Set();
+  for (const [size] of sizeCounts) {
+    if (size >= headingThreshold) {
+      headingSizes.add(size);
+    }
+  }
+  if (headingSizes.size === 0) {
+    return [];
+  }
+
+  // Sort heading sizes descending (largest = depth 0)
+  const sortedSizes = [...headingSizes].sort((a, b) => b - a);
+  const sizeToDepth = new Map();
+  for (let i = 0; i < sortedSizes.length; i++) {
+    sizeToDepth.set(sortedSizes[i], i);
+  }
+
+  // Extract headings with page numbers.
+  // pdfjs splits visual lines into multiple TextItems (e.g. "1." and
+  // "Introduction" are separate items). We accumulate all items on the
+  // same visual line and treat the line as a heading if most of its
+  // content is at a heading font size.
+  const candidateHeadings = [];
+  for (let pageIdx = 0; pageIdx < pageContents.length; pageIdx++) {
+    const textContent = pageContents[pageIdx];
+    const pageNumber = pageIdx + 1;
+    let lineItems = [];
+    let linePageNumber = pageNumber;
+    let lineFontName = "";
+    let lineHeadingFontSize = 0;
+    let lastFlushWasHeading = false;
+    const flushLine = () => {
+      if (lineItems.length === 0) return;
+
+      // Check if the majority of the line's non-whitespace content is heading-sized
+      let headingChars = 0;
+      let totalChars = 0;
+      for (const li of lineItems) {
+        const len = li.text.trim().length;
+        totalChars += len;
+        if (sizeToDepth.has(roundFontSize(li.fontSize))) {
+          headingChars += len;
+        }
+      }
+      if (totalChars > 0 && headingChars / totalChars > 0.5) {
+        const fullText = lineItems.map(li => li.text).join("").trim();
+        if (fullText.length > 0) {
+          candidateHeadings.push({
+            text: fullText,
+            fontSize: lineHeadingFontSize,
+            pageNumber: linePageNumber,
+            fontName: lineFontName,
+            contiguous: lastFlushWasHeading
+          });
+        }
+        lastFlushWasHeading = true;
+      } else {
+        lastFlushWasHeading = false;
+      }
+      lineItems = [];
+      lineHeadingFontSize = 0;
+    };
+    for (const rawItem of textContent.items) {
+      const item = rawItem;
+      if (!isTextItem(item)) {
+        continue;
+      }
+      const fontSize = getFontSize(item);
+      const rounded = roundFontSize(fontSize);
+      const isHeadingSized = sizeToDepth.has(rounded);
+      if (isHeadingSized && lineHeadingFontSize === 0) {
+        lineHeadingFontSize = rounded;
+        linePageNumber = pageNumber;
+        lineFontName = item.fontName;
+      }
+      if (lineHeadingFontSize > 0) {
+        lineItems.push({
+          text: item.str,
+          fontSize
+        });
+      }
+      if (item.hasEOL) {
+        flushLine();
+      }
+    }
+
+    // Flush remaining items at end of page
+    flushLine();
+  }
+
+  // Merge consecutive heading lines that were contiguous (no body text between them)
+  // and at the same font size. This joins multi-line titles that wrap in the PDF.
+  const mergedHeadings = [];
+  for (const heading of candidateHeadings) {
+    const prev = mergedHeadings[mergedHeadings.length - 1];
+    if (prev != null && heading.contiguous && Math.abs(prev.fontSize - heading.fontSize) < 0.1) {
+      prev.text += " " + heading.text;
+    } else {
+      mergedHeadings.push({
+        ...heading
+      });
+    }
+  }
+  return mergedHeadings.filter(heading => heading.text.trim().length <= OUTLINE_MAX_HEADING_LENGTH).map(heading => ({
+    title: heading.text.trim(),
+    depth: sizeToDepth.get(heading.fontSize) ?? 0,
+    pageNumber: heading.pageNumber,
+    bold: false,
+    italic: false
+  }));
+}
+//# sourceMappingURL=usePdfOutline.js.map

package/build/esm/pdf-viewer/hooks/usePdfOutline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfOutline.js","names":["useEffect","useState","OUTLINE_HEADING_SIZE_RATIO","OUTLINE_MAX_HEADING_LENGTH","EMPTY_OUTLINE","usePdfOutline","document","outlineItems","setOutlineItems","cancelled","outline","getOutline","length","items","resolveBookmarkOutline","extractHeadingsFromText","resolveItems","nodes","depth","node","pageNumber","dest","getDestination","pageIndex","getPageIndex","Array","isArray","push","title","bold","italic","isTextItem","item","roundFontSize","size","Math","round","getFontSize","height","transform","sqrt","numPages","pageContents","Promise","all","from","_","i","getPage","then","page","getTextContent","sizeCounts","Map","textContent","rawItem","str","trim","fontSize","rounded","set","get","bodySize","maxCount","count","headingThreshold","headingSizes","Set","add","sortedSizes","sort","a","b","sizeToDepth","candidateHeadings","pageIdx","lineItems","linePageNumber","lineFontName","lineHeadingFontSize","lastFlushWasHeading","flushLine","headingChars","totalChars","li","len","text","has","fullText","map","join","fontName","contiguous","isHeadingSized","hasEOL","mergedHeadings","heading","prev","abs","filter"],"sources":["usePdfOutline.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport { useEffect, useState } from \"react\";\nimport {\n  OUTLINE_HEADING_SIZE_RATIO,\n  OUTLINE_MAX_HEADING_LENGTH,\n} from \"../constants.js\";\nimport type { OutlineItem } from \"../types.js\";\n\nconst EMPTY_OUTLINE: OutlineItem[] = [];\n\nexport function usePdfOutline(\n  document: PDFDocumentProxy | undefined,\n): OutlineItem[] {\n  const [outlineItems, setOutlineItems] = useState<OutlineItem[]>(\n    EMPTY_OUTLINE,\n  );\n\n  useEffect(\n    function loadOutline() {\n      if (document == null) {\n        setOutlineItems(EMPTY_OUTLINE);\n        return;\n      }\n\n      let cancelled = false;\n\n      void (async () => {\n        try {\n          // Try embedded bookmarks first\n          const outline = await document.getOutline();\n          if (cancelled) return;\n\n          if (outline != null && outline.length > 0) {\n            const items = await resolveBookmarkOutline(document, outline);\n            if (!cancelled) {\n              setOutlineItems(items);\n            }\n            return;\n          }\n\n          // Fall back to extracting headings from text content\n          const items = await extractHeadingsFromText(document);\n          if (!cancelled) {\n            setOutlineItems(items.length > 0 ? items : EMPTY_OUTLINE);\n          }\n        } catch {\n          // If extraction fails entirely, leave outline empty\n          if (!cancelled) {\n            setOutlineItems(EMPTY_OUTLINE);\n          }\n        }\n      })();\n\n      return () => {\n        cancelled = true;\n      };\n    },\n    [document],\n  );\n\n  return outlineItems;\n}\n\ntype BookmarkNode = Awaited<ReturnType<PDFDocumentProxy[\"getOutline\"]>>[number];\n\nasync function resolveBookmarkOutline(\n  document: PDFDocumentProxy,\n  outline: BookmarkNode[],\n): Promise<OutlineItem[]> {\n  const items: OutlineItem[] = [];\n\n  const resolveItems = async (\n    nodes: BookmarkNode[],\n    depth: number,\n  ): Promise<void> => {\n    for (const node of nodes) {\n      let pageNumber = 1;\n      try {\n        if (typeof node.dest === \"string\") {\n          const dest = await document.getDestination(node.dest);\n          if (dest != null) {\n            const pageIndex = await document.getPageIndex(dest[0]);\n            pageNumber = pageIndex + 1;\n          }\n        } else if (Array.isArray(node.dest) && node.dest.length > 0) {\n          const pageIndex = await document.getPageIndex(node.dest[0]);\n          pageNumber = pageIndex + 1;\n        }\n      } catch {\n        // If destination resolution fails, default to page 1\n      }\n\n      items.push({\n        title: node.title,\n        depth,\n        pageNumber,\n        bold: node.bold,\n        italic: node.italic,\n      });\n\n      if (node.items.length > 0) {\n        await resolveItems(node.items, depth + 1);\n      }\n    }\n  };\n\n  await resolveItems(outline, 0);\n  return items;\n}\n\ninterface RawHeading {\n  text: string;\n  fontSize: number;\n  pageNumber: number;\n  fontName: string;\n  /** True if this heading line immediately followed another heading line (no body text in between). */\n  contiguous: boolean;\n}\n\ninterface TextItemLike {\n  str: string;\n  height: number;\n  fontName: string;\n  transform: number[];\n  hasEOL: boolean;\n}\n\nfunction isTextItem(\n  item: Record<string, unknown>,\n): item is Record<string, unknown> & TextItemLike {\n  return \"str\" in item && \"transform\" in item;\n}\n\nfunction roundFontSize(size: number): number {\n  return Math.round(size * 10) / 10;\n}\n\n/**\n * Extract the font size from a pdfjs TextItem.\n * Prefer `height` when available, otherwise derive from the transform matrix.\n * The transform is [scaleX, skewY, skewX, scaleY, translateX, translateY].\n * Font size = sqrt(skewX² + scaleY²), which handles rotated text too.\n */\nfunction getFontSize(item: TextItemLike): number {\n  if (item.height > 0) {\n    return item.height;\n  }\n  const transform = item.transform;\n  if (Array.isArray(transform) && transform.length >= 4) {\n    return Math.sqrt(\n      (transform[2]) * (transform[2])\n        + (transform[3]) * (transform[3]),\n    );\n  }\n  return 0;\n}\n\nasync function extractHeadingsFromText(\n  document: PDFDocumentProxy,\n): Promise<OutlineItem[]> {\n  const numPages = document.numPages;\n\n  // Fetch all pages' text content in parallel\n  const pageContents = await Promise.all(\n    Array.from(\n      { length: numPages },\n      (_, i) => document.getPage(i + 1).then(page => page.getTextContent()),\n    ),\n  );\n\n  // Collect font size frequencies across all pages\n  const sizeCounts = new Map<number, number>();\n  for (const textContent of pageContents) {\n    for (const rawItem of textContent.items) {\n      const item = rawItem as Record<string, unknown>;\n      if (!isTextItem(item) || item.str.trim().length === 0) {\n        continue;\n      }\n      const fontSize = getFontSize(item);\n      if (fontSize > 0) {\n        const rounded = roundFontSize(fontSize);\n        sizeCounts.set(rounded, (sizeCounts.get(rounded) ?? 0) + 1);\n      }\n    }\n  }\n\n  // Find the most common font size (body text)\n  let bodySize = 0;\n  let maxCount = 0;\n  for (const [size, count] of sizeCounts) {\n    if (count > maxCount) {\n      maxCount = count;\n      bodySize = size;\n    }\n  }\n\n  if (bodySize === 0) {\n    return [];\n  }\n\n  // Heading threshold: text significantly larger than body text\n  const headingThreshold = bodySize * OUTLINE_HEADING_SIZE_RATIO;\n\n  // Collect all unique heading sizes above threshold\n  const headingSizes = new Set<number>();\n  for (const [size] of sizeCounts) {\n    if (size >= headingThreshold) {\n      headingSizes.add(size);\n    }\n  }\n\n  if (headingSizes.size === 0) {\n    return [];\n  }\n\n  // Sort heading sizes descending (largest = depth 0)\n  const sortedSizes = [...headingSizes].sort((a, b) => b - a);\n  const sizeToDepth = new Map<number, number>();\n  for (let i = 0; i < sortedSizes.length; i++) {\n    sizeToDepth.set(sortedSizes[i], i);\n  }\n\n  // Extract headings with page numbers.\n  // pdfjs splits visual lines into multiple TextItems (e.g. \"1.\" and\n  // \"Introduction\" are separate items). We accumulate all items on the\n  // same visual line and treat the line as a heading if most of its\n  // content is at a heading font size.\n  const candidateHeadings: RawHeading[] = [];\n\n  for (let pageIdx = 0; pageIdx < pageContents.length; pageIdx++) {\n    const textContent = pageContents[pageIdx];\n    const pageNumber = pageIdx + 1;\n\n    let lineItems: Array<{ text: string; fontSize: number }> = [];\n    let linePageNumber = pageNumber;\n    let lineFontName = \"\";\n    let lineHeadingFontSize = 0;\n    let lastFlushWasHeading = false;\n\n    const flushLine = (): void => {\n      if (lineItems.length === 0) return;\n\n      // Check if the majority of the line's non-whitespace content is heading-sized\n      let headingChars = 0;\n      let totalChars = 0;\n      for (const li of lineItems) {\n        const len = li.text.trim().length;\n        totalChars += len;\n        if (sizeToDepth.has(roundFontSize(li.fontSize))) {\n          headingChars += len;\n        }\n      }\n\n      if (totalChars > 0 && headingChars / totalChars > 0.5) {\n        const fullText = lineItems.map((li) => li.text).join(\"\").trim();\n        if (fullText.length > 0) {\n          candidateHeadings.push({\n            text: fullText,\n            fontSize: lineHeadingFontSize,\n            pageNumber: linePageNumber,\n            fontName: lineFontName,\n            contiguous: lastFlushWasHeading,\n          });\n        }\n        lastFlushWasHeading = true;\n      } else {\n        lastFlushWasHeading = false;\n      }\n\n      lineItems = [];\n      lineHeadingFontSize = 0;\n    };\n\n    for (const rawItem of textContent.items) {\n      const item = rawItem as Record<string, unknown>;\n      if (!isTextItem(item)) {\n        continue;\n      }\n\n      const fontSize = getFontSize(item);\n      const rounded = roundFontSize(fontSize);\n      const isHeadingSized = sizeToDepth.has(rounded);\n\n      if (isHeadingSized && lineHeadingFontSize === 0) {\n        lineHeadingFontSize = rounded;\n        linePageNumber = pageNumber;\n        lineFontName = item.fontName;\n      }\n\n      if (lineHeadingFontSize > 0) {\n        lineItems.push({ text: item.str, fontSize });\n      }\n\n      if (item.hasEOL) {\n        flushLine();\n      }\n    }\n\n    // Flush remaining items at end of page\n    flushLine();\n  }\n\n  // Merge consecutive heading lines that were contiguous (no body text between them)\n  // and at the same font size. This joins multi-line titles that wrap in the PDF.\n  const mergedHeadings: RawHeading[] = [];\n  for (const heading of candidateHeadings) {\n    const prev = mergedHeadings[mergedHeadings.length - 1];\n    if (\n      prev != null\n      && heading.contiguous\n      && Math.abs(prev.fontSize - heading.fontSize) < 0.1\n    ) {\n      prev.text += \" \" + heading.text;\n    } else {\n      mergedHeadings.push({ ...heading });\n    }\n  }\n\n  return mergedHeadings\n    .filter((heading) =>\n      heading.text.trim().length <= OUTLINE_MAX_HEADING_LENGTH\n    )\n    .map((heading) => ({\n      title: heading.text.trim(),\n      depth: sizeToDepth.get(heading.fontSize) ?? 0,\n      pageNumber: heading.pageNumber,\n      bold: false,\n      italic: false,\n    }));\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/pdf-viewer/hooks/usePdfViewer.js

@@ -16,7 +16,8 @@
 
 import { EventBus, PDFFindController, PDFLinkService, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
 import { useEffect, useRef } from "react";
-export function usePdfViewer(containerRef, viewerRef, document, initialScale) {
+import { PAGES_LOADED_EVENT } from "../constants.js";
+export function usePdfViewer(containerRef, viewerRef, document, initialScale, initialPage) {
   const pdfViewerRef = useRef(null);
   const eventBusRef = useRef(null);
   const findControllerRef = useRef(null);
@@ -50,6 +51,16 @@ export function usePdfViewer(containerRef, viewerRef, document, initialScale) {
     if (initialScale != null) {
       pdfViewer.currentScale = initialScale;
     }
+    if (initialPage != null && initialPage > 1) {
+      const onPagesLoaded = () => {
+        pdfViewer.currentPageNumber = initialPage;
+        pdfViewer.scrollPageIntoView({
+          pageNumber: initialPage
+        });
+        eventBus.off(PAGES_LOADED_EVENT, onPagesLoaded);
+      };
+      eventBus.on(PAGES_LOADED_EVENT, onPagesLoaded);
+    }
     eventBusRef.current = eventBus;
     findControllerRef.current = findController;
     pdfViewerRef.current = pdfViewer;

package/build/esm/pdf-viewer/hooks/usePdfViewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePdfViewer.js","names":["EventBus","PDFFindController","PDFLinkService","PDFViewer","useEffect","useRef","usePdfViewer","containerRef","viewerRef","document","initialScale","pdfViewerRef","eventBusRef","findControllerRef","container","current","viewer","eventBus","linkService","findController","updateMatchesCountOnProgress","pdfViewer","removePageBorders","setViewer","setDocument","currentScale","cleanup"],"sources":["usePdfViewer.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport {\n  EventBus,\n  PDFFindController,\n  PDFLinkService,\n  PDFViewer,\n} from \"pdfjs-dist/web/pdf_viewer.mjs\";\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\n\nexport interface UsePdfViewerResult {\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  eventBusRef: RefObject<EventBus | null>;\n  findControllerRef: RefObject<PDFFindController | null>;\n}\n\nexport function usePdfViewer(\n  containerRef: RefObject<HTMLDivElement | null>,\n  viewerRef: RefObject<HTMLDivElement | null>,\n  document: PDFDocumentProxy | undefined,\n  initialScale?: number,\n): UsePdfViewerResult {\n  const pdfViewerRef = useRef<PDFViewer | null>(null);\n  const eventBusRef = useRef<EventBus | null>(null);\n  const findControllerRef = useRef<PDFFindController | null>(null);\n\n  useEffect(function initializePdfViewer() {\n    const container = containerRef.current;\n    const viewer = viewerRef.current;\n    if (container == null || viewer == null || document == null) {\n      return;\n    }\n\n    const eventBus = new EventBus();\n    const linkService = new PDFLinkService({ eventBus });\n    const findController = new PDFFindController({\n      linkService,\n      eventBus,\n      updateMatchesCountOnProgress: true,\n    });\n\n    const pdfViewer = new PDFViewer({\n      container,\n      viewer,\n      eventBus,\n      linkService,\n      findController,\n      removePageBorders: true,\n    });\n\n    linkService.setViewer(pdfViewer);\n    linkService.setDocument(document);\n    findController.setDocument(document);\n    pdfViewer.setDocument(document);\n\n    if (initialScale != null) {\n      pdfViewer.currentScale = initialScale;\n    }\n\n    eventBusRef.current = eventBus;\n    findControllerRef.current = findController;\n    pdfViewerRef.current = pdfViewer;\n\n    return () => {\n      pdfViewerRef.current = null;\n      eventBusRef.current = null;\n      findControllerRef.current = null;\n      pdfViewer.cleanup();\n    };\n  }, [containerRef, viewerRef, document]);\n\n  return { pdfViewerRef, eventBusRef, findControllerRef };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SACEA,QAAQ,EACRC,iBAAiB,EACjBC,cAAc,EACdC,SAAS,QACJ,+BAA+B;AAEtC,SAASC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AAQzC,OAAO,SAASC,YAAYA,CAC1BC,YAA8C,EAC9CC,SAA2C,EAC3CC,QAAsC,EACtCC,YAAqB,EACD;EACpB,MAAMC,YAAY,GAAGN,MAAM,CAAmB,IAAI,CAAC;EACnD,MAAMO,WAAW,GAAGP,MAAM,CAAkB,IAAI,CAAC;EACjD,MAAMQ,iBAAiB,GAAGR,MAAM,CAA2B,IAAI,CAAC;EAEhED,SAAS,CAAC,YAA+B;IACvC,MAAMU,SAAS,GAAGP,YAAY,CAACQ,OAAO;IACtC,MAAMC,MAAM,GAAGR,SAAS,CAACO,OAAO;IAChC,IAAID,SAAS,IAAI,IAAI,IAAIE,MAAM,IAAI,IAAI,IAAIP,QAAQ,IAAI,IAAI,EAAE;MAC3D;IACF;IAEA,MAAMQ,QAAQ,GAAG,IAAIjB,QAAQ,CAAC,CAAC;IAC/B,MAAMkB,WAAW,GAAG,IAAIhB,cAAc,CAAC;MAAEe;IAAS,CAAC,CAAC;IACpD,MAAME,cAAc,GAAG,IAAIlB,iBAAiB,CAAC;MAC3CiB,WAAW;MACXD,QAAQ;MACRG,4BAA4B,EAAE;IAChC,CAAC,CAAC;IAEF,MAAMC,SAAS,GAAG,IAAIlB,SAAS,CAAC;MAC9BW,SAAS;MACTE,MAAM;MACNC,QAAQ;MACRC,WAAW;MACXC,cAAc;MACdG,iBAAiB,EAAE;IACrB,CAAC,CAAC;IAEFJ,WAAW,CAACK,SAAS,CAACF,SAAS,CAAC;IAChCH,WAAW,CAACM,WAAW,CAACf,QAAQ,CAAC;IACjCU,cAAc,CAACK,WAAW,CAACf,QAAQ,CAAC;IACpCY,SAAS,CAACG,WAAW,CAACf,QAAQ,CAAC;IAE/B,IAAIC,YAAY,IAAI,IAAI,EAAE;MACxBW,SAAS,CAACI,YAAY,GAAGf,YAAY;IACvC;IAEAE,WAAW,CAACG,OAAO,GAAGE,QAAQ;IAC9BJ,iBAAiB,CAACE,OAAO,GAAGI,cAAc;IAC1CR,YAAY,CAACI,OAAO,GAAGM,SAAS;IAEhC,OAAO,MAAM;MACXV,YAAY,CAACI,OAAO,GAAG,IAAI;MAC3BH,WAAW,CAACG,OAAO,GAAG,IAAI;MAC1BF,iBAAiB,CAACE,OAAO,GAAG,IAAI;MAChCM,SAAS,CAACK,OAAO,CAAC,CAAC;IACrB,CAAC;EACH,CAAC,EAAE,CAACnB,YAAY,EAAEC,SAAS,EAAEC,QAAQ,CAAC,CAAC;EAEvC,OAAO;IAAEE,YAAY;IAAEC,WAAW;IAAEC;EAAkB,CAAC;AACzD","ignoreList":[]}
+{"version":3,"file":"usePdfViewer.js","names":["EventBus","PDFFindController","PDFLinkService","PDFViewer","useEffect","useRef","PAGES_LOADED_EVENT","usePdfViewer","containerRef","viewerRef","document","initialScale","initialPage","pdfViewerRef","eventBusRef","findControllerRef","container","current","viewer","eventBus","linkService","findController","updateMatchesCountOnProgress","pdfViewer","removePageBorders","setViewer","setDocument","currentScale","onPagesLoaded","currentPageNumber","scrollPageIntoView","pageNumber","off","on","cleanup"],"sources":["usePdfViewer.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport {\n  EventBus,\n  PDFFindController,\n  PDFLinkService,\n  PDFViewer,\n} from \"pdfjs-dist/web/pdf_viewer.mjs\";\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\nimport { PAGES_LOADED_EVENT } from \"../constants.js\";\n\nexport interface UsePdfViewerResult {\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  eventBusRef: RefObject<EventBus | null>;\n  findControllerRef: RefObject<PDFFindController | null>;\n}\n\nexport function usePdfViewer(\n  containerRef: RefObject<HTMLDivElement | null>,\n  viewerRef: RefObject<HTMLDivElement | null>,\n  document: PDFDocumentProxy | undefined,\n  initialScale?: number,\n  initialPage?: number,\n): UsePdfViewerResult {\n  const pdfViewerRef = useRef<PDFViewer | null>(null);\n  const eventBusRef = useRef<EventBus | null>(null);\n  const findControllerRef = useRef<PDFFindController | null>(null);\n\n  useEffect(function initializePdfViewer() {\n    const container = containerRef.current;\n    const viewer = viewerRef.current;\n    if (container == null || viewer == null || document == null) {\n      return;\n    }\n\n    const eventBus = new EventBus();\n    const linkService = new PDFLinkService({ eventBus });\n    const findController = new PDFFindController({\n      linkService,\n      eventBus,\n      updateMatchesCountOnProgress: true,\n    });\n\n    const pdfViewer = new PDFViewer({\n      container,\n      viewer,\n      eventBus,\n      linkService,\n      findController,\n      removePageBorders: true,\n    });\n\n    linkService.setViewer(pdfViewer);\n    linkService.setDocument(document);\n    findController.setDocument(document);\n    pdfViewer.setDocument(document);\n\n    if (initialScale != null) {\n      pdfViewer.currentScale = initialScale;\n    }\n\n    if (initialPage != null && initialPage > 1) {\n      const onPagesLoaded = () => {\n        pdfViewer.currentPageNumber = initialPage;\n        pdfViewer.scrollPageIntoView({ pageNumber: initialPage });\n        eventBus.off(PAGES_LOADED_EVENT, onPagesLoaded);\n      };\n      eventBus.on(PAGES_LOADED_EVENT, onPagesLoaded);\n    }\n\n    eventBusRef.current = eventBus;\n    findControllerRef.current = findController;\n    pdfViewerRef.current = pdfViewer;\n\n    return () => {\n      pdfViewerRef.current = null;\n      eventBusRef.current = null;\n      findControllerRef.current = null;\n      pdfViewer.cleanup();\n    };\n  }, [containerRef, viewerRef, document]);\n\n  return { pdfViewerRef, eventBusRef, findControllerRef };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SACEA,QAAQ,EACRC,iBAAiB,EACjBC,cAAc,EACdC,SAAS,QACJ,+BAA+B;AAEtC,SAASC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAASC,kBAAkB,QAAQ,iBAAiB;AAQpD,OAAO,SAASC,YAAYA,CAC1BC,YAA8C,EAC9CC,SAA2C,EAC3CC,QAAsC,EACtCC,YAAqB,EACrBC,WAAoB,EACA;EACpB,MAAMC,YAAY,GAAGR,MAAM,CAAmB,IAAI,CAAC;EACnD,MAAMS,WAAW,GAAGT,MAAM,CAAkB,IAAI,CAAC;EACjD,MAAMU,iBAAiB,GAAGV,MAAM,CAA2B,IAAI,CAAC;EAEhED,SAAS,CAAC,YAA+B;IACvC,MAAMY,SAAS,GAAGR,YAAY,CAACS,OAAO;IACtC,MAAMC,MAAM,GAAGT,SAAS,CAACQ,OAAO;IAChC,IAAID,SAAS,IAAI,IAAI,IAAIE,MAAM,IAAI,IAAI,IAAIR,QAAQ,IAAI,IAAI,EAAE;MAC3D;IACF;IAEA,MAAMS,QAAQ,GAAG,IAAInB,QAAQ,CAAC,CAAC;IAC/B,MAAMoB,WAAW,GAAG,IAAIlB,cAAc,CAAC;MAAEiB;IAAS,CAAC,CAAC;IACpD,MAAME,cAAc,GAAG,IAAIpB,iBAAiB,CAAC;MAC3CmB,WAAW;MACXD,QAAQ;MACRG,4BAA4B,EAAE;IAChC,CAAC,CAAC;IAEF,MAAMC,SAAS,GAAG,IAAIpB,SAAS,CAAC;MAC9Ba,SAAS;MACTE,MAAM;MACNC,QAAQ;MACRC,WAAW;MACXC,cAAc;MACdG,iBAAiB,EAAE;IACrB,CAAC,CAAC;IAEFJ,WAAW,CAACK,SAAS,CAACF,SAAS,CAAC;IAChCH,WAAW,CAACM,WAAW,CAAChB,QAAQ,CAAC;IACjCW,cAAc,CAACK,WAAW,CAAChB,QAAQ,CAAC;IACpCa,SAAS,CAACG,WAAW,CAAChB,QAAQ,CAAC;IAE/B,IAAIC,YAAY,IAAI,IAAI,EAAE;MACxBY,SAAS,CAACI,YAAY,GAAGhB,YAAY;IACvC;IAEA,IAAIC,WAAW,IAAI,IAAI,IAAIA,WAAW,GAAG,CAAC,EAAE;MAC1C,MAAMgB,aAAa,GAAGA,CAAA,KAAM;QAC1BL,SAAS,CAACM,iBAAiB,GAAGjB,WAAW;QACzCW,SAAS,CAACO,kBAAkB,CAAC;UAAEC,UAAU,EAAEnB;QAAY,CAAC,CAAC;QACzDO,QAAQ,CAACa,GAAG,CAAC1B,kBAAkB,EAAEsB,aAAa,CAAC;MACjD,CAAC;MACDT,QAAQ,CAACc,EAAE,CAAC3B,kBAAkB,EAAEsB,aAAa,CAAC;IAChD;IAEAd,WAAW,CAACG,OAAO,GAAGE,QAAQ;IAC9BJ,iBAAiB,CAACE,OAAO,GAAGI,cAAc;IAC1CR,YAAY,CAACI,OAAO,GAAGM,SAAS;IAEhC,OAAO,MAAM;MACXV,YAAY,CAACI,OAAO,GAAG,IAAI;MAC3BH,WAAW,CAACG,OAAO,GAAG,IAAI;MAC1BF,iBAAiB,CAACE,OAAO,GAAG,IAAI;MAChCM,SAAS,CAACW,OAAO,CAAC,CAAC;IACrB,CAAC;EACH,CAAC,EAAE,CAAC1B,YAAY,EAAEC,SAAS,EAAEC,QAAQ,CAAC,CAAC;EAEvC,OAAO;IAAEG,YAAY;IAAEC,WAAW;IAAEC;EAAkB,CAAC;AACzD","ignoreList":[]}

package/build/esm/pdf-viewer/hooks/usePdfViewerCore.js

@@ -0,0 +1,80 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useCallback, useRef, useState } from "react";
+import { usePdfAnnotationPortals } from "./usePdfAnnotationPortals.js";
+import { usePdfDocument } from "./usePdfDocument.js";
+import { usePdfViewer } from "./usePdfViewer.js";
+import { usePdfViewerSync } from "./usePdfViewerSync.js";
+export function usePdfViewerCore({
+  src,
+  initialPage = 1,
+  initialScale = 1.0
+}) {
+  const {
+    document,
+    numPages,
+    loading,
+    error
+  } = usePdfDocument(src);
+  const [scale, setScale] = useState(initialScale);
+  const [currentPage, setCurrentPage] = useState(initialPage);
+  const containerRef = useRef(null);
+  const viewerRef = useRef(null);
+  const {
+    pdfViewerRef,
+    eventBusRef,
+    findControllerRef
+  } = usePdfViewer(containerRef, viewerRef, document, initialScale, initialPage);
+  const handleScaleChange = useCallback(newScale => {
+    setScale(newScale);
+  }, []);
+  const handlePageChange = useCallback(page => {
+    setCurrentPage(page);
+  }, []);
+  const {
+    scrollToPage: syncScrollToPage
+  } = usePdfViewerSync({
+    pdfViewerRef,
+    eventBusRef,
+    document,
+    scale,
+    onScaleChange: handleScaleChange,
+    onPageChange: handlePageChange
+  });
+  const scrollToPage = useCallback(page => {
+    setCurrentPage(page);
+    syncScrollToPage(page);
+  }, [syncScrollToPage]);
+  const portalTargets = usePdfAnnotationPortals(pdfViewerRef, eventBusRef, document);
+  return {
+    document,
+    numPages,
+    loading,
+    error,
+    containerRef,
+    viewerRef,
+    currentPage,
+    scrollToPage,
+    scale,
+    setScale,
+    portalTargets,
+    pdfViewerRef,
+    eventBusRef,
+    findControllerRef
+  };
+}
+//# sourceMappingURL=usePdfViewerCore.js.map

package/build/esm/pdf-viewer/hooks/usePdfViewerCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfViewerCore.js","names":["useCallback","useRef","useState","usePdfAnnotationPortals","usePdfDocument","usePdfViewer","usePdfViewerSync","usePdfViewerCore","src","initialPage","initialScale","document","numPages","loading","error","scale","setScale","currentPage","setCurrentPage","containerRef","viewerRef","pdfViewerRef","eventBusRef","findControllerRef","handleScaleChange","newScale","handlePageChange","page","scrollToPage","syncScrollToPage","onScaleChange","onPageChange","portalTargets"],"sources":["usePdfViewerCore.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport type {\n  EventBus,\n  PDFFindController,\n  PDFViewer,\n} from \"pdfjs-dist/web/pdf_viewer.mjs\";\nimport type { RefObject } from \"react\";\nimport { useCallback, useRef, useState } from \"react\";\nimport type { AnnotationPortalTarget } from \"./usePdfAnnotationPortals.js\";\nimport { usePdfAnnotationPortals } from \"./usePdfAnnotationPortals.js\";\nimport { usePdfDocument } from \"./usePdfDocument.js\";\nimport { usePdfViewer } from \"./usePdfViewer.js\";\nimport { usePdfViewerSync } from \"./usePdfViewerSync.js\";\n\nexport interface UsePdfViewerCoreOptions {\n  /** PDF source — URL string or ArrayBuffer */\n  src: string | ArrayBuffer;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n}\n\nexport interface UsePdfViewerCoreResult {\n  /** The loaded PDF document, or undefined while loading */\n  document: PDFDocumentProxy | undefined;\n  /** Total number of pages in the document */\n  numPages: number;\n  /** Whether the document is currently loading */\n  loading: boolean;\n  /** Error encountered while loading the document */\n  error: Error | undefined;\n\n  /** Ref to attach to the scroll-container div */\n  containerRef: RefObject<HTMLDivElement>;\n  /** Ref to attach to the inner viewer div (className=\"pdfViewer\") */\n  viewerRef: RefObject<HTMLDivElement>;\n\n  /** Current page number (1-indexed) */\n  currentPage: number;\n  /** Navigate to a specific page (updates state and scrolls the viewer) */\n  scrollToPage: (page: number) => void;\n\n  /** Current zoom scale */\n  scale: number;\n  /** Set the zoom scale directly */\n  setScale: (scale: number) => void;\n\n  /** Portal targets for rendering annotation overlays on each page */\n  portalTargets: AnnotationPortalTarget[];\n\n  /** Ref to the internal pdfjs PDFViewer instance */\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  /** Ref to the internal pdfjs EventBus instance */\n  eventBusRef: RefObject<EventBus | null>;\n  /** Ref to the internal pdfjs PDFFindController instance */\n  findControllerRef: RefObject<PDFFindController | null>;\n}\n\nexport function usePdfViewerCore({\n  src,\n  initialPage = 1,\n  initialScale = 1.0,\n}: UsePdfViewerCoreOptions): UsePdfViewerCoreResult {\n  const { document, numPages, loading, error } = usePdfDocument(src);\n  const [scale, setScale] = useState(initialScale);\n  const [currentPage, setCurrentPage] = useState(initialPage);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const viewerRef = useRef<HTMLDivElement>(null);\n\n  const { pdfViewerRef, eventBusRef, findControllerRef } = usePdfViewer(\n    containerRef,\n    viewerRef,\n    document,\n    initialScale,\n    initialPage,\n  );\n\n  const handleScaleChange = useCallback((newScale: number) => {\n    setScale(newScale);\n  }, []);\n\n  const handlePageChange = useCallback((page: number) => {\n    setCurrentPage(page);\n  }, []);\n\n  const { scrollToPage: syncScrollToPage } = usePdfViewerSync({\n    pdfViewerRef,\n    eventBusRef,\n    document,\n    scale,\n    onScaleChange: handleScaleChange,\n    onPageChange: handlePageChange,\n  });\n\n  const scrollToPage = useCallback(\n    (page: number) => {\n      setCurrentPage(page);\n      syncScrollToPage(page);\n    },\n    [syncScrollToPage],\n  );\n\n  const portalTargets = usePdfAnnotationPortals(\n    pdfViewerRef,\n    eventBusRef,\n    document,\n  );\n\n  return {\n    document,\n    numPages,\n    loading,\n    error,\n    containerRef,\n    viewerRef,\n    currentPage,\n    scrollToPage,\n    scale,\n    setScale,\n    portalTargets,\n    pdfViewerRef,\n    eventBusRef,\n    findControllerRef,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,SAASA,WAAW,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAErD,SAASC,uBAAuB,QAAQ,8BAA8B;AACtE,SAASC,cAAc,QAAQ,qBAAqB;AACpD,SAASC,YAAY,QAAQ,mBAAmB;AAChD,SAASC,gBAAgB,QAAQ,uBAAuB;AA+CxD,OAAO,SAASC,gBAAgBA,CAAC;EAC/BC,GAAG;EACHC,WAAW,GAAG,CAAC;EACfC,YAAY,GAAG;AACQ,CAAC,EAA0B;EAClD,MAAM;IAAEC,QAAQ;IAAEC,QAAQ;IAAEC,OAAO;IAAEC;EAAM,CAAC,GAAGV,cAAc,CAACI,GAAG,CAAC;EAClE,MAAM,CAACO,KAAK,EAAEC,QAAQ,CAAC,GAAGd,QAAQ,CAACQ,YAAY,CAAC;EAChD,MAAM,CAACO,WAAW,EAAEC,cAAc,CAAC,GAAGhB,QAAQ,CAACO,WAAW,CAAC;EAC3D,MAAMU,YAAY,GAAGlB,MAAM,CAAiB,IAAI,CAAC;EACjD,MAAMmB,SAAS,GAAGnB,MAAM,CAAiB,IAAI,CAAC;EAE9C,MAAM;IAAEoB,YAAY;IAAEC,WAAW;IAAEC;EAAkB,CAAC,GAAGlB,YAAY,CACnEc,YAAY,EACZC,SAAS,EACTT,QAAQ,EACRD,YAAY,EACZD,WACF,CAAC;EAED,MAAMe,iBAAiB,GAAGxB,WAAW,CAAEyB,QAAgB,IAAK;IAC1DT,QAAQ,CAACS,QAAQ,CAAC;EACpB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,gBAAgB,GAAG1B,WAAW,CAAE2B,IAAY,IAAK;IACrDT,cAAc,CAACS,IAAI,CAAC;EACtB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAM;IAAEC,YAAY,EAAEC;EAAiB,CAAC,GAAGvB,gBAAgB,CAAC;IAC1De,YAAY;IACZC,WAAW;IACXX,QAAQ;IACRI,KAAK;IACLe,aAAa,EAAEN,iBAAiB;IAChCO,YAAY,EAAEL;EAChB,CAAC,CAAC;EAEF,MAAME,YAAY,GAAG5B,WAAW,CAC7B2B,IAAY,IAAK;IAChBT,cAAc,CAACS,IAAI,CAAC;IACpBE,gBAAgB,CAACF,IAAI,CAAC;EACxB,CAAC,EACD,CAACE,gBAAgB,CACnB,CAAC;EAED,MAAMG,aAAa,GAAG7B,uBAAuB,CAC3CkB,YAAY,EACZC,WAAW,EACXX,QACF,CAAC;EAED,OAAO;IACLA,QAAQ;IACRC,QAAQ;IACRC,OAAO;IACPC,KAAK;IACLK,YAAY;IACZC,SAAS;IACTH,WAAW;IACXW,YAAY;IACZb,KAAK;IACLC,QAAQ;IACRgB,aAAa;IACbX,YAAY;IACZC,WAAW;IACXC;EACF,CAAC;AACH","ignoreList":[]}

package/build/esm/pdf-viewer/hooks/usePdfViewerState.js

@@ -0,0 +1,135 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { useCallback, useEffect, useState } from "react";
+import { MAX_SCALE, MIN_SCALE, SCALE_STEP } from "../constants.js";
+import { usePdfOutline } from "./usePdfOutline.js";
+import { usePdfViewerCore } from "./usePdfViewerCore.js";
+import { usePdfViewerSearch } from "./usePdfViewerSearch.js";
+export function usePdfViewerState({
+  src,
+  initialPage,
+  initialScale,
+  initialSidebarOpen = false,
+  sidebarMode: sidebarModeProp = "thumbnails",
+  onDownload
+}) {
+  const core = usePdfViewerCore({
+    src,
+    initialPage,
+    initialScale
+  });
+  const [rotation, setRotation] = useState(0);
+  const [sidebarOpen, setSidebarOpen] = useState(initialSidebarOpen);
+  const [sidebarMode, setSidebarMode] = useState(sidebarModeProp);
+  const search = usePdfViewerSearch(core.eventBusRef, core.findControllerRef, core.document);
+  const outlineItems = usePdfOutline(core.document);
+
+  // Sync sidebarMode prop changes to state
+  useEffect(function () {
+    setSidebarMode(sidebarModeProp);
+  }, [sidebarModeProp]);
+
+  // Sync rotation → PDFViewer
+  useEffect(function () {
+    const pdfViewer = core.pdfViewerRef.current;
+    if (pdfViewer != null) {
+      pdfViewer.pagesRotation = rotation;
+    }
+  }, [core.pdfViewerRef, rotation]);
+
+  // Ctrl+F keyboard shortcut
+  useEffect(function () {
+    const handleKeyDown = e => {
+      if ((e.ctrlKey || e.metaKey) && e.key === "f") {
+        e.preventDefault();
+        search.openSearch();
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [search.openSearch]);
+  const zoomIn = useCallback(() => {
+    core.setScale(Math.min(core.scale + SCALE_STEP, MAX_SCALE));
+  }, [core.scale, core.setScale]);
+  const zoomOut = useCallback(() => {
+    core.setScale(Math.max(core.scale - SCALE_STEP, MIN_SCALE));
+  }, [core.scale, core.setScale]);
+  const rotateLeft = useCallback(() => {
+    setRotation(prev => (prev - 90 + 360) % 360);
+  }, []);
+  const rotateRight = useCallback(() => {
+    setRotation(prev => (prev + 90) % 360);
+  }, []);
+  const toggleSidebar = useCallback(() => {
+    setSidebarOpen(prev => !prev);
+  }, []);
+  const download = useCallback(filename => {
+    if (core.document == null) {
+      return;
+    }
+    void core.document.getData().then(data => {
+      const blob = new Blob([data.buffer], {
+        type: "application/pdf"
+      });
+      const url = URL.createObjectURL(blob);
+      const resolvedFilename = resolveDownloadFilename(src, filename);
+      const a = globalThis.document.createElement("a");
+      a.href = url;
+      a.download = resolvedFilename;
+      a.click();
+      URL.revokeObjectURL(url);
+      onDownload?.({
+        success: true,
+        filename: resolvedFilename
+      });
+    }).catch(err => {
+      onDownload?.({
+        success: false,
+        error: err instanceof Error ? err : new Error("Failed to download PDF")
+      });
+    });
+  }, [core.document, src, onDownload]);
+  return {
+    ...core,
+    zoomIn,
+    zoomOut,
+    rotation,
+    rotateLeft,
+    rotateRight,
+    sidebarOpen,
+    sidebarMode,
+    setSidebarMode,
+    toggleSidebar,
+    search,
+    outlineItems,
+    download
+  };
+}
+
+/** Derive a download filename from an explicit name, the src URL, or a fallback. */
+function resolveDownloadFilename(src, filename) {
+  if (filename != null) {
+    return filename;
+  }
+  if (typeof src === "string") {
+    return src.split("/").pop()?.split("?")[0] || "document.pdf";
+  }
+  return "document.pdf";
+}
+//# sourceMappingURL=usePdfViewerState.js.map

package/build/esm/pdf-viewer/hooks/usePdfViewerState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfViewerState.js","names":["useCallback","useEffect","useState","MAX_SCALE","MIN_SCALE","SCALE_STEP","usePdfOutline","usePdfViewerCore","usePdfViewerSearch","usePdfViewerState","src","initialPage","initialScale","initialSidebarOpen","sidebarMode","sidebarModeProp","onDownload","core","rotation","setRotation","sidebarOpen","setSidebarOpen","setSidebarMode","search","eventBusRef","findControllerRef","document","outlineItems","pdfViewer","pdfViewerRef","current","pagesRotation","handleKeyDown","e","ctrlKey","metaKey","key","preventDefault","openSearch","window","addEventListener","removeEventListener","zoomIn","setScale","Math","min","scale","zoomOut","max","rotateLeft","prev","rotateRight","toggleSidebar","download","filename","getData","then","data","blob","Blob","buffer","type","url","URL","createObjectURL","resolvedFilename","resolveDownloadFilename","a","globalThis","createElement","href","click","revokeObjectURL","success","catch","err","error","Error","split","pop"],"sources":["usePdfViewerState.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useCallback, useEffect, useState } from \"react\";\nimport { MAX_SCALE, MIN_SCALE, SCALE_STEP } from \"../constants.js\";\nimport type { PdfDownloadResult, SidebarMode } from \"../types.js\";\nimport { usePdfOutline } from \"./usePdfOutline.js\";\nimport type {\n  UsePdfViewerCoreOptions,\n  UsePdfViewerCoreResult,\n} from \"./usePdfViewerCore.js\";\nimport { usePdfViewerCore } from \"./usePdfViewerCore.js\";\nimport type { UsePdfViewerSearchResult } from \"./usePdfViewerSearch.js\";\nimport { usePdfViewerSearch } from \"./usePdfViewerSearch.js\";\n\nexport interface UsePdfViewerStateOptions extends UsePdfViewerCoreOptions {\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /** Which sidebar panel to show (default \"thumbnails\") */\n  sidebarMode?: SidebarMode;\n  /** Callback fired when a download completes or fails */\n  onDownload?: (result: PdfDownloadResult) => void;\n}\n\nexport interface UsePdfViewerStateResult extends UsePdfViewerCoreResult {\n  /** Zoom in by one step */\n  zoomIn: () => void;\n  /** Zoom out by one step */\n  zoomOut: () => void;\n\n  /** Current rotation in degrees (0, 90, 180, 270) */\n  rotation: number;\n  /** Rotate 90 degrees counter-clockwise */\n  rotateLeft: () => void;\n  /** Rotate 90 degrees clockwise */\n  rotateRight: () => void;\n\n  /** Whether the sidebar panel is open */\n  sidebarOpen: boolean;\n  /** Which sidebar panel is active */\n  sidebarMode: SidebarMode;\n  /** Change the active sidebar panel */\n  setSidebarMode: (mode: SidebarMode) => void;\n  /** Toggle sidebar open/closed */\n  toggleSidebar: () => void;\n\n  /** Search state and actions */\n  search: UsePdfViewerSearchResult;\n\n  /** Document outline items (from bookmarks or text extraction) */\n  outlineItems: ReturnType<typeof usePdfOutline>;\n\n  /** Download the PDF as a file */\n  download: (filename?: string) => void;\n}\n\nexport function usePdfViewerState({\n  src,\n  initialPage,\n  initialScale,\n  initialSidebarOpen = false,\n  sidebarMode: sidebarModeProp = \"thumbnails\",\n  onDownload,\n}: UsePdfViewerStateOptions): UsePdfViewerStateResult {\n  const core = usePdfViewerCore({ src, initialPage, initialScale });\n\n  const [rotation, setRotation] = useState(0);\n  const [sidebarOpen, setSidebarOpen] = useState(initialSidebarOpen);\n  const [sidebarMode, setSidebarMode] = useState<SidebarMode>(sidebarModeProp);\n\n  const search = usePdfViewerSearch(\n    core.eventBusRef,\n    core.findControllerRef,\n    core.document,\n  );\n\n  const outlineItems = usePdfOutline(core.document);\n\n  // Sync sidebarMode prop changes to state\n  useEffect(function syncSidebarMode() {\n    setSidebarMode(sidebarModeProp);\n  }, [sidebarModeProp]);\n\n  // Sync rotation → PDFViewer\n  useEffect(function syncRotationToViewer() {\n    const pdfViewer = core.pdfViewerRef.current;\n    if (pdfViewer != null) {\n      pdfViewer.pagesRotation = rotation;\n    }\n  }, [core.pdfViewerRef, rotation]);\n\n  // Ctrl+F keyboard shortcut\n  useEffect(function registerSearchShortcut() {\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if ((e.ctrlKey || e.metaKey) && e.key === \"f\") {\n        e.preventDefault();\n        search.openSearch();\n      }\n    };\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", handleKeyDown);\n    };\n  }, [search.openSearch]);\n\n  const zoomIn = useCallback(() => {\n    core.setScale(Math.min(core.scale + SCALE_STEP, MAX_SCALE));\n  }, [core.scale, core.setScale]);\n\n  const zoomOut = useCallback(() => {\n    core.setScale(Math.max(core.scale - SCALE_STEP, MIN_SCALE));\n  }, [core.scale, core.setScale]);\n\n  const rotateLeft = useCallback(() => {\n    setRotation((prev) => (prev - 90 + 360) % 360);\n  }, []);\n\n  const rotateRight = useCallback(() => {\n    setRotation((prev) => (prev + 90) % 360);\n  }, []);\n\n  const toggleSidebar = useCallback(() => {\n    setSidebarOpen((prev) => !prev);\n  }, []);\n\n  const download = useCallback((filename?: string) => {\n    if (core.document == null) {\n      return;\n    }\n    void core.document.getData().then((data) => {\n      const blob = new Blob([data.buffer as ArrayBuffer], {\n        type: \"application/pdf\",\n      });\n      const url = URL.createObjectURL(blob);\n      const resolvedFilename = resolveDownloadFilename(src, filename);\n      const a = globalThis.document.createElement(\"a\");\n      a.href = url;\n      a.download = resolvedFilename;\n      a.click();\n      URL.revokeObjectURL(url);\n      onDownload?.({ success: true, filename: resolvedFilename });\n    }).catch((err: unknown) => {\n      onDownload?.({\n        success: false,\n        error: err instanceof Error\n          ? err\n          : new Error(\"Failed to download PDF\"),\n      });\n    });\n  }, [core.document, src, onDownload]);\n\n  return {\n    ...core,\n    zoomIn,\n    zoomOut,\n    rotation,\n    rotateLeft,\n    rotateRight,\n    sidebarOpen,\n    sidebarMode,\n    setSidebarMode,\n    toggleSidebar,\n    search,\n    outlineItems,\n    download,\n  };\n}\n\n/** Derive a download filename from an explicit name, the src URL, or a fallback. */\nfunction resolveDownloadFilename(\n  src: string | ArrayBuffer,\n  filename: string | undefined,\n): string {\n  if (filename != null) {\n    return filename;\n  }\n  if (typeof src === \"string\") {\n    return src.split(\"/\").pop()?.split(\"?\")[0] || \"document.pdf\";\n  }\n  return \"document.pdf\";\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AACxD,SAASC,SAAS,EAAEC,SAAS,EAAEC,UAAU,QAAQ,iBAAiB;AAElE,SAASC,aAAa,QAAQ,oBAAoB;AAKlD,SAASC,gBAAgB,QAAQ,uBAAuB;AAExD,SAASC,kBAAkB,QAAQ,yBAAyB;AA2C5D,OAAO,SAASC,iBAAiBA,CAAC;EAChCC,GAAG;EACHC,WAAW;EACXC,YAAY;EACZC,kBAAkB,GAAG,KAAK;EAC1BC,WAAW,EAAEC,eAAe,GAAG,YAAY;EAC3CC;AACwB,CAAC,EAA2B;EACpD,MAAMC,IAAI,GAAGV,gBAAgB,CAAC;IAAEG,GAAG;IAAEC,WAAW;IAAEC;EAAa,CAAC,CAAC;EAEjE,MAAM,CAACM,QAAQ,EAAEC,WAAW,CAAC,GAAGjB,QAAQ,CAAC,CAAC,CAAC;EAC3C,MAAM,CAACkB,WAAW,EAAEC,cAAc,CAAC,GAAGnB,QAAQ,CAACW,kBAAkB,CAAC;EAClE,MAAM,CAACC,WAAW,EAAEQ,cAAc,CAAC,GAAGpB,QAAQ,CAAca,eAAe,CAAC;EAE5E,MAAMQ,MAAM,GAAGf,kBAAkB,CAC/BS,IAAI,CAACO,WAAW,EAChBP,IAAI,CAACQ,iBAAiB,EACtBR,IAAI,CAACS,QACP,CAAC;EAED,MAAMC,YAAY,GAAGrB,aAAa,CAACW,IAAI,CAACS,QAAQ,CAAC;;EAEjD;EACAzB,SAAS,CAAC,YAA2B;IACnCqB,cAAc,CAACP,eAAe,CAAC;EACjC,CAAC,EAAE,CAACA,eAAe,CAAC,CAAC;;EAErB;EACAd,SAAS,CAAC,YAAgC;IACxC,MAAM2B,SAAS,GAAGX,IAAI,CAACY,YAAY,CAACC,OAAO;IAC3C,IAAIF,SAAS,IAAI,IAAI,EAAE;MACrBA,SAAS,CAACG,aAAa,GAAGb,QAAQ;IACpC;EACF,CAAC,EAAE,CAACD,IAAI,CAACY,YAAY,EAAEX,QAAQ,CAAC,CAAC;;EAEjC;EACAjB,SAAS,CAAC,YAAkC;IAC1C,MAAM+B,aAAa,GAAIC,CAAgB,IAAK;MAC1C,IAAI,CAACA,CAAC,CAACC,OAAO,IAAID,CAAC,CAACE,OAAO,KAAKF,CAAC,CAACG,GAAG,KAAK,GAAG,EAAE;QAC7CH,CAAC,CAACI,cAAc,CAAC,CAAC;QAClBd,MAAM,CAACe,UAAU,CAAC,CAAC;MACrB;IACF,CAAC;IACDC,MAAM,CAACC,gBAAgB,CAAC,SAAS,EAAER,aAAa,CAAC;IACjD,OAAO,MAAM;MACXO,MAAM,CAACE,mBAAmB,CAAC,SAAS,EAAET,aAAa,CAAC;IACtD,CAAC;EACH,CAAC,EAAE,CAACT,MAAM,CAACe,UAAU,CAAC,CAAC;EAEvB,MAAMI,MAAM,GAAG1C,WAAW,CAAC,MAAM;IAC/BiB,IAAI,CAAC0B,QAAQ,CAACC,IAAI,CAACC,GAAG,CAAC5B,IAAI,CAAC6B,KAAK,GAAGzC,UAAU,EAAEF,SAAS,CAAC,CAAC;EAC7D,CAAC,EAAE,CAACc,IAAI,CAAC6B,KAAK,EAAE7B,IAAI,CAAC0B,QAAQ,CAAC,CAAC;EAE/B,MAAMI,OAAO,GAAG/C,WAAW,CAAC,MAAM;IAChCiB,IAAI,CAAC0B,QAAQ,CAACC,IAAI,CAACI,GAAG,CAAC/B,IAAI,CAAC6B,KAAK,GAAGzC,UAAU,EAAED,SAAS,CAAC,CAAC;EAC7D,CAAC,EAAE,CAACa,IAAI,CAAC6B,KAAK,EAAE7B,IAAI,CAAC0B,QAAQ,CAAC,CAAC;EAE/B,MAAMM,UAAU,GAAGjD,WAAW,CAAC,MAAM;IACnCmB,WAAW,CAAE+B,IAAI,IAAK,CAACA,IAAI,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,CAAC;EAChD,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,WAAW,GAAGnD,WAAW,CAAC,MAAM;IACpCmB,WAAW,CAAE+B,IAAI,IAAK,CAACA,IAAI,GAAG,EAAE,IAAI,GAAG,CAAC;EAC1C,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,aAAa,GAAGpD,WAAW,CAAC,MAAM;IACtCqB,cAAc,CAAE6B,IAAI,IAAK,CAACA,IAAI,CAAC;EACjC,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMG,QAAQ,GAAGrD,WAAW,CAAEsD,QAAiB,IAAK;IAClD,IAAIrC,IAAI,CAACS,QAAQ,IAAI,IAAI,EAAE;MACzB;IACF;IACA,KAAKT,IAAI,CAACS,QAAQ,CAAC6B,OAAO,CAAC,CAAC,CAACC,IAAI,CAAEC,IAAI,IAAK;MAC1C,MAAMC,IAAI,GAAG,IAAIC,IAAI,CAAC,CAACF,IAAI,CAACG,MAAM,CAAgB,EAAE;QAClDC,IAAI,EAAE;MACR,CAAC,CAAC;MACF,MAAMC,GAAG,GAAGC,GAAG,CAACC,eAAe,CAACN,IAAI,CAAC;MACrC,MAAMO,gBAAgB,GAAGC,uBAAuB,CAACxD,GAAG,EAAE4C,QAAQ,CAAC;MAC/D,MAAMa,CAAC,GAAGC,UAAU,CAAC1C,QAAQ,CAAC2C,aAAa,CAAC,GAAG,CAAC;MAChDF,CAAC,CAACG,IAAI,GAAGR,GAAG;MACZK,CAAC,CAACd,QAAQ,GAAGY,gBAAgB;MAC7BE,CAAC,CAACI,KAAK,CAAC,CAAC;MACTR,GAAG,CAACS,eAAe,CAACV,GAAG,CAAC;MACxB9C,UAAU,GAAG;QAAEyD,OAAO,EAAE,IAAI;QAAEnB,QAAQ,EAAEW;MAAiB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAACS,KAAK,CAAEC,GAAY,IAAK;MACzB3D,UAAU,GAAG;QACXyD,OAAO,EAAE,KAAK;QACdG,KAAK,EAAED,GAAG,YAAYE,KAAK,GACvBF,GAAG,GACH,IAAIE,KAAK,CAAC,wBAAwB;MACxC,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ,CAAC,EAAE,CAAC5D,IAAI,CAACS,QAAQ,EAAEhB,GAAG,EAAEM,UAAU,CAAC,CAAC;EAEpC,OAAO;IACL,GAAGC,IAAI;IACPyB,MAAM;IACNK,OAAO;IACP7B,QAAQ;IACR+B,UAAU;IACVE,WAAW;IACX/B,WAAW;IACXN,WAAW;IACXQ,cAAc;IACd8B,aAAa;IACb7B,MAAM;IACNI,YAAY;IACZ0B;EACF,CAAC;AACH;;AAEA;AACA,SAASa,uBAAuBA,CAC9BxD,GAAyB,EACzB4C,QAA4B,EACpB;EACR,IAAIA,QAAQ,IAAI,IAAI,EAAE;IACpB,OAAOA,QAAQ;EACjB;EACA,IAAI,OAAO5C,GAAG,KAAK,QAAQ,EAAE;IAC3B,OAAOA,GAAG,CAACoE,KAAK,CAAC,GAAG,CAAC,CAACC,GAAG,CAAC,CAAC,EAAED,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc;EAC9D;EACA,OAAO,cAAc;AACvB","ignoreList":[]}

package/build/esm/pdf-viewer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["types.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/** The visual style of an annotation rendered on the PDF. */\nexport type AnnotationType = \"highlight\" | \"underline\" | \"comment\" | \"pin\";\n\n/** A single annotation positioned on a specific page of the PDF. */\nexport interface PdfAnnotation {\n  /** Unique identifier for this annotation */\n  id: string;\n  /** The type of annotation to render */\n  type: AnnotationType;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Coordinates in PDF points (origin: bottom-left of page) */\n  rect: { x: number; y: number; width: number; height: number };\n  /** Optional label or tooltip text */\n  label?: string;\n  /** Optional color override (CSS color string) */\n  color?: string;\n}\n\n/** Props for the {@link PdfViewer} component. */\nexport interface PdfViewerProps {\n  /** PDF source — URL string or ArrayBuffer */\n  src: string | ArrayBuffer;\n  /** Annotations to overlay on the PDF, keyed by page number (1-indexed) */\n  annotations?: Record<number, PdfAnnotation[]>;\n  /**\n   * Callback fired when an annotation is clicked.\n   *\n   * @param annotation - The annotation that was clicked\n   * @returns void\n   */\n  onAnnotationClick?: (annotation: PdfAnnotation) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /** Additional CSS class name for the root element */\n  className?: string;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"types.js","names":[],"sources":["types.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type React from \"react\";\n\n/** Which sidebar panel to display when the sidebar is open. */\nexport type SidebarMode = \"thumbnails\" | \"outline\";\n\n/** A single item in the PDF document outline (table of contents). */\nexport interface OutlineItem {\n  title: string;\n  depth: number;\n  pageNumber: number;\n  bold: boolean;\n  italic: boolean;\n}\n\n/** The visual style of an annotation rendered on the PDF. */\nexport type AnnotationType = \"highlight\" | \"underline\" | \"comment\" | \"pin\";\n\n/** A single annotation positioned on a specific page of the PDF. */\nexport interface PdfAnnotation {\n  /** Unique identifier for this annotation */\n  id: string;\n  /** The type of annotation to render */\n  type: AnnotationType;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Coordinates in PDF points (origin: bottom-left of page) */\n  rect: { x: number; y: number; width: number; height: number };\n  /** Optional label or tooltip text */\n  label?: string;\n  /** Optional color override (CSS color string) */\n  color?: string;\n}\n\n/** Result passed to the {@link PdfViewerProps.onDownload} callback. */\nexport type PdfDownloadResult =\n  | { success: true; filename: string }\n  | { success: false; error: Error };\n\n/** Props for the {@link PdfViewer} component. */\nexport interface PdfViewerProps {\n  /** PDF source — URL string or ArrayBuffer */\n  src: string | ArrayBuffer;\n  /** Annotations to overlay on the PDF, keyed by page number (1-indexed) */\n  annotations?: Record<number, PdfAnnotation[]>;\n  /**\n   * Callback fired when an annotation is clicked.\n   *\n   * @param annotation - The annotation that was clicked\n   * @returns void\n   */\n  onAnnotationClick?: (annotation: PdfAnnotation) => void;\n  /**\n   * Callback fired when a download completes or fails.\n   *\n   * @param result - The download result indicating success with the filename, or failure with an error\n   * @returns void\n   */\n  onDownload?: (result: PdfDownloadResult) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /**\n   * Whether the download button is shown in the toolbar.\n   * @default false\n   */\n  enableDownload?: boolean;\n  /**\n   * Which sidebar panel to show: thumbnails or document outline.\n   * @default \"thumbnails\"\n   */\n  sidebarMode?: SidebarMode;\n  /**\n   * Custom icon components for each outline depth level (0-indexed).\n   * Key 0 = top-level items, 1 = first nesting level, etc.\n   * If omitted, no icons are rendered.\n   */\n  outlineIcons?: Partial<Record<number, React.ComponentType>>;\n  /** Additional CSS class name for the root element */\n  className?: string;\n}\n"],"mappings":"","ignoreList":[]}