unpdf 1.6.2 → 1.8.0

package/dist/types/src/display/draw_layer.d.ts

@@ -1,12 +1,137 @@
+/**
+ * Configuration for {@linkcode DrawLayer}.
+ */
+export type DrawLayerOptions = {
+    /**
+     * Filter factory used to style selections (optional).
+     */
+    filterFactory?: Object | null | undefined;
+    /**
+     * Page foreground/background colors for HCM (optional).
+     */
+    pageColors?: Object | null | undefined;
+    /**
+     *   Zero-based page index.
+     */
+    pageIndex: number;
+    /**
+     * Text layer element (optional).
+     */
+    textLayer?: Element | null | undefined;
+};
+/**
+ * Result of {@linkcode normalizeEdgeBoundary}.
+ */
+export type EdgeBoundaryResult = {
+    /**
+     *   Normalized container.
+     */
+    container: Node;
+    /**
+     *   Normalized offset.
+     */
+    offset: number;
+};
+/**
+ * Result of {@linkcode SelectionRotator}.
+ */
+export type SelectionRotatorResult = {
+    /**
+     *   Rotated X coordinate.
+     */
+    x: number;
+    /**
+     *   Rotated Y coordinate.
+     */
+    y: number;
+    /**
+     *   Rotated width.
+     */
+    width: number;
+    /**
+     *   Rotated height.
+     */
+    height: number;
+};
+/**
+ * Rotate the coordinates of a rectangle according to the position of the
+ * text layer in the viewport.
+ */
+export type SelectionRotator = (x: number, y: number, width: number, height: number) => SelectionRotatorResult;
+/**
+ * Data related to the selection for a text layer.
+ */
+export type TextLayerSelectionData = {
+    /**
+     *   Draw layer associated with the text layer.
+     */
+    drawLayer: DrawLayer;
+    /**
+     * Node (SVG path element) used to draw the selection.
+     */
+    path?: SVGPathElement | null | undefined;
+    /**
+     * Node (div element) used to display the selection.
+     */
+    selectionDiv?: HTMLDivElement | null | undefined;
+};
 /**
  * Manage the SVGs drawn on top of the page canvas.
  * It's important to have them directly on top of the canvas because we want to
  * be able to use mix-blend-mode for some of them.
  */
 export class DrawLayer {
-    static "__#private@#id": number;
+    static #id: number;
+    static #selectionId: number;
+    /** @type {AbortController | null} */
+    static #selectionChangeAC: AbortController | null;
+    /** @type {Set<HTMLDivElement>} */
+    static #selections: Set<HTMLDivElement>;
+    /** @type {boolean} */
+    static #isSelecting: boolean;
+    /** @type {Set<Element>} */
+    static #textLayerSet: Set<Element>;
+    /** @type {WeakMap<Element, TextLayerSelectionData>} */
+    static #textLayers: WeakMap<Element, TextLayerSelectionData>;
+    /**
+     * Clean up the selection for a text layer.
+     *
+     * @param {Element} textLayer
+     *   Text layer.
+     * @returns {undefined}
+     *   Nothing.
+     */
+    static #cleanupTextLayerSelection(textLayer: Element): undefined;
+    /**
+     * @returns {boolean}
+     *   Whether there is a non-collapsed document selection.
+     */
+    static #hasSelection(): boolean;
+    /**
+     * @returns {Array<Element>}
+     *   Connected text layers sorted in document order.
+     */
+    static #getOrderedTextLayers(): Array<Element>;
+    /**
+     * Handle `selectionchange` to update the selection display for text layers.
+     * We want to display the selection in a separate layer on top of the text
+     * layer because the text layer has `mix-blend-mode: multiply` and we want
+     * the selection to have a different blend mode.
+     *
+     * @returns {undefined}
+     *   Nothing.
+     */
+    static #selectionChange(): undefined;
     static get _svgFactory(): any;
-    static "__#private@#setBox"(element: any, [x, y, width, height]: [any, any, any, any]): void;
+    static #setBox(element: any, [x, y, width, height]: [any, any, any, any]): void;
+    /**
+     * @param {DrawLayerOptions} options
+     *   Configuration.
+     * @returns
+     *   Instance.
+     */
+    constructor({ filterFactory, pageColors, pageIndex, textLayer, }: DrawLayerOptions);
+    pageIndex: number;
     setParent(parent: any): void;
     draw(properties: any, isPathUpdatable?: boolean, hasClip?: boolean): {
         id: number;

package/dist/types/src/display/editor/alt_text.d.ts

@@ -1,5 +1,5 @@
 export class AltText {
-    static "__#private@#l10nNewButton": null;
+    static #l10nNewButton: null;
     static _l10n: null;
     static initialize(l10n: any): void;
     constructor(editor: any);

package/dist/types/src/display/editor/annotation_editor_layer.d.ts

@@ -1,5 +1,5 @@
 export type AnnotationEditorUIManager = import("./tools.js").AnnotationEditorUIManager;
-export type PageViewport = import("../display_utils.js").PageViewport;
+export type PageViewport = import("../page_viewport.js").PageViewport;
 export type TextAccessibilityManager = import("../../../web/text_accessibility.js").TextAccessibilityManager;
 export type AnnotationLayer = import("../annotation_layer.js").AnnotationLayer;
 export type DrawLayer = import("../draw_layer.js").DrawLayer;
@@ -46,14 +46,14 @@ export type RenderEditorLayerOptions = {
  */
 export class AnnotationEditorLayer {
     static _initialized: boolean;
-    static "__#private@#editorTypes": Map<number, typeof FreeTextEditor | typeof HighlightEditor | typeof InkEditor | typeof SignatureEditor | typeof StampEditor>;
+    static #editorTypes: Map<number, typeof FreeTextEditor | typeof HighlightEditor | typeof InkEditor | typeof SignatureEditor | typeof StampEditor>;
     /**
      * @param {AnnotationEditorLayerOptions} options
      */
     constructor({ uiManager, pageIndex, div, structTreeLayer, accessibilityManager, annotationLayer, drawLayer, textLayer, viewport, l10n, }: AnnotationEditorLayerOptions);
     pageIndex: number;
     div: HTMLDivElement;
-    viewport: import("../display_utils.js").PageViewport;
+    viewport: import("../page_viewport.js").PageViewport;
     drawLayer: import("../draw_layer.js").DrawLayer;
     _structTree: import("../../../web/struct_tree_layer_builder.js").StructTreeLayerBuilder;
     get isEmpty(): boolean;

package/dist/types/src/display/editor/color_picker.d.ts

@@ -4,10 +4,11 @@
  * to select a color for the annotation.
  */
 export class BasicColorPicker {
-    static "__#private@#l10nColor": null;
+    static #l10nColor: null;
     constructor(editor: any);
     renderButton(): HTMLInputElement;
     update(value: any): void;
+    updateOpacity(value: any): void;
     destroy(): void;
     hideDropdown(): void;
     #private;
@@ -18,7 +19,7 @@ export class BasicColorPicker {
  * to select a color for the annotation.
  */
 export class ColorPicker {
-    static "__#private@#l10nColor": null;
+    static #l10nColor: null;
     static get _keyboardManager(): any;
     constructor({ editor, uiManager }: {
         editor?: null | undefined;

package/dist/types/src/display/editor/draw.d.ts

@@ -4,9 +4,9 @@
 export class DrawingEditor extends AnnotationEditor {
     static _currentDrawId: number;
     static _currentParent: null;
-    static "__#private@#currentDraw": null;
-    static "__#private@#currentDrawingAC": null;
-    static "__#private@#currentDrawingOptions": null;
+    static #currentDraw: null;
+    static #currentDrawingAC: null;
+    static #currentDrawingOptions: null;
     static _INNER_MARGIN: number;
     static _mergeSVGProperties(p1: any, p2: any): any;
     /**
@@ -27,6 +27,7 @@ export class DrawingEditor extends AnnotationEditor {
         INK_COLOR: number;
         INK_THICKNESS: number;
         INK_OPACITY: number;
+        INK_COLOR_AND_OPACITY: number;
         HIGHLIGHT_COLOR: number;
         HIGHLIGHT_THICKNESS: number;
         HIGHLIGHT_FREE: number;
@@ -73,6 +74,8 @@ export class DrawingEditor extends AnnotationEditor {
     constructor(params: any);
     _colorPicker: null;
     _drawId: null;
+    /** @inheritdoc */
+    onUpdatedOpacity(): void;
     _addOutlines(params: any): void;
     /** @inheritdoc */
     updateParams(type: any, value: any): void;
@@ -83,6 +86,10 @@ export class DrawingEditor extends AnnotationEditor {
      * @param {string} color
      */
     _updateProperty(type: any, name: any, value: any): void;
+    /**
+     * Update color and opacity atomically as one undoable command.
+     */
+    _updateColorAndOpacity(color: any, opacity: any): void;
     /** @inheritdoc */
     _onTranslating(_x: any, _y: any): void;
     /** @inheritdoc */

package/dist/types/src/display/editor/drawers/freedraw.d.ts

@@ -12,9 +12,9 @@ export class FreeDrawOutline extends Outline {
     #private;
 }
 export class FreeDrawOutliner {
-    static "__#private@#MIN_DIST": number;
-    static "__#private@#MIN_DIFF": number;
-    static "__#private@#MIN": number;
+    static #MIN_DIST: number;
+    static #MIN_DIFF: number;
+    static #MIN: number;
     constructor({ x, y }: {
         x: any;
         y: any;

package/dist/types/src/display/editor/drawers/highlight.d.ts

@@ -30,7 +30,6 @@ declare class HighlightOutline extends Outline {
      */
     serialize([blX, blY, trX, trY]: Array<number>, _rotation: number): Array<Array<number>>;
     get box(): any;
-    get classNamesForOutlining(): string[];
     #private;
 }
 import { Outline } from "./outline.js";

package/dist/types/src/display/editor/drawers/outline.d.ts

@@ -5,7 +5,6 @@ export class Outline {
     static _translate(src: any, tx: any, ty: any, dest: any): any;
     static svgRound(x: any): number;
     static _normalizePoint(x: any, y: any, parentWidth: any, parentHeight: any, rotation: any): number[];
-    static _normalizePagePoint(x: any, y: any, rotation: any): any[];
     static createBezierPoints(x1: any, y1: any, x2: any, y2: any, x3: any, y3: any): number[];
     /**
      * @returns {string} The SVG path of the outline.

package/dist/types/src/display/editor/drawers/signaturedraw.d.ts

@@ -2,29 +2,29 @@
  * Basic text editor in order to create a Signature annotation.
  */
 export class SignatureExtractor {
-    static "__#private@#PARAMETERS": {
+    static #PARAMETERS: {
         maxDim: number;
         sigmaSFactor: number;
         sigmaR: number;
         kernelSize: number;
     };
-    static "__#private@#neighborIndexToId"(i0: any, j0: any, i: any, j: any): any;
-    static "__#private@#neighborIdToIndex": Int32Array<ArrayBuffer>;
-    static "__#private@#clockwiseNonZero"(buf: any, width: any, i0: any, j0: any, i: any, j: any, offset: any): number;
-    static "__#private@#counterClockwiseNonZero"(buf: any, width: any, i0: any, j0: any, i: any, j: any, offset: any): number;
-    static "__#private@#findContours"(buf: any, width: any, height: any, threshold: any): {
+    static #neighborIndexToId(i0: any, j0: any, i: any, j: any): any;
+    static #neighborIdToIndex: Int32Array<ArrayBuffer>;
+    static #clockwiseNonZero(buf: any, width: any, i0: any, j0: any, i: any, j: any, offset: any): number;
+    static #counterClockwiseNonZero(buf: any, width: any, i0: any, j0: any, i: any, j: any, offset: any): number;
+    static #findContours(buf: any, width: any, height: any, threshold: any): {
         isHole: boolean;
         points: number[];
         id: number;
         parent: number;
     }[];
-    static "__#private@#douglasPeuckerHelper"(points: any, start: any, end: any, output: any): void;
-    static "__#private@#douglasPeucker"(points: any): any[] | null;
-    static "__#private@#bilateralFilter"(buf: any, width: any, height: any, sigmaS: any, sigmaR: any, kernelSize: any): (Uint32Array<ArrayBuffer> | Uint8Array<any>)[];
-    static "__#private@#getHistogram"(buf: any): Uint32Array<ArrayBuffer>;
-    static "__#private@#toUint8"(buf: any): Uint8ClampedArray<ArrayBuffer>;
-    static "__#private@#guessThreshold"(histogram: any): number;
-    static "__#private@#getGrayPixels"(bitmap: any): any[];
+    static #douglasPeuckerHelper(points: any, start: any, end: any, output: any): void;
+    static #douglasPeucker(points: any): any[] | null;
+    static #bilateralFilter(buf: any, width: any, height: any, sigmaS: any, sigmaR: any, kernelSize: any): (Uint32Array<ArrayBuffer> | Uint8Array<any>)[];
+    static #getHistogram(buf: any): Uint32Array<ArrayBuffer>;
+    static #toUint8(buf: any): Uint8ClampedArray<ArrayBuffer>;
+    static #guessThreshold(histogram: any): number;
+    static #getGrayPixels(bitmap: any): any[];
     static extractContoursFromText(text: any, { fontFamily, fontStyle, fontWeight }: {
         fontFamily: any;
         fontStyle: any;

package/dist/types/src/display/editor/editor.d.ts

@@ -34,6 +34,7 @@ export type AnnotationEditorParameters = {
  */
 export class AnnotationEditor {
     static _l10n: null;
+    static _l10nAlert: null;
     static _l10nResizer: null;
     static _borderLineWidth: number;
     static _colorManager: ColorManager;
@@ -73,7 +74,7 @@ export class AnnotationEditor {
      * @param {AnnotationEditorLayer} parent
      */
     static paste(item: DataTransferItem, parent: AnnotationEditorLayer): void;
-    static "__#private@#rotatePoint"(x: any, y: any, angle: any): any[];
+    static #rotatePoint(x: any, y: any, angle: any): any[];
     static _round(x: any): number;
     /**
      * Deserialize the editor.

package/dist/types/src/display/editor/freetext.d.ts

@@ -16,8 +16,8 @@ export class FreeTextEditor extends AnnotationEditor {
     static updateDefaultParams(type: any, value: any): void;
     /** @inheritdoc */
     static get defaultPropertiesToUpdate(): any[][];
-    static "__#private@#getNodeContent"(node: any): any;
-    static "__#private@#deserializeContent"(content: any): any;
+    static #getNodeContent(node: any): any;
+    static #deserializeContent(content: any): any;
     /** @inheritdoc */
     static deserialize(data: any, parent: any, uiManager: any): Promise<AnnotationEditor | null>;
     constructor(params: any);

package/dist/types/src/display/editor/highlight.d.ts

@@ -19,14 +19,14 @@ export class HighlightEditor extends AnnotationEditor {
     /** @inheritdoc */
     static updateDefaultParams(type: any, value: any): void;
     static get defaultPropertiesToUpdate(): (number | null)[][];
-    static "__#private@#rotateBbox"([x, y, width, height]: [any, any, any, any], angle: any): any[];
+    static #rotateBbox([x, y, width, height]: [any, any, any, any], angle: any): any[];
     static startHighlighting(parent: any, isLTR: any, { target: textLayer, x, y }: {
         target: any;
         x: any;
         y: any;
     }): void;
-    static "__#private@#highlightMove"(parent: any, event: any): void;
-    static "__#private@#endHighlight"(parent: any, event: any): void;
+    static #highlightMove(parent: any, event: any): void;
+    static #endHighlight(parent: any, event: any): void;
     /** @inheritdoc */
     static deserialize(data: any, parent: any, uiManager: any): Promise<AnnotationEditor | null>;
     constructor(params: any);

package/dist/types/src/display/editor/ink.d.ts

@@ -24,6 +24,8 @@ export class InkEditor extends DrawingEditor {
     /** @inheritdoc */
     get toolbarButtons(): (string | null)[][];
     get colorType(): number;
+    get colorAndOpacityType(): number;
+    get opacityType(): number;
     get color(): any;
     get opacity(): any;
     /** @inheritdoc */

package/dist/types/src/display/editor/toolbar.d.ts

@@ -1,6 +1,6 @@
 export class EditorToolbar {
-    static "__#private@#l10nRemove": null;
-    static "__#private@#pointerDown"(e: any): void;
+    static #l10nRemove: null;
+    static #pointerDown(e: any): void;
     constructor(editor: any);
     render(): HTMLDivElement;
     get div(): null;

package/dist/types/src/display/editor/tools.d.ts

@@ -260,11 +260,6 @@ export class AnnotationEditorUIManager {
      * @param {AnnotationEditor} editor
      */
     setSelected(editor: AnnotationEditor): void;
-    /**
-     * Check if the editor is selected.
-     * @param {AnnotationEditor} editor
-     */
-    isSelected(editor: AnnotationEditor): boolean;
     get firstSelectedEditor(): any;
     /**
      * Unselect an editor.
@@ -440,10 +435,10 @@ export class CommandManager {
  * multiple pointers (e.g. two fingers, a pen, a mouse, ...).
  */
 export class CurrentPointers {
-    static "__#private@#pointerId": number;
-    static "__#private@#pointerIds": null;
-    static "__#private@#moveTimestamp": number;
-    static "__#private@#pointerType": null;
+    static #pointerId: number;
+    static #pointerIds: null;
+    static #moveTimestamp: number;
+    static #pointerType: null;
     static initializeAndAddPointerId(pointerId: any): void;
     static setPointer(pointerType: any, pointerId: any): void;
     static setTimeStamp(timeStamp: any): void;
@@ -462,16 +457,39 @@ export class CurrentPointers {
  * non-mac OSes.
  */
 export class KeyboardManager {
+    static ALT: number;
+    static CTRL: number;
+    static META: number;
+    static SHIFT: number;
+    /**
+     * Parse a shortcut string like "ctrl+shift+a" into a `[key, modifiers]`
+     * pair. Modifier names are case-insensitive and may appear in any order;
+     * the key part is matched against `event.key` so `Space` is normalized to
+     * `" "` but other names like `ArrowLeft`, `Enter`, `Backspace`, and
+     * single-letter keys (`a`, `Z`) are preserved.
+     * @param {string} value
+     * @returns {[string|null, number]}
+     */
+    static #parseShortcut(value: string): [string | null, number];
+    /**
+     * Translate `event.code` (a layout-independent physical key identifier) to
+     * the equivalent `event.key` value on a US layout, so a Ctrl+A shortcut
+     * still fires when the user is on a layout where the "A" key produces a
+     * non-Latin character.
+     * @param {string} code
+     * @returns {string|null}
+     */
+    static #codeToKey(code: string): string | null;
     /**
      * Create a new keyboard manager class.
      * @param {Array<Array>} callbacks - an array containing an array of shortcuts
-     * and a callback to call.
-     * A shortcut is a string like `ctrl+c` or `mac+ctrl+c` for mac OS.
+     * and a callback to call. If the array contains no `mac+`-prefixed entry,
+     * every shortcut applies on all platforms. As soon as it contains at least
+     * one `mac+` entry, the `mac+` ones become the macOS-only set and the bare
+     * entries apply only on non-Mac.
      */
     constructor(callbacks: Array<any[]>);
-    buffer: any[];
     callbacks: Map<any, any>;
-    allKeys: Set<any>;
     /**
      * Execute a callback, if any, for a given keyboard event.
      * The self is used as `this` in the callback.
@@ -480,5 +498,4 @@ export class KeyboardManager {
      * @returns
      */
     exec(self: Object, event: KeyboardEvent): void;
-    #private;
 }

package/dist/types/src/display/filter_factory.d.ts

@@ -3,7 +3,32 @@ export class BaseFilterFactory {
     addHCMFilter(fgColor: any, bgColor: any): string;
     addAlphaFilter(map: any): string;
     addLuminosityFilter(map: any): string;
+    addKnockoutFilter(alpha?: number): string;
     addHighlightHCMFilter(filterName: any, fgColor: any, bgColor: any, newFgColor: any, newBgColor: any): string;
+    /**
+     * Create a filter for the selection of text, given colors.
+     *
+     * @param {string} fgColor
+     * @param {string} bgColor
+     * @returns {string}
+     */
+    addSelectionHCMFilter(fgColor: string, bgColor: string): string;
+    /**
+     * Create a filter for the selection of text.
+     *
+     * @returns {string}
+     */
+    addSelectionFilter(): string;
+    /**
+     * @param {Object} [pageColors]
+     * @param {string} [pageColors.background]
+     * @param {string} [pageColors.foreground]
+     * @returns {Record<string, string> | null}
+     */
+    createSelectionStyle(pageColors?: {
+        background?: string | undefined;
+        foreground?: string | undefined;
+    }): Record<string, string> | null;
     destroy(keepHCM?: boolean): void;
 }
 /**
@@ -24,6 +49,7 @@ export class DOMFilterFactory extends BaseFilterFactory {
     addHCMFilter(fgColor: any, bgColor: any): any;
     addAlphaFilter(map: any): any;
     addLuminosityFilter(map: any): any;
+    addKnockoutFilter(alpha?: number): any;
     addHighlightHCMFilter(filterName: any, fgColor: any, bgColor: any, newFgColor: any, newBgColor: any): any;
     #private;
 }

package/dist/types/src/display/node_utils.d.ts

@@ -1,9 +1,9 @@
-export function fetchData(url: any): Promise<Uint8Array<ArrayBuffer>>;
+export function fetchData(url: any): Promise<Uint8Array<any>>;
 export class NodeBinaryDataFactory extends BaseBinaryDataFactory {
     /**
      * @ignore
      */
-    _fetch(url: any, kind: any): Promise<Uint8Array<ArrayBuffer>>;
+    _fetch(url: any, kind: any): Promise<Uint8Array<any>>;
 }
 export class NodeCanvasFactory extends BaseCanvasFactory {
     /**

package/dist/types/src/display/obj_bin_transform_display.d.ts

@@ -38,7 +38,7 @@ export class FontInfo {
 }
 export class FontPathInfo {
     constructor(buffer: any);
-    get path(): Float32Array<any> | Float16Array<any>;
+    get path(): any;
     #private;
 }
 export class PatternInfo {
@@ -46,11 +46,7 @@ export class PatternInfo {
     buffer: any;
     view: DataView<any>;
     data: Uint8Array<any>;
-    getIR(): (string | number | number[] | Uint8Array<any> | Float32Array<any> | {
-        type: number;
-        coords: Int32Array<any>;
-        colors: Int32Array<any>;
-    }[] | null)[] | (string | number | number[] | (string | number)[][] | null)[];
+    getIR(): (string | number | number[] | Float32Array<any> | Uint8Array<any> | null)[] | (string | number | number[] | (string | number)[][] | null)[];
 }
 export class SystemFontInfo {
     constructor(buffer: any);

package/dist/types/src/display/optional_content_config.d.ts

@@ -1,8 +1,13 @@
 export class OptionalContentConfig {
-    constructor(data: any, renderingIntent?: number);
+    static fromSerializable({ data, renderingIntent, groupState }: {
+        data: any;
+        renderingIntent: any;
+        groupState: any;
+    }): OptionalContentConfig;
+    constructor(data: any, renderingIntent?: number, groupState?: null);
+    creator: null;
+    name: null;
     renderingIntent: number;
-    name: any;
-    creator: any;
     isVisible(group: any): any;
     setVisibility(id: any, visible?: boolean, preserveRB?: boolean): void;
     setOCGState({ state, preserveRB }: {
@@ -13,6 +18,11 @@ export class OptionalContentConfig {
     getOrder(): any;
     getGroup(id: any): any;
     getHash(): string;
+    get serializable(): {
+        data: any;
+        renderingIntent: number;
+        groupState: Map<any, any>;
+    };
     [Symbol.iterator](): MapIterator<[any, any]>;
     #private;
 }