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

package/dist/styles.css

@@ -0,0 +1,2 @@
+@layer rpv{.rpv-root{--_rpv-viewport-max-width:var(--rpv-viewport-max-width,650px);--_rpv-viewport-min-height:var(--rpv-viewport-min-height,712px);--_rpv-viewport-max-height:var(--rpv-viewport-max-height,800px);--_rpv-viewport-padding:var(--rpv-viewport-padding,0px);--_rpv-toolbar-max-width:var(--rpv-toolbar-max-width,482px);box-sizing:border-box;width:100%;max-width:100%;height:auto;font-family:var(--rpv-font-family,inherit);background:0 0;border:none;border-radius:8px;outline:none;flex-direction:column;align-items:center;display:flex;position:relative}.rpv-root *,.rpv-root :before,.rpv-root :after{box-sizing:border-box}.rpv-root[data-compact]{--_rpv-viewport-max-width:100%;--_rpv-viewport-min-height:var(--rpv-viewport-min-height-compact,400px);--_rpv-viewport-max-height:100%;--_rpv-viewport-padding:var(--rpv-viewport-padding-compact,16px)}.rpv-root[data-fullscreen]{--_rpv-viewport-min-height:0px;--_rpv-viewport-max-width:100%;--_rpv-viewport-max-height:100%;--_rpv-viewport-padding:var(--rpv-viewport-padding-fullscreen,32px);--_rpv-toolbar-max-width:100%;height:100vh;height:100dvh}.rpv-root[data-presentation=native],.rpv-root[data-presentation=overlay]{background:var(--rpv-fullscreen-bg,#fff);border-radius:0;height:100%}.rpv-root[data-presentation=overlay]{z-index:var(--rpv-overlay-z-index,1300);position:fixed;inset:0}.rpv-viewport{width:100%;max-width:var(--_rpv-viewport-max-width);min-height:var(--_rpv-viewport-min-height);max-height:var(--_rpv-viewport-max-height);padding:var(--_rpv-viewport-padding);margin-bottom:var(--rpv-viewport-margin-bottom,64px);overscroll-behavior:contain;background:0 0;flex:auto;align-items:flex-start;display:flex;position:relative;overflow:auto}.rpv-viewport:focus-visible{outline:2px solid var(--rpv-accent,#1976d2);outline-offset:2px}.rpv-root[data-toolbar-position=top] .rpv-viewport{margin-bottom:0}.rpv-page{box-sizing:content-box;background:var(--rpv-page-bg,#fff);border:var(--rpv-page-border,1px solid #ddd);border-radius:var(--rpv-page-radius,4px);box-shadow:var(--rpv-page-shadow,0 2px 8px #0000001a);flex:none;margin-inline:auto;position:relative;overflow:hidden}.rpv-page__canvas-host,.rpv-page__canvas{width:100%;height:100%;display:block}.rpv-page[data-state=error]{min-width:min(100%,320px);min-height:240px}.rpv-page[data-state=error] .rpv-page__canvas-host{display:none}.rpv-toolbar-wrapper{max-width:var(--_rpv-toolbar-max-width);justify-content:center;display:flex}.rpv-toolbar{min-height:var(--rpv-toolbar-min-height,48px);padding:0 var(--rpv-toolbar-padding-x,16px);margin-bottom:var(--rpv-toolbar-margin-bottom,40px);font-size:var(--rpv-label-font-size,14px);font-weight:var(--rpv-label-font-weight,600);color:var(--rpv-toolbar-fg,#fff);background:var(--rpv-toolbar-bg,#54646e);border-radius:var(--rpv-toolbar-radius,8px);flex-wrap:nowrap;flex:none;justify-content:space-between;align-items:center;column-gap:0;line-height:1.43;display:flex;position:relative}.rpv-toolbar[data-extended]{column-gap:var(--rpv-toolbar-group-gap,16px)}.rpv-root[data-toolbar-position=top] .rpv-toolbar{margin-bottom:16px}.rpv-toolbar__group{align-items:center;gap:var(--rpv-toolbar-gap,8px);flex:none;display:flex}.rpv-menu-anchor{display:inline-flex;position:relative}.rpv-menu{z-index:10;min-width:208px;color:var(--rpv-menu-fg,#1f2a30);background:var(--rpv-menu-bg,#fff);border:1px solid var(--rpv-menu-border,#00000014);box-shadow:var(--rpv-menu-shadow,0 10px 28px #0f172a2e, 0 2px 6px #0f172a1f);transform-origin:100% 100%;border-radius:10px;flex-direction:column;gap:2px;margin:0;padding:6px;font-size:14px;font-weight:500;line-height:1.4;animation:.12s ease-out rpv-menu-in;display:flex;position:absolute;bottom:calc(100% + 14px);right:-8px}.rpv-menu[data-placement=bottom]{transform-origin:100% 0;top:calc(100% + 14px);bottom:auto}@keyframes rpv-menu-in{0%{opacity:0;transform:translateY(4px)scale(.98)}}@media (prefers-reduced-motion:reduce){.rpv-menu{animation:none}}.rpv-menu__item{width:100%;min-height:40px;font:inherit;color:inherit;text-align:left;white-space:nowrap;cursor:pointer;background:0 0;border:0;border-radius:6px;align-items:center;gap:12px;margin:0;padding:0 12px;display:flex}.rpv-menu__item:hover:not([aria-disabled=true]),.rpv-menu__item:focus-visible{background:var(--rpv-menu-hover-bg,#54646e1f);outline:none}.rpv-menu__item:focus-visible{box-shadow:inset 0 0 0 2px var(--rpv-accent,#1976d2)}.rpv-menu__item[aria-disabled=true]{cursor:default;opacity:.45}.rpv-menu__icon{color:var(--rpv-menu-icon-fg,#54646e);flex:none;display:flex}.rpv-menu__icon .rpv-icon{width:20px;height:20px}.rpv-root.rpv-theme-dark .rpv-menu{--rpv-menu-bg:#2b363c;--rpv-menu-fg:#eceff1;--rpv-menu-icon-fg:#b0bec5;--rpv-menu-border:#ffffff14;--rpv-menu-hover-bg:#ffffff14}@media (prefers-color-scheme:dark){.rpv-root.rpv-theme-auto .rpv-menu{--rpv-menu-bg:#2b363c;--rpv-menu-fg:#eceff1;--rpv-menu-icon-fg:#b0bec5;--rpv-menu-border:#ffffff14;--rpv-menu-hover-bg:#ffffff14}}.rpv-toolbar__label{min-width:40px;font-size:var(--rpv-label-font-size,14px);font-weight:var(--rpv-label-font-weight,600);letter-spacing:.01071em;text-align:center;white-space:nowrap;margin:0;line-height:1.43}.rpv-toolbar__pages{min-width:80px}.rpv-root[data-compact] .rpv-toolbar__pages{min-width:40px}.rpv-button{width:var(--rpv-button-size,34px);height:var(--rpv-button-size,34px);font:inherit;color:inherit;cursor:pointer;-webkit-tap-highlight-color:transparent;background:0 0;border:0;border-radius:50%;flex:none;justify-content:center;align-items:center;margin:0;padding:0;transition:background-color .15s cubic-bezier(.4,0,.2,1);display:inline-flex}.rpv-button:hover:not(:disabled){background:var(--rpv-button-hover-bg,#ffffff1a)}@media (hover:none){.rpv-button:hover:not(:disabled){background:0 0}}.rpv-button:focus-visible{outline:var(--rpv-focus-ring,2px solid #fff);outline-offset:var(--rpv-focus-ring-offset,2px)}.rpv-button:disabled{color:var(--rpv-button-disabled-fg,#ffffff4d);cursor:default}.rpv-icon{width:var(--rpv-icon-size,24px);height:var(--rpv-icon-size,24px);fill:currentColor;flex:none}.rpv-loading{z-index:1;flex-direction:column;align-items:center;gap:16px;display:flex;position:absolute;top:50%;left:50%;transform:translate(-50%,-50%)}.rpv-loading__text,.rpv-print-status__text{letter-spacing:.00938em;color:var(--rpv-muted-fg,#0009);margin:0;font-size:1rem;line-height:1.5}.rpv-spinner{width:40px;height:40px;color:var(--rpv-accent,#1976d2);animation:1.4s linear infinite rpv-spin;display:inline-block}.rpv-spinner svg{display:block}.rpv-spinner circle{stroke:currentColor;stroke-dasharray:80 200;stroke-dashoffset:0;animation:1.4s ease-in-out infinite rpv-dash}@keyframes rpv-spin{to{transform:rotate(360deg)}}@keyframes rpv-dash{0%{stroke-dasharray:1 200;stroke-dashoffset:0}50%{stroke-dasharray:100 200;stroke-dashoffset:-15px}to{stroke-dasharray:100 200;stroke-dashoffset:-125px}}@media (prefers-reduced-motion:reduce){.rpv-spinner,.rpv-spinner circle{animation-duration:4s}}.rpv-error-area{width:100%;max-width:var(--_rpv-viewport-max-width)}.rpv-error{flex-direction:column;justify-content:center;align-items:center;width:100%;height:400px;padding:32px;display:flex}.rpv-error--page{height:100%;min-height:240px;padding:16px}.rpv-alert{letter-spacing:.01071em;max-width:100%;color:var(--rpv-error-fg,#5f2120);background:var(--rpv-error-bg,#fdeded);border-radius:4px;margin-bottom:16px;padding:6px 16px;font-size:.875rem;font-weight:400;line-height:1.43;display:flex}.rpv-alert__icon{color:var(--rpv-error-icon,#d32f2f);margin-right:12px;padding:7px 0;display:flex}.rpv-alert__icon .rpv-icon{width:22px;height:22px}.rpv-alert__message{overflow-wrap:anywhere;min-width:0;padding:8px 0}.rpv-text-button{min-width:64px;font:inherit;letter-spacing:.02857em;text-transform:uppercase;color:var(--rpv-text-button-fg,#1565c0);cursor:pointer;background:0 0;border:1px solid;border-radius:4px;padding:6px 16px;font-size:.875rem;font-weight:500;line-height:1.75}.rpv-text-button:hover{background:color-mix(in srgb, currentColor 8%, transparent)}.rpv-text-button:focus-visible{outline:2px solid var(--rpv-accent,#1976d2);outline-offset:2px}.rpv-print-status{z-index:2;background:#ffffffd9;flex-direction:column;justify-content:center;align-items:center;gap:16px;animation:.15s ease-out .4s both rpv-fade-in;display:flex;position:absolute;inset:0}@keyframes rpv-fade-in{0%{opacity:0}to{opacity:1}}.rpv-root.rpv-theme-dark{--rpv-toolbar-bg:#263238;--rpv-toolbar-fg:#eceff1;--rpv-focus-ring:2px solid #90caf9;--rpv-page-border:1px solid #37474f;--rpv-page-shadow:0 2px 12px #0009;--rpv-accent:#90caf9;--rpv-text-button-fg:#90caf9;--rpv-muted-fg:#ffffffb3;--rpv-error-bg:#160b0b;--rpv-error-fg:#f4c7c7;--rpv-error-icon:#f44336;--rpv-fullscreen-bg:#121212;--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark}.rpv-root.rpv-theme-dark .rpv-print-status{background:#121212d9}@media (prefers-color-scheme:dark){.rpv-root.rpv-theme-auto{--rpv-toolbar-bg:#263238;--rpv-toolbar-fg:#eceff1;--rpv-focus-ring:2px solid #90caf9;--rpv-page-border:1px solid #37474f;--rpv-page-shadow:0 2px 12px #0009;--rpv-accent:#90caf9;--rpv-text-button-fg:#90caf9;--rpv-muted-fg:#ffffffb3;--rpv-error-bg:#160b0b;--rpv-error-fg:#f4c7c7;--rpv-error-icon:#f44336;--rpv-fullscreen-bg:#121212;--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark}}.rpv-sr-only{clip:rect(0, 0, 0, 0);white-space:nowrap;border:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.rpv-page{--scale-round-x:1px;--scale-round-y:1px}.rpv-page__layers{position:absolute;inset:0}.rpv-page [data-main-rotation="90"]{transform:rotate(90deg)translateY(-100%)}.rpv-page [data-main-rotation="180"]{transform:rotate(180deg)translate(-100%,-100%)}.rpv-page [data-main-rotation="270"]{transform:rotate(270deg)translate(-100%)}.rpv-page .textLayer{--min-font-size:1;--text-scale-factor:calc(var(--total-scale-factor) * var(--min-font-size));--min-font-size-inv:calc(1 / var(--min-font-size));z-index:0;text-align:initial;letter-spacing:normal;word-spacing:normal;-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;forced-color-adjust:none;caret-color:canvastext;opacity:1;transform-origin:0 0;line-height:1;position:absolute;inset:0;overflow:clip}.rpv-page .textLayer :is(span,br){color:#0000;white-space:pre;cursor:text;transform-origin:0 0;-webkit-user-select:text;user-select:text;position:absolute}.rpv-page .textLayer>:not(.markedContent),.rpv-page .textLayer .markedContent span:not(.markedContent){--font-height:0;--scale-x:1;--rotate:0deg;z-index:1;font-size:calc(var(--text-scale-factor) * var(--font-height));transform:rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv))}.rpv-page .textLayer .markedContent{display:contents}.rpv-page .textLayer span[role=img]{cursor:default;-webkit-user-select:none;user-select:none}.rpv-page .textLayer ::selection{background:var(--rpv-selection-bg,#0000ff40)}.rpv-page .textLayer br::selection{background:0 0}.rpv-page .textLayer .endOfContent{z-index:0;cursor:default;-webkit-user-select:none;user-select:none;display:block;position:absolute;inset:100% 0 0}.rpv-page .textLayer.selecting .endOfContent{top:0}.rpv-page .textLayer .highlight{background-color:var(--rpv-search-highlight,#ffd50080);border-radius:3px;margin:-1px;padding:1px}.rpv-page .textLayer .highlight.appended{position:initial}.rpv-page .textLayer .highlight.selected{background-color:var(--rpv-search-highlight-selected,#ff6f0099)}.rpv-page .annotationLayer{z-index:1;pointer-events:none;transform-origin:0 0;position:absolute;top:0;left:0}.rpv-page .annotationLayer section{box-sizing:border-box;text-align:initial;pointer-events:auto;transform-origin:0 0;position:absolute}.rpv-page .annotationLayer .linkAnnotation>a{width:100%;height:100%;font-size:1em;position:absolute;top:0;left:0}.rpv-page .annotationLayer .linkAnnotation>a:hover{background:#ff03;box-shadow:0 2px 10px #ff09}.rpv-page .annotationLayer .linkAnnotation>a:focus-visible{outline:2px solid var(--rpv-accent,#1976d2);outline-offset:1px}.rpv-pages{gap:var(--rpv-page-gap,16px);flex-direction:column;flex:none;align-items:center;margin-inline:auto;display:flex}.rpv-page-slot{flex:none;position:relative}.rpv-page-slot>.rpv-page{margin:0}.rpv-body{flex:auto;justify-content:center;gap:12px;width:100%;min-height:0;display:flex}.rpv-body>.rpv-viewport,.rpv-body>.rpv-error-area{flex:auto}.rpv-thumbnails{width:var(--rpv-thumbnails-width,148px);max-height:var(--_rpv-viewport-max-height);margin-bottom:var(--rpv-viewport-margin-bottom,64px);overscroll-behavior:contain;flex:none;padding:4px;overflow-y:auto}.rpv-root:not([data-fullscreen]) .rpv-thumbnails{max-height:var(--_rpv-viewport-min-height)}.rpv-thumbnails__list{flex-direction:column;gap:10px;margin:0;padding:0;list-style:none;display:flex}.rpv-thumbnail{width:100%;font:inherit;color:inherit;cursor:pointer;background:0 0;border:2px solid #0000;border-radius:6px;flex-direction:column;align-items:center;gap:4px;padding:6px;display:flex}.rpv-thumbnail:hover{background:#0000000d}.rpv-thumbnail[aria-current=page]{border-color:var(--rpv-accent,#1976d2)}.rpv-thumbnail:focus-visible{outline:2px solid var(--rpv-accent,#1976d2);outline-offset:2px}.rpv-thumbnail .rpv-page{box-shadow:none;margin:0}.rpv-thumbnail__placeholder{background:var(--rpv-page-bg,#fff);border:var(--rpv-page-border,1px solid #ddd);width:112px;height:145px;display:block}.rpv-thumbnail__number{color:var(--rpv-muted-fg,#0009);font-size:12px}.rpv-search{width:100%;max-width:var(--_rpv-viewport-max-width);color:var(--rpv-search-fg,#37474f);background:var(--rpv-search-bg,#fff);border:var(--rpv-page-border,1px solid #ddd);border-radius:8px;align-items:center;gap:4px;margin-bottom:12px;padding:4px 8px;display:flex}.rpv-search__icon{color:var(--rpv-muted-fg,#0009);display:flex}.rpv-search__input{min-width:0;height:32px;font:inherit;color:inherit;background:0 0;border:0;outline:none;flex:1;padding:0 6px}.rpv-search:focus-within{outline:2px solid var(--rpv-accent,#1976d2);outline-offset:-1px}.rpv-search__status{min-width:5em;color:var(--rpv-muted-fg,#0009);text-align:right;white-space:nowrap;font-size:14px}.rpv-search .rpv-button:hover:not(:disabled){background:#0000000f}.rpv-search .rpv-button:disabled{color:#0000004d}.rpv-search .rpv-button:focus-visible{outline:2px solid var(--rpv-accent,#1976d2)}.rpv-toolbar__pages--input{white-space:nowrap;justify-content:center;align-items:center;gap:8px;display:inline-flex}.rpv-toolbar .rpv-page-input{transition:background-color .15s,border-color .15s;box-sizing:border-box!important;width:calc(var(--rpv-page-input-chars,2) * 1ch + 22px)!important;min-width:0!important;max-width:none!important;height:28px!important;min-height:0!important;font:inherit!important;font-variant-numeric:tabular-nums!important;color:var(--rpv-toolbar-fg,#fff)!important;text-align:center!important;appearance:none!important;background:var(--rpv-page-input-bg,#00000038)!important;border:1px solid var(--rpv-page-input-border,#ffffff59)!important;box-shadow:none!important;border-radius:6px!important;margin:0!important;padding:0 6px!important}.rpv-toolbar .rpv-page-input:hover:not(:disabled){border-color:#ffffffb3!important}.rpv-toolbar .rpv-page-input:focus-visible{outline-offset:1px;outline:2px solid #ffffff59;border-color:var(--rpv-toolbar-fg,#fff)!important;background:#00000052!important}.rpv-toolbar .rpv-page-input::selection{color:inherit;background:#ffffff59}.rpv-toolbar .rpv-page-input:disabled{opacity:.5}.rpv-zoom-reset{min-width:48px;height:28px;font:inherit;color:inherit;text-align:center;cursor:pointer;background:0 0;border:1px solid #0000;border-radius:6px;margin:0;padding:0 8px;transition:background-color .15s,border-color .15s}.rpv-zoom-reset:hover{background:var(--rpv-button-hover-bg,#ffffff1a);border-color:#ffffff40}.rpv-zoom-reset:focus-visible{outline:var(--rpv-focus-ring,2px solid #fff);outline-offset:var(--rpv-focus-ring-offset,2px)}.rpv-password-area{justify-content:center;align-items:center;min-height:400px;padding:32px;display:flex}.rpv-password{color:#1b2430;background:var(--rpv-page-bg,#fff);border:var(--rpv-page-border,1px solid #ddd);width:min(100%,340px);box-shadow:var(--rpv-page-shadow,0 2px 8px #0000001a);border-radius:8px;flex-direction:column;gap:10px;margin:auto;padding:24px;display:flex}.rpv-password__title{margin:0;font-weight:600}.rpv-password__error{color:var(--rpv-error-fg,#5f2120);margin:0}.rpv-password label{font-size:14px}.rpv-password input{height:36px;font:inherit;border:1px solid #8a94a3;border-radius:6px;padding:0 10px}.rpv-password input:focus-visible{outline:2px solid var(--rpv-accent,#1976d2);outline-offset:1px}.rpv-root.rpv-theme-dark .rpv-search{--rpv-search-fg:#eceff1;--rpv-search-bg:#1e272c}.rpv-root.rpv-theme-dark .rpv-search .rpv-button:disabled{color:#ffffff4d}.rpv-root.rpv-theme-dark .rpv-password{color:#eceff1;background:var(--rpv-page-bg,#1e272c)}@media (prefers-color-scheme:dark){.rpv-root.rpv-theme-auto .rpv-search{--rpv-search-fg:#eceff1;--rpv-search-bg:#1e272c}.rpv-root.rpv-theme-auto .rpv-search .rpv-button:disabled{color:#ffffff4d}.rpv-root.rpv-theme-auto .rpv-password{color:#eceff1;background:var(--rpv-page-bg,#1e272c)}}}
+/*$vite$:1*/

package/dist/types.d.ts

@@ -0,0 +1,324 @@
+import { getDocument, PDFDocumentProxy } from 'pdfjs-dist';
+import { CSSProperties, ReactNode } from 'react';
+import { PageRenderInfo } from './hooks/usePageRenderer.js';
+import { PdfViewerLabels } from './labels.js';
+/**
+ * A PDF document source.
+ *
+ * - `string` / `URL`: fetched by the viewer (see {@link PdfRequestOptions}).
+ * - `ArrayBuffer` / `Uint8Array` / `Blob` (including `File`): read directly, nothing is uploaded.
+ *
+ * Strings compare by value; every other source compares by identity, so keep binary sources
+ * referentially stable (e.g. in state) to avoid reloading on every render.
+ */
+export type PdfSource = string | URL | ArrayBuffer | Uint8Array | Blob;
+/** Clockwise rotation in degrees, relative to the page's natural orientation. */
+export type Rotation = 
+/** Upright (the page's natural orientation). */
+0
+/** A quarter turn clockwise. */
+ | 90
+/** Upside down. */
+ | 180
+/** A quarter turn counter-clockwise. */
+ | 270;
+/**
+ * How fullscreen is presented.
+ *
+ * - `'controlled'`: layout-only; the parent decides how to present fullscreen.
+ * - `'native'`: the browser Fullscreen API on the viewer root, falling back to `'overlay'`.
+ * - `'overlay'`: a fixed, full-viewport layer with a focus trap; `Esc` closes it.
+ */
+export type FullscreenMode = 
+/** Layout only: the parent decides how to present fullscreen. */
+'controlled'
+/** The browser Fullscreen API on the viewer root, falling back to `'overlay'`. */
+ | 'native'
+/** A fixed, full-viewport layer with a focus trap and scroll lock; `Esc` closes it. */
+ | 'overlay';
+/** Identifies a toolbar control. */
+export type ToolbarAction = 'zoomOut' | 'zoomLevel' | 'zoomIn' | 'previousPage' | 'pageIndicator' | 'nextPage' | 'fullscreen' | 'rotate' | 'download' | 'print';
+/** Lifecycle status of a document load. */
+export type PdfDocumentStatus = 
+/** No source, or an HTTP error that `onHttpError` handled. */
+'idle'
+/** Fetching or parsing the document. */
+ | 'loading'
+/** The document is loaded and pages can render. */
+ | 'ready'
+/** Loading failed; the error is available. */
+ | 'error';
+/** Machine-readable category of a {@link PdfViewerError}. */
+export type PdfViewerErrorCode = 
+/** The `pdfjs-dist` module or its worker failed to load. */
+'PDFJS_LOAD_FAILED'
+/** `fetch` rejected (offline, CORS, DNS, …). */
+ | 'NETWORK_ERROR'
+/** The server answered with a non-2xx status (`status` is set). */
+ | 'HTTP_ERROR'
+/** The bytes are not a valid PDF. */
+ | 'INVALID_PDF'
+/** The document is encrypted and no password was supplied. */
+ | 'PASSWORD_REQUIRED'
+/** The supplied password is wrong. */
+ | 'INCORRECT_PASSWORD'
+/** A page failed to render. */
+ | 'RENDER_FAILED'
+/** Saving the document failed. */
+ | 'DOWNLOAD_FAILED'
+/** Printing failed. */
+ | 'PRINT_FAILED'
+/** Anything else. */
+ | 'UNKNOWN';
+/**
+ * A typed viewer error. Aborted loads and canceled renders are never reported as errors.
+ */
+export interface PdfViewerError {
+    /** Error category. */
+    readonly code: PdfViewerErrorCode;
+    /** Human-readable message. For `HTTP_ERROR` it comes from `getHttpErrorMessage`. */
+    readonly message: string;
+    /** HTTP status, for `HTTP_ERROR`. */
+    readonly status?: number;
+    /** The underlying error, when there is one. */
+    readonly cause?: unknown;
+}
+type DocumentInitParameters = NonNullable<Parameters<typeof getDocument>[0]>;
+/**
+ * Per-instance options forwarded to `pdfjs-dist`'s `getDocument` (for example `cMapUrl`,
+ * `standardFontDataUrl` or `verbosity`). Source-related options are managed by the viewer.
+ */
+export type PdfJsDocumentOptions = Omit<DocumentInitParameters, 'url' | 'data' | 'password' | 'range' | 'worker' | 'httpHeaders' | 'withCredentials'>;
+/** Controls how string and `URL` sources are fetched. */
+export interface PdfRequestOptions {
+    /** Extra `fetch` options (headers, credentials, …) for URL sources. */
+    requestInit?: RequestInit | undefined;
+    /** Replaces `fetch` entirely, e.g. with an authenticated client. */
+    fetcher?: ((url: string, init: RequestInit) => Promise<Response>) | undefined;
+    /**
+     * Called for non-2xx responses. Return `true` when handled (for example after redirecting to a
+     * sign-in page): the viewer then shows its empty state and does not call `onError`.
+     */
+    onHttpError?: ((response: Response) => boolean | void | Promise<boolean | void>) | undefined;
+    /**
+     * Builds the message for an `HTTP_ERROR`. Return `undefined` to use the default, which reads an
+     * RFC 7807 body (`detail`, then `title`), then a JSON string body, then
+     * `Failed to fetch PDF: {status} {statusText}`.
+     */
+    getHttpErrorMessage?: ((response: Response) => Promise<string | undefined>) | undefined;
+}
+/** Toolbar customization. */
+export interface ToolbarConfig {
+    /** Toolbar placement. Default `'bottom'`. */
+    position?: 'bottom' | 'top' | undefined;
+    /**
+     * Actions to show. Their order within each group is fixed.
+     *
+     * @defaultValue all actions
+     */
+    actions?: readonly ToolbarAction[] | undefined;
+    /** Actions hidden in compact, non-fullscreen mode. Default `['rotate', 'print']`. */
+    hiddenWhenCompact?: readonly ToolbarAction[] | undefined;
+}
+/**
+ * Imperative viewer API, available through `ref` and passed to `renderToolbar`. Values are a
+ * snapshot of the render that produced the object.
+ */
+export interface PdfViewerApi {
+    readonly status: PdfDocumentStatus;
+    /** Page count; `0` without a document. */
+    readonly numPages: number;
+    /** Current 1-based page, clamped to the document. */
+    readonly page: number;
+    /** Current scale (1 = 100%). */
+    readonly scale: number;
+    readonly rotation: Rotation;
+    readonly fullscreen: boolean;
+    /** Whether `zoomIn()` would change the scale. */
+    readonly canZoomIn: boolean;
+    /** Whether `zoomOut()` would change the scale. */
+    readonly canZoomOut: boolean;
+    goToPage(page: number): void;
+    nextPage(): void;
+    previousPage(): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    /** Sets the scale, clamped to `[minScale, maxScale]`. */
+    setScale(scale: number): void;
+    /** Returns to `defaultScale`. */
+    resetZoom(): void;
+    /** Rotates by 90° clockwise (default) or counter-clockwise. */
+    rotate(direction?: 'cw' | 'ccw'): void;
+    toggleFullscreen(): void;
+    /** Saves the loaded document (no second request). */
+    download(): Promise<void>;
+    /** Prints according to `printMode`. */
+    print(): Promise<void>;
+    /** Loads the source again. */
+    reload(): void;
+    /** The loaded PDF.js document, for advanced use. */
+    getDocument(): PDFDocumentProxy | null;
+}
+/** Props for `PdfViewer`. Every piece of state supports the value / defaultValue / onChange trio. */
+export interface PdfViewerProps extends PdfRequestOptions {
+    /** The document. `null`, `undefined` and `''` show the empty state. */
+    source: PdfSource | null | undefined;
+    /**
+     * Download file name: a `File`'s name, else the URL's last `.pdf` segment, else `document.pdf`.
+     *
+     * @defaultValue derived from the source
+     */
+    fileName?: string | undefined;
+    /** Controlled 1-based page. */
+    page?: number | undefined;
+    /** Initial page when uncontrolled, and the page a new document opens on. Default `1`. */
+    defaultPage?: number | undefined;
+    onPageChange?: ((page: number) => void) | undefined;
+    /** Controlled scale (1 = 100%). */
+    scale?: number | undefined;
+    /** Initial scale when uncontrolled; also the "reset zoom" target. Default `1`. */
+    defaultScale?: number | undefined;
+    onScaleChange?: ((scale: number) => void) | undefined;
+    /** Controlled rotation, relative to each page's natural orientation. */
+    rotation?: Rotation | undefined;
+    /** Initial rotation when uncontrolled. Default `0`. */
+    defaultRotation?: Rotation | undefined;
+    onRotationChange?: ((rotation: Rotation) => void) | undefined;
+    /** Controlled fullscreen state. */
+    fullscreen?: boolean | undefined;
+    /** Initial fullscreen state when uncontrolled. Default `false`. */
+    defaultFullscreen?: boolean | undefined;
+    onFullscreenChange?: ((fullscreen: boolean) => void) | undefined;
+    /**
+     * How fullscreen is presented. `'controlled'`: layout only, the parent presents it. `'native'`:
+     * the browser Fullscreen API on the viewer, falling back to `'overlay'`. `'overlay'`: a fixed
+     * full-viewport layer with a focus trap and scroll lock; `Esc` closes it.
+     *
+     * @defaultValue `'controlled'` when `fullscreen` is passed, else `'native'`
+     */
+    fullscreenMode?: FullscreenMode | undefined;
+    /** Zoom floor. Default `0.25`. */
+    minScale?: number | undefined;
+    /** Zoom ceiling. Default `5`. */
+    maxScale?: number | undefined;
+    /** Zoom button increment. Default `0.05`. */
+    scaleStep?: number | undefined;
+    /** Opt-in preset ladder; the zoom buttons step between presets instead of by `scaleStep`. */
+    zoomLevels?: readonly number[] | undefined;
+    /** At the default scale, shrink the page to the available width. Default `true`. */
+    fitWidthAtDefaultScale?: boolean | undefined;
+    /**
+     * Opt-in: at the default scale, scale the page to fill the width (`'width'`) or to fit entirely
+     * (`'page'`). Zooming away from the default scale shows the page at true size. Default `'none'`.
+     */
+    fitMode?: 'none' | 'width' | 'page' | undefined;
+    /** Password for encrypted documents. */
+    password?: string | undefined;
+    /** Per-instance `getDocument` overrides. */
+    pdfjsOptions?: PdfJsDocumentOptions | undefined;
+    /** `false` hides the toolbar; an object customizes it. Default `true`. */
+    toolbar?: boolean | ToolbarConfig | undefined;
+    /** Viewport width (px) below which the compact layout applies. Default `960`. */
+    compactBreakpoint?: number | undefined;
+    /**
+     * Keyboard shortcuts while focus is inside the viewer (never while typing in a field, or with
+     * Alt, Ctrl or ⌘ held). Default `true`.
+     *
+     * @shortcut PageUp Previous page.
+     * @shortcut PageDown Next page.
+     * @shortcut ArrowLeft Previous page; a zoomed page scrolls horizontally first.
+     * @shortcut ArrowRight Next page; a zoomed page scrolls horizontally first.
+     * @shortcut Home First page.
+     * @shortcut End Last page.
+     * @shortcut + Zoom in (`=` also works).
+     * @shortcut - Zoom out (`_` also works).
+     * @shortcut 0 Reset zoom to `defaultScale`.
+     * @shortcut r Rotate clockwise.
+     * @shortcut Shift+R Rotate counter-clockwise.
+     * @shortcut f Toggle fullscreen.
+     */
+    keyboardShortcuts?: boolean | undefined;
+    /** `'render'` prints through a hidden iframe; `'open-url'` opens the PDF in a new tab. Default `'render'`. */
+    printMode?: 'render' | 'open-url' | undefined;
+    /**
+     * Canvas pixel budget per page (4096 × 4096). Above it, resolution degrades gracefully.
+     *
+     * @defaultValue `16777216`
+     */
+    maxCanvasPixels?: number | undefined;
+    /**
+     * Label overrides (i18n). Keep the object stable (e.g. at module scope).
+     *
+     * @defaultValue English (`defaultLabels`)
+     */
+    labels?: Partial<PdfViewerLabels> | undefined;
+    /**
+     * BCP 47 locale for number formatting, e.g. `'hu-HU'`.
+     *
+     * @defaultValue the browser locale
+     */
+    locale?: string | undefined;
+    /** Page layout: `'single'` or `'continuous'` vertical scrolling. Default `'single'`. */
+    layout?: 'single' | 'continuous' | undefined;
+    /** Selectable text layer (copy, find, assistive technology). Default `false`. */
+    textLayer?: boolean | undefined;
+    /** Clickable links: internal links navigate, external links open in a new tab. Default `false`. */
+    annotationLayer?: boolean | undefined;
+    /** Editable page number in the toolbar. Default `false`. */
+    pageInput?: boolean | undefined;
+    /** The zoom label becomes a button that resets zoom. Default `false`. */
+    zoomReset?: boolean | undefined;
+    /** Ctrl/⌘ + wheel and trackpad-pinch zoom, anchored at the pointer. Default `false`. */
+    wheelZoom?: boolean | undefined;
+    /** Ask for the password of encrypted documents instead of showing an error. Default `false`. */
+    passwordPrompt?: boolean | undefined;
+    /** Replaces the built-in password prompt. */
+    renderPasswordPrompt?: ((context: {
+        incorrect: boolean;
+        submit: (password: string) => void;
+    }) => ReactNode) | undefined;
+    /** Page thumbnails sidebar (hidden in compact, non-fullscreen mode). Default `false`. */
+    thumbnails?: boolean | undefined;
+    /**
+     * Find-in-document bar with highlighting (implies the text layer). Default `false`.
+     *
+     * @shortcut Ctrl+F Focus the search field (`⌘+F` on macOS); `Enter` and `Shift+Enter` step through matches, `Escape` clears.
+     */
+    search?: boolean | undefined;
+    /** Replaces the loading view. */
+    renderLoading?: (() => ReactNode) | undefined;
+    /** Replaces the error view (document and page errors). */
+    renderError?: ((error: PdfViewerError, actions: {
+        retry: () => void;
+    }) => ReactNode) | undefined;
+    /** Replaces the toolbar; receives the viewer API. */
+    renderToolbar?: ((api: PdfViewerApi) => ReactNode) | undefined;
+    /** Replaces the empty view. */
+    renderEmpty?: (() => ReactNode) | undefined;
+    /** Called when a document is ready. */
+    onDocumentLoad?: ((info: {
+        numPages: number;
+        fingerprint: string;
+    }) => void) | undefined;
+    /** Called after each completed page render. */
+    onPageRender?: ((info: PageRenderInfo) => void) | undefined;
+    /** Called for every failure except aborts, canceled renders and handled HTTP errors. */
+    onError?: ((error: PdfViewerError) => void) | undefined;
+    /** Return `false` to prevent the default download. */
+    onDownload?: ((context: {
+        fileName: string;
+        data: Uint8Array;
+    }) => void | false) | undefined;
+    /** Return `false` to prevent the default print. */
+    onPrint?: (() => void | false) | undefined;
+    className?: string | undefined;
+    style?: CSSProperties | undefined;
+    id?: string | undefined;
+    /**
+     * Accessible name of the viewer region.
+     *
+     * @defaultValue `labels.viewer`
+     */
+    'aria-label'?: string | undefined;
+}
+export {};

package/package.json

@@ -1,6 +1,97 @@
 {
   "name": "@kingtech/react-pdf-viewer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Accessible, themeable React PDF viewer built on PDF.js: zoom, rotation, fullscreen, search, thumbnails, download and print, with no UI-kit dependency.",
+  "keywords": [
+    "react",
+    "pdf",
+    "pdf-viewer",
+    "pdfjs",
+    "pdf.js",
+    "pdfjs-dist",
+    "viewer",
+    "document-viewer",
+    "accessible",
+    "a11y",
+    "ssr"
+  ],
+  "license": "MIT",
+  "author": "Gyula Kiraly (https://github.com/kiralygyula92)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kiralygyula92/react-pdf-viewer.git",
+    "directory": "packages/react-pdf-viewer"
+  },
+  "homepage": "https://react-pdf-viewer-chi.vercel.app/react-pdf-viewer/",
+  "bugs": {
+    "url": "https://github.com/kiralygyula92/react-pdf-viewer/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "prepack": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "qa": "publint --strict && attw --pack . --profile esm-only --exclude-entrypoints ./styles.css && size-limit"
+  },
+  "peerDependencies": {
+    "pdfjs-dist": "^6.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@size-limit/preset-small-lib": "^14.0.0",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.7",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "axe-core": "^4.13.0",
+    "jsdom": "^30.1.0",
+    "pdfjs-dist": "^6.3.289",
+    "publint": "^0.3.24",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "size-limit": "^14.0.0",
+    "vite": "^8.3.0",
+    "vite-plugin-dts": "^5.1.1",
+    "vitest": "^5.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "size-limit": [
+    {
+      "name": "main entry (excluding peer dependencies)",
+      "path": "dist/index.js",
+      "limit": "20 kB",
+      "ignore": [
+        "react",
+        "react-dom",
+        "pdfjs-dist"
+      ]
+    }
+  ]
+}