@gembox/pdfviewer 2026.5.102 → 2026.5.103

package/dist/es/pdfviewer.css

@@ -1,5 +1,5 @@
 /*
- * GemBox.PdfViewer v2026.5.102 (https://www.gemboxsoftware.com/pdfviewer)
+ * GemBox.PdfViewer v2026.5.103 (https://www.gemboxsoftware.com/pdfviewer)
  * Copyright © GemBox Ltd. — All rights reserved.
  * Licensed under commercial license. See LICENSE.txt in the package root or e-mail us at info@gemboxsoftware.com to obtain the license.
  *

package/dist/es/pdfviewer.d.ts

@@ -250,6 +250,23 @@ export declare namespace constants {
     }
 }
 
+/**
+ * Defines the cursor modes available in the PDF viewer.
+ *
+ * @remarks
+ * The cursor mode determines how the mouse or touch interactions work with the PDF document.
+ */
+export declare enum CursorMode {
+    /**
+     * Text selection mode. Allows selecting and copying text from the PDF document.
+     */
+    TextSelection = 0,
+    /**
+     * Draggable mode. Allows dragging the PDF document with mouse or touch instead of text selection.
+     */
+    Draggable = 1
+}
+
 /**
  * Represents an event that is emitted when a digital signing operation completes successfully.
  *
@@ -513,6 +530,14 @@ export declare class DownloadButtonUI extends BasicButtonUI {
 export declare interface DownloadButtonUIOptions extends VisibilityOption {
 }
 
+/**
+ * Represents the available values that can be displayed in dropdown menus for zoom options.
+ *
+ * @remarks
+ * This type includes constants for page fit and page width, as well as predefined zoom percentage values from the constants module.
+ */
+export declare type DropdownValues = typeof constants.pageFit | typeof constants.pageWidth | (typeof constants.zoomPercentageDropdownValues)[number];
+
 /**
  * Represents the e-signature element in the PDF viewer's side panel.
  *
@@ -699,6 +724,11 @@ export declare interface FeaturesOptions {
     digitalSigning?: DigitalSigningOptions;
 }
 
+export declare class FreeText {
+    get fontSize(): number;
+    set fontSize(value: number);
+}
+
 /**
  * Represents the free text annotation component in the PDF viewer's toolbar.
  *
@@ -824,6 +854,25 @@ export declare type NestedMessages = {
     [key: string]: string | NestedMessages;
 };
 
+/**
+ * Represents a button in the PDF viewer toolbar that navigates to the next page of the document.
+ *
+ * @remarks
+ * This button allows users to move forward through the pages of the loaded PDF document, providing specific behavior for page navigation.
+ */
+export declare class NextPageButtonUI extends BasicButtonUI {
+}
+
+/**
+ * Represents a button in the PDF viewer toolbar that navigates to the next search match.
+ *
+ * @remarks
+ * This button allows users to move to the next occurrence of their search query within the document,
+ * providing specific behavior for search navigation.
+ */
+export declare class NextSearchButtonUI extends BasicButtonUI {
+}
+
 /**
  * Represents a button in the PDF viewer toolbar that opens file dialog for loading PDF documents.
  *
@@ -893,6 +942,32 @@ export declare interface PageEventMap {
  */
 export declare const pageFit = "pageFit";
 
+/**
+ * Represents an event that is fired when the input value has changed and page navigation occurs.
+ *
+ * @remarks
+ * This event provides read-only access to the target page number after validation.
+ */
+export declare interface PageInputChangedEvent extends ViewerEvent {
+    /**
+     * The target page number (entered as 1-based number) that has been applied.
+     */
+    readonly pageNumber: number;
+}
+
+/**
+ * Represents an event that is fired when the input value is about to change.
+ *
+ * @remarks
+ * This event can be prevented to stop the page navigation from occurring.
+ */
+export declare interface PageInputChangingEvent extends ViewerEvent {
+    /**
+     * The page number string that is about to be applied.
+     */
+    value: string;
+}
+
 /**
  * Provides functionality for managing and navigating through pages in a PDF document.
  *
@@ -952,6 +1027,43 @@ export declare class PageNavigation implements EventElement<PageEventMap> {
     previousPage(): void;
 }
 
+/**
+ * PageNavigationFieldEventMap is an interface used to provide type-safe event listeners and is not instantiated
+ * or used directly. It maps event names to their corresponding event object types and
+ * is consumed by addEventListener to ensure correct typing of listener callbacks.
+ */
+export declare interface PageNavigationFieldEventMap {
+    /**
+     * Event fired when the input value is about to change.
+     */
+    inputChanging: PageInputChangingEvent;
+    /**
+     * Event fired when the input value has changed and page navigation occurs.
+     */
+    inputChanged: PageInputChangedEvent;
+}
+
+/**
+ * Represents a field in the PDF viewer toolbar that allows users to navigate to specific pages by entering page numbers.
+ *
+ * @remarks
+ * This component provides functionality for direct page navigation through user input, handling page number changes and validation.
+ */
+export declare class PageNavigationFieldUI implements VisibilityElement, EventElement<PageNavigationFieldEventMap> {
+    /** @inheritdoc */
+    get isVisible(): boolean;
+    /** @inheritdoc */
+    set isVisible(value: boolean);
+    /** @inheritdoc */
+    addEventListener<K extends keyof PageNavigationFieldEventMap>(type: K, listener: (event: PageNavigationFieldEventMap[K]) => void): void;
+    /**
+     * Sets the input value and handles page navigation.
+     *
+     * @param value - The page number string to navigate to.
+     */
+    setInput(value: string): void;
+}
+
 /**
  * Represents page navigation controls for the viewer toolbar.
  */
@@ -1000,6 +1112,25 @@ export declare class PanModeButtonUI extends BasicButtonUI {
 export declare interface PanModeButtonUIOptions extends VisibilityOption {
 }
 
+/**
+ * Represents a button in the PDF viewer toolbar that navigates to the previous page of the document.
+ *
+ * @remarks
+ * This button allows users to move backward through the pages of the loaded PDF document, providing specific behavior for page navigation.
+ */
+export declare class PreviousPageButtonUI extends BasicButtonUI {
+}
+
+/**
+ * Represents a button in the PDF viewer toolbar that navigates to the previous search match.
+ *
+ * @remarks
+ * This button allows users to move to the previous occurrence of their search query within the document,
+ * providing specific behavior for search navigation.
+ */
+export declare class PreviousSearchButtonUI extends BasicButtonUI {
+}
+
 /**
  * Represents a button in the PDF viewer toolbar that allows users to print the current document.
  *
@@ -1020,6 +1151,32 @@ export declare class PrintButtonUI extends BasicButtonUI {
 export declare interface PrintButtonUIOptions extends VisibilityOption {
 }
 
+/**
+ * Represents an event that is fired when the search query has changed and text searching occurs.
+ *
+ * @remarks
+ * This event provides read-only access to the search query after validation.
+ */
+export declare interface QueryChangedEvent extends ViewerEvent {
+    /**
+     * The search query that has been applied.
+     */
+    readonly value: string;
+}
+
+/**
+ * Represents an event that is fired when the search query is about to change.
+ *
+ * @remarks
+ * This event can be prevented to stop the search from occurring.
+ */
+export declare interface QueryChangingEvent extends ViewerEvent {
+    /**
+     * The search query that is about to be applied.
+     */
+    value: string;
+}
+
 /**
  * Provides search functionality for finding text within PDF documents.
  *
@@ -1170,6 +1327,43 @@ export declare interface SearchEventMap {
     searchCompleted: SearchCompletedEvent;
 }
 
+/**
+ * SearchFieldEventMap is an interface used to provide type-safe event listeners and is not instantiated
+ * or used directly. It maps event names to their corresponding event object types and
+ * is consumed by addEventListener to ensure correct typing of listener callbacks.
+ */
+export declare interface SearchFieldEventMap {
+    /**
+     * Event fired when the search query is about to change.
+     */
+    queryChanging: QueryChangingEvent;
+    /**
+     * Event fired when the search query has changed and text searching occurs.
+     */
+    queryChanged: QueryChangedEvent;
+}
+
+/**
+ * Represents a field in the PDF viewer toolbar that allows users to search for text within documents.
+ *
+ * @remarks
+ * This component provides functionality for text searching through user input, handling search queries and validation.
+ */
+export declare class SearchFieldUI implements VisibilityElement, EventElement<SearchFieldEventMap> {
+    /** @inheritdoc */
+    get isVisible(): boolean;
+    /** @inheritdoc */
+    set isVisible(value: boolean);
+    /** @inheritdoc */
+    addEventListener<K extends keyof SearchFieldEventMap>(type: K, listener: (event: SearchFieldEventMap[K]) => void): void;
+    /**
+     * Sets the search query and handles text searching.
+     *
+     * @param value - The search query string to find in the document.
+     */
+    setQuery(value: string): void;
+}
+
 /**
  * Event emitted when a search operation is starting.
  *
@@ -1609,6 +1803,32 @@ export declare interface UIOptions {
     sidePanel?: SidePanelUIOptions;
 }
 
+/**
+ * Represents an event that is fired when the zoom level has changed and been applied.
+ *
+ * @remarks
+ * This event provides read-only access to the selected zoom level after validation.
+ */
+export declare interface ValueChangedEvent extends ViewerEvent {
+    /**
+     * The zoom level that has been applied.
+     */
+    readonly value: DropdownValues;
+}
+
+/**
+ * Represents an event that is fired when the zoom level is about to change.
+ *
+ * @remarks
+ * This event can be prevented to stop the zoom level from being applied.
+ */
+export declare interface ValueChangingEvent extends ViewerEvent {
+    /**
+     * The zoom level that is about to be applied.
+     */
+    value: DropdownValues;
+}
+
 /**
  * Represents a base event interface for the PDF viewer that provides functionality
  * similar to the standard DOM Event interface, allowing events to be canceled.
@@ -1806,6 +2026,57 @@ export declare interface ZoomChangingEvent extends ViewerEvent {
     zoomLevelAfter: ZoomLevel;
 }
 
+/**
+ * ZoomDropdownEventMap is an interface used to provide type-safe event listeners and is not instantiated
+ * or used directly. It maps event names to their corresponding event object types and
+ * is consumed by addEventListener to ensure correct typing of listener callbacks.
+ */
+export declare interface ZoomDropdownEventMap {
+    /**
+     * Event fired when the zoom level is about to change.
+     */
+    valueChanging: ValueChangingEvent;
+    /**
+     * Event fired when the zoom level has changed and been applied.
+     */
+    valueChanged: ValueChangedEvent;
+}
+
+/**
+ * Represents a dropdown in the PDF viewer toolbar that allows users to select different zoom levels.
+ *
+ * @remarks
+ * This component provides functionality for zoom level selection through user input, handling zoom changes and validation.
+ */
+export declare class ZoomDropdownUI implements VisibilityElement, EventElement<ZoomDropdownEventMap> {
+    /** @inheritdoc */
+    get isVisible(): boolean;
+    /** @inheritdoc */
+    set isVisible(value: boolean);
+    /** @inheritdoc */
+    addEventListener<K extends keyof ZoomDropdownEventMap>(type: K, listener: (event: ZoomDropdownEventMap[K]) => void): void;
+    /**
+     * Selects a zoom level from the dropdown.
+     *
+     * @param value - The zoom level to apply
+     */
+    select(value: DropdownValues): void;
+    /**
+     * Whether the dropdown is opened or closed.
+     */
+    get isOpened(): boolean;
+    /**
+     * Whether the dropdown is opened or closed.
+     *
+     * @param value - The visibility state to set.
+     */
+    set isOpened(value: boolean);
+    /**
+     * Toggles the open/closed state of the dropdown.
+     */
+    toggleOpen(): void;
+}
+
 /**
  * ZoomEventMap is an interface used to provide type-safe event listeners and is not instantiated
  * or used directly. It maps event names to their corresponding event object types and
@@ -1820,6 +2091,59 @@ export declare interface ZoomEventMap {
     zoomChanged: ZoomChangedEvent;
 }
 
+/**
+ * ZoomInButtonEventMap is an interface used to provide type-safe event listeners and is not instantiated
+ * or used directly. It maps event names to their corresponding event object types and
+ * is consumed by addEventListener to ensure correct typing of listener callbacks.
+ */
+export declare interface ZoomInButtonEventMap {
+    /**
+     * Event fired when the zoom in button is clicked.
+     */
+    click: ZoomInClickEvent;
+}
+
+/**
+ * Represents a button in the PDF viewer toolbar that increases the magnification level of the document view.
+ *
+ * @remarks
+ * This component provides functionality for zooming in on the document, handling zoom changes with before/after information.
+ */
+export declare class ZoomInButtonUI implements VisibilityElement, EventElement<ZoomInButtonEventMap> {
+    /** @inheritdoc */
+    get isVisible(): boolean;
+    /** @inheritdoc */
+    set isVisible(value: boolean);
+    /** @inheritdoc */
+    addEventListener<K extends keyof ZoomInButtonEventMap>(type: K, listener: (event: ZoomInButtonEventMap[K]) => void): void;
+    /**
+     * Increases the zoom level by one step.
+     *
+     * @remarks
+     * This method calculates the next appropriate zoom level based on predefined steps and
+     * emits {@link ZoomInClickEvent} before applying the change.
+     */
+    click(): Promise<void>;
+}
+
+/**
+ * Represents an event that is fired when the zoom in button is clicked.
+ *
+ * @remarks
+ * This event provides read-only access to the current zoom level and allows modification of the target
+ * zoom level before it's applied. The event can be prevented to stop the zoom operation entirely.
+ */
+export declare interface ZoomInClickEvent extends ViewerEvent {
+    /**
+     * The current zoom level before the change.
+     */
+    readonly zoomLevelBefore: number;
+    /**
+     * The target zoom level after the change. This value can be modified to customize the zoom operation.
+     */
+    zoomLevelAfter: number;
+}
+
 /**
  * Represents the zoom level that can be applied to the PDF viewer.
  *
@@ -1828,6 +2152,59 @@ export declare interface ZoomEventMap {
  */
 export declare type ZoomLevel = number | typeof constants.automatic | typeof constants.pageFit | typeof constants.pageWidth;
 
+/**
+ * ZoomOutButtonEventMap is an interface used to provide type-safe event listeners and is not instantiated
+ * or used directly. It maps event names to their corresponding event object types and
+ * is consumed by addEventListener to ensure correct typing of listener callbacks.
+ */
+export declare interface ZoomOutButtonEventMap {
+    /**
+     * Event fired when the zoom out button is clicked.
+     */
+    click: ZoomOutClickEvent;
+}
+
+/**
+ * Represents a button in the PDF viewer toolbar that decreases the magnification level of the document view.
+ *
+ * @remarks
+ * This component provides functionality for zooming out on the document, handling zoom changes with before/after information.
+ */
+export declare class ZoomOutButtonUI implements VisibilityElement, EventElement<ZoomOutButtonEventMap> {
+    /** @inheritdoc */
+    get isVisible(): boolean;
+    /** @inheritdoc */
+    set isVisible(value: boolean);
+    /** @inheritdoc */
+    addEventListener<K extends keyof ZoomOutButtonEventMap>(type: K, listener: (event: ZoomOutButtonEventMap[K]) => void): void;
+    /**
+     * Decreases the zoom level by one step.
+     *
+     * @remarks
+     * This method calculates the previous appropriate zoom level based on predefined steps and
+     * emits {@link ZoomOutClickEvent} before applying the change.
+     */
+    click(): Promise<void>;
+}
+
+/**
+ * Represents an event that is fired when the zoom out button is clicked.
+ *
+ * @remarks
+ * This event provides read-only access to the current zoom level and allows modification of the target
+ * zoom level before it's applied. The event can be prevented to stop the zoom operation entirely.
+ */
+export declare interface ZoomOutClickEvent extends ViewerEvent {
+    /**
+     * The current zoom level before the change.
+     */
+    readonly zoomLevelBefore: number;
+    /**
+     * The target zoom level after the change. This value can be modified to customize the zoom operation.
+     */
+    zoomLevelAfter: number;
+}
+
 /**
  * Represents the default zoom percentage values for the dropdown menu.
  *