@file-viewer/core 3.3.1 → 3.3.3

package/dist/assets.d.ts

@@ -1,2 +1,2 @@
-export * from './platform/assets.js';
-export type * from './platform/assets.js';
+export * from "./platform/assets.js";
+export type * from "./platform/assets.js";

package/dist/assets.js

@@ -1,5 +1 @@
-// Public subpath facade for `@file-viewer/core/assets`.
-//
-// Asset resolution belongs to the platform layer, but this root-level file is
-// intentionally kept as the stable package export declared in package.json.
-export * from './platform/assets.js';
+export * from "./platform/assets.js";

package/dist/browser/controller.d.ts

@@ -1,4 +1,4 @@
-import { type FileViewerAiOptions, type FileViewerApplyViewStateOptions, type FileViewerArchiveOptions, type FileViewerCadOptions, type FileViewerDocxOptions, type FileViewerDocumentAnchor, type FileViewerDocumentChunk, type FileViewerEvent, type FileViewerEventHandler, type FileViewerEventType, type FileViewerFileRef, type FileViewerFitMode, type FileViewerFitOptions, type FileViewerFitResult, type FileViewerInstance, type FileViewerLifecycleContext, type FileViewerOperationAvailability, type FileViewerOptions, type FileViewerPdfOptions, type FileViewerPresentationOptions, type FileViewerSpreadsheetOptions, type FileViewerPublicApi, type FileViewerSearchOptions, type FileViewerSearchState, type FileViewerThemeMode, type FileViewerToolbarOptions, type FileViewerToolbarPosition, type FileViewerTypstOptions, type FileViewerUiDensity, type FileViewerUiOptions, type FileViewerViewState, type FileViewerWatermarkOptions, type FileViewerPrintOptions, type FileViewerZoomState, type RendererRegistry } from '../index.js';
+import { type FileViewerAiOptions, type FileViewerApplyViewStateOptions, type FileViewerArchiveOptions, type FileViewerCadOptions, type FileViewerDocxOptions, type FileViewerDocumentAnchor, type FileViewerDocumentChunk, type FileViewerEvent, type FileViewerEventHandler, type FileViewerEventType, type FileViewerFileRef, type FileViewerFitMode, type FileViewerFitOptions, type FileViewerFitResult, type FileViewerInstance, type FileViewerLifecycleContext, type FileViewerOperationAvailability, type FileViewerOptions, type FileViewerPdfOptions, type FileViewerPresentationOptions, type FileViewerSpreadsheetOptions, type FileViewerPublicApi, type FileViewerSearchOptions, type FileViewerSearchState, type FileViewerThemeMode, type FileViewerToolbarOptions, type FileViewerToolbarPosition, type FileViewerTypstOptions, type FileViewerUiDensity, type FileViewerUiOptions, type FileViewerViewState, type FileViewerWatermarkOptions, type FileViewerPrintOptions, type FileViewerZoomState, type RendererRegistry } from "../index.js";
 export type FileRef = FileViewerFileRef;
 export type ViewerWatermarkOptions = FileViewerWatermarkOptions;
 export type ViewerToolbarPosition = FileViewerToolbarPosition;
@@ -34,7 +34,6 @@ export interface ViewerState {
     search: FileViewerSearchState | null;
     zoom: FileViewerZoomState | null;
     location: FileViewerDocumentAnchor | null;
-    /** Added in 2.2; optional so existing state fixtures remain source-compatible. */
     viewState?: FileViewerViewState | null;
 }
 export type ViewerStateListener = (state: ViewerState, event?: ViewerEvent) => void;

package/dist/browser/controller.js

@@ -1,8 +1,9 @@
-import { appendFileViewerStyle, cloneFileViewerViewState, applyFileViewerZoomAvailability, createViewer, isFileViewerShadowRoot, normalizeFileViewerUiDensity, normalizeFileViewerTheme, normalizeFileViewerStyleIsolation, syncFileViewerRenderSurfaceBackground, } from '../index.js';
-import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, createFileViewerTranslator, getExtension, normalizeFileViewerSourceUrl, hasVisibleFileViewerToolbarActions, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, resolveFileViewerRemoteSourcePlan, resolveFileViewerColorScheme, resolveFileViewerToolbarOrder, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, toggleFileViewerColorScheme, wrapFileViewerFileRef, } from '../index.js';
-import { resolveFileViewerToolbarZoomButtons } from '../lifecycle/operations.js';
-import { createToolbarFocusRestorer } from './toolbar-focus.js';
-import { createViewerSourceFeedback } from './source-feedback.js';
+import { appendFileViewerStyle, cloneFileViewerViewState, applyFileViewerZoomAvailability, createViewer, isFileViewerShadowRoot, normalizeFileViewerUiDensity, normalizeFileViewerTheme, normalizeFileViewerStyleIsolation, syncFileViewerRenderSurfaceBackground, } from "../index.js";
+import { DEFAULT_FILE_VIEWER_SOURCE_FILENAME, createFileViewerTranslator, getExtension, normalizeFileViewerSourceUrl, hasVisibleFileViewerToolbarActions, isFileViewerZoomButtonDisabled, normalizeFileViewerToolbar, normalizeFilename, readFileViewerBuffer, resolveFileViewerSourceFilename, resolveFileViewerRemoteSourcePlan, resolveFileViewerColorScheme, resolveFileViewerToolbarOrder, resolveFileViewerToolbarPosition, resolveVisibleFileViewerToolbar, toggleFileViewerColorScheme, wrapFileViewerFileRef, } from "../index.js";
+import { resolveFileViewerToolbarZoomButtons } from "../lifecycle/operations.js";
+import { createToolbarFocusRestorer } from "./toolbar-focus.js";
+import { bindToolbarKeyboardActivation } from "./toolbar-keyboard.js";
+import { createViewerSourceFeedback } from "./source-feedback.js";
 const isBrowser = () => typeof window !== 'undefined' && typeof document !== 'undefined';
 const hasSource = (options = {}) => {
     return !!(options.url || options.file || options.buffer);
@@ -16,8 +17,6 @@ const toViewerSourceInput = (options = {}) => ({
     type: options.type,
     size: options.size,
 });
-// These options feed renderer selection or rendering itself. Viewer chrome,
-// fitting, watermark, and operation callbacks update in place instead.
 const RENDER_AFFECTING_VIEWER_OPTION_KEYS = [
     'theme',
     'rendererMode',
@@ -149,8 +148,6 @@ const resolveViewerLoadSource = async (source, options = {}) => {
             url: source.url, filename, type,
             pageHref: options.pageHref, streaming: options.streaming,
         });
-        // A supplied transport owns authentication/acquisition and keeps its normal
-        // buffered contract. Only the default PDF URL path defers bytes to PDF.js.
         if (!options.fetchFile && options.acceptsPdfUrl && plan.streamPdf) {
             (_e = options.onPhase) === null || _e === void 0 ? void 0 : _e.call(options, 'streamingPdf');
             return { url: plan.url, filename: plan.filename, type: plan.extension, size: source.size };
@@ -316,9 +313,6 @@ const DEFAULT_TOOLBAR_ZOOM_STATE = {
     canZoomOut: false,
     canReset: false,
 };
-// A ShadowRoot cannot be detached. Track the exact roots created on viewer
-// hosts so a later light-DOM remount can expose its children through a slot,
-// without mistaking and clearing a ShadowRoot owned by the host application.
 const ownedViewerShadowRoots = new WeakMap();
 const WEB_VIEWER_STYLE = `
 :host,.file-viewer-web-shell{display:block;width:100%;height:100%;min-width:0;min-height:0;contain:content;--file-viewer-bg:transparent;--file-viewer-content-bg:transparent;--file-viewer-text:#172033;--file-viewer-muted:#607282;--file-viewer-font:14px/1.45 system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;--file-viewer-border:rgba(20,35,53,.08);--file-viewer-toolbar-bg:rgba(255,255,255,.92);--file-viewer-toolbar-border:rgba(20,35,53,.06);--file-viewer-toolbar-shadow:0 18px 44px rgba(15,23,42,.16);--file-viewer-toolbar-radius:999px;--file-viewer-toolbar-gap:6px;--file-viewer-toolbar-min-height:45px;--file-viewer-toolbar-padding:6px 10px;--file-viewer-toolbar-floating-min-height:42px;--file-viewer-toolbar-floating-padding:6px;--file-viewer-toolbar-floating-offset:16px;--file-viewer-group-bg:rgba(20,35,53,.035);--file-viewer-group-border:rgba(20,35,53,.08);--file-viewer-group-gap:2px;--file-viewer-group-padding:2px;--file-viewer-button-color:#40546a;--file-viewer-button-hover-bg:rgba(33,163,102,.1);--file-viewer-button-hover-color:#16774c;--file-viewer-button-disabled-color:#aab5c0;--file-viewer-button-radius:8px;--file-viewer-button-min-width:42px;--file-viewer-button-height:30px;--file-viewer-button-padding:0 10px;--file-viewer-icon-button-size:30px;--file-viewer-zoom-meter-min-width:48px;--file-viewer-zoom-meter-padding:0 8px;--file-viewer-floating-button-min-width:48px;--file-viewer-floating-button-height:32px;--file-viewer-floating-icon-button-size:32px;--file-viewer-floating-zoom-meter-min-width:54px;--file-viewer-search-input-height:30px;--file-viewer-search-input-padding:0 10px;--file-viewer-search-button-min-width:32px;--file-viewer-search-button-padding:0 8px;--file-viewer-search-count-min-width:42px;--file-viewer-floating-search-input-height:32px;--file-viewer-focus-ring:rgba(31,157,103,.22);--file-viewer-z-toolbar:20;--file-viewer-z-floating-toolbar:30}
@@ -422,26 +416,14 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
     }
     else if (shouldUseShadowRoot && canAttachShadowRoot) {
         try {
-            // The viewer owns this root even when its host already lives inside a
-            // customer's ShadowRoot. Reusing the ancestor would let that component's
-            // resets override the toolbar and would make our :host rules mutate the
-            // customer's outer custom element.
-            // Delegated focus makes Safari taps on renderer controls focus the first
-            // toolbar input instead, triggering keyboard zoom and viewport scrolling.
             renderRoot = container.attachShadow({ mode: 'open' });
             ownedViewerShadowRoots.set(container, renderRoot);
         }
         catch {
-            // Some HTMLElement subclasses cannot host Shadow DOM, and a closed root
-            // is intentionally invisible through `shadowRoot`. Keep the legacy
-            // scoped path usable instead of surfacing a raw NotSupportedError.
             renderRoot = container;
         }
     }
     else if (existingHostShadowRoot && !hasOwnedHostShadowRoot) {
-        // The application owns this root. Preserve every existing child and mount
-        // the viewer in a dedicated boundary. Shadow mode gets a nested root so
-        // customer resets in the outer component cannot reach the viewer.
         mountBoundary = documentRef.createElement('div');
         mountBoundary.dataset.fileViewerMountBoundary = 'true';
         existingHostShadowRoot.appendChild(mountBoundary);
@@ -458,9 +440,6 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
         }
     }
     else if (!shouldUseShadowRoot && hasOwnedHostShadowRoot && existingHostShadowRoot) {
-        // Light-DOM children of a shadow host are not painted unless the root has
-        // a slot. Keep the immutable owned root, but project the real light-DOM
-        // viewer so host selectors and legacy deep overrides work as documented.
         const slot = documentRef.createElement('slot');
         slot.dataset.fileViewerLightDomSlot = 'true';
         existingHostShadowRoot.replaceChildren(slot);
@@ -468,9 +447,6 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
     }
     renderRoot.replaceChildren();
     const styleHandle = appendFileViewerStyle(renderRoot, WEB_VIEWER_STYLE, {
-        // Adopt only into a root owned by the viewer. Adopting into an ancestor
-        // ShadowRoot would leak toolbar selectors and apply :host rules to the
-        // customer's custom element.
         adoptedStyleSheet: isFileViewerShadowRoot(renderRoot),
     });
     const shell = documentRef.createElement('div');
@@ -539,6 +515,7 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
         syncFileViewerRenderSurfaceBackground(shell, currentOptions.options);
     };
     const captureToolbarFocus = createToolbarFocusRestorer(toolbarEl, contentEl);
+    const disposeToolbarKeyboard = bindToolbarKeyboardActivation(toolbarEl);
     let controller = null;
     let searchDraft = '';
     const isSearchToolbarVisible = (toolbar, options) => {
@@ -684,12 +661,6 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
                 group.appendChild(createReadonlyMeter(documentRef, zoomState.label, 'file-viewer-web-zoom-meter'));
             }
             if (zoomButtons.zoomReset) {
-                // Placed before the zoom-in button (not after) so that toggling this
-                // button's visibility never shifts the zoom-in button's position: the
-                // toolbar group is right-aligned, and both icon buttons share the same
-                // width, so inserting "1:1" after "+" would make it land exactly on
-                // top of the previous "+" position, turning a repeated zoom-in click
-                // into an accidental reset (see GitHub issue #88).
                 const button = createButton(documentRef, '1:1', 'file-viewer-web-icon-button', () => controller === null || controller === void 0 ? void 0 : controller.resetZoom());
                 button.title = t('toolbar.zoomReset');
                 button.dataset.viewerToolbarKey = 'zoom-reset';
@@ -996,9 +967,6 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
         }
     };
     if (currentSource) {
-        // The initial declarative source has no caller awaiting it. State changes
-        // and the visible error surface remain authoritative without a global
-        // unhandled-rejection event for an expected rendering failure.
         void loadSource(currentSource).catch(() => undefined);
     }
     controller = {
@@ -1068,6 +1036,7 @@ export const mountViewer = (container, initialOptions = {}, coreOptions = {}) =>
             if (disposed)
                 return;
             disposed = true;
+            disposeToolbarKeyboard();
             cancel();
             (_a = viewerColorSchemeQuery === null || viewerColorSchemeQuery === void 0 ? void 0 : viewerColorSchemeQuery.removeEventListener) === null || _a === void 0 ? void 0 : _a.call(viewerColorSchemeQuery, 'change', handleViewerColorSchemeChange);
             void instance.destroy('component-unmount');

package/dist/browser/source-feedback.d.ts

@@ -1,4 +1,3 @@
-import { type FileViewerI18nInput } from '../i18n/messages.js';
+import { type FileViewerI18nInput } from "../i18n/messages.js";
 export type ViewerSourcePhase = 'downloading' | 'reading' | 'streamingPdf';
-/** The shell owns acquisition feedback; renderers retain their own error surface. */
 export declare const createViewerSourceFeedback: (shell: HTMLElement, content: HTMLElement) => (phase: ViewerSourcePhase | null, error: unknown, extension: string, options?: FileViewerI18nInput, rendererHasError?: boolean) => void;

package/dist/browser/source-feedback.js

@@ -1,6 +1,5 @@
-import { createFileViewerTranslator } from '../i18n/messages.js';
-import { createFileViewerErrorState } from '../viewer/state.js';
-/** The shell owns acquisition feedback; renderers retain their own error surface. */
+import { createFileViewerTranslator } from "../i18n/messages.js";
+import { createFileViewerErrorState } from "../viewer/state.js";
 export const createViewerSourceFeedback = (shell, content) => {
     let surface = null;
     let title = null;

package/dist/browser/toolbar-focus.d.ts

@@ -1,2 +1 @@
-/** Preserve the active logical action across state-driven toolbar rebuilds. */
 export declare function createToolbarFocusRestorer(toolbar: HTMLElement, content: HTMLElement): () => (temporarilyUnavailable?: boolean) => void;

package/dist/browser/toolbar-focus.js

@@ -1,4 +1,3 @@
-/** Preserve the active logical action across state-driven toolbar rebuilds. */
 export function createToolbarFocusRestorer(toolbar, content) {
     let pendingKey = null;
     const controls = () => Array.from(toolbar.querySelectorAll('[data-viewer-toolbar-key]'));
@@ -35,8 +34,6 @@ export function createToolbarFocusRestorer(toolbar, content) {
                     target.setSelectionRange(selection[0], selection[1], selection[2] || undefined);
             }
             else {
-                // All actions may be temporarily disabled during a load. Restore only
-                // while the user remains here; moving elsewhere clears this pending key.
                 pendingKey = key;
                 toolbar.tabIndex = -1;
                 toolbar.focus({ preventScroll: true });

package/dist/browser/toolbar-keyboard.d.ts

@@ -0,0 +1 @@
+export declare function bindToolbarKeyboardActivation(toolbar: HTMLElement): () => void;

package/dist/browser/toolbar-keyboard.js

@@ -0,0 +1,63 @@
+const isSpace = (event) => event.code === 'Space' || event.key === ' ' || event.key === 'Spacebar';
+export function bindToolbarKeyboardActivation(toolbar) {
+    var _a;
+    const documentRef = toolbar.ownerDocument;
+    let pending = null;
+    let releaseTimer;
+    const clear = () => { pending = null; };
+    const clearOnSpaceDown = (event) => {
+        if (isSpace(event) || event.key === 'Tab' || event.key === 'Escape')
+            clear();
+    };
+    const clearAfterSpaceUp = (event) => {
+        if (!isSpace(event))
+            return;
+        const released = pending;
+        clearTimeout(releaseTimer);
+        releaseTimer = setTimeout(() => { if (pending === released)
+            clear(); }, 0);
+    };
+    const buttonFor = (event) => {
+        const target = event.target;
+        return (target === null || target === void 0 ? void 0 : target.tagName) === 'BUTTON' && toolbar.contains(target) ? target : null;
+    };
+    const onKeyDown = (event) => {
+        if (!isSpace(event) || event.defaultPrevented || event.isComposing || event.altKey || event.ctrlKey || event.metaKey)
+            return;
+        const button = buttonFor(event);
+        if (!(button === null || button === void 0 ? void 0 : button.dataset.viewerToolbarKey) || button.disabled)
+            return;
+        event.preventDefault();
+        pending = { key: button.dataset.viewerToolbarKey };
+    };
+    const onKeyUp = (event) => {
+        if (!isSpace(event))
+            return;
+        const activation = pending;
+        clear();
+        if (!activation || event.defaultPrevented || event.isComposing || event.altKey || event.ctrlKey || event.metaKey)
+            return;
+        const button = buttonFor(event);
+        if (!button || button.disabled || button.dataset.viewerToolbarKey !== activation.key)
+            return;
+        event.preventDefault();
+        button.click();
+    };
+    documentRef.addEventListener('keydown', clearOnSpaceDown, true);
+    documentRef.addEventListener('keyup', clearAfterSpaceUp, true);
+    documentRef.addEventListener('pointerdown', clear, true);
+    (_a = documentRef.defaultView) === null || _a === void 0 ? void 0 : _a.addEventListener('blur', clear);
+    toolbar.addEventListener('keydown', onKeyDown);
+    toolbar.addEventListener('keyup', onKeyUp);
+    return () => {
+        var _a;
+        clear();
+        clearTimeout(releaseTimer);
+        documentRef.removeEventListener('keydown', clearOnSpaceDown, true);
+        documentRef.removeEventListener('keyup', clearAfterSpaceUp, true);
+        documentRef.removeEventListener('pointerdown', clear, true);
+        (_a = documentRef.defaultView) === null || _a === void 0 ? void 0 : _a.removeEventListener('blur', clear);
+        toolbar.removeEventListener('keydown', onKeyDown);
+        toolbar.removeEventListener('keyup', onKeyUp);
+    };
+}

package/dist/browser.d.ts

@@ -1,2 +1,2 @@
-export * from './index.js';
-export * from './browser/controller.js';
+export * from "./index.js";
+export * from "./browser/controller.js";

package/dist/browser.js

@@ -1,2 +1,2 @@
-export * from './index.js';
-export * from './browser/controller.js';
+export * from "./index.js";
+export * from "./browser/controller.js";

package/dist/config/options.d.ts

@@ -1,4 +1,4 @@
-import type { FileViewerArchiveOptions, FileViewerCadOptions, FileViewerOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerUiDensity } from '../contracts/types.js';
+import type { FileViewerArchiveOptions, FileViewerCadOptions, FileViewerOptions, FileViewerResolvedThemeMode, FileViewerThemeMode, FileViewerToolbarOptions, FileViewerUiDensity } from "../contracts/types.js";
 export type FileViewerSerializableToolbarOptions = Omit<FileViewerToolbarOptions, 'beforeOperation' | 'beforeDownload' | 'beforePrint' | 'beforeExportHtml'>;
 export type FileViewerSerializableCadOptions = Omit<FileViewerCadOptions, 'workerUrl'> & {
     workerUrl?: string;