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

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

@@ -0,0 +1,10 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { EventBus, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+export interface AnnotationPortalTarget {
+	pageNumber: number;
+	container: HTMLDivElement;
+	pageHeight: number;
+	scale: number;
+}
+export declare function usePdfAnnotationPortals(pdfViewerRef: RefObject<PDFViewer | null>, eventBusRef: RefObject<EventBus | null>, document: PDFDocumentProxy | undefined): AnnotationPortalTarget[];

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;AACnD,cAAc,UAAU,iBAAiB,+BAAgC;AACzE,cAAc,iBAAiB,OAAQ;AAIvC,iBAAiB,uBAAuB;CACtC;CACA,WAAW;CACX;CACA;AACD;AAED,OAAO,iBAAS,wBACdA,cAAc,UAAU,mBACxBC,aAAa,UAAU,kBACvBC,UAAU,+BACT","names":["pdfViewerRef: RefObject<PDFViewer | null>","eventBusRef: RefObject<EventBus | null>","document: PDFDocumentProxy | undefined"],"sources":["../../../../src/pdf-viewer/hooks/usePdfAnnotationPortals.ts"],"version":3,"file":"usePdfAnnotationPortals.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/usePdfDocument.d.ts

@@ -0,0 +1,9 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+interface UsePdfDocumentResult {
+	document: PDFDocumentProxy | undefined;
+	numPages: number;
+	loading: boolean;
+	error: Error | undefined;
+}
+export declare function usePdfDocument(src: string | ArrayBuffer): UsePdfDocumentResult;
+export {};

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;UAgBzC,qBAAqB;CAC7B,UAAU;CACV;CACA;CACA,OAAO;AACR;AAED,OAAO,iBAAS,eACdA,cAAc,cACb","names":["src: string | ArrayBuffer"],"sources":["../../../../src/pdf-viewer/hooks/usePdfDocument.ts"],"version":3,"file":"usePdfDocument.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"}

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

@@ -0,0 +1,36 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+import type { PdfRect, PdfTextHighlightEvent } from "../types.js";
+export interface UsePdfHighlightModeOptions {
+	pdfViewerRef: RefObject<PDFViewer | null>;
+	document: PDFDocumentProxy | undefined;
+	enabled: boolean;
+	onTextHighlight?: (event: PdfTextHighlightEvent) => void;
+	onHighlightDelete?: (event: PdfTextHighlightEvent) => void;
+}
+export interface UsePdfHighlightModeResult {
+	highlightModeActive: boolean;
+	toggleHighlightMode: () => void;
+	deleteHighlight: (editorId: string) => void;
+}
+/**
+* Converts an RGB array (0.0–1.0 per channel) to a CSS hex color string.
+*/
+export declare function rgbArrayToHex(color: number[]): string;
+/**
+* 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 declare function quadPointsToRects(quadPoints: Float32Array): PdfRect[];
+/**
+* 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 declare function usePdfHighlightMode({ pdfViewerRef, document, enabled, onTextHighlight, onHighlightDelete }: UsePdfHighlightModeOptions): UsePdfHighlightModeResult;

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

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cAAc,wBAAwB,YAAa;AACnD,cAAc,iBAAiB,+BAAgC;AAC/D,cAAc,iBAAiB,OAAQ;AAEvC,cAAc,SAAS,6BAA6B,aAAc;AAElE,iBAAiB,2BAA2B;CAC1C,cAAc,UAAU;CACxB,UAAU;CACV;CACA,mBAAmBA,OAAO;CAC1B,qBAAqBA,OAAO;AAC7B;AAED,iBAAiB,0BAA0B;CACzC;CACA;CACA,kBAAkBC;AACnB;;;;AAKD,OAAO,iBAAS,cAAcC;;;;;;;;;;AAkB9B,OAAO,iBAAS,kBACdC,YAAY,eACX;;;;;;AAuBH,OAAO,iBAAS,oBAAoB,EAClC,cACA,UACA,SACA,iBACA,mBAC2B,EAA1B,6BAA6B","names":["event: PdfTextHighlightEvent","editorId: string","color: number[]","quadPoints: Float32Array"],"sources":["../../../../src/pdf-viewer/hooks/usePdfHighlightMode.ts"],"version":3,"file":"usePdfHighlightMode.d.ts"}

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

@@ -0,0 +1,3 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { OutlineItem } from "../types.js";
+export declare function usePdfOutline(document: PDFDocumentProxy | undefined): OutlineItem[];

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;AAMnD,cAAc,mBAAmB,aAAc;AAI/C,OAAO,iBAAS,cACdA,UAAU,+BACT","names":["document: PDFDocumentProxy | undefined"],"sources":["../../../../src/pdf-viewer/hooks/usePdfOutline.ts"],"version":3,"file":"usePdfOutline.d.ts"}

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

@@ -0,0 +1,9 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import { EventBus, PDFFindController, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+export interface UsePdfViewerResult {
+	pdfViewerRef: RefObject<PDFViewer | null>;
+	eventBusRef: RefObject<EventBus | null>;
+	findControllerRef: RefObject<PDFFindController | null>;
+}
+export declare function usePdfViewer(containerRef: RefObject<HTMLDivElement | null>, viewerRef: RefObject<HTMLDivElement | null>, document: PDFDocumentProxy | undefined, initialScale?: number, initialPage?: number): UsePdfViewerResult;

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

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cAAc,wBAAwB,YAAa;AACnD,SACE,UACA,mBAEA,iBACK,+BAAgC;AACvC,cAAc,iBAAiB,OAAQ;AAIvC,iBAAiB,mBAAmB;CAClC,cAAc,UAAU;CACxB,aAAa,UAAU;CACvB,mBAAmB,UAAU;AAC9B;AAED,OAAO,iBAAS,aACdA,cAAc,UAAU,wBACxBC,WAAW,UAAU,wBACrBC,UAAU,8BACVC,uBACAC,uBACC","names":["containerRef: RefObject<HTMLDivElement | null>","viewerRef: RefObject<HTMLDivElement | null>","document: PDFDocumentProxy | undefined","initialScale?: number","initialPage?: number"],"sources":["../../../../src/pdf-viewer/hooks/usePdfViewer.ts"],"version":3,"file":"usePdfViewer.d.ts"}

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

@@ -0,0 +1,43 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { EventBus, PDFFindController, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+import type { AnnotationPortalTarget } from "./usePdfAnnotationPortals.js";
+export interface UsePdfViewerCoreOptions {
+	/** PDF source — URL string or ArrayBuffer */
+	src: string | ArrayBuffer;
+	/** Initial page number (1-indexed, default 1) */
+	initialPage?: number;
+	/** Initial zoom scale (default 1.0) */
+	initialScale?: number;
+}
+export interface UsePdfViewerCoreResult {
+	/** The loaded PDF document, or undefined while loading */
+	document: PDFDocumentProxy | undefined;
+	/** Total number of pages in the document */
+	numPages: number;
+	/** Whether the document is currently loading */
+	loading: boolean;
+	/** Error encountered while loading the document */
+	error: Error | undefined;
+	/** Ref to attach to the scroll-container div */
+	containerRef: RefObject<HTMLDivElement>;
+	/** Ref to attach to the inner viewer div (className="pdfViewer") */
+	viewerRef: RefObject<HTMLDivElement>;
+	/** Current page number (1-indexed) */
+	currentPage: number;
+	/** Navigate to a specific page (updates state and scrolls the viewer) */
+	scrollToPage: (page: number) => void;
+	/** Current zoom scale */
+	scale: number;
+	/** Set the zoom scale directly */
+	setScale: (scale: number) => void;
+	/** Portal targets for rendering annotation overlays on each page */
+	portalTargets: AnnotationPortalTarget[];
+	/** Ref to the internal pdfjs PDFViewer instance */
+	pdfViewerRef: RefObject<PDFViewer | null>;
+	/** Ref to the internal pdfjs EventBus instance */
+	eventBusRef: RefObject<EventBus | null>;
+	/** Ref to the internal pdfjs PDFFindController instance */
+	findControllerRef: RefObject<PDFFindController | null>;
+}
+export declare function usePdfViewerCore({ src, initialPage, initialScale }: UsePdfViewerCoreOptions): UsePdfViewerCoreResult;

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;AACnD,cACE,UACA,mBACA,iBACK,+BAAgC;AACvC,cAAc,iBAAiB,OAAQ;AAEvC,cAAc,8BAA8B,8BAA+B;AAM3E,iBAAiB,wBAAwB;;CAEvC,cAAc;;CAEd;;CAEA;AACD;AAED,iBAAiB,uBAAuB;;CAEtC,UAAU;;CAEV;;CAEA;;CAEA,OAAO;;CAGP,cAAc,UAAU;;CAExB,WAAW,UAAU;;CAGrB;;CAEA,eAAeA;;CAGf;;CAEA,WAAWC;;CAGX,eAAe;;CAGf,cAAc,UAAU;;CAExB,aAAa,UAAU;;CAEvB,mBAAmB,UAAU;AAC9B;AAED,OAAO,iBAAS,iBAAiB,EAC/B,KACA,aACA,cACwB,EAAvB,0BAA0B","names":["page: number","scale: number"],"sources":["../../../../src/pdf-viewer/hooks/usePdfViewerCore.ts"],"version":3,"file":"usePdfViewerCore.d.ts"}

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

@@ -0,0 +1,15 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { EventBus, PDFFindController } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+export interface UsePdfViewerSearchResult {
+	query: string;
+	totalMatches: number;
+	currentMatchIndex: number;
+	isSearchOpen: boolean;
+	setQuery: (query: string) => void;
+	nextMatch: () => void;
+	prevMatch: () => void;
+	openSearch: () => void;
+	closeSearch: () => void;
+}
+export declare function usePdfViewerSearch(eventBusRef: RefObject<EventBus | null>, findControllerRef: RefObject<PDFFindController | null>, document: PDFDocumentProxy | undefined): UsePdfViewerSearchResult;

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;AACnD,cACE,UACA,yBACK,+BAAgC;AACvC,cAAc,iBAAiB,OAAQ;AASvC,iBAAiB,yBAAyB;CACxC;CACA;CACA;CACA;CACA,WAAWA;CACX;CACA;CACA;CACA;AACD;AAED,OAAO,iBAAS,mBACdC,aAAa,UAAU,kBACvBC,mBAAmB,UAAU,2BAC7BC,UAAU,+BACT","names":["query: string","eventBusRef: RefObject<EventBus | null>","findControllerRef: RefObject<PDFFindController | null>","document: PDFDocumentProxy | undefined"],"sources":["../../../../src/pdf-viewer/hooks/usePdfViewerSearch.ts"],"version":3,"file":"usePdfViewerSearch.d.ts"}

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

@@ -0,0 +1,39 @@
+import type { PdfDownloadResult, SidebarMode } from "../types.js";
+import { usePdfOutline } from "./usePdfOutline.js";
+import type { UsePdfViewerCoreOptions, UsePdfViewerCoreResult } from "./usePdfViewerCore.js";
+import type { UsePdfViewerSearchResult } from "./usePdfViewerSearch.js";
+export interface UsePdfViewerStateOptions extends UsePdfViewerCoreOptions {
+	/** Whether the sidebar is initially open (default false) */
+	initialSidebarOpen?: boolean;
+	/** Which sidebar panel to show (default "thumbnails") */
+	sidebarMode?: SidebarMode;
+	/** Callback fired when a download completes or fails */
+	onDownload?: (result: PdfDownloadResult) => void;
+}
+export interface UsePdfViewerStateResult extends UsePdfViewerCoreResult {
+	/** Zoom in by one step */
+	zoomIn: () => void;
+	/** Zoom out by one step */
+	zoomOut: () => void;
+	/** Current rotation in degrees (0, 90, 180, 270) */
+	rotation: number;
+	/** Rotate 90 degrees counter-clockwise */
+	rotateLeft: () => void;
+	/** Rotate 90 degrees clockwise */
+	rotateRight: () => void;
+	/** Whether the sidebar panel is open */
+	sidebarOpen: boolean;
+	/** Which sidebar panel is active */
+	sidebarMode: SidebarMode;
+	/** Change the active sidebar panel */
+	setSidebarMode: (mode: SidebarMode) => void;
+	/** Toggle sidebar open/closed */
+	toggleSidebar: () => void;
+	/** Search state and actions */
+	search: UsePdfViewerSearchResult;
+	/** Document outline items (from bookmarks or text extraction) */
+	outlineItems: ReturnType<typeof usePdfOutline>;
+	/** Download the PDF as a file */
+	download: (filename?: string) => void;
+}
+export declare function usePdfViewerState({ src, initialPage, initialScale, initialSidebarOpen, sidebarMode: sidebarModeProp, onDownload }: UsePdfViewerStateOptions): UsePdfViewerStateResult;

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

@@ -0,0 +1 @@
+{"mappings":"AAkBA,cAAc,mBAAmB,mBAAmB,aAAc;AAClE,SAAS,qBAAqB,oBAAqB;AACnD,cACE,yBACA,8BACK,uBAAwB;AAE/B,cAAc,gCAAgC,yBAA0B;AAGxE,iBAAiB,iCAAiC,wBAAwB;;CAExE;;CAEA,cAAc;;CAEd,cAAcA,QAAQ;AACvB;AAED,iBAAiB,gCAAgC,uBAAuB;;CAEtE;;CAEA;;CAGA;;CAEA;;CAEA;;CAGA;;CAEA,aAAa;;CAEb,iBAAiBC,MAAM;;CAEvB;;CAGA,QAAQ;;CAGR,cAAc,kBAAkB;;CAGhC,WAAWC;AACZ;AAED,OAAO,iBAAS,kBAAkB,EAChC,KACA,aACA,cACA,oBACA,aAAa,iBACb,YACyB,EAAxB,2BAA2B","names":["result: PdfDownloadResult","mode: SidebarMode","filename?: string"],"sources":["../../../../src/pdf-viewer/hooks/usePdfViewerState.ts"],"version":3,"file":"usePdfViewerState.d.ts"}

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

@@ -0,0 +1,15 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+import type { EventBus, PDFViewer } from "pdfjs-dist/web/pdf_viewer.mjs";
+import type { RefObject } from "react";
+interface UsePdfViewerSyncOptions {
+	pdfViewerRef: RefObject<PDFViewer | null>;
+	eventBusRef: RefObject<EventBus | null>;
+	document: PDFDocumentProxy | undefined;
+	scale: number;
+	onScaleChange: (scale: number) => void;
+	onPageChange: (page: number) => void;
+}
+export declare function usePdfViewerSync({ pdfViewerRef, eventBusRef, document, scale, onScaleChange, onPageChange }: UsePdfViewerSyncOptions): {
+	scrollToPage: (page: number) => void
+};
+export {};

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,wBAAwB,YAAa;AACnD,cAAc,UAAU,iBAAiB,+BAAgC;AACzE,cAAc,iBAAiB,OAAQ;UAI7B,wBAAwB;CAChC,cAAc,UAAU;CACxB,aAAa,UAAU;CACvB,UAAU;CACV;CACA,gBAAgBA;CAChB,eAAeC;AAChB;AAED,OAAO,iBAAS,iBAAiB,EAC/B,cACA,aACA,UACA,OACA,eACA,cACwB,EAAvB,0BAA0B;CAC3B,eAAeA;AAChB","names":["scale: number","page: number"],"sources":["../../../../src/pdf-viewer/hooks/usePdfViewerSync.ts"],"version":3,"file":"usePdfViewerSync.d.ts"}

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

@@ -0,0 +1,210 @@
+import type React from "react";
+/** Which sidebar panel to display when the sidebar is open. */
+export type SidebarMode = "thumbnails" | "outline";
+/** A single item in the PDF document outline (table of contents). */
+export interface OutlineItem {
+	title: string;
+	depth: number;
+	pageNumber: number;
+	bold: boolean;
+	italic: boolean;
+}
+/** The visual style of an annotation rendered on the PDF. */
+export type AnnotationType = "highlight" | "underline" | "comment" | "pin" | "custom";
+/** A rectangle in PDF coordinate space (origin: bottom-left of page). */
+export interface PdfRect {
+	x: number;
+	y: number;
+	width: number;
+	height: number;
+}
+/** Props passed to a custom annotation renderer. */
+export interface PdfAnnotationRenderProps {
+	annotation: PdfAnnotation;
+	scale: number;
+	pageHeight: number;
+}
+/** Common fields shared by all annotation types. */
+interface PdfAnnotationBase {
+	/** Unique identifier for this annotation */
+	id: string;
+	/** Page number (1-indexed) */
+	page: number;
+	/** Coordinates in PDF points (origin: bottom-left of page) */
+	rect: PdfRect;
+	/** Additional rects for multi-line text highlights. When present, all rects are rendered. */
+	rects?: PdfRect[];
+	/** Optional label or tooltip text */
+	label?: string;
+	/** Optional color override (CSS color string) */
+	color?: string;
+}
+/** A built-in annotation type (highlight, underline, comment, pin). */
+interface PdfStandardAnnotation extends PdfAnnotationBase {
+	/** The type of annotation to render */
+	type: "highlight" | "underline" | "comment" | "pin";
+}
+/** A custom annotation with a user-provided renderer. */
+export interface PdfCustomAnnotation extends PdfAnnotationBase {
+	/** Must be "custom" for custom-rendered annotations */
+	type: "custom";
+	/** Render function for the custom annotation content (required for custom type) */
+	render: (props: PdfAnnotationRenderProps) => React.ReactNode;
+}
+/** A single annotation positioned on a specific page of the PDF. */
+export type PdfAnnotation = PdfStandardAnnotation | PdfCustomAnnotation;
+/** Result passed to the {@link PdfViewerProps.onDownload} callback. */
+export type PdfDownloadResult = {
+	success: true
+	filename: string
+} | {
+	success: false
+	error: Error
+};
+/** Possible values for a PDF form field. */
+export type PdfFormFieldValue = string | boolean | string[];
+/** Data emitted when the user creates a text highlight via the highlight editor. */
+export interface PdfTextHighlightEvent {
+	/** Internal PDF.js editor ID. Use with `deleteHighlight` to programmatically remove. */
+	editorId: string;
+	/** Page number (1-indexed) */
+	page: number;
+	/** Bounding rects in PDF coordinate space (bottom-left origin) */
+	rects: PdfRect[];
+	/** The selected text content */
+	selectedText: string;
+	/** Highlight color as CSS color string */
+	color: string;
+}
+/** Imperative handle for programmatic control of a {@link PdfViewer} or {@link BasePdfViewer}. */
+export interface PdfViewerHandle {
+	/** Scroll the viewer to the given page number (1-indexed). */
+	scrollToPage: (page: number) => void;
+	/** Programmatically delete a highlight by its `editorId` (from {@link PdfTextHighlightEvent}). */
+	deleteHighlight: (editorId: string) => void;
+}
+/**
+* Options for {@link usePdfViewerInstance}.
+* Equivalent to {@link PdfViewerProps} minus the `className` rendering concern.
+*/
+export interface PdfViewerInstanceOptions {
+	/** PDF source — URL string or ArrayBuffer */
+	src: string | ArrayBuffer;
+	/** Annotations to overlay on the PDF */
+	annotations?: PdfAnnotation[];
+	/** Callback fired when an annotation is clicked */
+	onAnnotationClick?: (annotation: PdfAnnotation) => void;
+	/** Callback fired when a download completes or fails */
+	onDownload?: (result: PdfDownloadResult) => void;
+	/** Whether the highlight toggle button is shown in the toolbar */
+	highlightEnabled?: boolean;
+	/** Callback fired when the user creates a text highlight */
+	onTextHighlight?: (event: PdfTextHighlightEvent) => void;
+	/** Callback fired when the user deletes a highlight */
+	onHighlightDelete?: (event: PdfTextHighlightEvent) => void;
+	/** Initial form field values keyed by field name */
+	formData?: Record<string, PdfFormFieldValue>;
+	/** Callback fired when the user clicks the save button */
+	onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;
+	/** Callback fired when any form field value changes */
+	onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;
+	/** Initial page number (1-indexed, default 1) */
+	initialPage?: number;
+	/** Initial zoom scale (default 1.0) */
+	initialScale?: number;
+	/** Whether the sidebar is initially open (default false) */
+	initialSidebarOpen?: boolean;
+	/** Whether the download button is shown in the toolbar */
+	enableDownload?: boolean;
+	/** Which sidebar panel to show: thumbnails or document outline */
+	sidebarMode?: SidebarMode;
+	/** Custom icon components for each outline depth level (0-indexed) */
+	outlineIcons?: Partial<Record<number, React.ComponentType>>;
+}
+/** Props for the {@link PdfViewer} component. */
+export interface PdfViewerProps {
+	/** PDF source — URL string or ArrayBuffer */
+	src: string | ArrayBuffer;
+	/** Annotations to overlay on the PDF */
+	annotations?: PdfAnnotation[];
+	/**
+	* Callback fired when an annotation is clicked.
+	*
+	* @param annotation - The annotation that was clicked
+	* @returns void
+	*/
+	onAnnotationClick?: (annotation: PdfAnnotation) => void;
+	/**
+	* Callback fired when a download completes or fails.
+	*
+	* @param result - The download result indicating success with the filename, or failure with an error
+	* @returns void
+	*/
+	onDownload?: (result: PdfDownloadResult) => void;
+	/**
+	* Whether the highlight toggle button is shown in the toolbar.
+	* @default false
+	*/
+	enableHighlight?: boolean;
+	/**
+	* Callback fired when the user creates a text highlight.
+	* Only fires when highlight mode is active.
+	*
+	* @param event - The highlight event with page, rects, text, and color
+	* @returns void
+	*/
+	onTextHighlight?: (event: PdfTextHighlightEvent) => void;
+	/**
+	* Callback fired when the user deletes a highlight via the PDF.js editor UI.
+	*
+	* @param event - The highlight event that was deleted
+	* @returns void
+	*/
+	onHighlightDelete?: (event: PdfTextHighlightEvent) => void;
+	/** Initial page number (1-indexed, default 1) */
+	initialPage?: number;
+	/** Initial zoom scale (default 1.0) */
+	initialScale?: number;
+	/** Whether the sidebar is initially open (default false) */
+	initialSidebarOpen?: boolean;
+	/**
+	* Whether the download button is shown in the toolbar.
+	* @default false
+	*/
+	enableDownload?: boolean;
+	/**
+	* Which sidebar panel to show: thumbnails or document outline.
+	* @default "thumbnails"
+	*/
+	sidebarMode?: SidebarMode;
+	/**
+	* Custom icon components for each outline depth level (0-indexed).
+	* Key 0 = top-level items, 1 = first nesting level, etc.
+	* If omitted, no icons are rendered.
+	*/
+	outlineIcons?: Partial<Record<number, React.ComponentType>>;
+	/**
+	* Initial form field values keyed by field name. Applied when the document loads.
+	* Use this to pre-populate form fields when resuming a previously edited PDF.
+	*/
+	formData?: Record<string, PdfFormFieldValue>;
+	/**
+	* Callback fired when the user clicks the save button in the toolbar.
+	* Receives all current form field values keyed by field name.
+	*
+	* @param data - All form field values keyed by field name
+	* @returns void
+	*/
+	onFormSubmit?: (data: Record<string, PdfFormFieldValue>) => void;
+	/**
+	* Callback fired when any form field value changes.
+	*
+	* @param fieldName - The name of the field that changed
+	* @param value - The new value
+	* @returns void
+	*/
+	onFormChange?: (fieldName: string, value: PdfFormFieldValue) => void;
+	/** Additional CSS class name for the root element */
+	className?: string;
+}
+export {};

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,YAAY,WAAW,OAAQ;;AAG/B,YAAY,cAAc,eAAe;;AAGzC,iBAAiB,YAAY;CAC3B;CACA;CACA;CACA;CACA;AACD;;AAGD,YAAY,iBACR,cACA,cACA,YACA,QACA;;AAGJ,iBAAiB,QAAQ;CACvB;CACA;CACA;CACA;AACD;;AAGD,iBAAiB,yBAAyB;CACxC,YAAY;CACZ;CACA;AACD;;UAGS,kBAAkB;;CAE1B;;CAEA;;CAEA,MAAM;;CAEN,QAAQ;;CAER;;CAEA;AACD;;UAGS,8BAA8B,kBAAkB;;CAExD,MAAM,cAAc,cAAc,YAAY;AAC/C;;AAGD,iBAAiB,4BAA4B,kBAAkB;;CAE7D,MAAM;;CAEN,SAASA,OAAO,6BAA6B,MAAM;AACpD;;AAGD,YAAY,gBAAgB,wBAAwB;;AAGpD,YAAY,oBACR;CAAE,SAAS;CAAM;AAAkB,IACnC;CAAE,SAAS;CAAO,OAAO;AAAO;;AAGpC,YAAY;;AAGZ,iBAAiB,sBAAsB;;CAErC;;CAEA;;CAEA,OAAO;;CAEP;;CAEA;AACD;;AAGD,iBAAiB,gBAAgB;;CAE/B,eAAeC;;CAEf,kBAAkBC;AACnB;;;;;AAMD,iBAAiB,yBAAyB;;CAExC,cAAc;;CAEd,cAAc;;CAEd,qBAAqBC,YAAY;;CAEjC,cAAcC,QAAQ;;CAEtB;;CAEA,mBAAmBC,OAAO;;CAE1B,qBAAqBA,OAAO;;CAE5B,WAAW,eAAe;;CAE1B,gBAAgBC,MAAM,eAAe;;CAErC,gBAAgBC,mBAAmBC,OAAO;;CAE1C;;CAEA;;CAEA;;CAEA;;CAEA,cAAc;;CAEd,eAAe,QAAQ,eAAe,MAAM;AAC7C;;AAGD,iBAAiB,eAAe;;CAE9B,cAAc;;CAEd,cAAc;;;;;;;CAOd,qBAAqBL,YAAY;;;;;;;CAOjC,cAAcC,QAAQ;;;;;CAKtB;;;;;;;;CAQA,mBAAmBC,OAAO;;;;;;;CAO1B,qBAAqBA,OAAO;;CAE5B;;CAEA;;CAEA;;;;;CAKA;;;;;CAKA,cAAc;;;;;;CAMd,eAAe,QAAQ,eAAe,MAAM;;;;;CAK5C,WAAW,eAAe;;;;;;;;CAQ1B,gBAAgBC,MAAM,eAAe;;;;;;;;CAQrC,gBAAgBC,mBAAmBC,OAAO;;CAE1C;AACD","names":["props: PdfAnnotationRenderProps","page: number","editorId: string","annotation: PdfAnnotation","result: PdfDownloadResult","event: PdfTextHighlightEvent","data: Record<string, PdfFormFieldValue>","fieldName: string","value: PdfFormFieldValue"],"sources":["../../../src/pdf-viewer/types.ts"],"version":3,"file":"types.d.ts"}

package/build/types/public/experimental.d.ts

@@ -1,9 +1,40 @@
+export { BaseFilterList } from "../filter-list/base/BaseFilterList.js";
+export type { BaseFilterListProps, RenderFilterInput } from "../filter-list/base/BaseFilterListApi.js";
+export { FilterList } from "../filter-list/FilterList.js";
 export type { FilterDefinitionUnion, FilterListProps } from "../filter-list/FilterListApi.js";
 export type { FilterComponentType, FilterListItemProps, FilterState, PropertyFilterDefinition } from "../filter-list/FilterListItemApi.js";
+export { deserializeFilterStates, serializeFilterStates } from "../filter-list/utils/filterStateSerialization.js";
 export { ObjectTable } from "../object-table/ObjectTable.js";
-export type { ColumnDefinition, ColumnDefinitionLocator, ObjectTableProps } from "../object-table/ObjectTableApi.js";
-export type { CellIdentifier, CellValueState } from "../object-table/utils/types.js";
+export type { ColumnDefinition, ColumnDefinitionLocator, CustomColumnLocator, FunctionColumnLocator, ObjectTableProps, PropertyColumnLocator, RdpColumnLocator } from "../object-table/ObjectTableApi.js";
+export type { CellEditInfo } from "../object-table/utils/types.js";
 export type { BaseTableProps } from "../object-table/Table.js";
 export { BaseTable } from "../object-table/Table.js";
 export { ColumnConfigDialog } from "../object-table/ColumnConfigDialog.js";
 export type { ColumnConfigDialogProps, ColumnConfigOptions } from "../object-table/ColumnConfigDialog.js";
+export { BasePdfViewer } from "../pdf-viewer/PdfViewer.js";
+export type { AnnotationType, PdfAnnotation, PdfAnnotationRenderProps, PdfCustomAnnotation, PdfDownloadResult, PdfFormFieldValue, PdfRect, PdfTextHighlightEvent, PdfViewerProps, SidebarMode } from "../pdf-viewer/types.js";
+export { PdfViewerAnnotationLayer, type PdfViewerAnnotationLayerProps } from "../pdf-viewer/components/PdfViewerAnnotationLayer.js";
+export { PdfViewerContent, type PdfViewerContentProps } from "../pdf-viewer/components/PdfViewerContent.js";
+export { PdfViewerOutlineSidebar, type PdfViewerOutlineSidebarProps } from "../pdf-viewer/components/PdfViewerOutlineSidebar.js";
+export { PdfViewerSearchBar, type PdfViewerSearchBarProps } from "../pdf-viewer/components/PdfViewerSearchBar.js";
+export { PdfViewerSidebar, type PdfViewerSidebarProps } from "../pdf-viewer/components/PdfViewerSidebar.js";
+export { PdfViewerToolbar, type PdfViewerToolbarProps } from "../pdf-viewer/components/PdfViewerToolbar.js";
+export { type AnnotationPortalTarget, 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, type UsePdfFormFieldsOptions, type UsePdfFormFieldsResult } from "../pdf-viewer/hooks/usePdfFormFields.js";
+export { usePdfHighlightMode, type UsePdfHighlightModeOptions, type UsePdfHighlightModeResult } from "../pdf-viewer/hooks/usePdfHighlightMode.js";
+export { usePdfOutline } from "../pdf-viewer/hooks/usePdfOutline.js";
+export { usePdfViewer, type UsePdfViewerResult } from "../pdf-viewer/hooks/usePdfViewer.js";
+export { usePdfViewerSearch, type UsePdfViewerSearchResult } from "../pdf-viewer/hooks/usePdfViewerSearch.js";
+export { usePdfViewerSync } from "../pdf-viewer/hooks/usePdfViewerSync.js";
+export { type OutlineItem } from "../pdf-viewer/types.js";
+export { type PdfViewerContextValue, PdfViewerProvider, usePdfViewerContext, usePdfViewerInstance } from "../pdf-viewer/PdfViewerContext.js";
+export type { PdfViewerHandle, PdfViewerInstanceOptions } from "../pdf-viewer/types.js";
+export { usePdfViewerCore, type UsePdfViewerCoreOptions, type UsePdfViewerCoreResult } from "../pdf-viewer/hooks/usePdfViewerCore.js";
+export { usePdfViewerState, type UsePdfViewerStateOptions, type UsePdfViewerStateResult } from "../pdf-viewer/hooks/usePdfViewerState.js";
+export { PdfViewer, type PdfViewerMediaProps } from "../pdf-viewer/PdfRenderer.js";
+export { ActionForm } from "../action-form/ActionForm.js";
+export type { ActionFormProps, BaseFormProps, FormError, FormState } from "../action-form/ActionFormApi.js";
+export { BaseForm } from "../action-form/BaseForm.js";
+export type { ActionParameters, BaseFormFieldProps, CustomFieldProps, DatetimePickerFieldProps, DropdownFieldProps, FieldComponent, FieldValueType, FilePickerProps, FormFieldDefinition, FormFieldPropsByType, NumberInputFieldProps, ObjectSetFieldProps, Option, RadioButtonsFieldProps, RendererFieldDefinition, TextAreaFieldProps, TextInputFieldProps } from "../action-form/FormFieldApi.js";

package/build/types/public/experimental.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,uBACA,uBACK;AACP,cACE,qBACA,qBACA,aACA,gCACK;AAGP,SAAS,mBAAmB;AAC5B,cACE,kBACA,yBACA,wBACK;AACP,cACE,gBACA,sBACK;AAGP,cAAc,sBAAsB;AACpC,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B;AACnC,cACE,yBACA,2BACK","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}
+{"mappings":"AAgBA,SAAS,sBAAsB;AAC/B,cACE,qBACA,yBACK;AACP,SAAS,kBAAkB;AAE3B,cACE,uBACA,uBACK;AACP,cACE,qBACA,qBACA,aACA,gCACK;AACP,SACE,yBACA,6BACK;AAGP,SAAS,mBAAmB;AAC5B,cACE,kBACA,yBACA,qBACA,uBACA,kBACA,uBACA,wBACK;AACP,cAAc,oBAAoB;AAGlC,cAAc,sBAAsB;AACpC,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B;AACnC,cACE,yBACA,2BACK;AAGP,SAAS,qBAAqB;AAC9B,cACE,gBACA,eACA,0BACA,qBACA,mBACA,mBACA,SACA,uBACA,gBACA,mBACK;AAGP,SACE,+BACK,qCACA;AACP,SACE,uBACK,6BACA;AACP,SACE,8BACK,oCACA;AACP,SACE,yBACK,+BACA;AACP,SACE,uBACK,6BACA;AACP,SACE,uBACK,6BACA;AAGP,cACO,wBACL,+BACK;AACP,SAAS,+BAA+B;AACxC,SAAS,sBAAsB;AAC/B,SACE,uBACK,8BACA,8BACA;AACP,SACE,0BACK,iCACA,iCACA;AACP,SAAS,qBAAqB;AAC9B,SACE,mBACK,0BACA;AACP,SACE,yBACK,gCACA;AACP,SAAS,wBAAwB;AACjC,cAAc,mBAAmB;AAGjC,cACO,uBACL,mBACA,qBACA,4BACK;AACP,cACE,iBACA,gCACK;AAGP,SACE,uBACK,8BACA,8BACA;AACP,SACE,wBACK,+BACA,+BACA;AAGP,SACE,gBACK,2BACA;AAEP,SAAS,kBAAkB;AAC3B,cACE,iBACA,eACA,WACA,iBACK;AACP,SAAS,gBAAgB;AACzB,cACE,kBACA,oBACA,kBACA,0BACA,oBACA,gBACA,gBACA,iBACA,qBACA,sBACA,uBACA,qBACA,QACA,wBACA,yBACA,oBACA,2BACK","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}

package/build/types/public/primitives.d.ts

@@ -0,0 +1,3 @@
+export { ActionButton, type ButtonProps } from "../base-components/action-button/ActionButton.js";
+export { Dialog, type DialogProps } from "../base-components/dialog/Dialog.js";
+export { Tooltip, TooltipArrow, type TooltipProps } from "../base-components/tooltip/index.js";

package/build/types/public/primitives.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,SACE,mBACK,mBACA;AACP,SAAS,aAAa,mBAAmB;AACzC,SACE,SACA,mBACK,oBACA","names":[],"sources":["../../../src/public/primitives.ts"],"version":3,"file":"primitives.d.ts"}

package/build/types/shared/assertUnreachable.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;AAqBA,OAAO,iBAAS,kBAAkBA","names":["value: never"],"sources":["../../../src/shared/assertUnreachable.ts"],"version":3,"file":"assertUnreachable.d.ts"}

package/build/types/shared/dateUtils.d.ts

@@ -0,0 +1,31 @@
+/**
+* Date utilities for HTML date inputs.
+*
+* These functions operate on local time by design. HTML <input type="date">
+* returns and expects values in "YYYY-MM-DD" format without timezone info.
+*
+* `parseDateFromInput` appends "T00:00:00" (no "Z") so the date is parsed as
+* local midnight rather than UTC midnight. Without this, negative-offset
+* timezones (e.g. US timezones) would shift "2024-01-15" to Jan 14 locally.
+*
+* Consumers providing dates from an API (typically UTC) should handle
+* UTC-to-local conversion before passing values to these functions.
+*/
+export declare function formatDateForInput(date: Date | undefined | null): string;
+/** Formats the time portion of a Date as "HH:mm". */
+export declare function formatTime(date: Date): string;
+export declare function parseDateFromInput(value: string | undefined | null): Date | undefined;
+export declare function formatDatetimeForInput(date: Date | undefined | null): string;
+/**
+* Parses a datetime-local input string (e.g. "2024-01-15T14:30") into a Date.
+* Delegates to `parseDateFromISO` since the parsing logic is identical for
+* string inputs — datetime-local strings already include the time component
+* and have no "Z" suffix, so `new Date()` parses them as local time.
+*/
+export declare function parseDatetimeFromInput(value: string | undefined | null): Date | undefined;
+export declare function formatDateForDisplay(date: Date | undefined | null, fallback?: string): string;
+/** Formats a Date as "2024-06-15 14:30" — space-separated, more readable than T. */
+export declare function formatDatetimeForDisplay(date: Date | undefined | null): string;
+/** Parses space-separated ("2024-06-15 14:30") or T-separated datetime strings. */
+export declare function parseDatetimeFromDisplay(value: string | undefined | null): Date | undefined;
+export declare function parseDateFromISO(value: string | Date | undefined | null): Date | undefined;

package/build/types/shared/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;;;;;AA8BA,OAAO,iBAAS,mBAAmBA,MAAM;;AASzC,OAAO,iBAAS,WAAWC,MAAM;AAMjC,OAAO,iBAAS,mBACdC,mCACC;AAMH,OAAO,iBAAS,uBACdF,MAAM;;;;;;;AAYR,OAAO,iBAAS,uBACdE,mCACC;AAKH,OAAO,iBAAS,qBACdF,MAAM,yBACNG;;AAWF,OAAO,iBAAS,yBACdH,MAAM;;AAOR,OAAO,iBAAS,yBACdE,mCACC;AAOH,OAAO,iBAAS,iBACdE,gBAAgB,0BACf","names":["date: Date | undefined | null","date: Date","value: string | undefined | null","fallback: string","value: string | Date | undefined | null"],"sources":["../../../src/shared/dateUtils.ts"],"version":3,"file":"dateUtils.d.ts"}

package/build/types/shared/typedMemo.d.ts

@@ -0,0 +1,6 @@
+/**
+* TODO: Delete this once `React.memo` is typed to not lose generics to `unknown`
+*
+* Context: https://github.com/DefinitelyTyped/DefinitelyTyped/issues/37087
+*/
+export declare const typedReactMemo: <T>(component: T) => T;

package/build/types/shared/typedMemo.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;AAuBA,OAAO,cAAMA,iBAAiB,GAAGC,WAAW,MAAM","names":["typedReactMemo: <T>(component: T) => T","component: T"],"sources":["../../../src/shared/typedMemo.ts"],"version":3,"file":"typedMemo.d.ts"}