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

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

@@ -0,0 +1,199 @@
+/*
+ * 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 { AnnotationEditorType } from "pdfjs-dist";
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Converts an RGB array (0.0–1.0 per channel) to a CSS hex color string.
+ */
+export function rgbArrayToHex(color) {
+  const r = Math.round(color[0] * 255);
+  const g = Math.round(color[1] * 255);
+  const b = Math.round(color[2] * 255);
+  return `#${r.toString(16).padStart(2, "0")}${g.toString(16).padStart(2, "0")}${b.toString(16).padStart(2, "0")}`;
+}
+
+/**
+ * Converts quadPoints (PDF spec format) back to PdfRect[].
+ * QuadPoints are 8 values per quad: [x1,y1, x2,y2, x3,y3, x4,y4]
+ * representing the four corners of each highlight rect.
+ *
+ * PDF.js highlight editor produces axis-aligned quads with ordering:
+ *   (x1,y1)=top-left, (x2,y2)=top-right, (x3,y3)=bottom-left, (x4,y4)=bottom-right
+ * We derive the bounding rect from x1, y1 (top), x2 (right edge), y3 (bottom).
+ */
+export function quadPointsToRects(quadPoints) {
+  const rects = [];
+  for (let i = 0; i < quadPoints.length; i += 8) {
+    const x1 = quadPoints[i];
+    const y1 = quadPoints[i + 1];
+    const x2 = quadPoints[i + 2];
+    const y3 = quadPoints[i + 5];
+    const x = Math.min(x1, x2);
+    const y = Math.min(y1, y3);
+    const width = Math.abs(x2 - x1);
+    const height = Math.abs(y1 - y3);
+    rects.push({
+      x,
+      y,
+      width,
+      height
+    });
+  }
+  return rects;
+}
+
+/**
+ * Hook that manages the PDF.js built-in highlight annotation editor mode.
+ * When active, users can select text to create highlights.
+ * A callback fires with the annotation details for persistence.
+ */
+export function usePdfHighlightMode({
+  pdfViewerRef,
+  document,
+  enabled,
+  onTextHighlight,
+  onHighlightDelete
+}) {
+  const [highlightModeActive, setHighlightModeActive] = useState(false);
+  const onTextHighlightRef = useRef(onTextHighlight);
+  const onHighlightDeleteRef = useRef(onHighlightDelete);
+  const knownEditorIdsRef = useRef(new Set());
+  const editorEventsRef = useRef(new Map());
+
+  // Keep callback refs in sync
+  useEffect(function () {
+    onTextHighlightRef.current = onTextHighlight;
+    onHighlightDeleteRef.current = onHighlightDelete;
+  }, [onTextHighlight, onHighlightDelete]);
+
+  // Toggle the PDF.js annotation editor mode
+  useEffect(function () {
+    const pdfViewer = pdfViewerRef.current;
+    if (pdfViewer == null || document == null) {
+      return;
+    }
+    try {
+      if (highlightModeActive && enabled) {
+        pdfViewer.annotationEditorMode = {
+          mode: AnnotationEditorType.HIGHLIGHT
+        };
+      } else {
+        pdfViewer.annotationEditorMode = {
+          mode: AnnotationEditorType.NONE
+        };
+      }
+    } catch {
+      // AnnotationEditorUIManager may not be initialized yet
+    }
+  }, [pdfViewerRef, document, highlightModeActive, enabled]);
+
+  // Deactivate highlight mode when the feature is disabled
+  useEffect(function () {
+    if (!enabled) {
+      setHighlightModeActive(false);
+    }
+  }, [enabled]);
+
+  // Clear tracked editors when the document changes (but not on highlight toggle)
+  const prevDocumentRef = useRef(undefined);
+  useEffect(function () {
+    if (document !== prevDocumentRef.current) {
+      knownEditorIdsRef.current.clear();
+      editorEventsRef.current.clear();
+      prevDocumentRef.current = document;
+    }
+  }, [document]);
+
+  // Listen for new highlights being added to annotation storage
+  useEffect(function () {
+    if (document == null || !highlightModeActive || !enabled) {
+      return;
+    }
+    const storage = document.annotationStorage;
+    const previousOnAnnotationEditor = storage.onAnnotationEditor;
+
+    // Monkey-patch storage.remove to detect highlight deletions.
+    // This is fragile but necessary because PDF.js does not emit events
+    // when editors are removed. Restore the original on cleanup.
+    const originalRemove = storage.remove.bind(storage);
+    storage.remove = key => {
+      const savedEvent = editorEventsRef.current.get(key);
+      if (savedEvent != null) {
+        editorEventsRef.current.delete(key);
+        knownEditorIdsRef.current.delete(key);
+        onHighlightDeleteRef.current?.(savedEvent);
+      }
+      originalRemove(key);
+    };
+    storage.onAnnotationEditor = type => {
+      // onAnnotationEditor fires with the editor's static _type (string "highlight")
+      if (type !== "highlight") {
+        return;
+      }
+
+      // Find new editors in storage
+      const allEntries = storage.getAll();
+      if (allEntries == null) {
+        return;
+      }
+      for (const [id, entry] of Object.entries(allEntries)) {
+        if (knownEditorIdsRef.current.has(id)) {
+          continue;
+        }
+
+        // Check if this is a highlight editor with serializable data
+        if (typeof entry === "object" && entry != null && "serialize" in entry && typeof entry.serialize === "function") {
+          knownEditorIdsRef.current.add(id);
+          const serialized = entry.serialize(false);
+          if (serialized == null || serialized.annotationType !== AnnotationEditorType.HIGHLIGHT) {
+            continue;
+          }
+          const rects = serialized.quadPoints != null ? quadPointsToRects(serialized.quadPoints) : [];
+          if (rects.length === 0) {
+            continue;
+          }
+          const color = Array.isArray(serialized.color) ? rgbArrayToHex(serialized.color) : "#fff066";
+
+          // Extract text from the editor's aria-label (stores selected text)
+          const selectedText = typeof entry.div?.getAttribute === "function" ? entry.div.getAttribute("aria-label") ?? "" : "";
+          const event = {
+            page: serialized.pageIndex + 1,
+            rects,
+            selectedText,
+            color
+          };
+
+          // Store the event so we can provide it back on delete
+          editorEventsRef.current.set(id, event);
+          onTextHighlightRef.current?.(event);
+        }
+      }
+    };
+    return () => {
+      storage.onAnnotationEditor = previousOnAnnotationEditor;
+      storage.remove = originalRemove;
+    };
+  }, [document, highlightModeActive, enabled]);
+  const toggleHighlightMode = useCallback(() => {
+    setHighlightModeActive(prev => !prev);
+  }, []);
+  return {
+    highlightModeActive,
+    toggleHighlightMode
+  };
+}
+//# sourceMappingURL=usePdfHighlightMode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfHighlightMode.js","names":["AnnotationEditorType","useCallback","useEffect","useRef","useState","rgbArrayToHex","color","r","Math","round","g","b","toString","padStart","quadPointsToRects","quadPoints","rects","i","length","x1","y1","x2","y3","x","min","y","width","abs","height","push","usePdfHighlightMode","pdfViewerRef","document","enabled","onTextHighlight","onHighlightDelete","highlightModeActive","setHighlightModeActive","onTextHighlightRef","onHighlightDeleteRef","knownEditorIdsRef","Set","editorEventsRef","Map","current","pdfViewer","annotationEditorMode","mode","HIGHLIGHT","NONE","prevDocumentRef","undefined","clear","storage","annotationStorage","previousOnAnnotationEditor","onAnnotationEditor","originalRemove","remove","bind","key","savedEvent","get","delete","type","allEntries","getAll","id","entry","Object","entries","has","serialize","add","serialized","annotationType","Array","isArray","selectedText","div","getAttribute","event","page","pageIndex","set","toggleHighlightMode","prev"],"sources":["usePdfHighlightMode.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 { AnnotationEditorType } from \"pdfjs-dist\";\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport type { PDFViewer } from \"pdfjs-dist/web/pdf_viewer.mjs\";\nimport type { RefObject } from \"react\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { PdfRect, PdfTextHighlightEvent } from \"../types.js\";\n\nexport interface UsePdfHighlightModeOptions {\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  document: PDFDocumentProxy | undefined;\n  enabled: boolean;\n  onTextHighlight?: (event: PdfTextHighlightEvent) => void;\n  onHighlightDelete?: (event: PdfTextHighlightEvent) => void;\n}\n\nexport interface UsePdfHighlightModeResult {\n  highlightModeActive: boolean;\n  toggleHighlightMode: () => void;\n}\n\n/**\n * Converts an RGB array (0.0–1.0 per channel) to a CSS hex color string.\n */\nexport function rgbArrayToHex(color: number[]): string {\n  const r = Math.round(color[0] * 255);\n  const g = Math.round(color[1] * 255);\n  const b = Math.round(color[2] * 255);\n  return `#${r.toString(16).padStart(2, \"0\")}${\n    g.toString(16).padStart(2, \"0\")\n  }${b.toString(16).padStart(2, \"0\")}`;\n}\n\n/**\n * Converts quadPoints (PDF spec format) back to PdfRect[].\n * QuadPoints are 8 values per quad: [x1,y1, x2,y2, x3,y3, x4,y4]\n * representing the four corners of each highlight rect.\n *\n * PDF.js highlight editor produces axis-aligned quads with ordering:\n *   (x1,y1)=top-left, (x2,y2)=top-right, (x3,y3)=bottom-left, (x4,y4)=bottom-right\n * We derive the bounding rect from x1, y1 (top), x2 (right edge), y3 (bottom).\n */\nexport function quadPointsToRects(\n  quadPoints: Float32Array,\n): PdfRect[] {\n  const rects: PdfRect[] = [];\n  for (let i = 0; i < quadPoints.length; i += 8) {\n    const x1 = quadPoints[i];\n    const y1 = quadPoints[i + 1];\n    const x2 = quadPoints[i + 2];\n    const y3 = quadPoints[i + 5];\n\n    const x = Math.min(x1, x2);\n    const y = Math.min(y1, y3);\n    const width = Math.abs(x2 - x1);\n    const height = Math.abs(y1 - y3);\n\n    rects.push({ x, y, width, height });\n  }\n  return rects;\n}\n\n/**\n * Hook that manages the PDF.js built-in highlight annotation editor mode.\n * When active, users can select text to create highlights.\n * A callback fires with the annotation details for persistence.\n */\nexport function usePdfHighlightMode({\n  pdfViewerRef,\n  document,\n  enabled,\n  onTextHighlight,\n  onHighlightDelete,\n}: UsePdfHighlightModeOptions): UsePdfHighlightModeResult {\n  const [highlightModeActive, setHighlightModeActive] = useState(false);\n  const onTextHighlightRef = useRef(onTextHighlight);\n  const onHighlightDeleteRef = useRef(onHighlightDelete);\n  const knownEditorIdsRef = useRef<Set<string>>(new Set());\n  const editorEventsRef = useRef<Map<string, PdfTextHighlightEvent>>(new Map());\n\n  // Keep callback refs in sync\n  useEffect(function syncCallbackRef() {\n    onTextHighlightRef.current = onTextHighlight;\n    onHighlightDeleteRef.current = onHighlightDelete;\n  }, [onTextHighlight, onHighlightDelete]);\n\n  // Toggle the PDF.js annotation editor mode\n  useEffect(function syncHighlightMode() {\n    const pdfViewer = pdfViewerRef.current;\n    if (pdfViewer == null || document == null) {\n      return;\n    }\n\n    try {\n      if (highlightModeActive && enabled) {\n        pdfViewer.annotationEditorMode = {\n          mode: AnnotationEditorType.HIGHLIGHT,\n        };\n      } else {\n        pdfViewer.annotationEditorMode = {\n          mode: AnnotationEditorType.NONE,\n        };\n      }\n    } catch {\n      // AnnotationEditorUIManager may not be initialized yet\n    }\n  }, [pdfViewerRef, document, highlightModeActive, enabled]);\n\n  // Deactivate highlight mode when the feature is disabled\n  useEffect(function deactivateOnDisable() {\n    if (!enabled) {\n      setHighlightModeActive(false);\n    }\n  }, [enabled]);\n\n  // Clear tracked editors when the document changes (but not on highlight toggle)\n  const prevDocumentRef = useRef<PDFDocumentProxy | undefined>(undefined);\n  useEffect(function clearOnDocumentChange() {\n    if (document !== prevDocumentRef.current) {\n      knownEditorIdsRef.current.clear();\n      editorEventsRef.current.clear();\n      prevDocumentRef.current = document;\n    }\n  }, [document]);\n\n  // Listen for new highlights being added to annotation storage\n  useEffect(function listenForHighlights() {\n    if (document == null || !highlightModeActive || !enabled) {\n      return;\n    }\n\n    const storage = document.annotationStorage;\n    const previousOnAnnotationEditor = storage.onAnnotationEditor;\n\n    // Monkey-patch storage.remove to detect highlight deletions.\n    // This is fragile but necessary because PDF.js does not emit events\n    // when editors are removed. Restore the original on cleanup.\n    const originalRemove = storage.remove.bind(storage);\n    storage.remove = (key: string) => {\n      const savedEvent = editorEventsRef.current.get(key);\n      if (savedEvent != null) {\n        editorEventsRef.current.delete(key);\n        knownEditorIdsRef.current.delete(key);\n        onHighlightDeleteRef.current?.(savedEvent);\n      }\n      originalRemove(key);\n    };\n\n    storage.onAnnotationEditor = (type: string | number | null) => {\n      // onAnnotationEditor fires with the editor's static _type (string \"highlight\")\n      if (type !== \"highlight\") {\n        return;\n      }\n\n      // Find new editors in storage\n      const allEntries = storage.getAll();\n      if (allEntries == null) {\n        return;\n      }\n\n      for (const [id, entry] of Object.entries(allEntries)) {\n        if (knownEditorIdsRef.current.has(id)) {\n          continue;\n        }\n\n        // Check if this is a highlight editor with serializable data\n        if (\n          typeof entry === \"object\" && entry != null\n          && \"serialize\" in entry\n          && typeof entry.serialize === \"function\"\n        ) {\n          knownEditorIdsRef.current.add(id);\n          const serialized = entry.serialize(false);\n          if (\n            serialized == null\n            || serialized.annotationType !== AnnotationEditorType.HIGHLIGHT\n          ) {\n            continue;\n          }\n\n          const rects = serialized.quadPoints != null\n            ? quadPointsToRects(serialized.quadPoints)\n            : [];\n\n          if (rects.length === 0) {\n            continue;\n          }\n\n          const color = Array.isArray(serialized.color)\n            ? rgbArrayToHex(serialized.color)\n            : \"#fff066\";\n\n          // Extract text from the editor's aria-label (stores selected text)\n          const selectedText = typeof entry.div?.getAttribute === \"function\"\n            ? entry.div.getAttribute(\"aria-label\") ?? \"\"\n            : \"\";\n\n          const event: PdfTextHighlightEvent = {\n            page: serialized.pageIndex + 1,\n            rects,\n            selectedText,\n            color,\n          };\n\n          // Store the event so we can provide it back on delete\n          editorEventsRef.current.set(id, event);\n\n          onTextHighlightRef.current?.(event);\n        }\n      }\n    };\n\n    return () => {\n      storage.onAnnotationEditor = previousOnAnnotationEditor;\n      storage.remove = originalRemove;\n    };\n  }, [document, highlightModeActive, enabled]);\n\n  const toggleHighlightMode = useCallback(() => {\n    setHighlightModeActive((prev) => !prev);\n  }, []);\n\n  return {\n    highlightModeActive,\n    toggleHighlightMode,\n  };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import { AnnotationEditorType } from "pdfjs-dist";
 import { EventBus, PDFFindController, PDFLinkService, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
 import { useEffect, useRef } from "react";
 import { PAGES_LOADED_EVENT } from "../constants.js";
@@ -42,25 +43,30 @@ export function usePdfViewer(containerRef, viewerRef, document, initialScale, in
       eventBus,
       linkService,
       findController,
-      removePageBorders: true
+      removePageBorders: true,
+      annotationEditorMode: AnnotationEditorType.NONE,
+      annotationEditorHighlightColors: "yellow=#FFFF98,green=#53FFBC,blue=#80EBFF,pink=#FFCBE6,red=#FF4F5F"
     });
     linkService.setViewer(pdfViewer);
     linkService.setDocument(document);
     findController.setDocument(document);
     pdfViewer.setDocument(document);
-    if (initialScale != null) {
-      pdfViewer.currentScale = initialScale;
-    }
-    if (initialPage != null && initialPage > 1) {
-      const onPagesLoaded = () => {
+
+    // Apply initial scale and page after pages are loaded to avoid
+    // "scrollPageIntoView: not a valid pageNumber" console errors.
+    const onPagesLoaded = () => {
+      if (initialScale != null) {
+        pdfViewer.currentScale = initialScale;
+      }
+      if (initialPage != null && initialPage > 1) {
         pdfViewer.currentPageNumber = initialPage;
         pdfViewer.scrollPageIntoView({
           pageNumber: initialPage
         });
-        eventBus.off(PAGES_LOADED_EVENT, onPagesLoaded);
-      };
-      eventBus.on(PAGES_LOADED_EVENT, onPagesLoaded);
-    }
+      }
+      eventBus.off(PAGES_LOADED_EVENT, onPagesLoaded);
+    };
+    eventBus.on(PAGES_LOADED_EVENT, onPagesLoaded);
     eventBusRef.current = eventBus;
     findControllerRef.current = findController;
     pdfViewerRef.current = pdfViewer;

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

@@ -1 +1 @@
-{"version":3,"file":"usePdfViewer.js","names":["EventBus","PDFFindController","PDFLinkService","PDFViewer","useEffect","useRef","PAGES_LOADED_EVENT","usePdfViewer","containerRef","viewerRef","document","initialScale","initialPage","pdfViewerRef","eventBusRef","findControllerRef","container","current","viewer","eventBus","linkService","findController","updateMatchesCountOnProgress","pdfViewer","removePageBorders","setViewer","setDocument","currentScale","onPagesLoaded","currentPageNumber","scrollPageIntoView","pageNumber","off","on","cleanup"],"sources":["usePdfViewer.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport {\n  EventBus,\n  PDFFindController,\n  PDFLinkService,\n  PDFViewer,\n} from \"pdfjs-dist/web/pdf_viewer.mjs\";\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\nimport { PAGES_LOADED_EVENT } from \"../constants.js\";\n\nexport interface UsePdfViewerResult {\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  eventBusRef: RefObject<EventBus | null>;\n  findControllerRef: RefObject<PDFFindController | null>;\n}\n\nexport function usePdfViewer(\n  containerRef: RefObject<HTMLDivElement | null>,\n  viewerRef: RefObject<HTMLDivElement | null>,\n  document: PDFDocumentProxy | undefined,\n  initialScale?: number,\n  initialPage?: number,\n): UsePdfViewerResult {\n  const pdfViewerRef = useRef<PDFViewer | null>(null);\n  const eventBusRef = useRef<EventBus | null>(null);\n  const findControllerRef = useRef<PDFFindController | null>(null);\n\n  useEffect(function initializePdfViewer() {\n    const container = containerRef.current;\n    const viewer = viewerRef.current;\n    if (container == null || viewer == null || document == null) {\n      return;\n    }\n\n    const eventBus = new EventBus();\n    const linkService = new PDFLinkService({ eventBus });\n    const findController = new PDFFindController({\n      linkService,\n      eventBus,\n      updateMatchesCountOnProgress: true,\n    });\n\n    const pdfViewer = new PDFViewer({\n      container,\n      viewer,\n      eventBus,\n      linkService,\n      findController,\n      removePageBorders: true,\n    });\n\n    linkService.setViewer(pdfViewer);\n    linkService.setDocument(document);\n    findController.setDocument(document);\n    pdfViewer.setDocument(document);\n\n    if (initialScale != null) {\n      pdfViewer.currentScale = initialScale;\n    }\n\n    if (initialPage != null && initialPage > 1) {\n      const onPagesLoaded = () => {\n        pdfViewer.currentPageNumber = initialPage;\n        pdfViewer.scrollPageIntoView({ pageNumber: initialPage });\n        eventBus.off(PAGES_LOADED_EVENT, onPagesLoaded);\n      };\n      eventBus.on(PAGES_LOADED_EVENT, onPagesLoaded);\n    }\n\n    eventBusRef.current = eventBus;\n    findControllerRef.current = findController;\n    pdfViewerRef.current = pdfViewer;\n\n    return () => {\n      pdfViewerRef.current = null;\n      eventBusRef.current = null;\n      findControllerRef.current = null;\n      pdfViewer.cleanup();\n    };\n  }, [containerRef, viewerRef, document]);\n\n  return { pdfViewerRef, eventBusRef, findControllerRef };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SACEA,QAAQ,EACRC,iBAAiB,EACjBC,cAAc,EACdC,SAAS,QACJ,+BAA+B;AAEtC,SAASC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAASC,kBAAkB,QAAQ,iBAAiB;AAQpD,OAAO,SAASC,YAAYA,CAC1BC,YAA8C,EAC9CC,SAA2C,EAC3CC,QAAsC,EACtCC,YAAqB,EACrBC,WAAoB,EACA;EACpB,MAAMC,YAAY,GAAGR,MAAM,CAAmB,IAAI,CAAC;EACnD,MAAMS,WAAW,GAAGT,MAAM,CAAkB,IAAI,CAAC;EACjD,MAAMU,iBAAiB,GAAGV,MAAM,CAA2B,IAAI,CAAC;EAEhED,SAAS,CAAC,YAA+B;IACvC,MAAMY,SAAS,GAAGR,YAAY,CAACS,OAAO;IACtC,MAAMC,MAAM,GAAGT,SAAS,CAACQ,OAAO;IAChC,IAAID,SAAS,IAAI,IAAI,IAAIE,MAAM,IAAI,IAAI,IAAIR,QAAQ,IAAI,IAAI,EAAE;MAC3D;IACF;IAEA,MAAMS,QAAQ,GAAG,IAAInB,QAAQ,CAAC,CAAC;IAC/B,MAAMoB,WAAW,GAAG,IAAIlB,cAAc,CAAC;MAAEiB;IAAS,CAAC,CAAC;IACpD,MAAME,cAAc,GAAG,IAAIpB,iBAAiB,CAAC;MAC3CmB,WAAW;MACXD,QAAQ;MACRG,4BAA4B,EAAE;IAChC,CAAC,CAAC;IAEF,MAAMC,SAAS,GAAG,IAAIpB,SAAS,CAAC;MAC9Ba,SAAS;MACTE,MAAM;MACNC,QAAQ;MACRC,WAAW;MACXC,cAAc;MACdG,iBAAiB,EAAE;IACrB,CAAC,CAAC;IAEFJ,WAAW,CAACK,SAAS,CAACF,SAAS,CAAC;IAChCH,WAAW,CAACM,WAAW,CAAChB,QAAQ,CAAC;IACjCW,cAAc,CAACK,WAAW,CAAChB,QAAQ,CAAC;IACpCa,SAAS,CAACG,WAAW,CAAChB,QAAQ,CAAC;IAE/B,IAAIC,YAAY,IAAI,IAAI,EAAE;MACxBY,SAAS,CAACI,YAAY,GAAGhB,YAAY;IACvC;IAEA,IAAIC,WAAW,IAAI,IAAI,IAAIA,WAAW,GAAG,CAAC,EAAE;MAC1C,MAAMgB,aAAa,GAAGA,CAAA,KAAM;QAC1BL,SAAS,CAACM,iBAAiB,GAAGjB,WAAW;QACzCW,SAAS,CAACO,kBAAkB,CAAC;UAAEC,UAAU,EAAEnB;QAAY,CAAC,CAAC;QACzDO,QAAQ,CAACa,GAAG,CAAC1B,kBAAkB,EAAEsB,aAAa,CAAC;MACjD,CAAC;MACDT,QAAQ,CAACc,EAAE,CAAC3B,kBAAkB,EAAEsB,aAAa,CAAC;IAChD;IAEAd,WAAW,CAACG,OAAO,GAAGE,QAAQ;IAC9BJ,iBAAiB,CAACE,OAAO,GAAGI,cAAc;IAC1CR,YAAY,CAACI,OAAO,GAAGM,SAAS;IAEhC,OAAO,MAAM;MACXV,YAAY,CAACI,OAAO,GAAG,IAAI;MAC3BH,WAAW,CAACG,OAAO,GAAG,IAAI;MAC1BF,iBAAiB,CAACE,OAAO,GAAG,IAAI;MAChCM,SAAS,CAACW,OAAO,CAAC,CAAC;IACrB,CAAC;EACH,CAAC,EAAE,CAAC1B,YAAY,EAAEC,SAAS,EAAEC,QAAQ,CAAC,CAAC;EAEvC,OAAO;IAAEG,YAAY;IAAEC,WAAW;IAAEC;EAAkB,CAAC;AACzD","ignoreList":[]}
+{"version":3,"file":"usePdfViewer.js","names":["AnnotationEditorType","EventBus","PDFFindController","PDFLinkService","PDFViewer","useEffect","useRef","PAGES_LOADED_EVENT","usePdfViewer","containerRef","viewerRef","document","initialScale","initialPage","pdfViewerRef","eventBusRef","findControllerRef","container","current","viewer","eventBus","linkService","findController","updateMatchesCountOnProgress","pdfViewer","removePageBorders","annotationEditorMode","NONE","annotationEditorHighlightColors","setViewer","setDocument","onPagesLoaded","currentScale","currentPageNumber","scrollPageIntoView","pageNumber","off","on","cleanup"],"sources":["usePdfViewer.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AnnotationEditorType } from \"pdfjs-dist\";\nimport type { PDFDocumentProxy } from \"pdfjs-dist\";\nimport {\n  EventBus,\n  PDFFindController,\n  PDFLinkService,\n  PDFViewer,\n} from \"pdfjs-dist/web/pdf_viewer.mjs\";\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\nimport { PAGES_LOADED_EVENT } from \"../constants.js\";\n\nexport interface UsePdfViewerResult {\n  pdfViewerRef: RefObject<PDFViewer | null>;\n  eventBusRef: RefObject<EventBus | null>;\n  findControllerRef: RefObject<PDFFindController | null>;\n}\n\nexport function usePdfViewer(\n  containerRef: RefObject<HTMLDivElement | null>,\n  viewerRef: RefObject<HTMLDivElement | null>,\n  document: PDFDocumentProxy | undefined,\n  initialScale?: number,\n  initialPage?: number,\n): UsePdfViewerResult {\n  const pdfViewerRef = useRef<PDFViewer | null>(null);\n  const eventBusRef = useRef<EventBus | null>(null);\n  const findControllerRef = useRef<PDFFindController | null>(null);\n\n  useEffect(function initializePdfViewer() {\n    const container = containerRef.current;\n    const viewer = viewerRef.current;\n    if (container == null || viewer == null || document == null) {\n      return;\n    }\n\n    const eventBus = new EventBus();\n    const linkService = new PDFLinkService({ eventBus });\n    const findController = new PDFFindController({\n      linkService,\n      eventBus,\n      updateMatchesCountOnProgress: true,\n    });\n\n    const pdfViewer = new PDFViewer({\n      container,\n      viewer,\n      eventBus,\n      linkService,\n      findController,\n      removePageBorders: true,\n      annotationEditorMode: AnnotationEditorType.NONE,\n      annotationEditorHighlightColors:\n        \"yellow=#FFFF98,green=#53FFBC,blue=#80EBFF,pink=#FFCBE6,red=#FF4F5F\",\n    });\n\n    linkService.setViewer(pdfViewer);\n    linkService.setDocument(document);\n    findController.setDocument(document);\n    pdfViewer.setDocument(document);\n\n    // Apply initial scale and page after pages are loaded to avoid\n    // \"scrollPageIntoView: not a valid pageNumber\" console errors.\n    const onPagesLoaded = () => {\n      if (initialScale != null) {\n        pdfViewer.currentScale = initialScale;\n      }\n      if (initialPage != null && initialPage > 1) {\n        pdfViewer.currentPageNumber = initialPage;\n        pdfViewer.scrollPageIntoView({ pageNumber: initialPage });\n      }\n      eventBus.off(PAGES_LOADED_EVENT, onPagesLoaded);\n    };\n    eventBus.on(PAGES_LOADED_EVENT, onPagesLoaded);\n\n    eventBusRef.current = eventBus;\n    findControllerRef.current = findController;\n    pdfViewerRef.current = pdfViewer;\n\n    return () => {\n      pdfViewerRef.current = null;\n      eventBusRef.current = null;\n      findControllerRef.current = null;\n      pdfViewer.cleanup();\n    };\n  }, [containerRef, viewerRef, document]);\n\n  return { pdfViewerRef, eventBusRef, findControllerRef };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,oBAAoB,QAAQ,YAAY;AAEjD,SACEC,QAAQ,EACRC,iBAAiB,EACjBC,cAAc,EACdC,SAAS,QACJ,+BAA+B;AAEtC,SAASC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAASC,kBAAkB,QAAQ,iBAAiB;AAQpD,OAAO,SAASC,YAAYA,CAC1BC,YAA8C,EAC9CC,SAA2C,EAC3CC,QAAsC,EACtCC,YAAqB,EACrBC,WAAoB,EACA;EACpB,MAAMC,YAAY,GAAGR,MAAM,CAAmB,IAAI,CAAC;EACnD,MAAMS,WAAW,GAAGT,MAAM,CAAkB,IAAI,CAAC;EACjD,MAAMU,iBAAiB,GAAGV,MAAM,CAA2B,IAAI,CAAC;EAEhED,SAAS,CAAC,YAA+B;IACvC,MAAMY,SAAS,GAAGR,YAAY,CAACS,OAAO;IACtC,MAAMC,MAAM,GAAGT,SAAS,CAACQ,OAAO;IAChC,IAAID,SAAS,IAAI,IAAI,IAAIE,MAAM,IAAI,IAAI,IAAIR,QAAQ,IAAI,IAAI,EAAE;MAC3D;IACF;IAEA,MAAMS,QAAQ,GAAG,IAAInB,QAAQ,CAAC,CAAC;IAC/B,MAAMoB,WAAW,GAAG,IAAIlB,cAAc,CAAC;MAAEiB;IAAS,CAAC,CAAC;IACpD,MAAME,cAAc,GAAG,IAAIpB,iBAAiB,CAAC;MAC3CmB,WAAW;MACXD,QAAQ;MACRG,4BAA4B,EAAE;IAChC,CAAC,CAAC;IAEF,MAAMC,SAAS,GAAG,IAAIpB,SAAS,CAAC;MAC9Ba,SAAS;MACTE,MAAM;MACNC,QAAQ;MACRC,WAAW;MACXC,cAAc;MACdG,iBAAiB,EAAE,IAAI;MACvBC,oBAAoB,EAAE1B,oBAAoB,CAAC2B,IAAI;MAC/CC,+BAA+B,EAC7B;IACJ,CAAC,CAAC;IAEFP,WAAW,CAACQ,SAAS,CAACL,SAAS,CAAC;IAChCH,WAAW,CAACS,WAAW,CAACnB,QAAQ,CAAC;IACjCW,cAAc,CAACQ,WAAW,CAACnB,QAAQ,CAAC;IACpCa,SAAS,CAACM,WAAW,CAACnB,QAAQ,CAAC;;IAE/B;IACA;IACA,MAAMoB,aAAa,GAAGA,CAAA,KAAM;MAC1B,IAAInB,YAAY,IAAI,IAAI,EAAE;QACxBY,SAAS,CAACQ,YAAY,GAAGpB,YAAY;MACvC;MACA,IAAIC,WAAW,IAAI,IAAI,IAAIA,WAAW,GAAG,CAAC,EAAE;QAC1CW,SAAS,CAACS,iBAAiB,GAAGpB,WAAW;QACzCW,SAAS,CAACU,kBAAkB,CAAC;UAAEC,UAAU,EAAEtB;QAAY,CAAC,CAAC;MAC3D;MACAO,QAAQ,CAACgB,GAAG,CAAC7B,kBAAkB,EAAEwB,aAAa,CAAC;IACjD,CAAC;IACDX,QAAQ,CAACiB,EAAE,CAAC9B,kBAAkB,EAAEwB,aAAa,CAAC;IAE9ChB,WAAW,CAACG,OAAO,GAAGE,QAAQ;IAC9BJ,iBAAiB,CAACE,OAAO,GAAGI,cAAc;IAC1CR,YAAY,CAACI,OAAO,GAAGM,SAAS;IAEhC,OAAO,MAAM;MACXV,YAAY,CAACI,OAAO,GAAG,IAAI;MAC3BH,WAAW,CAACG,OAAO,GAAG,IAAI;MAC1BF,iBAAiB,CAACE,OAAO,GAAG,IAAI;MAChCM,SAAS,CAACc,OAAO,CAAC,CAAC;IACrB,CAAC;EACH,CAAC,EAAE,CAAC7B,YAAY,EAAEC,SAAS,EAAEC,QAAQ,CAAC,CAAC;EAEvC,OAAO;IAAEG,YAAY;IAAEC,WAAW;IAAEC;EAAkB,CAAC;AACzD","ignoreList":[]}

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

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

package/build/esm/public/experimental.js

@@ -37,7 +37,10 @@ export { PdfViewerToolbar } from "../pdf-viewer/components/PdfViewerToolbar.js";
 
 // PdfViewer hooks — primitive
 export { usePdfAnnotationPortals } from "../pdf-viewer/hooks/usePdfAnnotationPortals.js";
+export { usePdfAnnotationsByPage } from "../pdf-viewer/hooks/usePdfAnnotationsByPage.js";
 export { usePdfDocument } from "../pdf-viewer/hooks/usePdfDocument.js";
+export { usePdfFormFields } from "../pdf-viewer/hooks/usePdfFormFields.js";
+export { usePdfHighlightMode } from "../pdf-viewer/hooks/usePdfHighlightMode.js";
 export { usePdfOutline } from "../pdf-viewer/hooks/usePdfOutline.js";
 export { usePdfViewer } from "../pdf-viewer/hooks/usePdfViewer.js";
 export { usePdfViewerSearch } from "../pdf-viewer/hooks/usePdfViewerSearch.js";

package/build/esm/public/experimental.js.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["BaseFilterList","FilterList","deserializeFilterStates","serializeFilterStates","ObjectTable","BaseTable","ColumnConfigDialog","BasePdfViewer","PdfViewerAnnotationLayer","PdfViewerContent","PdfViewerOutlineSidebar","PdfViewerSearchBar","PdfViewerSidebar","PdfViewerToolbar","usePdfAnnotationPortals","usePdfDocument","usePdfOutline","usePdfViewer","usePdfViewerSearch","usePdfViewerSync","usePdfViewerCore","usePdfViewerState","PdfViewer","ActionForm","BaseForm"],"sources":["experimental.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\nexport { BaseFilterList } from \"../filter-list/base/BaseFilterList.js\";\nexport type {\n  BaseFilterListProps,\n  RenderFilterInput,\n} from \"../filter-list/base/BaseFilterListApi.js\";\nexport { FilterList } from \"../filter-list/FilterList.js\";\n\nexport type {\n  FilterDefinitionUnion,\n  FilterListProps,\n} from \"../filter-list/FilterListApi.js\";\nexport type {\n  FilterComponentType,\n  FilterListItemProps,\n  FilterState,\n  PropertyFilterDefinition,\n} from \"../filter-list/FilterListItemApi.js\";\nexport {\n  deserializeFilterStates,\n  serializeFilterStates,\n} from \"../filter-list/utils/filterStateSerialization.js\";\n\n// ObjectTable that loads and displays data for a given objectSet\nexport { ObjectTable } from \"../object-table/ObjectTable.js\";\nexport type {\n  ColumnDefinition,\n  ColumnDefinitionLocator,\n  CustomColumnLocator,\n  FunctionColumnLocator,\n  ObjectTableProps,\n  PropertyColumnLocator,\n  RdpColumnLocator,\n} from \"../object-table/ObjectTableApi.js\";\nexport type { CellEditInfo } from \"../object-table/utils/types.js\";\n\n// BaseTable that does not handle data fetching\nexport type { BaseTableProps } from \"../object-table/Table.js\";\nexport { BaseTable } from \"../object-table/Table.js\";\n\nexport { ColumnConfigDialog } from \"../object-table/ColumnConfigDialog.js\";\nexport type {\n  ColumnConfigDialogProps,\n  ColumnConfigOptions,\n} from \"../object-table/ColumnConfigDialog.js\";\n\n// PdfViewer\nexport { BasePdfViewer } from \"../pdf-viewer/PdfViewer.js\";\nexport type {\n  AnnotationType,\n  PdfAnnotation,\n  PdfDownloadResult,\n  PdfViewerProps,\n  SidebarMode,\n} from \"../pdf-viewer/types.js\";\n\n// PdfViewer building blocks\nexport {\n  PdfViewerAnnotationLayer,\n  type PdfViewerAnnotationLayerProps,\n} from \"../pdf-viewer/components/PdfViewerAnnotationLayer.js\";\nexport {\n  PdfViewerContent,\n  type PdfViewerContentProps,\n} from \"../pdf-viewer/components/PdfViewerContent.js\";\nexport {\n  PdfViewerOutlineSidebar,\n  type PdfViewerOutlineSidebarProps,\n} from \"../pdf-viewer/components/PdfViewerOutlineSidebar.js\";\nexport {\n  PdfViewerSearchBar,\n  type PdfViewerSearchBarProps,\n} from \"../pdf-viewer/components/PdfViewerSearchBar.js\";\nexport {\n  PdfViewerSidebar,\n  type PdfViewerSidebarProps,\n} from \"../pdf-viewer/components/PdfViewerSidebar.js\";\nexport {\n  PdfViewerToolbar,\n  type PdfViewerToolbarProps,\n} from \"../pdf-viewer/components/PdfViewerToolbar.js\";\n\n// PdfViewer hooks — primitive\nexport {\n  type AnnotationPortalTarget,\n  usePdfAnnotationPortals,\n} from \"../pdf-viewer/hooks/usePdfAnnotationPortals.js\";\nexport { usePdfDocument } from \"../pdf-viewer/hooks/usePdfDocument.js\";\nexport { usePdfOutline } from \"../pdf-viewer/hooks/usePdfOutline.js\";\nexport {\n  usePdfViewer,\n  type UsePdfViewerResult,\n} from \"../pdf-viewer/hooks/usePdfViewer.js\";\nexport {\n  usePdfViewerSearch,\n  type UsePdfViewerSearchResult,\n} from \"../pdf-viewer/hooks/usePdfViewerSearch.js\";\nexport { usePdfViewerSync } from \"../pdf-viewer/hooks/usePdfViewerSync.js\";\nexport { type OutlineItem } from \"../pdf-viewer/types.js\";\n\n// PdfViewer hooks — composition\nexport {\n  usePdfViewerCore,\n  type UsePdfViewerCoreOptions,\n  type UsePdfViewerCoreResult,\n} from \"../pdf-viewer/hooks/usePdfViewerCore.js\";\nexport {\n  usePdfViewerState,\n  type UsePdfViewerStateOptions,\n  type UsePdfViewerStateResult,\n} from \"../pdf-viewer/hooks/usePdfViewerState.js\";\n\n// PdfViewer (Media wrapper)\nexport {\n  PdfViewer,\n  type PdfViewerMediaProps,\n} from \"../pdf-viewer/PdfRenderer.js\";\n\nexport { ActionForm } from \"../action-form/ActionForm.js\";\nexport type {\n  ActionFormProps,\n  BaseFormProps,\n  FormError,\n  FormState,\n} from \"../action-form/ActionFormApi.js\";\nexport { BaseForm } from \"../action-form/BaseForm.js\";\nexport type {\n  ActionParameters,\n  BaseFormFieldProps,\n  CustomFieldProps,\n  DatetimePickerFieldProps,\n  DropdownFieldProps,\n  FieldComponent,\n  FieldValueType,\n  FilePickerProps,\n  FormFieldDefinition,\n  FormFieldPropsByType,\n  NumberInputFieldProps,\n  ObjectSetFieldProps,\n  Option,\n  RadioButtonsFieldProps,\n  RendererFieldDefinition,\n  TextAreaFieldProps,\n  TextInputFieldProps,\n} from \"../action-form/FormFieldApi.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,uCAAuC;AAKtE,SAASC,UAAU,QAAQ,8BAA8B;AAYzD,SACEC,uBAAuB,EACvBC,qBAAqB,QAChB,kDAAkD;;AAEzD;AACA,SAASC,WAAW,QAAQ,gCAAgC;;AAY5D;;AAEA,SAASC,SAAS,QAAQ,0BAA0B;AAEpD,SAASC,kBAAkB,QAAQ,uCAAuC;AAM1E;AACA,SAASC,aAAa,QAAQ,4BAA4B;AAS1D;AACA,SACEC,wBAAwB,QAEnB,sDAAsD;AAC7D,SACEC,gBAAgB,QAEX,8CAA8C;AACrD,SACEC,uBAAuB,QAElB,qDAAqD;AAC5D,SACEC,kBAAkB,QAEb,gDAAgD;AACvD,SACEC,gBAAgB,QAEX,8CAA8C;AACrD,SACEC,gBAAgB,QAEX,8CAA8C;;AAErD;AACA,SAEEC,uBAAuB,QAClB,gDAAgD;AACvD,SAASC,cAAc,QAAQ,uCAAuC;AACtE,SAASC,aAAa,QAAQ,sCAAsC;AACpE,SACEC,YAAY,QAEP,qCAAqC;AAC5C,SACEC,kBAAkB,QAEb,2CAA2C;AAClD,SAASC,gBAAgB,QAAQ,yCAAyC;AAG1E;AACA,SACEC,gBAAgB,QAGX,yCAAyC;AAChD,SACEC,iBAAiB,QAGZ,0CAA0C;;AAEjD;AACA,SACEC,SAAS,QAEJ,8BAA8B;AAErC,SAASC,UAAU,QAAQ,8BAA8B;AAOzD,SAASC,QAAQ,QAAQ,4BAA4B","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":["BaseFilterList","FilterList","deserializeFilterStates","serializeFilterStates","ObjectTable","BaseTable","ColumnConfigDialog","BasePdfViewer","PdfViewerAnnotationLayer","PdfViewerContent","PdfViewerOutlineSidebar","PdfViewerSearchBar","PdfViewerSidebar","PdfViewerToolbar","usePdfAnnotationPortals","usePdfAnnotationsByPage","usePdfDocument","usePdfFormFields","usePdfHighlightMode","usePdfOutline","usePdfViewer","usePdfViewerSearch","usePdfViewerSync","usePdfViewerCore","usePdfViewerState","PdfViewer","ActionForm","BaseForm"],"sources":["experimental.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\nexport { BaseFilterList } from \"../filter-list/base/BaseFilterList.js\";\nexport type {\n  BaseFilterListProps,\n  RenderFilterInput,\n} from \"../filter-list/base/BaseFilterListApi.js\";\nexport { FilterList } from \"../filter-list/FilterList.js\";\n\nexport type {\n  FilterDefinitionUnion,\n  FilterListProps,\n} from \"../filter-list/FilterListApi.js\";\nexport type {\n  FilterComponentType,\n  FilterListItemProps,\n  FilterState,\n  PropertyFilterDefinition,\n} from \"../filter-list/FilterListItemApi.js\";\nexport {\n  deserializeFilterStates,\n  serializeFilterStates,\n} from \"../filter-list/utils/filterStateSerialization.js\";\n\n// ObjectTable that loads and displays data for a given objectSet\nexport { ObjectTable } from \"../object-table/ObjectTable.js\";\nexport type {\n  ColumnDefinition,\n  ColumnDefinitionLocator,\n  CustomColumnLocator,\n  FunctionColumnLocator,\n  ObjectTableProps,\n  PropertyColumnLocator,\n  RdpColumnLocator,\n} from \"../object-table/ObjectTableApi.js\";\nexport type { CellEditInfo } from \"../object-table/utils/types.js\";\n\n// BaseTable that does not handle data fetching\nexport type { BaseTableProps } from \"../object-table/Table.js\";\nexport { BaseTable } from \"../object-table/Table.js\";\n\nexport { ColumnConfigDialog } from \"../object-table/ColumnConfigDialog.js\";\nexport type {\n  ColumnConfigDialogProps,\n  ColumnConfigOptions,\n} from \"../object-table/ColumnConfigDialog.js\";\n\n// PdfViewer\nexport { BasePdfViewer } from \"../pdf-viewer/PdfViewer.js\";\nexport type {\n  AnnotationType,\n  PdfAnnotation,\n  PdfAnnotationRenderProps,\n  PdfCustomAnnotation,\n  PdfDownloadResult,\n  PdfFormFieldValue,\n  PdfRect,\n  PdfTextHighlightEvent,\n  PdfViewerProps,\n  SidebarMode,\n} from \"../pdf-viewer/types.js\";\n\n// PdfViewer building blocks\nexport {\n  PdfViewerAnnotationLayer,\n  type PdfViewerAnnotationLayerProps,\n} from \"../pdf-viewer/components/PdfViewerAnnotationLayer.js\";\nexport {\n  PdfViewerContent,\n  type PdfViewerContentProps,\n} from \"../pdf-viewer/components/PdfViewerContent.js\";\nexport {\n  PdfViewerOutlineSidebar,\n  type PdfViewerOutlineSidebarProps,\n} from \"../pdf-viewer/components/PdfViewerOutlineSidebar.js\";\nexport {\n  PdfViewerSearchBar,\n  type PdfViewerSearchBarProps,\n} from \"../pdf-viewer/components/PdfViewerSearchBar.js\";\nexport {\n  PdfViewerSidebar,\n  type PdfViewerSidebarProps,\n} from \"../pdf-viewer/components/PdfViewerSidebar.js\";\nexport {\n  PdfViewerToolbar,\n  type PdfViewerToolbarProps,\n} from \"../pdf-viewer/components/PdfViewerToolbar.js\";\n\n// PdfViewer hooks — primitive\nexport {\n  type AnnotationPortalTarget,\n  usePdfAnnotationPortals,\n} from \"../pdf-viewer/hooks/usePdfAnnotationPortals.js\";\nexport { usePdfAnnotationsByPage } from \"../pdf-viewer/hooks/usePdfAnnotationsByPage.js\";\nexport { usePdfDocument } from \"../pdf-viewer/hooks/usePdfDocument.js\";\nexport {\n  usePdfFormFields,\n  type UsePdfFormFieldsOptions,\n  type UsePdfFormFieldsResult,\n} from \"../pdf-viewer/hooks/usePdfFormFields.js\";\nexport {\n  usePdfHighlightMode,\n  type UsePdfHighlightModeOptions,\n  type UsePdfHighlightModeResult,\n} from \"../pdf-viewer/hooks/usePdfHighlightMode.js\";\nexport { usePdfOutline } from \"../pdf-viewer/hooks/usePdfOutline.js\";\nexport {\n  usePdfViewer,\n  type UsePdfViewerResult,\n} from \"../pdf-viewer/hooks/usePdfViewer.js\";\nexport {\n  usePdfViewerSearch,\n  type UsePdfViewerSearchResult,\n} from \"../pdf-viewer/hooks/usePdfViewerSearch.js\";\nexport { usePdfViewerSync } from \"../pdf-viewer/hooks/usePdfViewerSync.js\";\nexport { type OutlineItem } from \"../pdf-viewer/types.js\";\n\n// PdfViewer hooks — composition\nexport {\n  usePdfViewerCore,\n  type UsePdfViewerCoreOptions,\n  type UsePdfViewerCoreResult,\n} from \"../pdf-viewer/hooks/usePdfViewerCore.js\";\nexport {\n  usePdfViewerState,\n  type UsePdfViewerStateOptions,\n  type UsePdfViewerStateResult,\n} from \"../pdf-viewer/hooks/usePdfViewerState.js\";\n\n// PdfViewer (Media wrapper)\nexport {\n  PdfViewer,\n  type PdfViewerMediaProps,\n} from \"../pdf-viewer/PdfRenderer.js\";\n\nexport { ActionForm } from \"../action-form/ActionForm.js\";\nexport type {\n  ActionFormProps,\n  BaseFormProps,\n  FormError,\n  FormState,\n} from \"../action-form/ActionFormApi.js\";\nexport { BaseForm } from \"../action-form/BaseForm.js\";\nexport type {\n  ActionParameters,\n  BaseFormFieldProps,\n  CustomFieldProps,\n  DatetimePickerFieldProps,\n  DropdownFieldProps,\n  FieldComponent,\n  FieldValueType,\n  FilePickerProps,\n  FormFieldDefinition,\n  FormFieldPropsByType,\n  NumberInputFieldProps,\n  ObjectSetFieldProps,\n  Option,\n  RadioButtonsFieldProps,\n  RendererFieldDefinition,\n  TextAreaFieldProps,\n  TextInputFieldProps,\n} from \"../action-form/FormFieldApi.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,cAAc,QAAQ,uCAAuC;AAKtE,SAASC,UAAU,QAAQ,8BAA8B;AAYzD,SACEC,uBAAuB,EACvBC,qBAAqB,QAChB,kDAAkD;;AAEzD;AACA,SAASC,WAAW,QAAQ,gCAAgC;;AAY5D;;AAEA,SAASC,SAAS,QAAQ,0BAA0B;AAEpD,SAASC,kBAAkB,QAAQ,uCAAuC;AAM1E;AACA,SAASC,aAAa,QAAQ,4BAA4B;AAc1D;AACA,SACEC,wBAAwB,QAEnB,sDAAsD;AAC7D,SACEC,gBAAgB,QAEX,8CAA8C;AACrD,SACEC,uBAAuB,QAElB,qDAAqD;AAC5D,SACEC,kBAAkB,QAEb,gDAAgD;AACvD,SACEC,gBAAgB,QAEX,8CAA8C;AACrD,SACEC,gBAAgB,QAEX,8CAA8C;;AAErD;AACA,SAEEC,uBAAuB,QAClB,gDAAgD;AACvD,SAASC,uBAAuB,QAAQ,gDAAgD;AACxF,SAASC,cAAc,QAAQ,uCAAuC;AACtE,SACEC,gBAAgB,QAGX,yCAAyC;AAChD,SACEC,mBAAmB,QAGd,4CAA4C;AACnD,SAASC,aAAa,QAAQ,sCAAsC;AACpE,SACEC,YAAY,QAEP,qCAAqC;AAC5C,SACEC,kBAAkB,QAEb,2CAA2C;AAClD,SAASC,gBAAgB,QAAQ,yCAAyC;AAG1E;AACA,SACEC,gBAAgB,QAGX,yCAAyC;AAChD,SACEC,iBAAiB,QAGZ,0CAA0C;;AAEjD;AACA,SACEC,SAAS,QAEJ,8BAA8B;AAErC,SAASC,UAAU,QAAQ,8BAA8B;AAOzD,SAASC,QAAQ,QAAQ,4BAA4B","ignoreList":[]}

package/build/types/action-form/FormFieldApi.d.ts

@@ -175,7 +175,9 @@ export interface FilePickerProps extends BaseFormFieldProps<File | File[]> {
 /**
 * Text area field props
 */
-export interface TextAreaFieldProps extends BaseFormFieldProps<string>, Pick<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows" | "wrap" | "minLength" | "maxLength"> {}
+export interface TextAreaFieldProps extends BaseFormFieldProps<string>, Pick<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows" | "wrap" | "minLength" | "maxLength"> {
+	placeholder?: string;
+}
 export interface TextInputFieldProps extends BaseFormFieldProps<string>, Pick<React.InputHTMLAttributes<HTMLInputElement>, "minLength" | "maxLength"> {
 	placeholder?: string;
 }
@@ -188,7 +190,11 @@ export interface NumberInputFieldProps extends BaseFormFieldProps<number>, Pick<
 */
 export interface RadioButtonsFieldProps<V> extends BaseFormFieldProps<V> {
 	/**
-	* Available options for radio buttons
+	* Available options for radio buttons.
+	*
+	* Values are compared by reference equality (`===`). When options contain
+	* non-primitive values, pass the same object references for `value` and
+	* the corresponding option entry.
 	*/
 	options: Option<V>[];
 }

package/build/types/action-form/FormFieldApi.d.ts.map

@@ -1 +1 @@
-{"mappings":"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","names":["error: ValidationError","value: FieldValueType<Q, K>","date: Date","item: V","a: V","b: V","props: BaseFormFieldProps<V>","value: V | null"],"sources":["../../../src/action-form/FormFieldApi.ts"],"version":3,"file":"FormFieldApi.d.ts"}
+{"mappings":"AAgBA,cACE,kBACA,gBACA,aACA,qBACA,uBACA,WACA,4BACK,WAAY;AACnB,YAAY,WAAW,OAAQ;;;;AAK/B,iBAAiB;CACf,UAAU;CACV,UAAU,SAAS,KAAK,SAAS;EACjC;;;;CAIA,UAAU;;;;;CAMV;;;;CAKA,eAAe,eAAe,GAAG;;;;CAKjC,gBAAgB,8BAA8B,oBAAoB,GAAG;;;;CAKrE;;;;CAKA;;;;;CAMA;;;;;;CAOA,sBAAsB,WAAW;;;;CAKjC;;;;;;;CAQA,qBAAqBA,OAAO;;;;;;;CAQ5B,YAAYC,OAAO,eAAe,GAAG,OAAO;;;;;CAM5C,sBAAsB,KACpB,qBACE,8BACE,oBAAoB,GAAG,MAG3B,QAAQ;AAEX;KAEI,kBAAkB;CAAE,MAAM;CAAgB;AAAe;KAEzD,iBACD,aACA,QACA,QACA,cACA,cACA,YACA;;;;AAKJ,iBAAiB,qBAAqB;CACpC,iBAAiB;CACjB,UAAU;CACV,aAAa;CACb,cAAc;CACd,YAAY,oBAAoB;CAChC,eAAe;CACf,WAAW;CACX,YAAY;CACZ,QAAQ;AACT;;;;;;AAOD,iBAAiB,iCAAiC,mBAAmB,MAAM;;;;;CAKzE,MAAM;;;;;CAMN,MAAM;;;;CAKN;;;;;CAMA;;;;CAKA;;CAGA,cAAcC,MAAM;AACrB;;;;AAKD,iBAAiB;CAAmB;CAAG,2BAA2B;UACxD,mBAAmB,iBAAiB,OAAO,MAAM,GAC3D;;;;CAIE,OAAO;;;;CAKP,qBAAqBC,MAAM;;;;;CAM3B,aAAaA,MAAM;;;;;CAMnB,eAAeC,GAAG,GAAGC,GAAG;;;;;;CAOxB;;;;CAKA;;;;CAKA,aAAa;AACd;AAED,iBAAiB,wBAAwB,mBAAmB,OAAO,QAAQ;;;;CAIzE;;;;CAKA;;;;CAKA;AACD;;;;AAKD,iBAAiB,2BACf,4BACA,KACE,MAAM,uBAAuB,sBAC3B,SACA,SAIA,cAIA,aAEN;CACE;AACD;AAED,iBAAiB,4BACf,4BACA,KACE,MAAM,oBAAoB,mBAIxB,cAIA,aAEN;CACE;AACD;;;;AAKD,iBAAiB,8BACf,4BACA,KACE,MAAM,oBAAoB,mBAIxB,QAIA,QACA,QAEN,CAAE;;;;AAKF,iBAAiB,uBAAuB,WAAW,mBAAmB,GAAG;;;;;;;;CAQvE,SAAS,OAAO;AACjB;;;;AAKD,iBAAiB,OAAO,GAAG;CACzB;CACA,OAAO;AACR;;;;AAKD,iBAAiB,oBAAoB,UAAU,8BACrC,mBAAmB,UAAU,IACvC,CAAE;;;;AAKF,iBAAiB,iBAAiB,WAAW,mBAAmB,GAAG;;;;CAIjE,iBAAiBC,OAAO,mBAAmB,OAAO,MAAM;AACzD;AAED,iBAAiB,mBAAmB,GAAG;;;;;CAKrC;;;;CAKA,OAAO;;;;;;;;;;;;;;CAcP,YAAYC,OAAO;AACpB;AAED,YAAY,SAAS,UAAU,mCACvB,iBAAiB;;;;AAKzB,YAAY,iBAAiB,UAAU,6BACrC,oBAAoB,GAAG;;;;;;AAOzB,YAAY;CACV,UAAU;CACV,gBAAgB,iBAAiB,WAAW,iBAAiB;IAC3D,iBAAiB,GAAG,GAAG,gBACzB,eAAe,SAAS,aAAa,KAAK,YAAY,WAAW,KAC/D,iBAAiB,GAAG,GAAG,gBAAgB,eAAe,SAAS,gBACzD,KACJ,YAAY,cAAc,KAC5B,iBAAiB,GAAG,GAAG,gBAAgB,eAAe,SAAS,aACzD,KACJ,YAAY,WAAW,KACzB,iBAAiB,GAAG,GAAG,sBAAsB,wBAC3C,sBAAsB,iBAAiB,GAAG,GAAG;;;;AAMnD,YAAY;CACV,UAAU,4BAA4B;CACtC,gBAAgB,iBAAiB,WAAW,iBAAiB;IAC3D,iBAAiB,GAAG,GAAG;;;;AAK3B,YAAY,iBACR,oBACA,aACA,gBACA,iBACA,kBACA,eACA,cACA,eACA;;;;;AAMJ,YAAY,YACR,YACA,WACA,YACA,SACA,WACA,aACA,cACA,eACA,YACA,mBACA,eACA,aACA,YACA;CAAE,MAAM;CAAU;AAAgB,IAClC;CAAE,MAAM;CAAa;AAAmB,IACxC;CAAE,MAAM;CAAa;AAAmB,IACxC;CAAE,MAAM;CAAU,QAAQ;AAAwB;;;;;;;;;AAUtD,YAAY,6BACT,KAAK,kBAAiB;CACrB;CACA,gBAAgB;CAChB,YAAY;CACZ;CACA;CACA;CACA;CACA;CACA,sBAAsB,WAAW;CACjC,sBAAsB,KAAK,qBAAqB,IAAI,UAAU;AAC/D,IACD;;;;AAKF,YAAY,8BAA8B,UAAU,uBAClD,UAAU,cAAc,eACpB,UAAU,WAAW,aACrB,UAAU,mBAAmB,eAAe,gBAC5C,UAAU,YAAY,kBAAkB,aACxC,UAAU,WAAW,eAAe,cACpC,UAAU,aAAa,cAAc,oBACrC,UACE,WACA,YACA,SACA,UACA,UACA,SACA,YAAY","names":["error: ValidationError","value: FieldValueType<Q, K>","date: Date","item: V","a: V","b: V","props: BaseFormFieldProps<V>","value: V | null"],"sources":["../../../src/action-form/FormFieldApi.ts"],"version":3,"file":"FormFieldApi.d.ts"}

package/build/types/action-form/fields/FormFieldRenderer.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,OAAO,WAAqB,OAAQ;AAEpC,cAAc,+BAA+B,oBAAqB;AAOlE,iBAAiB,uBAAuB;CACtC,iBAAiB;CACjB;CACA,qBAAqBA;AACtB;AAED,OAAO,cAAMC,mBAAmB,MAAM,GAAG","names":["value: unknown","FormFieldRenderer: React.FC<FormFieldRendererProps>"],"sources":["../../../../src/action-form/fields/FormFieldRenderer.tsx"],"version":3,"file":"FormFieldRenderer.d.ts"}
+{"mappings":"AAgBA,OAAO,WAAqB,OAAQ;AAEpC,cAAsB,+BAA+B,oBAAqB;AAU1E,iBAAiB,uBAAuB;CACtC,iBAAiB;CACjB;CACA,qBAAqBA;AACtB;AAED,OAAO,cAAMC,mBAAmB,MAAM,GAAG","names":["value: unknown","FormFieldRenderer: React.FC<FormFieldRendererProps>"],"sources":["../../../../src/action-form/fields/FormFieldRenderer.tsx"],"version":3,"file":"FormFieldRenderer.d.ts"}

package/build/types/action-form/fields/RadioButtonsField.d.ts

@@ -0,0 +1,3 @@
+import { type ReactElement } from "react";
+import type { RadioButtonsFieldProps } from "../FormFieldApi.js";
+export declare const RadioButtonsField: <V>(props: RadioButtonsFieldProps<V>) => ReactElement;

package/build/types/action-form/fields/RadioButtonsField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAkBA,cAAoB,oBAA0C,OAAQ;AAEtE,cAAsB,8BAA8B,oBAAqB;AAGzE,OAAO,cAAMA,oBAAoB,GAC/BC,OAAO,uBAAuB,OAC3B","names":["RadioButtonsField: <V>(\n  props: RadioButtonsFieldProps<V>,\n) => ReactElement","props: RadioButtonsFieldProps<V>"],"sources":["../../../../src/action-form/fields/RadioButtonsField.tsx"],"version":3,"file":"RadioButtonsField.d.ts"}

package/build/types/action-form/fields/TextAreaField.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { TextAreaFieldProps } from "../FormFieldApi.js";
+export declare function TextAreaField({ id, value, onChange, placeholder, rows, wrap, minLength, maxLength }: TextAreaFieldProps): React.ReactElement;

package/build/types/action-form/fields/TextAreaField.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,OAAO,WAA4B,OAAQ;AAC3C,cAAc,0BAA0B,oBAAqB;AAK7D,OAAO,iBAAS,cAAc,EAC5B,IACA,OACA,UACA,aACA,MACA,MACA,WACA,WACmB,EAAlB,qBAAqB,MAAM","names":[],"sources":["../../../../src/action-form/fields/TextAreaField.tsx"],"version":3,"file":"TextAreaField.d.ts"}

package/build/types/pdf-viewer/PdfViewer.d.ts

@@ -1,4 +1,4 @@
 import "pdfjs-dist/web/pdf_viewer.css";
 import React from "react";
 import type { PdfViewerProps } from "./types.js";
-export declare function BasePdfViewer({ src, annotations, onAnnotationClick, onDownload, initialPage, initialScale, initialSidebarOpen, enableDownload, sidebarMode: sidebarModeProp, outlineIcons, className }: PdfViewerProps): React.ReactElement;
+export declare function BasePdfViewer({ src, annotations, onAnnotationClick, onDownload, enableHighlight, onTextHighlight, onHighlightDelete, formData, onFormSubmit, onFormChange, initialPage, initialScale, initialSidebarOpen, enableDownload, sidebarMode: sidebarModeProp, outlineIcons, className }: PdfViewerProps): React.ReactElement;

package/build/types/pdf-viewer/PdfViewer.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAkBA,OAAO,+BAAgC;AACvC,OAAO,WAAW,OAAQ;AAU1B,cAAc,sBAAsB,YAAa;AAEjD,OAAO,iBAAS,cAAc,EAC5B,KACA,aACA,mBACA,YACA,aACA,cACA,oBACA,gBACA,aAAa,iBACb,cACA,WACe,EAAd,iBAAiB,MAAM","names":[],"sources":["../../../src/pdf-viewer/PdfViewer.tsx"],"version":3,"file":"PdfViewer.d.ts"}
+{"mappings":"AAkBA,OAAO,+BAAgC;AACvC,OAAO,WAAW,OAAQ;AAa1B,cAAc,sBAAsB,YAAa;AAEjD,OAAO,iBAAS,cAAc,EAC5B,KACA,aACA,mBACA,YACA,iBACA,iBACA,mBACA,UACA,cACA,cACA,aACA,cACA,oBACA,gBACA,aAAa,iBACb,cACA,WACe,EAAd,iBAAiB,MAAM","names":[],"sources":["../../../src/pdf-viewer/PdfViewer.tsx"],"version":3,"file":"PdfViewer.d.ts"}

package/build/types/pdf-viewer/components/PdfViewerAnnotationLayer.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAiBA,OAAO,WAAqC,OAAQ;AACpD,cAAc,qBAAqB,aAAc;AAGjD,iBAAiB,8BAA8B;CAC7C,aAAa;CACb;CACA;CACA,qBAAqBA,YAAY;AAClC;AAgED,OAAO,iBAAS,yBAAyB,EACvC,aACA,YACA,OACA,mBAC8B,EAA7B,gCAAgC,MAAM","names":["annotation: PdfAnnotation"],"sources":["../../../../src/pdf-viewer/components/PdfViewerAnnotationLayer.tsx"],"version":3,"file":"PdfViewerAnnotationLayer.d.ts"}
+{"mappings":"AAiBA,OAAO,WAAqC,OAAQ;AACpD,cAAc,qBAAmD,aAAc;AAG/E,iBAAiB,8BAA8B;CAC7C,aAAa;CACb;CACA;CACA,qBAAqBA,YAAY;AAClC;AA4JD,OAAO,iBAAS,yBAAyB,EACvC,aACA,YACA,OACA,mBAC8B,EAA7B,gCAAgC,MAAM","names":["annotation: PdfAnnotation"],"sources":["../../../../src/pdf-viewer/components/PdfViewerAnnotationLayer.tsx"],"version":3,"file":"PdfViewerAnnotationLayer.d.ts"}

package/build/types/pdf-viewer/components/PdfViewerContent.d.ts

@@ -1,11 +1,11 @@
 import "pdfjs-dist/web/pdf_viewer.css";
 import React from "react";
-import type { PdfAnnotation } from "../types.js";
+import type { PdfAnnotation, PdfFormFieldValue } from "../types.js";
 export interface PdfViewerContentProps {
 	/** PDF source — URL string or ArrayBuffer */
 	src: string | ArrayBuffer;
-	/** Annotations to overlay on the PDF, keyed by page number (1-indexed) */
-	annotations?: Record<number, PdfAnnotation[]>;
+	/** Annotations to overlay on the PDF */
+	annotations?: PdfAnnotation[];
 	/** Callback fired when an annotation is clicked */
 	onAnnotationClick?: (annotation: PdfAnnotation) => void;
 	/** Initial page number (1-indexed, default 1) */
@@ -16,7 +16,11 @@ export interface PdfViewerContentProps {
 	onPageChange?: (page: number) => void;
 	/** Callback fired when the zoom scale changes */
 	onScaleChange?: (scale: number) => void;
+	/** Initial form field values keyed by field name. Applied when the document loads. */
+	formData?: Record<string, PdfFormFieldValue>;
+	/** Callback fired when any form field value changes. */
+	onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;
 	/** Additional CSS class name for the root element */
 	className?: string;
 }
-export declare function PdfViewerContent({ src, annotations, onAnnotationClick, initialPage, initialScale, onPageChange: onPageChangeProp, onScaleChange: onScaleChangeProp, className }: PdfViewerContentProps): React.ReactElement;
+export declare function PdfViewerContent({ src, annotations, onAnnotationClick, initialPage, initialScale, onPageChange: onPageChangeProp, onScaleChange: onScaleChangeProp, formData, onFormChange, className }: PdfViewerContentProps): React.ReactElement;

package/build/types/pdf-viewer/components/PdfViewerContent.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAkBA,OAAO,+BAAgC;AACvC,OAAO,WAAkC,OAAQ;AAKjD,cAAc,qBAAqB,aAAc;AAGjD,iBAAiB,sBAAsB;;CAErC,cAAc;;CAEd,cAAc,eAAe;;CAE7B,qBAAqBA,YAAY;;CAEjC;;CAEA;;CAEA,gBAAgBC;;CAEhB,iBAAiBC;;CAEjB;AACD;AAED,OAAO,iBAAS,iBAAiB,EAC/B,KACA,aACA,mBACA,aACA,cACA,cAAc,kBACd,eAAe,mBACf,WACsB,EAArB,wBAAwB,MAAM","names":["annotation: PdfAnnotation","page: number","scale: number"],"sources":["../../../../src/pdf-viewer/components/PdfViewerContent.tsx"],"version":3,"file":"PdfViewerContent.d.ts"}
+{"mappings":"AAkBA,OAAO,+BAAgC;AACvC,OAAO,WAAkC,OAAQ;AAOjD,cAAc,eAAe,yBAAyB,aAAc;AAGpE,iBAAiB,sBAAsB;;CAErC,cAAc;;CAEd,cAAc;;CAEd,qBAAqBA,YAAY;;CAEjC;;CAEA;;CAEA,gBAAgBC;;CAEhB,iBAAiBC;;CAEjB,WAAW,eAAe;;CAE1B,gBAAgBC,mBAAmBC,OAAO;;CAE1C;AACD;AAED,OAAO,iBAAS,iBAAiB,EAC/B,KACA,aACA,mBACA,aACA,cACA,cAAc,kBACd,eAAe,mBACf,UACA,cACA,WACsB,EAArB,wBAAwB,MAAM","names":["annotation: PdfAnnotation","page: number","scale: number","fieldName: string","value: PdfFormFieldValue"],"sources":["../../../../src/pdf-viewer/components/PdfViewerContent.tsx"],"version":3,"file":"PdfViewerContent.d.ts"}

package/build/types/pdf-viewer/components/PdfViewerToolbar.d.ts

@@ -12,5 +12,10 @@ export interface PdfViewerToolbarProps {
 	enableDownload: boolean;
 	onRotateLeft: () => void;
 	onRotateRight: () => void;
+	enableHighlight: boolean;
+	highlightModeActive: boolean;
+	onHighlightToggle: () => void;
+	enableFormSave?: boolean;
+	onFormSave?: () => void;
 }
-export declare function PdfViewerToolbar({ currentPage, numPages, scale, sidebarOpen, onPageChange, onScaleChange, onSearchOpen, onSidebarToggle, onDownload, enableDownload, onRotateLeft, onRotateRight }: PdfViewerToolbarProps): React.ReactElement;
+export declare function PdfViewerToolbar({ currentPage, numPages, scale, sidebarOpen, onPageChange, onScaleChange, onSearchOpen, onSidebarToggle, onDownload, enableDownload, onRotateLeft, onRotateRight, enableHighlight, highlightModeActive, onHighlightToggle, enableFormSave, onFormSave }: PdfViewerToolbarProps): React.ReactElement;

package/build/types/pdf-viewer/components/PdfViewerToolbar.d.ts.map

@@ -1 +1 @@
-{"mappings":"AA4BA,OAAO,WAAiD,OAAQ;AAIhE,iBAAiB,sBAAsB;CACrC;CACA;CACA;CACA;CACA,eAAeA;CACf,gBAAgBC;CAChB;CACA;CACA;CACA;CACA;CACA;AACD;AAED,OAAO,iBAAS,iBAAiB,EAC/B,aACA,UACA,OACA,aACA,cACA,eACA,cACA,iBACA,YACA,gBACA,cACA,eACsB,EAArB,wBAAwB,MAAM","names":["page: number","scale: number"],"sources":["../../../../src/pdf-viewer/components/PdfViewerToolbar.tsx"],"version":3,"file":"PdfViewerToolbar.d.ts"}
+{"mappings":"AA+BA,OAAO,WAAiD,OAAQ;AAIhE,iBAAiB,sBAAsB;CACrC;CACA;CACA;CACA;CACA,eAAeA;CACf,gBAAgBC;CAChB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;AAED,OAAO,iBAAS,iBAAiB,EAC/B,aACA,UACA,OACA,aACA,cACA,eACA,cACA,iBACA,YACA,gBACA,cACA,eACA,iBACA,qBACA,mBACA,gBACA,YACsB,EAArB,wBAAwB,MAAM","names":["page: number","scale: number"],"sources":["../../../../src/pdf-viewer/components/PdfViewerToolbar.tsx"],"version":3,"file":"PdfViewerToolbar.d.ts"}

package/build/types/pdf-viewer/constants.d.ts

@@ -1,5 +1,4 @@
 import type { PdfAnnotation } from "./types.js";
-export declare const EMPTY_ANNOTATIONS: Record<number, PdfAnnotation[]>;
 export declare const EMPTY_ANNOTATION_ARRAY: PdfAnnotation[];
 export declare const EMPTY_STRING = "";
 export declare const SCALE_STEP = .25;
@@ -20,3 +19,4 @@ export declare const PAGE_CHANGING_EVENT = "pagechanging";
 export declare const SCALE_CHANGING_EVENT = "scalechanging";
 export declare const PAGE_RENDERED_EVENT = "pagerendered";
 export declare const PAGES_LOADED_EVENT = "pagesloaded";
+export declare const ANNOTATION_LAYER_RENDERED_EVENT = "annotationlayerrendered";

package/build/types/pdf-viewer/constants.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,qBAAqB,YAAa;AAGhD,OAAO,cAAMA,mBAAmB,eAAe;AAC/C,OAAO,cAAMC,wBAAwB;AACrC,OAAO,cAAM,eAAe;AAG5B,OAAO,cAAM,aAAa;AAC1B,OAAO,cAAM,YAAY;AACzB,OAAO,cAAM,YAAY;AACzB,OAAO,cAAM,sBAAsB;AACnC,OAAO,cAAM,gBAAgB;AAC7B,OAAO,cAAM,kBAAkB;AAC/B,OAAO,cAAMC;;AAMb,OAAO,cAAM,6BAA6B;;AAE1C,OAAO,cAAM,6BAA6B;AAG1C,OAAO,cAAM,aAAa;AAC1B,OAAO,cAAM,kCAAkC;AAC/C,OAAO,cAAM,kCAAkC;AAC/C,OAAO,cAAM,sBAAsB;AACnC,OAAO,cAAM,uBAAuB;AACpC,OAAO,cAAM,sBAAsB;AACnC,OAAO,cAAM,qBAAqB","names":["EMPTY_ANNOTATIONS: Record<number, PdfAnnotation[]>","EMPTY_ANNOTATION_ARRAY: PdfAnnotation[]","DEVICE_PIXEL_RATIO: number"],"sources":["../../../src/pdf-viewer/constants.ts"],"version":3,"file":"constants.d.ts"}
+{"mappings":"AAgBA,cAAc,qBAAqB,YAAa;AAGhD,OAAO,cAAMA,wBAAwB;AACrC,OAAO,cAAM,eAAe;AAG5B,OAAO,cAAM,aAAa;AAC1B,OAAO,cAAM,YAAY;AACzB,OAAO,cAAM,YAAY;AACzB,OAAO,cAAM,sBAAsB;AACnC,OAAO,cAAM,gBAAgB;AAC7B,OAAO,cAAM,kBAAkB;AAC/B,OAAO,cAAMC;;AAMb,OAAO,cAAM,6BAA6B;;AAE1C,OAAO,cAAM,6BAA6B;AAG1C,OAAO,cAAM,aAAa;AAC1B,OAAO,cAAM,kCAAkC;AAC/C,OAAO,cAAM,kCAAkC;AAC/C,OAAO,cAAM,sBAAsB;AACnC,OAAO,cAAM,uBAAuB;AACpC,OAAO,cAAM,sBAAsB;AACnC,OAAO,cAAM,qBAAqB;AAElC,OAAO,cAAM,kCAAkC","names":["EMPTY_ANNOTATION_ARRAY: PdfAnnotation[]","DEVICE_PIXEL_RATIO: number"],"sources":["../../../src/pdf-viewer/constants.ts"],"version":3,"file":"constants.d.ts"}

package/build/types/pdf-viewer/hooks/usePdfAnnotationsByPage.d.ts

@@ -0,0 +1,5 @@
+import type { PdfAnnotation } from "../types.js";
+/**
+* Groups a flat array of annotations by page number for efficient per-page lookup.
+*/
+export declare function usePdfAnnotationsByPage(annotations: PdfAnnotation[]): Record<number, PdfAnnotation[]>;

package/build/types/pdf-viewer/hooks/usePdfAnnotationsByPage.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cAAc,qBAAqB,aAAc;;;;AAKjD,OAAO,iBAAS,wBACdA,aAAa,kBACZ,eAAe","names":["annotations: PdfAnnotation[]"],"sources":["../../../../src/pdf-viewer/hooks/usePdfAnnotationsByPage.ts"],"version":3,"file":"usePdfAnnotationsByPage.d.ts"}

package/build/types/pdf-viewer/hooks/usePdfFormFields.d.ts

@@ -0,0 +1,24 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { EventBus, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+import type { PdfFormFieldValue } from "../types.js";
+export interface UsePdfFormFieldsOptions {
+	pdfViewerRef: RefObject<PDFViewer | null>;
+	eventBusRef: RefObject<EventBus | null>;
+	document: PDFDocumentProxy | undefined;
+	formData?: Record<string, PdfFormFieldValue>;
+	onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;
+	onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;
+}
+export interface UsePdfFormFieldsResult {
+	/** Whether the loaded PDF contains interactive form fields. */
+	hasFormFields: boolean;
+	/** Collect all current form field values and invoke onFormSubmit. */
+	submitFormData: () => void;
+}
+/**
+* Hook that manages interactive PDF form fields.
+* Builds a field metadata map, pre-populates initial values,
+* listens for field changes, and collects values on submit.
+*/
+export declare function usePdfFormFields({ pdfViewerRef, eventBusRef, document, formData, onFormSubmit, onFormChange }: UsePdfFormFieldsOptions): UsePdfFormFieldsResult;

package/build/types/pdf-viewer/hooks/usePdfFormFields.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;AACnD,cAAc,UAAU,iBAAiB,+BAAgC;AACzE,cAAc,iBAAiB,OAAQ;AAGvC,cAAc,yBAAyB,aAAc;AAerD,iBAAiB,wBAAwB;CACvC,cAAc,UAAU;CACxB,aAAa,UAAU;CACvB,UAAU;CACV,WAAW,eAAe;CAC1B,gBAAgBA,MAAM,eAAe;CACrC,gBAAgBC,mBAAmBC,OAAO;AAC3C;AAED,iBAAiB,uBAAuB;;CAEtC;;CAEA;AACD;;;;;;AAqED,OAAO,iBAAS,iBAAiB,EAC/B,cACA,aACA,UACA,UACA,cACA,cACwB,EAAvB,0BAA0B","names":["data: Record<string, PdfFormFieldValue>","fieldName: string","value: PdfFormFieldValue"],"sources":["../../../../src/pdf-viewer/hooks/usePdfFormFields.ts"],"version":3,"file":"usePdfFormFields.d.ts"}