@p10node/office-engine 0.2.2 → 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/dist/types/react/docx/DocxEditor.d.ts

@@ -1,7 +1,7 @@
 import type { Block, CanonStyle, Paragraph, ParaDirty, ParaStyle, RunSet, RunStyle, StyleInfo } from '../../core/docx/types';
 import type { DocumentClient } from '../../core/worker/client';
 import { RichInput, type ReplaceOpts, type RichHost } from '../edit/input';
-import { type RRun, type Sel } from '../edit/rich';
+import { type Pos, type RRun, type Sel } from '../edit/rich';
 export interface DocState {
     blocks: Block[];
     heights: WeakMap<Block, number>;
@@ -81,6 +81,11 @@ export declare class DocxEditor implements RichHost<Paragraph> {
     prev(pa: string): string | undefined;
     next(pa: string): string | undefined;
     cmp(a: string, b: string): number;
+    /** the whole document: from the first to the last editable top-level paragraph */
+    all(): Sel | null;
+    selectAll(): void;
+    /** Deletes a top-level range that spans tables: the end paragraphs are joined, everything between goes (section breaks stay). */
+    deleteAcross(s: Pos, e: Pos): Pos | null;
     withRuns(p: Paragraph, runs: RRun[]): Paragraph;
     private origOf;
     defaultRun(p: Paragraph): Partial<RRun> | undefined;

package/dist/types/react/edit/input.d.ts

@@ -40,6 +40,10 @@ export interface RichHost<P extends RichPara = RichPara> {
     pendingStyle?(): Partial<RRun> | undefined;
     clearPending?(): void;
     onSelection?(sel: Sel | null): void;
+    /** the whole document (select all); null when there is nothing to select */
+    all?(): Sel | null;
+    /** deletes a range that spans other blocks (tables): applies the change and returns the caret, or null when unsupported */
+    deleteAcross?(s: Pos, e: Pos): Pos | null;
 }
 export declare function ordered(host: RichHost, s: Sel): [Pos, Pos];
 export declare function opDelete(host: RichHost, sel: Sel, opts?: ReplaceOpts): void;
@@ -63,6 +67,8 @@ export declare class RichInput {
     private justComposed;
     private raf;
     lastSel: Sel | null;
+    /** select all: the model selection covers every paragraph, the DOM one only what is rendered */
+    private override;
     constructor(host: RichHost);
     attach(root: HTMLElement): void;
     detach(): void;
@@ -70,6 +76,12 @@ export declare class RichInput {
     readSel(): Sel | null;
     /** current selection, falling back to the last known one (e.g. after focusing a toolbar control) */
     sel(): Sel | null;
+    /**
+     * Selects the whole document. The browser's own select-all is useless here: the editing host holds
+     * non-editable parts (headers, read-only paragraphs) and Chromium empties a selection that crosses them;
+     * pages are also virtualized, so the DOM only ever holds a part of the document.
+     */
+    selectAll(): boolean;
     /** Applies a model selection to the DOM; false when its paragraph isn't rendered. */
     restore(sel: Sel | null, focus?: boolean): boolean;
     private rangeSel;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p10node/office-engine",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Browser engine to view DOCX, XLSX, PPTX progressively (worker-based, range-loading, virtualized React views)",
   "type": "module",
   "license": "MIT",
@@ -54,6 +54,7 @@
     "collab": "bun scripts/collab-server.ts",
     "clean": "rm -rf dist",
     "screenshots": "bun scripts/screenshots.ts",
+    "gifs": "bun scripts/gifs.ts",
     "build:site": "bun scripts/build-site.ts"
   },
   "peerDependencies": {