@osdk/react-components 0.28.0 → 0.29.0-main-ee3bce8a1ee0d096ebcab66bfbc2d9d75977c26d

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @osdk/react-components
 
+## 0.29.0-main-ee3bce8a1ee0d096ebcab66bfbc2d9d75977c26d
+
+### Minor Changes
+
+- ee3bce8: Add `downloadFileName` prop to set the PDF download name.
+
+### Patch Changes
+
+- ee3bce8: Fix PDF viewer toolbar download saving an invalid filename.
+- Updated dependencies [06adca1]
+- Updated dependencies [79f8a6e]
+  - @osdk/client@2.32.0-main-ee3bce8a1ee0d096ebcab66bfbc2d9d75977c26d
+  - @osdk/api@2.32.0-main-ee3bce8a1ee0d096ebcab66bfbc2d9d75977c26d
+  - @osdk/react@2.32.0-main-ee3bce8a1ee0d096ebcab66bfbc2d9d75977c26d
+
 ## 0.28.0
 
 ### Minor Changes

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

@@ -17,7 +17,7 @@
 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 React, { forwardRef, useCallback, useImperativeHandle } from "react";
 import { PdfAnnotationOverlay } from "./components/PdfAnnotationOverlay.js";
 import { PdfViewerOutlineSidebar } from "./components/PdfViewerOutlineSidebar.js";
 import { PdfViewerSearchBar } from "./components/PdfViewerSearchBar.js";
@@ -45,6 +45,7 @@ export const BasePdfViewer = /*#__PURE__*/forwardRef(function ({
   initialAutoSize = false,
   initialSidebarOpen = false,
   enableDownload = false,
+  downloadFileName,
   sidebarMode: sidebarModeProp = "thumbnails",
   outlineIcons,
   className
@@ -85,6 +86,9 @@ export const BasePdfViewer = /*#__PURE__*/forwardRef(function ({
     onFormChange
   });
   const annotationsByPage = usePdfAnnotationsByPage(annotations);
+  const handleDownload = useCallback(() => {
+    viewer.download(downloadFileName);
+  }, [viewer, downloadFileName]);
   const rootClassName = classnames(styles.pdfViewer, className);
   if (viewer.loading) {
     return /*#__PURE__*/React.createElement("div", {
@@ -125,7 +129,7 @@ export const BasePdfViewer = /*#__PURE__*/forwardRef(function ({
     onAutoSizeToggle: viewer.toggleAutoSize,
     onSearchOpen: viewer.search.openSearch,
     onSidebarToggle: viewer.toggleSidebar,
-    onDownload: viewer.download,
+    onDownload: handleDownload,
     enableDownload: enableDownload,
     onRotateLeft: viewer.rotateLeft,
     onRotateRight: viewer.rotateRight,

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

@@ -1 +1 @@
-{"version":3,"file":"PdfViewer.js","names":["Error","ErrorIcon","Spin","classnames","React","forwardRef","useImperativeHandle","PdfAnnotationOverlay","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","initialAutoSize","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","autoSize","sidebarOpen","onPageChange","onZoomIn","zoomIn","onZoomOut","zoomOut","onAutoSizeToggle","toggleAutoSize","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"],"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 { PdfAnnotationOverlay } from \"./components/PdfAnnotationOverlay.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    initialAutoSize = false,\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      initialAutoSize,\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          autoSize={viewer.autoSize}\n          sidebarOpen={viewer.sidebarOpen}\n          onPageChange={viewer.scrollToPage}\n          onZoomIn={viewer.zoomIn}\n          onZoomOut={viewer.zoomOut}\n          onAutoSizeToggle={viewer.toggleAutoSize}\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 (\n                  <PdfAnnotationOverlay\n                    key={target.pageNumber}\n                    target={target}\n                    annotations={pageAnnotations}\n                    onAnnotationClick={onAnnotationClick}\n                  />\n                );\n              })}\n            </div>\n          </div>\n        </div>\n      </div>\n    );\n  },\n);\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"PdfViewer.js","names":["Error","ErrorIcon","Spin","classnames","React","forwardRef","useCallback","useImperativeHandle","PdfAnnotationOverlay","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","initialAutoSize","initialSidebarOpen","enableDownload","downloadFileName","sidebarMode","sidebarModeProp","outlineIcons","className","ref","viewer","highlightModeActive","toggleHighlightMode","deleteHighlight","pdfViewerRef","document","enabled","scrollToPage","hasFormFields","submitFormData","eventBusRef","annotationsByPage","handleDownload","download","rootClassName","pdfViewer","loading","createElement","loadingContainer","spinnerIcon","error","errorContainer","errorIcon","message","currentPage","numPages","scale","autoSize","sidebarOpen","onPageChange","onZoomIn","zoomIn","onZoomOut","zoomOut","onAutoSizeToggle","toggleAutoSize","onSearchOpen","search","openSearch","onSidebarToggle","toggleSidebar","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"],"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, useCallback, useImperativeHandle } from \"react\";\nimport { PdfAnnotationOverlay } from \"./components/PdfAnnotationOverlay.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    initialAutoSize = false,\n    initialSidebarOpen = false,\n    enableDownload = false,\n    downloadFileName,\n    sidebarMode: sidebarModeProp = \"thumbnails\",\n    outlineIcons,\n    className,\n  }, ref) {\n    const viewer = usePdfViewerState({\n      src,\n      initialPage,\n      initialScale,\n      initialAutoSize,\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 handleDownload = useCallback(() => {\n      viewer.download(downloadFileName);\n    }, [viewer, downloadFileName]);\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          autoSize={viewer.autoSize}\n          sidebarOpen={viewer.sidebarOpen}\n          onPageChange={viewer.scrollToPage}\n          onZoomIn={viewer.zoomIn}\n          onZoomOut={viewer.zoomOut}\n          onAutoSizeToggle={viewer.toggleAutoSize}\n          onSearchOpen={viewer.search.openSearch}\n          onSidebarToggle={viewer.toggleSidebar}\n          onDownload={handleDownload}\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 (\n                  <PdfAnnotationOverlay\n                    key={target.pageNumber}\n                    target={target}\n                    annotations={pageAnnotations}\n                    onAnnotationClick={onAnnotationClick}\n                  />\n                );\n              })}\n            </div>\n          </div>\n        </div>\n      </div>\n    );\n  },\n);\n"],"mappings":"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","ignoreList":[]}

package/build/browser/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\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 =\n  | \"highlight\"\n  | \"underline\"\n  | \"comment\"\n  | \"pin\"\n  | \"custom\";\n\n/** A rectangle in PDF coordinate space (origin: bottom-left of page). */\nexport interface PdfRect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** Props passed to a custom annotation renderer. */\nexport interface PdfAnnotationRenderProps {\n  annotation: PdfAnnotation;\n  scale: number;\n  pageHeight: number;\n  transform: number[];\n}\n\n/** Common fields shared by all annotation types. */\ninterface PdfAnnotationBase {\n  /** Unique identifier for this annotation */\n  id: string;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Coordinates in PDF points (origin: bottom-left of page) */\n  rect: PdfRect;\n  /** Additional rects for multi-line text highlights. When present, all rects are rendered. */\n  rects?: PdfRect[];\n  /** Optional label or tooltip text */\n  label?: string;\n  /** Optional color override (CSS color string) */\n  color?: string;\n}\n\n/** A built-in annotation type (highlight, underline, comment, pin). */\ninterface PdfStandardAnnotation extends PdfAnnotationBase {\n  /** The type of annotation to render */\n  type: \"highlight\" | \"underline\" | \"comment\" | \"pin\";\n}\n\n/** A custom annotation with a user-provided renderer. */\nexport interface PdfCustomAnnotation extends PdfAnnotationBase {\n  /** Must be \"custom\" for custom-rendered annotations */\n  type: \"custom\";\n  /** Render function for the custom annotation content (required for custom type) */\n  render: (props: PdfAnnotationRenderProps) => React.ReactNode;\n}\n\n/** A single annotation positioned on a specific page of the PDF. */\nexport type PdfAnnotation = PdfStandardAnnotation | PdfCustomAnnotation;\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/** Possible values for a PDF form field. */\nexport type PdfFormFieldValue = string | boolean | string[];\n\n/** Data emitted when the user creates a text highlight via the highlight editor. */\nexport interface PdfTextHighlightEvent {\n  /** Internal PDF.js editor ID. Use with `deleteHighlight` to programmatically remove. */\n  editorId: string;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Bounding rects in PDF coordinate space (bottom-left origin) */\n  rects: PdfRect[];\n  /** The selected text content */\n  selectedText: string;\n  /** Highlight color as CSS color string */\n  color: string;\n}\n\n/** Imperative handle for programmatic control of a {@link PdfViewer} or {@link BasePdfViewer}. */\nexport interface PdfViewerHandle {\n  /** Scroll the viewer to the given page number (1-indexed). */\n  scrollToPage: (page: number) => void;\n  /** Programmatically delete a highlight by its `editorId` (from {@link PdfTextHighlightEvent}). */\n  deleteHighlight: (editorId: string) => void;\n}\n\n/**\n * Options for {@link usePdfViewerInstance}.\n * Equivalent to {@link PdfViewerProps} minus the `className` rendering concern.\n */\nexport interface PdfViewerInstanceOptions {\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  /** Callback fired when a download completes or fails */\n  onDownload?: (result: PdfDownloadResult) => void;\n  /** Whether the highlight toggle button is shown in the toolbar */\n  highlightEnabled?: boolean;\n  /** Callback fired when the user creates a text highlight */\n  onTextHighlight?: (event: PdfTextHighlightEvent) => void;\n  /** Callback fired when the user deletes a highlight */\n  onHighlightDelete?: (event: PdfTextHighlightEvent) => void;\n  /** Initial form field values keyed by field name */\n  formData?: Record<string, PdfFormFieldValue>;\n  /** Callback fired when the user clicks the save button */\n  onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;\n  /** Callback fired when any form field value changes */\n  onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /**\n   * Whether auto-size (fit to width) is initially enabled.\n   * When enabled, the PDF scales to fit the container width and\n   * re-fits automatically on resize. Manual zoom disables auto-size.\n   * Takes precedence over {@link initialScale} when enabled.\n   * @default false\n   */\n  initialAutoSize?: boolean;\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /** Whether the download button is shown in the toolbar */\n  enableDownload?: boolean;\n  /** Which sidebar panel to show: thumbnails or document outline */\n  sidebarMode?: SidebarMode;\n  /** Custom icon components for each outline depth level (0-indexed) */\n  outlineIcons?: Partial<Record<number, React.ComponentType>>;\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 */\n  annotations?: 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  /**\n   * Whether the highlight toggle button is shown in the toolbar.\n   * @default false\n   */\n  enableHighlight?: boolean;\n  /**\n   * Callback fired when the user creates a text highlight.\n   * Only fires when highlight mode is active.\n   *\n   * @param event - The highlight event with page, rects, text, and color\n   * @returns void\n   */\n  onTextHighlight?: (event: PdfTextHighlightEvent) => void;\n  /**\n   * Callback fired when the user deletes a highlight via the PDF.js editor UI.\n   *\n   * @param event - The highlight event that was deleted\n   * @returns void\n   */\n  onHighlightDelete?: (event: PdfTextHighlightEvent) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /**\n   * Whether auto-size (fit to width) is initially enabled.\n   * When enabled, the PDF scales to fit the container width and\n   * re-fits automatically on resize. Manual zoom disables auto-size.\n   * Takes precedence over {@link initialScale} when enabled.\n   * @default false\n   */\n  initialAutoSize?: boolean;\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  /**\n   * Initial form field values keyed by field name. Applied when the document loads.\n   * Use this to pre-populate form fields when resuming a previously edited PDF.\n   */\n  formData?: Record<string, PdfFormFieldValue>;\n  /**\n   * Callback fired when the user clicks the save button in the toolbar.\n   * Receives all current form field values keyed by field name.\n   *\n   * @param data - All form field values keyed by field name\n   * @returns void\n   */\n  onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;\n  /**\n   * Callback fired when any form field value changes.\n   *\n   * @param fieldName - The name of the field that changed\n   * @param value - The new value\n   * @returns void\n   */\n  onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;\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 =\n  | \"highlight\"\n  | \"underline\"\n  | \"comment\"\n  | \"pin\"\n  | \"custom\";\n\n/** A rectangle in PDF coordinate space (origin: bottom-left of page). */\nexport interface PdfRect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** Props passed to a custom annotation renderer. */\nexport interface PdfAnnotationRenderProps {\n  annotation: PdfAnnotation;\n  scale: number;\n  pageHeight: number;\n  transform: number[];\n}\n\n/** Common fields shared by all annotation types. */\ninterface PdfAnnotationBase {\n  /** Unique identifier for this annotation */\n  id: string;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Coordinates in PDF points (origin: bottom-left of page) */\n  rect: PdfRect;\n  /** Additional rects for multi-line text highlights. When present, all rects are rendered. */\n  rects?: PdfRect[];\n  /** Optional label or tooltip text */\n  label?: string;\n  /** Optional color override (CSS color string) */\n  color?: string;\n}\n\n/** A built-in annotation type (highlight, underline, comment, pin). */\ninterface PdfStandardAnnotation extends PdfAnnotationBase {\n  /** The type of annotation to render */\n  type: \"highlight\" | \"underline\" | \"comment\" | \"pin\";\n}\n\n/** A custom annotation with a user-provided renderer. */\nexport interface PdfCustomAnnotation extends PdfAnnotationBase {\n  /** Must be \"custom\" for custom-rendered annotations */\n  type: \"custom\";\n  /** Render function for the custom annotation content (required for custom type) */\n  render: (props: PdfAnnotationRenderProps) => React.ReactNode;\n}\n\n/** A single annotation positioned on a specific page of the PDF. */\nexport type PdfAnnotation = PdfStandardAnnotation | PdfCustomAnnotation;\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/** Possible values for a PDF form field. */\nexport type PdfFormFieldValue = string | boolean | string[];\n\n/** Data emitted when the user creates a text highlight via the highlight editor. */\nexport interface PdfTextHighlightEvent {\n  /** Internal PDF.js editor ID. Use with `deleteHighlight` to programmatically remove. */\n  editorId: string;\n  /** Page number (1-indexed) */\n  page: number;\n  /** Bounding rects in PDF coordinate space (bottom-left origin) */\n  rects: PdfRect[];\n  /** The selected text content */\n  selectedText: string;\n  /** Highlight color as CSS color string */\n  color: string;\n}\n\n/** Imperative handle for programmatic control of a {@link PdfViewer} or {@link BasePdfViewer}. */\nexport interface PdfViewerHandle {\n  /** Scroll the viewer to the given page number (1-indexed). */\n  scrollToPage: (page: number) => void;\n  /** Programmatically delete a highlight by its `editorId` (from {@link PdfTextHighlightEvent}). */\n  deleteHighlight: (editorId: string) => void;\n}\n\n/**\n * Options for {@link usePdfViewerInstance}.\n * Equivalent to {@link PdfViewerProps} minus the `className` rendering concern.\n */\nexport interface PdfViewerInstanceOptions {\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  /** Callback fired when a download completes or fails */\n  onDownload?: (result: PdfDownloadResult) => void;\n  /** Whether the highlight toggle button is shown in the toolbar */\n  highlightEnabled?: boolean;\n  /** Callback fired when the user creates a text highlight */\n  onTextHighlight?: (event: PdfTextHighlightEvent) => void;\n  /** Callback fired when the user deletes a highlight */\n  onHighlightDelete?: (event: PdfTextHighlightEvent) => void;\n  /** Initial form field values keyed by field name */\n  formData?: Record<string, PdfFormFieldValue>;\n  /** Callback fired when the user clicks the save button */\n  onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;\n  /** Callback fired when any form field value changes */\n  onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /**\n   * Whether auto-size (fit to width) is initially enabled.\n   * When enabled, the PDF scales to fit the container width and\n   * re-fits automatically on resize. Manual zoom disables auto-size.\n   * Takes precedence over {@link initialScale} when enabled.\n   * @default false\n   */\n  initialAutoSize?: boolean;\n  /** Whether the sidebar is initially open (default false) */\n  initialSidebarOpen?: boolean;\n  /** Whether the download button is shown in the toolbar */\n  enableDownload?: boolean;\n  /** Which sidebar panel to show: thumbnails or document outline */\n  sidebarMode?: SidebarMode;\n  /** Custom icon components for each outline depth level (0-indexed) */\n  outlineIcons?: Partial<Record<number, React.ComponentType>>;\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 */\n  annotations?: 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  /**\n   * Whether the highlight toggle button is shown in the toolbar.\n   * @default false\n   */\n  enableHighlight?: boolean;\n  /**\n   * Callback fired when the user creates a text highlight.\n   * Only fires when highlight mode is active.\n   *\n   * @param event - The highlight event with page, rects, text, and color\n   * @returns void\n   */\n  onTextHighlight?: (event: PdfTextHighlightEvent) => void;\n  /**\n   * Callback fired when the user deletes a highlight via the PDF.js editor UI.\n   *\n   * @param event - The highlight event that was deleted\n   * @returns void\n   */\n  onHighlightDelete?: (event: PdfTextHighlightEvent) => void;\n  /** Initial page number (1-indexed, default 1) */\n  initialPage?: number;\n  /** Initial zoom scale (default 1.0) */\n  initialScale?: number;\n  /**\n   * Whether auto-size (fit to width) is initially enabled.\n   * When enabled, the PDF scales to fit the container width and\n   * re-fits automatically on resize. Manual zoom disables auto-size.\n   * Takes precedence over {@link initialScale} when enabled.\n   * @default false\n   */\n  initialAutoSize?: boolean;\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   * Filename used when the user downloads the PDF via the toolbar button.\n   * If omitted, the name is derived from the `src` URL, falling back to \"document.pdf\".\n   */\n  downloadFileName?: string;\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  /**\n   * Initial form field values keyed by field name. Applied when the document loads.\n   * Use this to pre-populate form fields when resuming a previously edited PDF.\n   */\n  formData?: Record<string, PdfFormFieldValue>;\n  /**\n   * Callback fired when the user clicks the save button in the toolbar.\n   * Receives all current form field values keyed by field name.\n   *\n   * @param data - All form field values keyed by field name\n   * @returns void\n   */\n  onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;\n  /**\n   * Callback fired when any form field value changes.\n   *\n   * @param fieldName - The name of the field that changed\n   * @param value - The new value\n   * @returns void\n   */\n  onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;\n  /** Additional CSS class name for the root element */\n  className?: string;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/util/UserAgent.js

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-const PACKAGE_USER_AGENT = `osdk-react-components/${"0.28.0"}`;
+const PACKAGE_USER_AGENT = `osdk-react-components/${"0.29.0-main-ee3bce8a1ee0d096ebcab66bfbc2d9d75977c26d"}`;
 export function componentUserAgent(componentName) {
   return `${PACKAGE_USER_AGENT}/${componentName}`;
 }

package/build/browser/util/UserAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserAgent.js","names":["PACKAGE_USER_AGENT","componentUserAgent","componentName"],"sources":["UserAgent.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\nconst PACKAGE_USER_AGENT =\n  `osdk-react-components/${process.env.PACKAGE_VERSION}`;\n\nexport function componentUserAgent(componentName: string): string {\n  return `${PACKAGE_USER_AGENT}/${componentName}`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,kBAAkB,GACtB,mCAAsD;AAExD,OAAO,SAASC,kBAAkBA,CAACC,aAAqB,EAAU;EAChE,OAAO,GAAGF,kBAAkB,IAAIE,aAAa,EAAE;AACjD","ignoreList":[]}
+{"version":3,"file":"UserAgent.js","names":["PACKAGE_USER_AGENT","componentUserAgent","componentName"],"sources":["UserAgent.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\nconst PACKAGE_USER_AGENT =\n  `osdk-react-components/${process.env.PACKAGE_VERSION}`;\n\nexport function componentUserAgent(componentName: string): string {\n  return `${PACKAGE_USER_AGENT}/${componentName}`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,kBAAkB,GACtB,iFAAsD;AAExD,OAAO,SAASC,kBAAkBA,CAACC,aAAqB,EAAU;EAChE,OAAO,GAAGF,kBAAkB,IAAIE,aAAa,EAAE;AACjD","ignoreList":[]}

package/build/cjs/{chunk-OJ4Q6LJ6.cjs → chunk-2Y7HLI74.cjs}

@@ -7,7 +7,7 @@ var chunkHNBSGCSZ_cjs = require('./chunk-HNBSGCSZ.cjs');
 var chunk7LXS66DW_cjs = require('./chunk-7LXS66DW.cjs');
 var chunkMD4KDE44_cjs = require('./chunk-MD4KDE44.cjs');
 var chunkUCTQICPR_cjs = require('./chunk-UCTQICPR.cjs');
-var chunkD565X4TE_cjs = require('./chunk-D565X4TE.cjs');
+var chunkD7RLWXOJ_cjs = require('./chunk-D7RLWXOJ.cjs');
 var react = require('@osdk/react');
 var React17 = require('react');
 var icons = require('@blueprintjs/icons');
@@ -1849,9 +1849,9 @@ var ActionForm = chunk3S52UDZM_cjs.typedReactMemo(function ActionFormFn({
 });
 
 // src/public/experimental/action-form.ts
-var ActionForm2 = chunkD565X4TE_cjs.withOsdkMetrics(ActionForm, "ActionForm");
+var ActionForm2 = chunkD7RLWXOJ_cjs.withOsdkMetrics(ActionForm, "ActionForm");
 
 exports.ActionForm = ActionForm2;
 exports.BaseForm = BaseForm;
-//# sourceMappingURL=chunk-OJ4Q6LJ6.cjs.map
-//# sourceMappingURL=chunk-OJ4Q6LJ6.cjs.map
+//# sourceMappingURL=chunk-2Y7HLI74.cjs.map
+//# sourceMappingURL=chunk-2Y7HLI74.cjs.map