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

package/build/esm/pdf-viewer/PdfViewer.js

@@ -0,0 +1,179 @@
+/*
+ * 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, { forwardRef, useImperativeHandle } from "react";
+import { createPortal } from "react-dom";
+import { PdfViewerAnnotationLayer } from "./components/PdfViewerAnnotationLayer.js";
+import { PdfViewerOutlineSidebar } from "./components/PdfViewerOutlineSidebar.js";
+import { PdfViewerSearchBar } from "./components/PdfViewerSearchBar.js";
+import { PdfViewerSidebar } from "./components/PdfViewerSidebar.js";
+import { PdfViewerToolbar } from "./components/PdfViewerToolbar.js";
+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";
+import styles from "./PdfViewer.module.css";
+export const BasePdfViewer = /*#__PURE__*/forwardRef(function ({
+  src,
+  annotations = EMPTY_ANNOTATION_ARRAY,
+  onAnnotationClick,
+  onDownload,
+  enableHighlight = false,
+  onTextHighlight,
+  onHighlightDelete,
+  formData,
+  onFormSubmit,
+  onFormChange,
+  initialPage = 1,
+  initialScale = 1.0,
+  initialSidebarOpen = false,
+  enableDownload = false,
+  sidebarMode: sidebarModeProp = "thumbnails",
+  outlineIcons,
+  className
+}, ref) {
+  const viewer = usePdfViewerState({
+    src,
+    initialPage,
+    initialScale,
+    initialSidebarOpen,
+    sidebarMode: sidebarModeProp,
+    onDownload
+  });
+  const {
+    highlightModeActive,
+    toggleHighlightMode,
+    deleteHighlight
+  } = usePdfHighlightMode({
+    pdfViewerRef: viewer.pdfViewerRef,
+    document: viewer.document,
+    enabled: enableHighlight,
+    onTextHighlight,
+    onHighlightDelete
+  });
+  useImperativeHandle(ref, () => ({
+    scrollToPage: viewer.scrollToPage,
+    deleteHighlight
+  }), [viewer.scrollToPage, deleteHighlight]);
+  const {
+    hasFormFields,
+    submitFormData
+  } = usePdfFormFields({
+    pdfViewerRef: viewer.pdfViewerRef,
+    eventBusRef: viewer.eventBusRef,
+    document: viewer.document,
+    formData,
+    onFormSubmit,
+    onFormChange
+  });
+  const annotationsByPage = usePdfAnnotationsByPage(annotations);
+  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(PdfViewerToolbar, {
+    currentPage: viewer.currentPage,
+    numPages: viewer.numPages,
+    scale: viewer.scale,
+    sidebarOpen: viewer.sidebarOpen,
+    onPageChange: viewer.scrollToPage,
+    onScaleChange: viewer.setScale,
+    onSearchOpen: viewer.search.openSearch,
+    onSidebarToggle: viewer.toggleSidebar,
+    onDownload: viewer.download,
+    enableDownload: enableDownload,
+    onRotateLeft: viewer.rotateLeft,
+    onRotateRight: viewer.rotateRight,
+    enableHighlight: enableHighlight,
+    highlightModeActive: highlightModeActive,
+    onHighlightToggle: toggleHighlightMode,
+    enableFormSave: onFormSubmit != null && hasFormFields,
+    onFormSave: submitFormData
+  }), viewer.search.isSearchOpen && /*#__PURE__*/React.createElement(PdfViewerSearchBar, {
+    query: viewer.search.query,
+    totalMatches: viewer.search.totalMatches,
+    currentMatchIndex: viewer.search.currentMatchIndex,
+    onQueryChange: viewer.search.setQuery,
+    onNext: viewer.search.nextMatch,
+    onPrev: viewer.search.prevMatch,
+    onClose: viewer.search.closeSearch
+  }), /*#__PURE__*/React.createElement("div", {
+    className: styles.contentArea
+  }, viewer.sidebarOpen && viewer.sidebarMode === "thumbnails" && /*#__PURE__*/React.createElement(PdfViewerSidebar, {
+    document: viewer.document,
+    numPages: viewer.numPages,
+    currentPage: viewer.currentPage,
+    onPageClick: viewer.scrollToPage,
+    sidebarMode: viewer.sidebarMode,
+    onSidebarModeChange: viewer.setSidebarMode
+  }), viewer.sidebarOpen && viewer.sidebarMode === "outline" && /*#__PURE__*/React.createElement(PdfViewerOutlineSidebar, {
+    outlineItems: viewer.outlineItems,
+    currentPage: viewer.currentPage,
+    onItemClick: viewer.scrollToPage,
+    sidebarMode: viewer.sidebarMode,
+    onSidebarModeChange: viewer.setSidebarMode,
+    outlineIcons: outlineIcons
+  }), /*#__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=PdfViewer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PdfViewer.js","names":["Error","ErrorIcon","Spin","classnames","React","forwardRef","useImperativeHandle","createPortal","PdfViewerAnnotationLayer","PdfViewerOutlineSidebar","PdfViewerSearchBar","PdfViewerSidebar","PdfViewerToolbar","EMPTY_ANNOTATION_ARRAY","usePdfAnnotationsByPage","usePdfFormFields","usePdfHighlightMode","usePdfViewerState","styles","BasePdfViewer","src","annotations","onAnnotationClick","onDownload","enableHighlight","onTextHighlight","onHighlightDelete","formData","onFormSubmit","onFormChange","initialPage","initialScale","initialSidebarOpen","enableDownload","sidebarMode","sidebarModeProp","outlineIcons","className","ref","viewer","highlightModeActive","toggleHighlightMode","deleteHighlight","pdfViewerRef","document","enabled","scrollToPage","hasFormFields","submitFormData","eventBusRef","annotationsByPage","rootClassName","pdfViewer","loading","createElement","loadingContainer","spinnerIcon","error","errorContainer","errorIcon","message","currentPage","numPages","scale","sidebarOpen","onPageChange","onScaleChange","setScale","onSearchOpen","search","openSearch","onSidebarToggle","toggleSidebar","download","onRotateLeft","rotateLeft","onRotateRight","rotateRight","onHighlightToggle","enableFormSave","onFormSave","isSearchOpen","query","totalMatches","currentMatchIndex","onQueryChange","setQuery","onNext","nextMatch","onPrev","prevMatch","onClose","closeSearch","contentArea","onPageClick","onSidebarModeChange","setSidebarMode","outlineItems","onItemClick","scrollContainerWrapper","containerRef","scrollContainer","viewerRef","portalTargets","map","target","pageAnnotations","pageNumber","length","key","pageHeight","container"],"sources":["PdfViewer.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, { forwardRef, useImperativeHandle } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { PdfViewerAnnotationLayer } from \"./components/PdfViewerAnnotationLayer.js\";\nimport { PdfViewerOutlineSidebar } from \"./components/PdfViewerOutlineSidebar.js\";\nimport { PdfViewerSearchBar } from \"./components/PdfViewerSearchBar.js\";\nimport { PdfViewerSidebar } from \"./components/PdfViewerSidebar.js\";\nimport { PdfViewerToolbar } from \"./components/PdfViewerToolbar.js\";\nimport { EMPTY_ANNOTATION_ARRAY } from \"./constants.js\";\nimport { usePdfAnnotationsByPage } from \"./hooks/usePdfAnnotationsByPage.js\";\nimport { usePdfFormFields } from \"./hooks/usePdfFormFields.js\";\nimport { usePdfHighlightMode } from \"./hooks/usePdfHighlightMode.js\";\nimport { usePdfViewerState } from \"./hooks/usePdfViewerState.js\";\nimport styles from \"./PdfViewer.module.css\";\nimport type { PdfViewerHandle, PdfViewerProps } from \"./types.js\";\n\nexport const BasePdfViewer: React.ForwardRefExoticComponent<\n  PdfViewerProps & React.RefAttributes<PdfViewerHandle>\n> = forwardRef<PdfViewerHandle, PdfViewerProps>(\n  function BasePdfViewer({\n    src,\n    annotations = EMPTY_ANNOTATION_ARRAY,\n    onAnnotationClick,\n    onDownload,\n    enableHighlight = false,\n    onTextHighlight,\n    onHighlightDelete,\n    formData,\n    onFormSubmit,\n    onFormChange,\n    initialPage = 1,\n    initialScale = 1.0,\n    initialSidebarOpen = false,\n    enableDownload = false,\n    sidebarMode: sidebarModeProp = \"thumbnails\",\n    outlineIcons,\n    className,\n  }, ref) {\n    const viewer = usePdfViewerState({\n      src,\n      initialPage,\n      initialScale,\n      initialSidebarOpen,\n      sidebarMode: sidebarModeProp,\n      onDownload,\n    });\n\n    const { highlightModeActive, toggleHighlightMode, deleteHighlight } =\n      usePdfHighlightMode({\n        pdfViewerRef: viewer.pdfViewerRef,\n        document: viewer.document,\n        enabled: enableHighlight,\n        onTextHighlight,\n        onHighlightDelete,\n      });\n\n    useImperativeHandle(ref, () => ({\n      scrollToPage: viewer.scrollToPage,\n      deleteHighlight,\n    }), [viewer.scrollToPage, deleteHighlight]);\n\n    const { hasFormFields, submitFormData } = usePdfFormFields({\n      pdfViewerRef: viewer.pdfViewerRef,\n      eventBusRef: viewer.eventBusRef,\n      document: viewer.document,\n      formData,\n      onFormSubmit,\n      onFormChange,\n    });\n\n    const annotationsByPage = usePdfAnnotationsByPage(annotations);\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        <PdfViewerToolbar\n          currentPage={viewer.currentPage}\n          numPages={viewer.numPages}\n          scale={viewer.scale}\n          sidebarOpen={viewer.sidebarOpen}\n          onPageChange={viewer.scrollToPage}\n          onScaleChange={viewer.setScale}\n          onSearchOpen={viewer.search.openSearch}\n          onSidebarToggle={viewer.toggleSidebar}\n          onDownload={viewer.download}\n          enableDownload={enableDownload}\n          onRotateLeft={viewer.rotateLeft}\n          onRotateRight={viewer.rotateRight}\n          enableHighlight={enableHighlight}\n          highlightModeActive={highlightModeActive}\n          onHighlightToggle={toggleHighlightMode}\n          enableFormSave={onFormSubmit != null && hasFormFields}\n          onFormSave={submitFormData}\n        />\n        {viewer.search.isSearchOpen && (\n          <PdfViewerSearchBar\n            query={viewer.search.query}\n            totalMatches={viewer.search.totalMatches}\n            currentMatchIndex={viewer.search.currentMatchIndex}\n            onQueryChange={viewer.search.setQuery}\n            onNext={viewer.search.nextMatch}\n            onPrev={viewer.search.prevMatch}\n            onClose={viewer.search.closeSearch}\n          />\n        )}\n        <div className={styles.contentArea}>\n          {viewer.sidebarOpen && viewer.sidebarMode === \"thumbnails\" && (\n            <PdfViewerSidebar\n              document={viewer.document}\n              numPages={viewer.numPages}\n              currentPage={viewer.currentPage}\n              onPageClick={viewer.scrollToPage}\n              sidebarMode={viewer.sidebarMode}\n              onSidebarModeChange={viewer.setSidebarMode}\n            />\n          )}\n          {viewer.sidebarOpen && viewer.sidebarMode === \"outline\" && (\n            <PdfViewerOutlineSidebar\n              outlineItems={viewer.outlineItems}\n              currentPage={viewer.currentPage}\n              onItemClick={viewer.scrollToPage}\n              sidebarMode={viewer.sidebarMode}\n              onSidebarModeChange={viewer.setSidebarMode}\n              outlineIcons={outlineIcons}\n            />\n          )}\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      </div>\n    );\n  },\n);\n"],"mappings":"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","ignoreList":[]}

package/build/esm/pdf-viewer/PdfViewer.module.css

@@ -0,0 +1,95 @@
+.pdfViewer {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  height: 100%;
+  background-color: var(--osdk-pdf-viewer-bg);
+  border: var(--osdk-pdf-viewer-border);
+  border-radius: var(--osdk-surface-border-radius);
+  overflow: hidden;
+  position: relative;
+}
+
+.contentArea {
+  display: flex;
+  flex: 1;
+  overflow: hidden;
+  position: relative;
+}
+
+.scrollContainerWrapper {
+  flex: 1;
+  position: relative;
+  overflow: hidden;
+}
+
+.scrollContainer {
+  overflow: auto;
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+}
+
+.loadingContainer {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: calc(var(--osdk-surface-spacing) * 2);
+  height: 100%;
+  font-family: var(--osdk-typography-family-default);
+  font-size: var(--osdk-typography-size-body-medium);
+  color: var(--osdk-typography-color-muted);
+}
+
+.errorContainer {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--osdk-surface-spacing);
+  height: 100%;
+  font-family: var(--osdk-typography-family-default);
+  font-size: var(--osdk-typography-size-body-medium);
+  color: var(--osdk-typography-color-danger-rest);
+}
+
+@keyframes spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.spinnerIcon {
+  animation: spin 1s linear infinite;
+  color: var(--osdk-typography-color-muted);
+}
+
+.errorIcon {
+  flex-shrink: 0;
+}
+
+/* PDFViewer page overrides */
+:global(.pdfViewer .page) {
+  box-shadow: var(--osdk-pdf-viewer-page-shadow);
+  background-color: var(--osdk-palette-white);
+  margin: 0 auto var(--osdk-pdf-viewer-page-gap);
+}
+
+/* Search highlight overrides — match pdf.js FindController CSS classes */
+:global(.textLayer) .highlight {
+  background-color: var(--osdk-pdf-viewer-search-highlight);
+  border-radius: 1px;
+}
+
+:global(.textLayer) .highlight.selected {
+  background-color: var(--osdk-pdf-viewer-search-active);
+}
+
+:global(.textLayer)::selection {
+  background: var(--osdk-intent-primary-rest);
+}

package/build/esm/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/esm/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":"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","ignoreList":[]}

package/build/esm/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";
+/** 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/esm/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":[]}