@p10node/office-engine 0.2.3 → 0.3.0

package/dist/types/embed.d.ts

@@ -10,7 +10,7 @@ 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);
  * 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/react/DocViewer.d.ts

@@ -57,5 +57,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

@@ -18,3 +18,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.3.0",
   "description": "Browser engine to view DOCX, XLSX, PPTX progressively (worker-based, range-loading, virtualized React views)",
   "type": "module",
   "license": "MIT",