@kingtech/react-pdf-viewer 0.0.0-stage → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# @kingtech/react-pdf-viewer
+
+## 1.0.1
+
+### Patch Changes
+
+- Publish from GitHub Actions with provenance. The library's code and API are unchanged.
+
+## 1.0.0
+
+### Major Changes
+
+- f39ecdb: First stable release of `PdfViewer`, an accessible, themeable React PDF viewer built on
+  `pdfjs-dist`. From this release on, the public API (components, hooks, props, `PdfViewerApi`,
+  labels, CSS classes and CSS variables) follows semantic versioning.
+
+  - Loads URLs, `URL` objects, `ArrayBuffer`, `Uint8Array`, `Blob` and `File` sources, with custom
+    `fetch` options, a replaceable fetcher, HTTP error hooks and typed `PdfViewerError`s with retry.
+  - Controlled or uncontrolled page, scale, rotation and fullscreen (`x` / `defaultX` / `onXChange`),
+    plus an imperative `PdfViewerApi` through `ref`.
+  - Cancellable, HiDPI, pixel-capped rendering that respects each page's intrinsic rotation. Memory
+    stays flat in long documents: pages and thumbnails far from view release their canvases and
+    cached page resources.
+  - A single-row responsive toolbar that collapses actions into a "More actions" menu, keyboard
+    shortcuts, WAI-ARIA toolbar and menu semantics, and native, overlay or controlled fullscreen.
+  - Download, and printing through a hidden frame with every page on a sheet of its own size, or
+    `printMode="open-url"` to hand the document to the browser's own viewer.
+  - Opt-in features: continuous layout, thumbnails, text layer, links, search, page-number input,
+    zoom presets and reset, fit modes, Ctrl/⌘ + wheel zoom and a password prompt.
+  - Label overrides with locale-aware number formatting, 50+ CSS variables and dark / auto presets.
+  - Headless building blocks: `usePdfDocument`, `PdfPageCanvas`, `PdfToolbar` and
+    `useControllableState`.
+  - Secure by default: `isEvalSupported: false`, a `pdfjs-dist` peer range that excludes
+    CVE-2024-4367, external links opened with `rel="noopener noreferrer"`, no script injection, and
+    SSR-safe rendering.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kiralygyula92
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,14 @@
+@kingtech/react-pdf-viewer
+Copyright (c) 2026 kiralygyula92. Licensed under the MIT License (see LICENSE).
+
+Third-party material
+--------------------
+
+This package includes SVG icon paths from Material Icons
+(https://github.com/google/material-design-icons), Copyright Google LLC,
+licensed under the Apache License, Version 2.0
+(https://www.apache.org/licenses/LICENSE-2.0).
+
+This package is designed to be used with PDF.js (https://github.com/mozilla/pdf.js),
+Copyright Mozilla Foundation and contributors, licensed under the Apache License,
+Version 2.0. PDF.js (`pdfjs-dist`) is a peer dependency and is not bundled.

package/README.md

@@ -1,3 +1,68 @@
-# Temporary Holding Version
+# @kingtech/react-pdf-viewer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/@kingtech/react-pdf-viewer)](https://www.npmjs.com/package/@kingtech/react-pdf-viewer)
+[![CI](https://github.com/kiralygyula92/react-pdf-viewer/actions/workflows/ci.yml/badge.svg)](https://github.com/kiralygyula92/react-pdf-viewer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+Accessible, themeable PDF viewer for React, built on PDF.js.
+
+A complete viewer with a toolbar for zoom, page navigation, fullscreen, rotation, download and
+print, plus opt-in continuous scrolling, thumbnails, search, selectable text and links. No UI-kit
+dependency, SSR-safe and fully typed.
+
+- **Accessible:** WAI-ARIA toolbar and menu semantics, keyboard shortcuts, live page announcements, checked with axe.
+- **Themeable:** plain CSS in a cascade layer, CSS variables, dark and automatic presets.
+- **Controlled or uncontrolled:** page, zoom, rotation and fullscreen each follow `x` / `defaultX` / `onXChange`.
+- **Production loading:** URLs with custom requests, `File`, `Blob` and bytes, typed errors with retry.
+- **Composable:** replace the toolbar, or build your own viewer with `usePdfDocument` and `PdfPageCanvas`.
+
+**[Documentation, live demos and API reference →](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/)**
+
+## Install
+
+```sh
+npm install @kingtech/react-pdf-viewer pdfjs-dist
+```
+
+Peer dependencies: `react` and `react-dom` 18 or 19, and `pdfjs-dist` 6. See
+[Requirements](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/getting-started/requirements/)
+for the tested versions and browsers.
+
+## Quick start
+
+```tsx
+import { PdfViewer } from '@kingtech/react-pdf-viewer';
+import '@kingtech/react-pdf-viewer/styles.css';
+
+export function Report() {
+  return <PdfViewer source="/files/report.pdf" />;
+}
+```
+
+Out of the box, PDF.js's worker and assets load from a CDN pinned to your installed version. For
+production, self-host them once at startup (Vite shown):
+
+```ts
+import { configurePdfJs } from '@kingtech/react-pdf-viewer';
+import workerSrc from 'pdfjs-dist/build/pdf.worker.min.mjs?url';
+
+configurePdfJs({ workerSrc });
+```
+
+Setup guides: [Vite](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/integrations/vite/),
+[Next.js](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/integrations/nextjs/),
+[webpack](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/integrations/webpack/).
+
+## Documentation
+
+- [Usage](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/getting-started/usage/): the common props and features.
+- [All features](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/all-features/): one page per capability, each with live demos.
+- [Customization](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/customization/): theming, labels, custom views.
+- [API reference](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/api/): every prop, type, CSS variable and shortcut, generated from the source.
+- [Security](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/guides/security/) and [Accessibility](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/guides/accessibility/) guides.
+- [Changelog](https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/discover-more/changelog/).
+
+## License
+
+[MIT](./LICENSE) © kiralygyula92. Third-party attributions (Material Icons paths, PDF.js) are listed in
+[`NOTICE`](./NOTICE).

package/dist/PdfViewer.d.ts

@@ -0,0 +1,23 @@
+import { PdfViewerApi, PdfViewerProps } from './types.js';
+/**
+ * A PDF viewer: one page at a time with a toolbar for zoom, navigation, fullscreen, rotation,
+ * download and print. Default props give a classic single-page layout; every
+ * additional feature (text layer, links, continuous layout, thumbnails, search, …) is opt-in.
+ *
+ * @example
+ * ```tsx
+ * import { PdfViewer } from '@kingtech/react-pdf-viewer';
+ * import '@kingtech/react-pdf-viewer/styles.css';
+ *
+ * <PdfViewer source="/files/document.pdf" fileName="document.pdf" />
+ * ```
+ *
+ * @cssClass rpv-root The root element. Add `rpv-theme-dark`, or `rpv-theme-auto` to follow the operating system, for the dark preset.
+ * @cssAttribute data-status Document status: `idle`, `loading`, `ready` or `error`.
+ * @cssAttribute data-layout The `layout` prop: `single` or `continuous`.
+ * @cssAttribute data-compact Present while the viewport is narrower than `compactBreakpoint`.
+ * @cssAttribute data-fullscreen Present in fullscreen, in any mode.
+ * @cssAttribute data-presentation How fullscreen is presented: `layout` (controlled mode), `native` or `overlay`.
+ * @cssAttribute data-zoomed Present while the scale is above `defaultScale`.
+ */
+export declare const PdfViewer: import('react').ForwardRefExoticComponent<PdfViewerProps & import('react').RefAttributes<PdfViewerApi>>;

package/dist/components/ContinuousPages.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { FitOptions } from '../core/geometry.js';
+import { Rotation } from '../types.js';
+interface ContinuousPagesProps {
+    document: PDFDocumentProxy;
+    numPages: number;
+    /** Current page; the list scrolls to it unless the change came from scrolling. */
+    page: number;
+    /** Reports the most visible page while the user scrolls. */
+    onVisiblePageChange: (page: number) => void;
+    scale: number;
+    rotation: Rotation;
+    fit: FitOptions | undefined;
+    /** The scroll container. */
+    scroller: HTMLElement | null;
+    /** Renders one page at an explicit scale. */
+    renderPage: (page: number, scale: number) => ReactNode;
+}
+declare function ContinuousPagesImpl({ document, numPages, page, onVisiblePageChange, scale, rotation, fit, scroller, renderPage, }: ContinuousPagesProps): import('react').JSX.Element;
+/** Vertically scrolling pages; only the visible pages ±1 are rendered. */
+export declare const ContinuousPages: import('react').MemoExoticComponent<typeof ContinuousPagesImpl>;
+export {};

package/dist/components/ErrorView.d.ts

@@ -0,0 +1,10 @@
+interface ErrorViewProps {
+    message: string;
+    retryLabel: string;
+    onRetry?: (() => void) | undefined;
+    /** `document` fills a 400px area; `page` sits inside the page box. */
+    variant?: 'document' | 'page' | undefined;
+}
+/** Red error alert with an optional Retry button. */
+export declare function ErrorView({ message, retryLabel, onRetry, variant }: ErrorViewProps): import('react').JSX.Element;
+export {};

package/dist/components/LoadingView.d.ts

@@ -0,0 +1,6 @@
+/** Indeterminate circular spinner. */
+export declare function Spinner(): import('react').JSX.Element;
+/** Centered spinner with a status text, shown while the document loads. */
+export declare function LoadingView({ label }: {
+    label: string;
+}): import('react').JSX.Element;

package/dist/components/PageInput.d.ts

@@ -0,0 +1,11 @@
+import { LabelContext } from '../labels.js';
+interface PageInputProps {
+    page: number;
+    numPages: number;
+    label: string;
+    context: LabelContext;
+    onCommit: (page: number) => void;
+}
+/** Editable page number (`Enter` or blur commits, `Esc` reverts) followed by the page count. */
+export declare function PageInput({ page, numPages, label, context, onCommit }: PageInputProps): import('react').JSX.Element;
+export {};

package/dist/components/PasswordPrompt.d.ts

@@ -0,0 +1,10 @@
+import { PdfViewerLabels } from '../labels.js';
+interface PasswordPromptProps {
+    labels: PdfViewerLabels;
+    /** The previous attempt was wrong. */
+    incorrect: boolean;
+    onSubmit: (password: string) => void;
+}
+/** Built-in password form for encrypted documents. */
+export declare function PasswordPrompt({ labels, incorrect, onSubmit }: PasswordPromptProps): import('react').JSX.Element;
+export {};

package/dist/components/PdfPageCanvas.d.ts

@@ -0,0 +1,53 @@
+import { CSSProperties, ReactNode } from 'react';
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { FitOptions } from '../core/geometry.js';
+import { PageHighlight, PageRenderInfo } from '../hooks/usePageRenderer.js';
+import { PdfViewerError, Rotation } from '../types.js';
+/** Props for {@link PdfPageCanvas}. */
+export interface PdfPageCanvasProps {
+    /** A loaded document, e.g. from `usePdfDocument`. */
+    document: PDFDocumentProxy;
+    /** 1-based page number; clamped to the document. */
+    page: number;
+    /** Scale, 1 = 100%. Default `1`. */
+    scale?: number | undefined;
+    /** User rotation, added to the page's intrinsic rotation. Default `0`. */
+    rotation?: Rotation | undefined;
+    /** Box the page must fit into (see {@link FitOptions}). */
+    fit?: FitOptions | undefined;
+    /** Canvas pixel budget. Default `16_777_216`. */
+    maxCanvasPixels?: number | undefined;
+    /** Render a selectable text layer (copy, find, assistive technology). Default `false`. */
+    textLayer?: boolean | undefined;
+    /** Render clickable links. Default `false`. */
+    annotationLayer?: boolean | undefined;
+    /** Highlight search matches (requires `textLayer`). */
+    highlight?: PageHighlight | undefined;
+    /** Called when an internal link targets another page. */
+    onLinkNavigate?: ((page: number) => void) | undefined;
+    /** Called with the selected search match's element (e.g. to scroll it into view). */
+    onHighlight?: ((element: HTMLElement) => void) | undefined;
+    /**
+     * Accessible name, e.g. `Page 1 of 3`. With a name the page is exposed as an image (or, with
+     * a text or annotation layer, as a group containing the text and links); without one it is
+     * decorative.
+     */
+    'aria-label'?: string | undefined;
+    className?: string | undefined;
+    style?: CSSProperties | undefined;
+    /** Replaces the default in-place error view. */
+    renderError?: ((error: PdfViewerError, actions: {
+        retry: () => void;
+    }) => ReactNode) | undefined;
+    /** Called after each completed render. */
+    onRender?: ((info: PageRenderInfo) => void) | undefined;
+    /** Called when rendering fails (cancellations are not failures). */
+    onError?: ((error: PdfViewerError) => void) | undefined;
+}
+declare function PdfPageCanvasImpl({ document, page, scale, rotation, fit, maxCanvasPixels, textLayer, annotationLayer, highlight, onLinkNavigate, onHighlight, 'aria-label': ariaLabel, className, style, renderError, onRender, onError, }: PdfPageCanvasProps): import('react').JSX.Element;
+/**
+ * Renders a single PDF page: cancellable, double-buffered, HiDPI and pixel-capped, with optional
+ * text and annotation layers. The building block for custom viewers (see `usePdfDocument`).
+ */
+export declare const PdfPageCanvas: import('react').MemoExoticComponent<typeof PdfPageCanvasImpl>;
+export {};

package/dist/components/SearchBar.d.ts

@@ -0,0 +1,18 @@
+import { Ref } from 'react';
+import { LabelContext, PdfViewerLabels } from '../labels.js';
+interface SearchBarProps {
+    inputRef: Ref<HTMLInputElement>;
+    query: string;
+    onQueryChange: (query: string) => void;
+    total: number;
+    /** 0-based index of the current match. */
+    current: number;
+    searching: boolean;
+    onNext: () => void;
+    onPrevious: () => void;
+    labels: PdfViewerLabels;
+    context: LabelContext;
+}
+/** Find-in-document field: `Enter` / `Shift+Enter` step through matches, `Esc` clears. */
+export declare function SearchBar({ inputRef, query, onQueryChange, total, current, searching, onNext, onPrevious, labels, context, }: SearchBarProps): import('react').JSX.Element;
+export {};

package/dist/components/Thumbnails.d.ts

@@ -0,0 +1,16 @@
+import { PDFDocumentProxy } from 'pdfjs-dist';
+import { LabelContext, PdfViewerLabels } from '../labels.js';
+import { Rotation } from '../types.js';
+interface ThumbnailsProps {
+    document: PDFDocumentProxy;
+    numPages: number;
+    page: number;
+    rotation: Rotation;
+    onSelect: (page: number) => void;
+    labels: PdfViewerLabels;
+    context: LabelContext;
+}
+declare function ThumbnailsImpl({ document, numPages, page, rotation, onSelect, labels, context, }: ThumbnailsProps): import('react').JSX.Element;
+/** Page thumbnails sidebar; thumbnails render only while they are near the visible area. */
+export declare const Thumbnails: import('react').MemoExoticComponent<typeof ThumbnailsImpl>;
+export {};

package/dist/components/Toolbar.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+import { PdfViewerLabels } from '../labels.js';
+import { PdfViewerApi, ToolbarConfig } from '../types.js';
+/** Props for {@link PdfToolbar}. */
+export interface PdfToolbarProps {
+    /** The viewer API (from a `ref` or `renderToolbar`). */
+    api: PdfViewerApi;
+    /** Label overrides. */
+    labels?: Partial<PdfViewerLabels> | undefined;
+    /** Which actions to show and where. */
+    config?: ToolbarConfig | undefined;
+    /** Compact layout (narrow viewport): hides `hiddenWhenCompact` actions outside fullscreen. */
+    compact?: boolean | undefined;
+    /** Locale for number formatting. */
+    locale?: string | undefined;
+    /** The zoom label becomes a button that resets zoom. Default `false`. */
+    zoomReset?: boolean | undefined;
+    /** Replaces the page indicator text (e.g. with a page-number input). */
+    pageIndicator?: ReactNode;
+    /** Where the "More actions" menu opens: `'top'` (above; default) or `'bottom'`. */
+    menuPlacement?: 'top' | 'bottom' | undefined;
+}
+declare function PdfToolbarImpl({ api, labels: labelOverrides, config, compact, locale, zoomReset, pageIndicator, menuPlacement, }: PdfToolbarProps): import('react').JSX.Element;
+/**
+ * The default toolbar: zoom, page navigation, fullscreen, rotate, download and print, on one
+ * row. When the row does not fit, secondary actions collapse into a "More actions" menu. Usable
+ * on its own, e.g. inside `renderToolbar`.
+ */
+export declare const PdfToolbar: import('react').MemoExoticComponent<typeof PdfToolbarImpl>;
+export {};

package/dist/components/ToolbarButton.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+import { ToolbarAction } from '../types.js';
+interface ToolbarButtonProps {
+    action: ToolbarAction;
+    label: string;
+    icon: ReactNode;
+    onClick: () => void;
+    disabled?: boolean | undefined;
+    tabIndex: number;
+    onFocus: (action: ToolbarAction) => void;
+}
+declare function ToolbarButtonImpl({ action, label, icon, onClick, disabled, tabIndex, onFocus, }: ToolbarButtonProps): import('react').JSX.Element;
+/** Round icon button used by the toolbar. */
+export declare const ToolbarButton: import('react').MemoExoticComponent<typeof ToolbarButtonImpl>;
+export {};

package/dist/components/ToolbarMenu.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+/** An entry of the toolbar's overflow menu. */
+export interface ToolbarMenuItem {
+    key: string;
+    label: string;
+    icon: ReactNode;
+    onSelect: () => void;
+    disabled?: boolean | undefined;
+}
+interface ToolbarMenuProps {
+    /** Accessible name of the button and the menu. */
+    label: string;
+    items: readonly ToolbarMenuItem[];
+    /** Opens above the toolbar (`'top'`, toolbar at the bottom) or below it. */
+    placement: 'top' | 'bottom';
+    tabIndex: number;
+    onFocus: () => void;
+}
+/**
+ * The "More actions" button and its menu (WAI-ARIA menu button pattern): arrow keys, Home and
+ * End move between items, `Esc` closes and returns focus to the button, `Tab` or a click outside
+ * closes it.
+ */
+export declare function ToolbarMenu({ label, items, placement, tabIndex, onFocus }: ToolbarMenuProps): import('react').JSX.Element;
+export {};

package/dist/components/icons.d.ts

@@ -0,0 +1,60 @@
+export declare const ZoomOutIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const ZoomInIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const NavigateBeforeIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const NavigateNextIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const FullscreenIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const FullscreenExitIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const RotateRightIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const DownloadIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const PrintIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const ErrorOutlineIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const SearchIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const ExpandLessIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const ExpandMoreIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const MoreVertIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};
+export declare const RestartIcon: {
+    (): import('react').JSX.Element;
+    displayName: string;
+};

package/dist/core/download.d.ts

@@ -0,0 +1,4 @@
+/** Wraps PDF bytes in a Blob (copying, so a shared or transferred buffer is never exposed). */
+export declare function toPdfBlob(data: Uint8Array): Blob;
+/** Saves bytes as a file through a temporary object URL and a hidden `<a download>`. */
+export declare function saveBytes(data: Uint8Array, fileName: string): void;

package/dist/core/env.d.ts

@@ -0,0 +1,2 @@
+/** True unless the consumer's bundler marks the build as production. */
+export declare function isDevelopment(): boolean;

package/dist/core/errors.d.ts

@@ -0,0 +1,19 @@
+import { PdfViewerError, PdfViewerErrorCode } from '../types.js';
+interface ErrorDetails {
+    status?: number | undefined;
+    cause?: unknown;
+}
+/** Creates a {@link PdfViewerError}. `message` defaults to a generic text for the code. */
+export declare function createPdfViewerError(code: PdfViewerErrorCode, message?: string, details?: ErrorDetails): PdfViewerError;
+/** Type guard for errors created by the viewer. */
+export declare function isPdfViewerError(value: unknown): value is PdfViewerError;
+/** True for fetch aborts and PDF.js loading-task aborts. */
+export declare function isAbortError(error: unknown): boolean;
+/** True for PDF.js render cancellations, which are a normal outcome. */
+export declare function isRenderCancelled(error: unknown): boolean;
+/**
+ * Maps anything thrown by the loading or rendering pipeline to a {@link PdfViewerError}.
+ * PDF.js exceptions are recognized by `name`, so this works with any `pdfjs-dist` build.
+ */
+export declare function toPdfViewerError(error: unknown, fallback: PdfViewerErrorCode): PdfViewerError;
+export {};

package/dist/core/fileName.d.ts

@@ -0,0 +1,10 @@
+import { PdfSource } from '../types.js';
+/** Name used when nothing better is known. */
+export declare const DEFAULT_FILE_NAME = "document.pdf";
+/** Last path segment of `url` when it ends in `.pdf`, otherwise `null`. */
+export declare function fileNameFromUrl(url: string): string | null;
+/**
+ * Download file name: the explicit `fileName`, then a `File`'s name, then the URL's last
+ * `.pdf` segment, then {@link DEFAULT_FILE_NAME}.
+ */
+export declare function resolveFileName(fileName: string | undefined, source: PdfSource | null | undefined): string;

package/dist/core/geometry.d.ts

@@ -0,0 +1,25 @@
+import { Rotation } from '../types.js';
+/** Default canvas pixel budget: 4096², the iOS Safari limit. */
+export declare const DEFAULT_MAX_CANVAS_PIXELS = 16777216;
+/** Clamps a 1-based page number to `[1, numPages]`. */
+export declare function clampPage(page: number, numPages: number): number;
+/** Snaps any angle to the nearest quarter turn in `[0, 360)`. */
+export declare function normalizeRotation(degrees: number): Rotation;
+/** Page rotation actually rendered: the page's intrinsic `/Rotate` plus the user rotation. */
+export declare function effectiveRotation(intrinsic: number, user: number): Rotation;
+/**
+ * Canvas backing-store multiplier: the device pixel ratio, reduced when the canvas would exceed
+ * `maxCanvasPixels` or the largest side browsers accept. Resolution degrades; CSS size does not.
+ */
+export declare function getOutputScale(cssWidth: number, cssHeight: number, devicePixelRatio: number, maxCanvasPixels: number): number;
+/** Constrains the rendered page to a box. */
+export interface FitOptions {
+    /** Available width in CSS pixels, including the page's border and padding. */
+    width?: number | undefined;
+    /** Available height in CSS pixels, including the page's border and padding. */
+    height?: number | undefined;
+    /** When `true` the page is scaled to fill the box; otherwise it only ever shrinks. */
+    upscale?: boolean | undefined;
+}
+/** Scale that satisfies `fit` for a page whose size at scale 1 is `baseWidth × baseHeight`. */
+export declare function fitScale(requested: number, baseWidth: number, baseHeight: number, fit: FitOptions | undefined): number;

package/dist/core/linkService.d.ts

@@ -0,0 +1,29 @@
+import { PDFDocumentProxy } from 'pdfjs-dist';
+/** Navigation callbacks the link service needs from the viewer. */
+export interface LinkNavigation {
+    /** Go to a 1-based page. */
+    goToPage: (page: number) => void;
+    /** Current 1-based page (for named actions such as NextPage). */
+    getPage: () => number;
+}
+/**
+ * The subset of PDF.js's `PDFLinkService` that `AnnotationLayer` uses for links. External links
+ * open in a new tab with `rel="noopener noreferrer"`; internal links navigate the viewer.
+ * (PDF.js only passes URLs with safe protocols through to `addLinkAttributes`.)
+ */
+export declare function createLinkService(pdf: PDFDocumentProxy, navigation: LinkNavigation): {
+    externalLinkEnabled: boolean;
+    isInPresentationMode: boolean;
+    eventBus: {
+        on: () => undefined;
+        off: () => undefined;
+        dispatch: () => undefined;
+    };
+    addLinkAttributes(link: HTMLAnchorElement, url: string): void;
+    getDestinationHash: () => string;
+    getAnchorUrl: () => string;
+    goToDestination(destination: unknown): void;
+    goToPage(page: number): void;
+    executeNamedAction(action: string): void;
+    executeSetOCGState: () => undefined;
+};

package/dist/core/loadSource.d.ts

@@ -0,0 +1,22 @@
+import { PdfRequestOptions, PdfSource } from '../types.js';
+/** Result of reading a source: PDF bytes, or an HTTP error the host handled itself. */
+export type LoadedSource = {
+    readonly kind: 'bytes';
+    readonly data: Uint8Array;
+} | {
+    readonly kind: 'handled';
+};
+/** `null`, `undefined` and `''` mean "no document". */
+export declare function isEmptySource(source: PdfSource | null | undefined): source is null | undefined;
+/**
+ * The default message logic: RFC 7807 `detail`, then `title`, then a JSON string body,
+ * then `Failed to fetch PDF: {status} {statusText}`.
+ */
+export declare function defaultHttpErrorMessage(response: Response): Promise<string>;
+/**
+ * Turns any {@link PdfSource} into bytes for PDF.js.
+ *
+ * Binary sources are copied because PDF.js transfers (detaches) the buffer it receives; without
+ * the copy a consumer's `ArrayBuffer` would become unusable after the first load.
+ */
+export declare function loadSource(source: PdfSource, signal: AbortSignal, options?: PdfRequestOptions): Promise<LoadedSource>;