@osdk/react-components 0.2.0-beta.9 → 0.2.1-main-20260407074313

package/build/browser/pdf-viewer/PdfViewer.module.css.js

@@ -0,0 +1,16 @@
+// CSS Module proxy for PdfViewer.module.css
+const styles = {
+  "pdfViewer": "PdfViewer-module__pdfViewer___7nCJQUHY",
+  "contentArea": "PdfViewer-module__contentArea___4QVW9oJR",
+  "scrollContainerWrapper": "PdfViewer-module__scrollContainerWrapper___MGUf2Bdn",
+  "scrollContainer": "PdfViewer-module__scrollContainer___H-KtV92S",
+  "loadingContainer": "PdfViewer-module__loadingContainer___jMm-fGVB",
+  "errorContainer": "PdfViewer-module__errorContainer___Vs2aAf-H",
+  "spinnerIcon": "PdfViewer-module__spinnerIcon___ToPhzHJn",
+  "spin": "PdfViewer-module__spin___RtvIp8OH",
+  "errorIcon": "PdfViewer-module__errorIcon___xdB0USZw",
+  "highlight": "PdfViewer-module__highlight___TS0k-Fyu",
+  "selected": "PdfViewer-module__selected___cQuODZ69"
+};
+
+export default styles;

package/build/browser/pdf-viewer/PdfViewerContext.js

@@ -0,0 +1,108 @@
+/*
+ * 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 React, { createContext, useContext, useMemo } from "react";
+import { EMPTY_ANNOTATION_ARRAY } from "./constants.js";
+import { usePdfAnnotationsByPage } from "./hooks/usePdfAnnotationsByPage.js";
+import { usePdfFormFields } from "./hooks/usePdfFormFields.js";
+import { usePdfHighlightMode } from "./hooks/usePdfHighlightMode.js";
+import { usePdfViewerState } from "./hooks/usePdfViewerState.js";
+
+/** The shape of the value provided by {@link PdfViewerProvider}. */
+
+const PdfViewerContext = /*#__PURE__*/createContext(null);
+/** Provides {@link PdfViewerContextValue} to descendant components. */
+export function PdfViewerProvider({
+  value,
+  children
+}) {
+  return /*#__PURE__*/React.createElement(PdfViewerContext.Provider, {
+    value: value
+  }, children);
+}
+
+/**
+ * Returns the nearest {@link PdfViewerContextValue} from a {@link PdfViewerProvider}.
+ * Throws if called outside a provider.
+ */
+export function usePdfViewerContext() {
+  const ctx = useContext(PdfViewerContext);
+  if (ctx == null) {
+    throw new Error("usePdfViewerContext must be used within a PdfViewerProvider");
+  }
+  return ctx;
+}
+
+/**
+ * Consumer-facing setup hook analogous to react-hook-form's `useForm()`.
+ * Accepts viewer options and returns a {@link PdfViewerContextValue} suitable
+ * for passing to {@link PdfViewerProvider}.
+ */
+export function usePdfViewerInstance(options) {
+  const viewer = usePdfViewerState({
+    src: options.src,
+    initialPage: options.initialPage,
+    initialScale: options.initialScale,
+    initialSidebarOpen: options.initialSidebarOpen,
+    sidebarMode: options.sidebarMode,
+    onDownload: options.onDownload
+  });
+  const {
+    highlightModeActive,
+    toggleHighlightMode
+  } = usePdfHighlightMode({
+    pdfViewerRef: viewer.pdfViewerRef,
+    document: viewer.document,
+    enabled: options.highlightEnabled ?? false,
+    onTextHighlight: options.onTextHighlight,
+    onHighlightDelete: options.onHighlightDelete
+  });
+  const {
+    hasFormFields,
+    submitFormData
+  } = usePdfFormFields({
+    pdfViewerRef: viewer.pdfViewerRef,
+    eventBusRef: viewer.eventBusRef,
+    document: viewer.document,
+    formData: options.formData,
+    onFormSubmit: options.onFormSubmit,
+    onFormChange: options.onFormChange
+  });
+  const annotations = options.annotations ?? EMPTY_ANNOTATION_ARRAY;
+  const annotationsByPage = usePdfAnnotationsByPage(annotations);
+  const highlightEnabled = options.highlightEnabled ?? false;
+  const enableDownload = options.enableDownload ?? false;
+  const enableFormSave = options.onFormSubmit != null && hasFormFields;
+  const {
+    onAnnotationClick,
+    outlineIcons
+  } = options;
+  return useMemo(() => ({
+    ...viewer,
+    highlightEnabled,
+    highlightModeActive,
+    toggleHighlightMode,
+    hasFormFields,
+    submitFormData,
+    annotations,
+    annotationsByPage,
+    onAnnotationClick,
+    enableDownload,
+    enableFormSave,
+    outlineIcons
+  }), [viewer, highlightEnabled, highlightModeActive, toggleHighlightMode, hasFormFields, submitFormData, annotations, annotationsByPage, onAnnotationClick, enableDownload, enableFormSave, outlineIcons]);
+}
+//# sourceMappingURL=PdfViewerContext.js.map

package/build/browser/pdf-viewer/PdfViewerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfViewerContext.js","names":["React","createContext","useContext","useMemo","EMPTY_ANNOTATION_ARRAY","usePdfAnnotationsByPage","usePdfFormFields","usePdfHighlightMode","usePdfViewerState","PdfViewerContext","PdfViewerProvider","value","children","createElement","Provider","usePdfViewerContext","ctx","Error","usePdfViewerInstance","options","viewer","src","initialPage","initialScale","initialSidebarOpen","sidebarMode","onDownload","highlightModeActive","toggleHighlightMode","pdfViewerRef","document","enabled","highlightEnabled","onTextHighlight","onHighlightDelete","hasFormFields","submitFormData","eventBusRef","formData","onFormSubmit","onFormChange","annotations","annotationsByPage","enableDownload","enableFormSave","onAnnotationClick","outlineIcons"],"sources":["PdfViewerContext.tsx"],"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 React, { createContext, useContext, useMemo } from \"react\";\nimport type { RefObject } from \"react\";\nimport { EMPTY_ANNOTATION_ARRAY } from \"./constants.js\";\nimport type {\n  AnnotationPortalTarget,\n} from \"./hooks/usePdfAnnotationPortals.js\";\nimport { usePdfAnnotationsByPage } from \"./hooks/usePdfAnnotationsByPage.js\";\nimport { usePdfFormFields } from \"./hooks/usePdfFormFields.js\";\nimport { usePdfHighlightMode } from \"./hooks/usePdfHighlightMode.js\";\nimport type { UsePdfViewerSearchResult } from \"./hooks/usePdfViewerSearch.js\";\nimport { usePdfViewerState } from \"./hooks/usePdfViewerState.js\";\nimport type {\n  OutlineItem,\n  PdfAnnotation,\n  PdfViewerInstanceOptions,\n  SidebarMode,\n} from \"./types.js\";\n\n/** The shape of the value provided by {@link PdfViewerProvider}. */\nexport interface PdfViewerContextValue {\n  // From UsePdfViewerStateResult (core + state)\n  document: PDFDocumentProxy | undefined;\n  numPages: number;\n  loading: boolean;\n  error: Error | undefined;\n  containerRef: RefObject<HTMLDivElement>;\n  viewerRef: RefObject<HTMLDivElement>;\n  currentPage: number;\n  scrollToPage: (page: number) => void;\n  scale: number;\n  setScale: (scale: number) => void;\n  zoomIn: () => void;\n  zoomOut: () => void;\n  rotation: number;\n  rotateLeft: () => void;\n  rotateRight: () => void;\n  sidebarOpen: boolean;\n  sidebarMode: SidebarMode;\n  setSidebarMode: (mode: SidebarMode) => void;\n  toggleSidebar: () => void;\n  search: UsePdfViewerSearchResult;\n  outlineItems: OutlineItem[];\n  download: (filename?: string) => void;\n  portalTargets: AnnotationPortalTarget[];\n\n  // From UsePdfHighlightModeResult\n  highlightEnabled: boolean;\n  highlightModeActive: boolean;\n  toggleHighlightMode: () => void;\n\n  // From UsePdfFormFieldsResult\n  hasFormFields: boolean;\n  submitFormData: () => void;\n\n  // Annotations\n  annotations: PdfAnnotation[];\n  annotationsByPage: Record<number, PdfAnnotation[]>;\n  onAnnotationClick: ((annotation: PdfAnnotation) => void) | undefined;\n\n  // Config props passed through\n  enableDownload: boolean;\n  enableFormSave: boolean;\n  outlineIcons: Partial<Record<number, React.ComponentType>> | undefined;\n\n  // Internal refs (for advanced consumers)\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  eventBusRef: RefObject<EventBus | null>;\n  findControllerRef: RefObject<PDFFindController | null>;\n}\n\nconst PdfViewerContext = createContext<PdfViewerContextValue | null>(null);\n\nexport interface PdfViewerProviderProps {\n  value: PdfViewerContextValue;\n  children: React.ReactNode;\n}\n\n/** Provides {@link PdfViewerContextValue} to descendant components. */\nexport function PdfViewerProvider(\n  { value, children }: PdfViewerProviderProps,\n): React.ReactElement {\n  return (\n    <PdfViewerContext.Provider value={value}>\n      {children}\n    </PdfViewerContext.Provider>\n  );\n}\n\n/**\n * Returns the nearest {@link PdfViewerContextValue} from a {@link PdfViewerProvider}.\n * Throws if called outside a provider.\n */\nexport function usePdfViewerContext(): PdfViewerContextValue {\n  const ctx = useContext(PdfViewerContext);\n  if (ctx == null) {\n    throw new Error(\n      \"usePdfViewerContext must be used within a PdfViewerProvider\",\n    );\n  }\n  return ctx;\n}\n\n/**\n * Consumer-facing setup hook analogous to react-hook-form's `useForm()`.\n * Accepts viewer options and returns a {@link PdfViewerContextValue} suitable\n * for passing to {@link PdfViewerProvider}.\n */\nexport function usePdfViewerInstance(\n  options: PdfViewerInstanceOptions,\n): PdfViewerContextValue {\n  const viewer = usePdfViewerState({\n    src: options.src,\n    initialPage: options.initialPage,\n    initialScale: options.initialScale,\n    initialSidebarOpen: options.initialSidebarOpen,\n    sidebarMode: options.sidebarMode,\n    onDownload: options.onDownload,\n  });\n\n  const { highlightModeActive, toggleHighlightMode } = usePdfHighlightMode({\n    pdfViewerRef: viewer.pdfViewerRef,\n    document: viewer.document,\n    enabled: options.highlightEnabled ?? false,\n    onTextHighlight: options.onTextHighlight,\n    onHighlightDelete: options.onHighlightDelete,\n  });\n\n  const { hasFormFields, submitFormData } = usePdfFormFields({\n    pdfViewerRef: viewer.pdfViewerRef,\n    eventBusRef: viewer.eventBusRef,\n    document: viewer.document,\n    formData: options.formData,\n    onFormSubmit: options.onFormSubmit,\n    onFormChange: options.onFormChange,\n  });\n\n  const annotations = options.annotations ?? EMPTY_ANNOTATION_ARRAY;\n  const annotationsByPage = usePdfAnnotationsByPage(annotations);\n\n  const highlightEnabled = options.highlightEnabled ?? false;\n  const enableDownload = options.enableDownload ?? false;\n  const enableFormSave = options.onFormSubmit != null && hasFormFields;\n  const { onAnnotationClick, outlineIcons } = options;\n\n  return useMemo(\n    () => ({\n      ...viewer,\n      highlightEnabled,\n      highlightModeActive,\n      toggleHighlightMode,\n      hasFormFields,\n      submitFormData,\n      annotations,\n      annotationsByPage,\n      onAnnotationClick,\n      enableDownload,\n      enableFormSave,\n      outlineIcons,\n    }),\n    [\n      viewer,\n      highlightEnabled,\n      highlightModeActive,\n      toggleHighlightMode,\n      hasFormFields,\n      submitFormData,\n      annotations,\n      annotationsByPage,\n      onAnnotationClick,\n      enableDownload,\n      enableFormSave,\n      outlineIcons,\n    ],\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,OAAOA,KAAK,IAAIC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAQ,OAAO;AAEjE,SAASC,sBAAsB,QAAQ,gBAAgB;AAIvD,SAASC,uBAAuB,QAAQ,oCAAoC;AAC5E,SAASC,gBAAgB,QAAQ,6BAA6B;AAC9D,SAASC,mBAAmB,QAAQ,gCAAgC;AAEpE,SAASC,iBAAiB,QAAQ,8BAA8B;;AAQhE;;AAoDA,MAAMC,gBAAgB,gBAAGR,aAAa,CAA+B,IAAI,CAAC;AAO1E;AACA,OAAO,SAASS,iBAAiBA,CAC/B;EAAEC,KAAK;EAAEC;AAAiC,CAAC,EACvB;EACpB,oBACEZ,KAAA,CAAAa,aAAA,CAACJ,gBAAgB,CAACK,QAAQ;IAACH,KAAK,EAAEA;EAAM,GACrCC,QACwB,CAAC;AAEhC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASG,mBAAmBA,CAAA,EAA0B;EAC3D,MAAMC,GAAG,GAAGd,UAAU,CAACO,gBAAgB,CAAC;EACxC,IAAIO,GAAG,IAAI,IAAI,EAAE;IACf,MAAM,IAAIC,KAAK,CACb,6DACF,CAAC;EACH;EACA,OAAOD,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,oBAAoBA,CAClCC,OAAiC,EACV;EACvB,MAAMC,MAAM,GAAGZ,iBAAiB,CAAC;IAC/Ba,GAAG,EAAEF,OAAO,CAACE,GAAG;IAChBC,WAAW,EAAEH,OAAO,CAACG,WAAW;IAChCC,YAAY,EAAEJ,OAAO,CAACI,YAAY;IAClCC,kBAAkB,EAAEL,OAAO,CAACK,kBAAkB;IAC9CC,WAAW,EAAEN,OAAO,CAACM,WAAW;IAChCC,UAAU,EAAEP,OAAO,CAACO;EACtB,CAAC,CAAC;EAEF,MAAM;IAAEC,mBAAmB;IAAEC;EAAoB,CAAC,GAAGrB,mBAAmB,CAAC;IACvEsB,YAAY,EAAET,MAAM,CAACS,YAAY;IACjCC,QAAQ,EAAEV,MAAM,CAACU,QAAQ;IACzBC,OAAO,EAAEZ,OAAO,CAACa,gBAAgB,IAAI,KAAK;IAC1CC,eAAe,EAAEd,OAAO,CAACc,eAAe;IACxCC,iBAAiB,EAAEf,OAAO,CAACe;EAC7B,CAAC,CAAC;EAEF,MAAM;IAAEC,aAAa;IAAEC;EAAe,CAAC,GAAG9B,gBAAgB,CAAC;IACzDuB,YAAY,EAAET,MAAM,CAACS,YAAY;IACjCQ,WAAW,EAAEjB,MAAM,CAACiB,WAAW;IAC/BP,QAAQ,EAAEV,MAAM,CAACU,QAAQ;IACzBQ,QAAQ,EAAEnB,OAAO,CAACmB,QAAQ;IAC1BC,YAAY,EAAEpB,OAAO,CAACoB,YAAY;IAClCC,YAAY,EAAErB,OAAO,CAACqB;EACxB,CAAC,CAAC;EAEF,MAAMC,WAAW,GAAGtB,OAAO,CAACsB,WAAW,IAAIrC,sBAAsB;EACjE,MAAMsC,iBAAiB,GAAGrC,uBAAuB,CAACoC,WAAW,CAAC;EAE9D,MAAMT,gBAAgB,GAAGb,OAAO,CAACa,gBAAgB,IAAI,KAAK;EAC1D,MAAMW,cAAc,GAAGxB,OAAO,CAACwB,cAAc,IAAI,KAAK;EACtD,MAAMC,cAAc,GAAGzB,OAAO,CAACoB,YAAY,IAAI,IAAI,IAAIJ,aAAa;EACpE,MAAM;IAAEU,iBAAiB;IAAEC;EAAa,CAAC,GAAG3B,OAAO;EAEnD,OAAOhB,OAAO,CACZ,OAAO;IACL,GAAGiB,MAAM;IACTY,gBAAgB;IAChBL,mBAAmB;IACnBC,mBAAmB;IACnBO,aAAa;IACbC,cAAc;IACdK,WAAW;IACXC,iBAAiB;IACjBG,iBAAiB;IACjBF,cAAc;IACdC,cAAc;IACdE;EACF,CAAC,CAAC,EACF,CACE1B,MAAM,EACNY,gBAAgB,EAChBL,mBAAmB,EACnBC,mBAAmB,EACnBO,aAAa,EACbC,cAAc,EACdK,WAAW,EACXC,iBAAiB,EACjBG,iBAAiB,EACjBF,cAAc,EACdC,cAAc,EACdE,YAAY,CAEhB,CAAC;AACH","ignoreList":[]}

package/build/browser/pdf-viewer/components/PdfViewerAnnotationLayer.js

@@ -0,0 +1,141 @@
+/*
+ * 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 classnames from "classnames";
+import React, { useCallback, useMemo } from "react";
+import styles from "./PdfViewerAnnotationLayer.module.css.js";
+/** Convert a single PDF rect (bottom-left origin) to CSS positioning (top-left origin). */
+function computeRectStyle(rect, pageHeight, scale, color) {
+  return {
+    left: rect.x * scale,
+    top: (pageHeight - rect.y - rect.height) * scale,
+    width: rect.width * scale,
+    height: rect.height * scale,
+    ...(color != null ? {
+      "--osdk-pdf-annotation-color": color
+    } : {})
+  };
+}
+function useAnnotationHandlers(annotation, onClick) {
+  const handleClick = useCallback(() => {
+    onClick?.(annotation);
+  }, [onClick, annotation]);
+  const handleKeyDown = useCallback(e => {
+    if (e.key === "Enter") {
+      e.preventDefault();
+      onClick?.(annotation);
+    }
+  }, [onClick, annotation]);
+  return {
+    handleClick,
+    handleKeyDown
+  };
+}
+function AnnotationItem({
+  annotation,
+  pageHeight,
+  scale,
+  onClick
+}) {
+  const {
+    handleClick,
+    handleKeyDown
+  } = useAnnotationHandlers(annotation, onClick);
+  const className = classnames(styles.annotation, styles[annotation.type]);
+  const multiRects = annotation.rects;
+  const hasMultipleRects = multiRects != null && multiRects.length > 1;
+  const style = useMemo(() => computeRectStyle(annotation.rect, pageHeight, scale, annotation.color), [annotation, pageHeight, scale]);
+
+  // Multi-rect: render a group wrapper with one div per rect
+  if (hasMultipleRects) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: styles.annotationGroup,
+      onClick: handleClick,
+      onKeyDown: handleKeyDown,
+      role: "button",
+      tabIndex: 0,
+      title: annotation.label,
+      "data-annotation-id": annotation.id
+    }, multiRects.map((rect, i) => /*#__PURE__*/React.createElement("div", {
+      key: i,
+      className: className,
+      style: computeRectStyle(rect, pageHeight, scale, annotation.color)
+    })));
+  }
+
+  // Single rect: existing behavior
+
+  return /*#__PURE__*/React.createElement("div", {
+    className: className,
+    style: style,
+    onClick: handleClick,
+    onKeyDown: handleKeyDown,
+    role: "button",
+    tabIndex: 0,
+    title: annotation.label,
+    "data-annotation-id": annotation.id
+  });
+}
+function CustomAnnotationItem({
+  annotation,
+  pageHeight,
+  scale,
+  onClick
+}) {
+  const {
+    handleClick,
+    handleKeyDown
+  } = useAnnotationHandlers(annotation, onClick);
+  const style = useMemo(() => computeRectStyle(annotation.rect, pageHeight, scale, undefined), [annotation, pageHeight, scale]);
+  const renderProps = useMemo(() => ({
+    annotation,
+    scale,
+    pageHeight
+  }), [annotation, scale, pageHeight]);
+  return /*#__PURE__*/React.createElement("div", {
+    className: styles.annotation,
+    style: style,
+    onClick: handleClick,
+    onKeyDown: handleKeyDown,
+    role: "button",
+    tabIndex: 0,
+    title: annotation.label,
+    "data-annotation-id": annotation.id
+  }, annotation.render(renderProps));
+}
+export function PdfViewerAnnotationLayer({
+  annotations,
+  pageHeight,
+  scale,
+  onAnnotationClick
+}) {
+  return /*#__PURE__*/React.createElement("div", {
+    className: styles.annotationLayer
+  }, annotations.map(annotation => annotation.type === "custom" ? /*#__PURE__*/React.createElement(CustomAnnotationItem, {
+    key: annotation.id,
+    annotation: annotation,
+    pageHeight: pageHeight,
+    scale: scale,
+    onClick: onAnnotationClick
+  }) : /*#__PURE__*/React.createElement(AnnotationItem, {
+    key: annotation.id,
+    annotation: annotation,
+    pageHeight: pageHeight,
+    scale: scale,
+    onClick: onAnnotationClick
+  })));
+}
+//# sourceMappingURL=PdfViewerAnnotationLayer.js.map

package/build/browser/pdf-viewer/components/PdfViewerAnnotationLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfViewerAnnotationLayer.js","names":["classnames","React","useCallback","useMemo","styles","computeRectStyle","rect","pageHeight","scale","color","left","x","top","y","height","width","useAnnotationHandlers","annotation","onClick","handleClick","handleKeyDown","e","key","preventDefault","AnnotationItem","className","type","multiRects","rects","hasMultipleRects","length","style","createElement","annotationGroup","onKeyDown","role","tabIndex","title","label","id","map","i","CustomAnnotationItem","undefined","renderProps","render","PdfViewerAnnotationLayer","annotations","onAnnotationClick","annotationLayer"],"sources":["PdfViewerAnnotationLayer.tsx"],"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 classnames from \"classnames\";\nimport React, { useCallback, useMemo } from \"react\";\nimport type { PdfAnnotation, PdfCustomAnnotation, PdfRect } from \"../types.js\";\nimport styles from \"./PdfViewerAnnotationLayer.module.css\";\n\nexport interface PdfViewerAnnotationLayerProps {\n  annotations: PdfAnnotation[];\n  pageHeight: number;\n  scale: number;\n  onAnnotationClick?: (annotation: PdfAnnotation) => void;\n}\n\ninterface AnnotationItemProps {\n  annotation: PdfAnnotation;\n  pageHeight: number;\n  scale: number;\n  onClick?: (annotation: PdfAnnotation) => void;\n}\n\n/** Convert a single PDF rect (bottom-left origin) to CSS positioning (top-left origin). */\nfunction computeRectStyle(\n  rect: PdfRect,\n  pageHeight: number,\n  scale: number,\n  color: string | undefined,\n): React.CSSProperties {\n  return {\n    left: rect.x * scale,\n    top: (pageHeight - rect.y - rect.height) * scale,\n    width: rect.width * scale,\n    height: rect.height * scale,\n    ...(color != null\n      ? { \"--osdk-pdf-annotation-color\": color } as React.CSSProperties\n      : {}),\n  };\n}\n\nfunction useAnnotationHandlers(\n  annotation: PdfAnnotation,\n  onClick?: (annotation: PdfAnnotation) => void,\n) {\n  const handleClick = useCallback(() => {\n    onClick?.(annotation);\n  }, [onClick, annotation]);\n\n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent) => {\n      if (e.key === \"Enter\") {\n        e.preventDefault();\n        onClick?.(annotation);\n      }\n    },\n    [onClick, annotation],\n  );\n\n  return { handleClick, handleKeyDown };\n}\n\nfunction AnnotationItem({\n  annotation,\n  pageHeight,\n  scale,\n  onClick,\n}: AnnotationItemProps): React.ReactElement {\n  const { handleClick, handleKeyDown } = useAnnotationHandlers(\n    annotation,\n    onClick,\n  );\n\n  const className = classnames(\n    styles.annotation,\n    styles[annotation.type],\n  );\n\n  const multiRects = annotation.rects;\n  const hasMultipleRects = multiRects != null && multiRects.length > 1;\n\n  const style = useMemo(\n    () =>\n      computeRectStyle(annotation.rect, pageHeight, scale, annotation.color),\n    [annotation, pageHeight, scale],\n  );\n\n  // Multi-rect: render a group wrapper with one div per rect\n  if (hasMultipleRects) {\n    return (\n      <div\n        className={styles.annotationGroup}\n        onClick={handleClick}\n        onKeyDown={handleKeyDown}\n        role=\"button\"\n        tabIndex={0}\n        title={annotation.label}\n        data-annotation-id={annotation.id}\n      >\n        {multiRects.map((rect, i) => (\n          <div\n            key={i}\n            className={className}\n            style={computeRectStyle(\n              rect,\n              pageHeight,\n              scale,\n              annotation.color,\n            )}\n          />\n        ))}\n      </div>\n    );\n  }\n\n  // Single rect: existing behavior\n\n  return (\n    <div\n      className={className}\n      style={style}\n      onClick={handleClick}\n      onKeyDown={handleKeyDown}\n      role=\"button\"\n      tabIndex={0}\n      title={annotation.label}\n      data-annotation-id={annotation.id}\n    />\n  );\n}\n\nfunction CustomAnnotationItem({\n  annotation,\n  pageHeight,\n  scale,\n  onClick,\n}: AnnotationItemProps & {\n  annotation: PdfCustomAnnotation;\n}): React.ReactElement {\n  const { handleClick, handleKeyDown } = useAnnotationHandlers(\n    annotation,\n    onClick,\n  );\n\n  const style = useMemo(\n    () => computeRectStyle(annotation.rect, pageHeight, scale, undefined),\n    [annotation, pageHeight, scale],\n  );\n\n  const renderProps = useMemo(\n    () => ({ annotation, scale, pageHeight }),\n    [annotation, scale, pageHeight],\n  );\n\n  return (\n    <div\n      className={styles.annotation}\n      style={style}\n      onClick={handleClick}\n      onKeyDown={handleKeyDown}\n      role=\"button\"\n      tabIndex={0}\n      title={annotation.label}\n      data-annotation-id={annotation.id}\n    >\n      {annotation.render(renderProps)}\n    </div>\n  );\n}\n\nexport function PdfViewerAnnotationLayer({\n  annotations,\n  pageHeight,\n  scale,\n  onAnnotationClick,\n}: PdfViewerAnnotationLayerProps): React.ReactElement {\n  return (\n    <div className={styles.annotationLayer}>\n      {annotations.map((annotation) =>\n        annotation.type === \"custom\"\n          ? (\n            <CustomAnnotationItem\n              key={annotation.id}\n              annotation={annotation}\n              pageHeight={pageHeight}\n              scale={scale}\n              onClick={onAnnotationClick}\n            />\n          )\n          : (\n            <AnnotationItem\n              key={annotation.id}\n              annotation={annotation}\n              pageHeight={pageHeight}\n              scale={scale}\n              onClick={onAnnotationClick}\n            />\n          )\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/pdf-viewer/components/PdfViewerAnnotationLayer.module.css

@@ -0,0 +1,82 @@
+.annotationLayer {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: 3;
+}
+
+.annotationGroup {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+}
+
+.annotationGroup:focus-visible {
+  outline: var(--osdk-focus-outline);
+  outline-offset: var(--osdk-focus-visible-outline-offset);
+}
+
+.annotationGroup .annotation {
+  pointer-events: auto;
+}
+
+.annotation {
+  position: absolute;
+  pointer-events: auto;
+  cursor: pointer;
+  transition: opacity var(--osdk-emphasis-transition-duration)
+    var(--osdk-emphasis-ease-default);
+}
+
+.annotation:hover {
+  opacity: 0.8;
+}
+
+.annotation:focus-visible {
+  outline: var(--osdk-focus-outline);
+  outline-offset: var(--osdk-focus-visible-outline-offset);
+}
+
+.highlight {
+  background-color: var(
+    --osdk-pdf-annotation-color,
+    var(--osdk-pdf-viewer-annotation-highlight)
+  );
+  border-radius: 2px;
+}
+
+.underline {
+  background-color: transparent;
+  border-bottom: 2px solid
+    var(
+      --osdk-pdf-annotation-color,
+      var(--osdk-pdf-viewer-annotation-underline)
+    );
+}
+
+.comment {
+  background-color: var(
+    --osdk-pdf-annotation-color,
+    var(--osdk-pdf-viewer-annotation-comment)
+  );
+  border-radius: 50%;
+  width: 16px !important;
+  height: 16px !important;
+}
+
+.pin {
+  background-color: var(
+    --osdk-pdf-annotation-color,
+    var(--osdk-pdf-viewer-annotation-pin)
+  );
+  border-radius: 50% 50% 50% 0;
+  width: 16px !important;
+  height: 16px !important;
+  transform: rotate(-45deg);
+}

package/build/browser/pdf-viewer/components/PdfViewerAnnotationLayer.module.css.js

@@ -0,0 +1,12 @@
+// CSS Module proxy for PdfViewerAnnotationLayer.module.css
+const styles = {
+  "annotationLayer": "PdfViewerAnnotationLayer-module__annotationLayer___mljRfBSQ",
+  "annotationGroup": "PdfViewerAnnotationLayer-module__annotationGroup___CiaFrKH5",
+  "annotation": "PdfViewerAnnotationLayer-module__annotation___1dAkVbQ8",
+  "highlight": "PdfViewerAnnotationLayer-module__highlight___uPiyo2kN",
+  "underline": "PdfViewerAnnotationLayer-module__underline___-qCk9Jld",
+  "comment": "PdfViewerAnnotationLayer-module__comment___Yv4tVnUp",
+  "pin": "PdfViewerAnnotationLayer-module__pin___9xjpPtr-"
+};
+
+export default styles;

package/build/browser/pdf-viewer/components/PdfViewerContent.js

@@ -0,0 +1,125 @@
+/*
+ * 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 { Error as ErrorIcon, Spin } from "@blueprintjs/icons";
+import classnames from "classnames";
+import "pdfjs-dist/web/pdf_viewer.css";
+import React, { useEffect, useRef } from "react";
+import { createPortal } from "react-dom";
+import { EMPTY_ANNOTATION_ARRAY } from "../constants.js";
+import { usePdfAnnotationsByPage } from "../hooks/usePdfAnnotationsByPage.js";
+import { usePdfFormFields } from "../hooks/usePdfFormFields.js";
+import { usePdfViewerCore } from "../hooks/usePdfViewerCore.js";
+import styles from "../PdfViewer.module.css.js";
+import { PdfViewerAnnotationLayer } from "./PdfViewerAnnotationLayer.js";
+export function PdfViewerContent({
+  src,
+  annotations = EMPTY_ANNOTATION_ARRAY,
+  onAnnotationClick,
+  initialPage = 1,
+  initialScale = 1.0,
+  onPageChange: onPageChangeProp,
+  onScaleChange: onScaleChangeProp,
+  formData,
+  onFormChange,
+  className
+}) {
+  const viewer = usePdfViewerCore({
+    src,
+    initialPage,
+    initialScale
+  });
+  const annotationsByPage = usePdfAnnotationsByPage(annotations);
+  usePdfFormFields({
+    pdfViewerRef: viewer.pdfViewerRef,
+    eventBusRef: viewer.eventBusRef,
+    document: viewer.document,
+    formData,
+    onFormChange
+  });
+
+  // Use refs for callbacks to avoid firing on initial mount
+  const onPageChangeRef = useRef(onPageChangeProp);
+  onPageChangeRef.current = onPageChangeProp;
+  const onScaleChangeRef = useRef(onScaleChangeProp);
+  onScaleChangeRef.current = onScaleChangeProp;
+  const isInitialMountRef = useRef(true);
+  useEffect(function () {
+    if (isInitialMountRef.current) {
+      return;
+    }
+    onPageChangeRef.current?.(viewer.currentPage);
+  }, [viewer.currentPage]);
+  useEffect(function () {
+    if (isInitialMountRef.current) {
+      return;
+    }
+    onScaleChangeRef.current?.(viewer.scale);
+  }, [viewer.scale]);
+  useEffect(function () {
+    isInitialMountRef.current = false;
+  }, []);
+  const rootClassName = classnames(styles.pdfViewer, className);
+  if (viewer.loading) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: rootClassName
+    }, /*#__PURE__*/React.createElement("div", {
+      className: styles.loadingContainer
+    }, /*#__PURE__*/React.createElement(Spin, {
+      className: styles.spinnerIcon
+    }), "Loading\u2026"));
+  }
+  if (viewer.error != null) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: rootClassName
+    }, /*#__PURE__*/React.createElement("div", {
+      className: styles.errorContainer
+    }, /*#__PURE__*/React.createElement(ErrorIcon, {
+      className: styles.errorIcon
+    }), "Failed to load PDF: ", viewer.error.message));
+  }
+  if (viewer.document == null) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: rootClassName
+    }, /*#__PURE__*/React.createElement("div", {
+      className: styles.loadingContainer
+    }, "No document"));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: rootClassName
+  }, /*#__PURE__*/React.createElement("div", {
+    className: styles.scrollContainerWrapper
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: viewer.containerRef,
+    className: styles.scrollContainer
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: viewer.viewerRef,
+    className: "pdfViewer"
+  }), viewer.portalTargets.map(target => {
+    const pageAnnotations = annotationsByPage[target.pageNumber] ?? EMPTY_ANNOTATION_ARRAY;
+    if (pageAnnotations.length === 0) {
+      return null;
+    }
+    return /*#__PURE__*/createPortal(/*#__PURE__*/React.createElement(PdfViewerAnnotationLayer, {
+      key: target.pageNumber,
+      annotations: pageAnnotations,
+      pageHeight: target.pageHeight,
+      scale: target.scale,
+      onAnnotationClick: onAnnotationClick
+    }), target.container);
+  }))));
+}
+//# sourceMappingURL=PdfViewerContent.js.map

package/build/browser/pdf-viewer/components/PdfViewerContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfViewerContent.js","names":["Error","ErrorIcon","Spin","classnames","React","useEffect","useRef","createPortal","EMPTY_ANNOTATION_ARRAY","usePdfAnnotationsByPage","usePdfFormFields","usePdfViewerCore","styles","PdfViewerAnnotationLayer","PdfViewerContent","src","annotations","onAnnotationClick","initialPage","initialScale","onPageChange","onPageChangeProp","onScaleChange","onScaleChangeProp","formData","onFormChange","className","viewer","annotationsByPage","pdfViewerRef","eventBusRef","document","onPageChangeRef","current","onScaleChangeRef","isInitialMountRef","currentPage","scale","rootClassName","pdfViewer","loading","createElement","loadingContainer","spinnerIcon","error","errorContainer","errorIcon","message","scrollContainerWrapper","ref","containerRef","scrollContainer","viewerRef","portalTargets","map","target","pageAnnotations","pageNumber","length","key","pageHeight","container"],"sources":["PdfViewerContent.tsx"],"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 { Error as ErrorIcon, Spin } from \"@blueprintjs/icons\";\nimport classnames from \"classnames\";\nimport \"pdfjs-dist/web/pdf_viewer.css\";\nimport React, { useEffect, useRef } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { EMPTY_ANNOTATION_ARRAY } from \"../constants.js\";\nimport { usePdfAnnotationsByPage } from \"../hooks/usePdfAnnotationsByPage.js\";\nimport { usePdfFormFields } from \"../hooks/usePdfFormFields.js\";\nimport { usePdfViewerCore } from \"../hooks/usePdfViewerCore.js\";\nimport styles from \"../PdfViewer.module.css\";\nimport type { PdfAnnotation, PdfFormFieldValue } from \"../types.js\";\nimport { PdfViewerAnnotationLayer } from \"./PdfViewerAnnotationLayer.js\";\n\nexport interface PdfViewerContentProps {\n  /** PDF source — URL string or ArrayBuffer */\n  src: string | ArrayBuffer;\n  /** Annotations to overlay on the PDF */\n  annotations?: PdfAnnotation[];\n  /** Callback fired when an annotation is clicked */\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  /** Callback fired when the current page changes during scrolling */\n  onPageChange?: (page: number) => void;\n  /** Callback fired when the zoom scale changes */\n  onScaleChange?: (scale: number) => void;\n  /** Initial form field values keyed by field name. Applied when the document loads. */\n  formData?: Record<string, PdfFormFieldValue>;\n  /** Callback fired when any form field value changes. */\n  onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;\n  /** Additional CSS class name for the root element */\n  className?: string;\n}\n\nexport function PdfViewerContent({\n  src,\n  annotations = EMPTY_ANNOTATION_ARRAY,\n  onAnnotationClick,\n  initialPage = 1,\n  initialScale = 1.0,\n  onPageChange: onPageChangeProp,\n  onScaleChange: onScaleChangeProp,\n  formData,\n  onFormChange,\n  className,\n}: PdfViewerContentProps): React.ReactElement {\n  const viewer = usePdfViewerCore({ src, initialPage, initialScale });\n  const annotationsByPage = usePdfAnnotationsByPage(annotations);\n\n  usePdfFormFields({\n    pdfViewerRef: viewer.pdfViewerRef,\n    eventBusRef: viewer.eventBusRef,\n    document: viewer.document,\n    formData,\n    onFormChange,\n  });\n\n  // Use refs for callbacks to avoid firing on initial mount\n  const onPageChangeRef = useRef(onPageChangeProp);\n  onPageChangeRef.current = onPageChangeProp;\n  const onScaleChangeRef = useRef(onScaleChangeProp);\n  onScaleChangeRef.current = onScaleChangeProp;\n  const isInitialMountRef = useRef(true);\n\n  useEffect(function notifyPageChange() {\n    if (isInitialMountRef.current) {\n      return;\n    }\n    onPageChangeRef.current?.(viewer.currentPage);\n  }, [viewer.currentPage]);\n\n  useEffect(function notifyScaleChange() {\n    if (isInitialMountRef.current) {\n      return;\n    }\n    onScaleChangeRef.current?.(viewer.scale);\n  }, [viewer.scale]);\n\n  useEffect(function clearInitialMount() {\n    isInitialMountRef.current = false;\n  }, []);\n\n  const rootClassName = classnames(styles.pdfViewer, className);\n\n  if (viewer.loading) {\n    return (\n      <div className={rootClassName}>\n        <div className={styles.loadingContainer}>\n          <Spin className={styles.spinnerIcon} />\n          Loading…\n        </div>\n      </div>\n    );\n  }\n\n  if (viewer.error != null) {\n    return (\n      <div className={rootClassName}>\n        <div className={styles.errorContainer}>\n          <ErrorIcon className={styles.errorIcon} />\n          Failed to load PDF: {viewer.error.message}\n        </div>\n      </div>\n    );\n  }\n\n  if (viewer.document == null) {\n    return (\n      <div className={rootClassName}>\n        <div className={styles.loadingContainer}>No document</div>\n      </div>\n    );\n  }\n\n  return (\n    <div className={rootClassName}>\n      <div className={styles.scrollContainerWrapper}>\n        <div ref={viewer.containerRef} className={styles.scrollContainer}>\n          <div ref={viewer.viewerRef} className=\"pdfViewer\" />\n          {viewer.portalTargets.map((target) => {\n            const pageAnnotations = annotationsByPage[target.pageNumber]\n              ?? EMPTY_ANNOTATION_ARRAY;\n            if (pageAnnotations.length === 0) {\n              return null;\n            }\n            return createPortal(\n              <PdfViewerAnnotationLayer\n                key={target.pageNumber}\n                annotations={pageAnnotations}\n                pageHeight={target.pageHeight}\n                scale={target.scale}\n                onAnnotationClick={onAnnotationClick}\n              />,\n              target.container,\n            );\n          })}\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/pdf-viewer/components/PdfViewerOutlineSidebar.js

@@ -0,0 +1,98 @@
+/*
+ * 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 classnames from "classnames";
+import React, { useCallback, useMemo } from "react";
+import styles from "./PdfViewerOutlineSidebar.module.css.js";
+import { PdfViewerSidebarHeader } from "./PdfViewerSidebarHeader.js";
+const INDENT_PER_DEPTH = 16;
+export function PdfViewerOutlineSidebar({
+  outlineItems,
+  currentPage,
+  onItemClick,
+  sidebarMode,
+  onSidebarModeChange,
+  outlineIcons
+}) {
+  const activeIndex = useMemo(() => {
+    return computeActiveIndex(outlineItems, currentPage);
+  }, [outlineItems, currentPage]);
+  if (outlineItems.length === 0) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: styles.sidebar
+    }, /*#__PURE__*/React.createElement(PdfViewerSidebarHeader, {
+      sidebarMode: sidebarMode,
+      onSidebarModeChange: onSidebarModeChange
+    }), /*#__PURE__*/React.createElement("div", {
+      className: styles.emptyState
+    }, /*#__PURE__*/React.createElement("div", {
+      className: styles.emptyStateText
+    }, "No outline available")));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: styles.sidebar
+  }, /*#__PURE__*/React.createElement(PdfViewerSidebarHeader, {
+    sidebarMode: sidebarMode,
+    onSidebarModeChange: onSidebarModeChange
+  }), /*#__PURE__*/React.createElement("div", {
+    className: styles.scrollContainer
+  }, outlineItems.map((item, index) => /*#__PURE__*/React.createElement(PdfViewerOutlineItem, {
+    key: index,
+    item: item,
+    isActive: index === activeIndex,
+    onClick: onItemClick,
+    iconComponent: outlineIcons?.[item.depth]
+  }))));
+}
+function PdfViewerOutlineItem({
+  item,
+  isActive,
+  onClick,
+  iconComponent: IconComponent
+}) {
+  const handleClick = useCallback(() => {
+    onClick(item.pageNumber);
+  }, [onClick, item.pageNumber]);
+  const handleKeyDown = useCallback(e => {
+    if (e.key === "Enter" || e.key === " ") {
+      e.preventDefault();
+      onClick(item.pageNumber);
+    }
+  }, [onClick, item.pageNumber]);
+  const itemClassName = classnames(styles.outlineItem, isActive && styles.outlineItemActive, item.bold && styles.outlineItemBold, item.italic && styles.outlineItemItalic);
+  const paddingLeft = INDENT_PER_DEPTH * item.depth + 12;
+  return /*#__PURE__*/React.createElement("div", {
+    className: itemClassName,
+    onClick: handleClick,
+    onKeyDown: handleKeyDown,
+    role: "button",
+    tabIndex: 0,
+    "aria-label": item.title,
+    "aria-current": isActive ? "location" : undefined,
+    style: {
+      paddingLeft
+    }
+  }, IconComponent != null && /*#__PURE__*/React.createElement("span", {
+    className: styles.outlineItemIcon
+  }, /*#__PURE__*/React.createElement(IconComponent, null)), /*#__PURE__*/React.createElement("span", {
+    className: styles.outlineItemTitle
+  }, item.title));
+}
+function computeActiveIndex(items, currentPage) {
+  const idx = items.findIndex(item => item.pageNumber > currentPage);
+  return idx === -1 ? items.length - 1 : idx - 1;
+}
+//# sourceMappingURL=PdfViewerOutlineSidebar.js.map