@p10node/office-engine 0.3.0 → 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 / capture-select-all ("false" to turn off);
+ * 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). */

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>, {

package/package.json

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