@p10node/office-engine 0.2.3 → 0.4.0

package/dist/types/embed.d.ts

@@ -10,7 +10,8 @@ export declare function mount(el: HTMLElement, options: MountOptions): MountedVi
 /**
  * `<office-viewer src="/file.xlsx" style="height:600px"></office-viewer>`
  * Rendered inside a shadow root so host page CSS cannot leak in.
- * Attributes: src, name, editable, toolbar / thumbnails / save / download / file-menu / open ("false" to hide);
+ * Attributes: src, name, editable, toolbar / thumbnails / save / download / file-menu / open / capture-select-all ("false" to turn off),
+ * theme ("light" | "dark" | "auto");
  * real-time collaboration: collab (hub WebSocket URL), room, user (display name), base (snapshot seq `src` was opened at).
  * Property: `file` (File/Blob/ArrayBuffer) for local data.
  */

package/dist/types/index.d.ts

@@ -8,6 +8,7 @@ export { SlideView } from './react/pptx/Slide';
 export { useDocument, type DocumentState } from './react/useDocument';
 export { injectStyles, stylesText } from './react/injectStyles';
 export type { Zoom } from './react/common/ZoomControl';
+export type { Theme } from './react/common/hooks';
 export { DocumentClient, setDefaultWorker, type OpenOptions } from './core/worker/client';
 export type { DocSource } from './core/source';
 export type { DocKind } from './core/opc';

package/dist/types/react/DocViewer.d.ts

@@ -3,6 +3,7 @@ import type { DocSource } from '../core/source';
 import type { DocumentClient, OpenOptions } from '../core/worker/client';
 import type { Zoom } from './common/ZoomControl';
 import { type FileMenuItem } from './file/FileMenu';
+import { type Theme } from './common/hooks';
 import type { CollabOptions } from '../collab';
 export interface DocViewerProps {
     /** File, Blob, ArrayBuffer, Uint8Array or URL (HTTP Range requests are used when the server supports them). */
@@ -25,6 +26,11 @@ export interface DocViewerProps {
     worker?: OpenOptions['worker'];
     /** Where to inject the stylesheet (document or a shadow root). */
     styleTarget?: Document | ShadowRoot;
+    /**
+     * Color scheme of the viewer chrome (bars, menus, dialogs): 'light', 'dark' or 'auto' (follows the OS / browser setting).
+     * The document itself keeps its own colors. Default 'light'.
+     */
+    theme?: Theme;
     onLoad?: (client: DocumentClient) => void;
     onError?: (error: Error) => void;
     /** Start in edit mode. Default false (view). */
@@ -57,5 +63,10 @@ export interface DocViewerProps {
      * edits it together through the hub at `transport` (see src/collab).
      */
     collab?: CollabOptions;
+    /**
+     * Ctrl/⌘+A anywhere on the page selects the document (text fields outside the viewer keep their own).
+     * Default true. With false the shortcut works from the viewer only (its content or toolbar).
+     */
+    captureSelectAll?: boolean;
 }
 export declare function DocViewer(props: DocViewerProps): import("react").JSX.Element;

package/dist/types/react/common/Slots.d.ts

@@ -27,11 +27,17 @@ export interface ViewerApi {
     fileOps: {
         current: FileOps | null;
     };
+    /** set by the mounted view (see useSelectAll): Ctrl/⌘+A */
+    selectAll: {
+        current: (() => void) | null;
+    };
 }
 export declare const ViewerContext: import("react").Context<ViewerApi>;
 export declare const useViewer: () => ViewerApi;
 /** Publishes the view's file operations (latest closure each render) to the File menu. */
 export declare function useFileOps(ops: FileOps): void;
+/** Publishes the view's select-all: Ctrl/⌘+A from the viewer chrome or, with `captureSelectAll`, from anywhere on the page. */
+export declare function useSelectAll(fn: () => void): void;
 /** Renders the editor bar into the viewer's toolbar row. */
 export declare function EditorBar({ children }: {
     children: ReactNode;

package/dist/types/react/common/hooks.d.ts

@@ -1,6 +1,10 @@
 import { useLayoutEffect } from 'react';
 import type { DocumentClient } from '../../core/worker/client';
 export declare const useIsoLayoutEffect: typeof useLayoutEffect;
+/** Color scheme of the viewer chrome: 'auto' follows the browser / OS setting (prefers-color-scheme). */
+export type Theme = 'light' | 'dark' | 'auto';
+/** Whether the dark theme applies for `theme`; 'auto' tracks prefers-color-scheme live. */
+export declare function useDarkTheme(theme?: Theme): boolean;
 export declare function useForceUpdate(): [number, () => void];
 /** Element size via ResizeObserver. */
 export declare function useSize<T extends HTMLElement>(): [React.RefObject<T | null>, {
@@ -18,3 +22,10 @@ export declare function useMediaUrl(client: DocumentClient, path: string | undef
 export declare function lowerIndex(arr: ArrayLike<number>, v: number): number;
 export declare function useLatest<T>(v: T): import("react").RefObject<T>;
 export declare function useStableCallback<A extends unknown[], R>(fn: (...a: A) => R): (...a: A) => R;
+/** A control that takes typed text: Ctrl/⌘+A selects its own content. */
+export declare function isTextEntry(target: EventTarget | null): boolean;
+/**
+ * Focuses `el` so keyboard shortcuts work without a click. The focus stays where it is when a control
+ * outside the viewer has it (a host page form); the viewer's own chrome (or the page body) yields.
+ */
+export declare function claimFocus(el: HTMLElement | null): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p10node/office-engine",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "description": "Browser engine to view DOCX, XLSX, PPTX progressively (worker-based, range-loading, virtualized React views)",
   "type": "module",
   "license": "MIT",