@silurus/ooxml 0.12.0 → 0.14.0

package/dist/pptx.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./autoResize-ggn4hzd8.cjs`),t=require(`./pptx-f3apnG_M.cjs`);exports.PptxPresentation=t.r,exports.PptxViewer=t.n,exports.autoResize=e.t,exports.renderSlide=t.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./autoResize-ggn4hzd8.cjs`),t=require(`./pptx-BMJO4Oqg.cjs`);exports.PptxPresentation=t.r,exports.PptxViewer=t.n,exports.autoResize=e.t,exports.renderSlide=t.i;

package/dist/pptx.mjs

@@ -1,3 +1,3 @@
 import { t as e } from "./autoResize-U2-IRmNE.js";
-import { i as t, n, r } from "./pptx-VEtxsakL.js";
+import { i as t, n, r } from "./pptx-DVyrqUyw.js";
 export { r as PptxPresentation, n as PptxViewer, e as autoResize, t as renderSlide };

package/dist/types/docx.d.ts

@@ -141,23 +141,46 @@ export declare class DocxDocument {
     renderPage(target: HTMLCanvasElement | OffscreenCanvas, pageIndex: number, opts?: RenderPageOptions): Promise<void>;
 }
 
+/** Information about a rendered text segment for building a transparent selection overlay. */
+export declare interface DocxTextRunInfo {
+    text: string;
+    /** Left edge in canvas CSS px. */
+    x: number;
+    /** Top of line box in canvas CSS px. */
+    y: number;
+    /** Measured text width in CSS px. */
+    w: number;
+    /** Line height in CSS px. */
+    h: number;
+    /** Font size in CSS px. */
+    fontSize: number;
+}
+
 export declare class DocxViewer {
     private _doc;
     private _currentPage;
     private _canvas;
+    private _wrapper;
+    private _textLayer;
     private _opts;
     constructor(canvas: HTMLCanvasElement, opts?: DocxViewerOptions);
     load(source: string | ArrayBuffer): Promise<void>;
     get pageCount(): number;
     get currentPage(): number;
-    goToPage(index: number): void;
-    nextPage(): void;
-    prevPage(): void;
+    goToPage(index: number): Promise<void>;
+    nextPage(): Promise<void>;
+    prevPage(): Promise<void>;
     private _render;
+    private _buildTextLayer;
 }
 
 declare interface DocxViewerOptions extends RenderPageOptions {
     container?: HTMLElement;
+    /**
+     * When true, adds a transparent text overlay div over the canvas so the
+     * browser's native text selection works on document content.
+     */
+    enableTextSelection?: boolean;
 }
 
 declare interface FieldRun {
@@ -308,6 +331,15 @@ export declare interface RenderPageOptions {
     width?: number;
     dpr?: number;
     defaultTextColor?: string;
+    /** Called for each rendered text segment. Used to build a transparent text selection overlay. */
+    onTextRun?: (run: {
+        text: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        fontSize: number;
+    }) => void;
 }
 
 export declare interface SectionProps {

package/dist/types/index.d.ts

@@ -95,6 +95,11 @@ declare interface Cell {
     formula?: string;
 }
 
+declare interface CellAddress {
+    row: number;
+    col: number;
+}
+
 declare interface CellBorders {
     top: BorderSpec | null;
     bottom: BorderSpec | null;
@@ -109,6 +114,12 @@ declare interface CellRange {
     right: number;
 }
 
+declare interface CellRange_2 {
+    anchor: CellAddress;
+    active: CellAddress;
+    mode: SelectionMode_2;
+}
+
 declare type CellValue = {
     type: 'empty';
 } | {
@@ -471,7 +482,8 @@ export declare namespace docx {
         DocRun,
         TextRun_2 as TextRun,
         ImageRun,
-        RenderPageOptions
+        RenderPageOptions,
+        DocxTextRunInfo
     }
 }
 
@@ -489,23 +501,46 @@ declare class DocxDocument {
     renderPage(target: HTMLCanvasElement | OffscreenCanvas, pageIndex: number, opts?: RenderPageOptions): Promise<void>;
 }
 
+/** Information about a rendered text segment for building a transparent selection overlay. */
+declare interface DocxTextRunInfo {
+    text: string;
+    /** Left edge in canvas CSS px. */
+    x: number;
+    /** Top of line box in canvas CSS px. */
+    y: number;
+    /** Measured text width in CSS px. */
+    w: number;
+    /** Line height in CSS px. */
+    h: number;
+    /** Font size in CSS px. */
+    fontSize: number;
+}
+
 declare class DocxViewer {
     private _doc;
     private _currentPage;
     private _canvas;
+    private _wrapper;
+    private _textLayer;
     private _opts;
     constructor(canvas: HTMLCanvasElement, opts?: DocxViewerOptions);
     load(source: string | ArrayBuffer): Promise<void>;
     get pageCount(): number;
     get currentPage(): number;
-    goToPage(index: number): void;
-    nextPage(): void;
-    prevPage(): void;
+    goToPage(index: number): Promise<void>;
+    nextPage(): Promise<void>;
+    prevPage(): Promise<void>;
     private _render;
+    private _buildTextLayer;
 }
 
 declare interface DocxViewerOptions extends RenderPageOptions {
     container?: HTMLElement;
+    /**
+     * When true, adds a transparent text overlay div over the canvas so the
+     * browser's native text selection works on document content.
+     */
+    enableTextSelection?: boolean;
 }
 
 declare interface Dxf {
@@ -930,6 +965,8 @@ export declare namespace pptx {
         RenderSlideOptions,
         renderSlide,
         RenderOptions,
+        TextRunInfo,
+        TextRunCallback,
         autoResize,
         AutoResizeOptions,
         Presentation,
@@ -1013,6 +1050,8 @@ declare class PptxPresentation {
  */
 declare class PptxViewer {
     private readonly canvas;
+    private readonly wrapper;
+    private textLayer;
     private engine;
     private readonly opts;
     private currentSlide;
@@ -1029,6 +1068,7 @@ declare class PptxViewer {
     /** The underlying <canvas> element. */
     get canvasElement(): HTMLCanvasElement;
     private renderCurrentSlide;
+    private _buildTextLayer;
     /** Clean up the viewer and terminate the background worker. */
     destroy(): void;
 }
@@ -1051,6 +1091,11 @@ declare interface PptxViewerOptions extends RenderOptions {
      * badge over media posters.
      */
     enableMediaPlayback?: boolean;
+    /**
+     * When true, adds a transparent text overlay div over the canvas so the
+     * browser's native text selection works on slide content.
+     */
+    enableTextSelection?: boolean;
 }
 
 declare interface Presentation {
@@ -1097,13 +1142,22 @@ declare interface RenderPageOptions {
     width?: number;
     dpr?: number;
     defaultTextColor?: string;
+    /** Called for each rendered text segment. Used to build a transparent text selection overlay. */
+    onTextRun?: (run: {
+        text: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        fontSize: number;
+    }) => void;
 }
 
 /**
  * Render a single slide onto a <canvas> element.
  * Returns the canvas for convenience.
  */
-declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: RenderOptions): Promise<HTMLCanvasElement | OffscreenCanvas>;
+declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: RenderOptions, onTextRun?: TextRunCallback): Promise<HTMLCanvasElement | OffscreenCanvas>;
 
 /** Options for rendering a single slide onto a canvas. */
 declare interface RenderSlideOptions {
@@ -1111,6 +1165,8 @@ declare interface RenderSlideOptions {
     width?: number;
     /** Device pixel ratio. Defaults to window.devicePixelRatio or 1. */
     dpr?: number;
+    /** Called for each rendered text segment. Used to build a transparent text selection overlay. */
+    onTextRun?: TextRunCallback;
     /**
      * Skip drawing the play badge overlay on media elements. Used internally by
      * {@link PptxPresentation.presentSlide} so its interactive handle can draw
@@ -1133,6 +1189,8 @@ declare interface RenderViewportOptions {
     cellScale?: number;
     /** Pre-loaded Image elements keyed by their dataUrl (for ImageAnchor rendering). */
     loadedImages?: Map<string, HTMLImageElement>;
+    /** Called once per cell that contains text, with canvas-pixel position and cell address. */
+    onTextRun?: (info: TextRunInfo_2) => void;
 }
 
 declare interface Row {
@@ -1175,6 +1233,8 @@ declare interface SectionProps {
     docGridLinePitch?: number | null;
 }
 
+declare type SelectionMode_2 = 'cells' | 'rows' | 'cols' | 'all';
+
 declare interface Shadow {
     color: string;
     alpha: number;
@@ -1497,6 +1557,8 @@ declare interface TextRun_2 {
     highlight?: string | null;
 }
 
+declare type TextRunCallback = (run: TextRunInfo) => void;
+
 declare interface TextRunData {
     type: 'text';
     text: string;
@@ -1517,6 +1579,51 @@ declare interface TextRunData {
     fieldType?: string;
 }
 
+/** Information about a rendered text segment for building a transparent selection overlay. */
+declare interface TextRunInfo {
+    text: string;
+    /** X position in CSS px, relative to the shape's top-left corner. */
+    inShapeX: number;
+    /** Y position (top of line box) in CSS px, relative to the shape's top-left corner. */
+    inShapeY: number;
+    /** Measured text width in CSS px. */
+    w: number;
+    /** Line height in CSS px. */
+    h: number;
+    /** Font size in CSS px. */
+    fontSize: number;
+    /** Shape's left edge in canvas CSS px. */
+    shapeX: number;
+    /** Shape's top edge in canvas CSS px. */
+    shapeY: number;
+    /** Shape's width in canvas CSS px. */
+    shapeW: number;
+    /** Shape's height in canvas CSS px. */
+    shapeH: number;
+    /** Shape rotation in degrees (clockwise). */
+    rotation: number;
+    /**
+     * Additional rotation from a vertical text body (`vert="vert"` → 90,
+     * `vert="vert270"` → -90). The CSS overlay must add this to `rotation`.
+     */
+    textBodyRotation?: number;
+}
+
+/** Emitted once per cell that has text, with the cell's canvas-pixel bounds. */
+declare interface TextRunInfo_2 {
+    text: string;
+    /** Canvas CSS-pixel x of the cell's top-left corner. */
+    x: number;
+    /** Canvas CSS-pixel y of the cell's top-left corner. */
+    y: number;
+    /** Cell width in canvas CSS pixels. */
+    width: number;
+    /** Cell height in canvas CSS pixels. */
+    height: number;
+    row: number;
+    col: number;
+}
+
 declare interface ViewportRange {
     row: number;
     col: number;
@@ -1578,6 +1685,9 @@ export declare namespace xlsx {
         XlsxWorkbook,
         XlsxViewer,
         XlsxViewerOptions,
+        CellAddress,
+        CellRange_2 as CellRange,
+        SelectionMode_2 as SelectionMode,
         autoResize,
         AutoResizeOptions,
         Workbook,
@@ -1596,7 +1706,8 @@ export declare namespace xlsx {
         MergeCell,
         ParsedWorkbook,
         ViewportRange,
-        RenderViewportOptions
+        RenderViewportOptions,
+        TextRunInfo_2 as TextRunInfo
     }
 }
 
@@ -1634,9 +1745,30 @@ declare class XlsxViewer {
     private currentWorksheet;
     private opts;
     private resizeObserver;
+    private anchorCell;
+    private activeCell;
+    private selectionMode;
+    private isSelecting;
+    private selectionOverlay;
+    private keydownHandler;
     constructor(container: HTMLElement, opts?: XlsxViewerOptions);
     load(source: string | ArrayBuffer): Promise<void>;
     showSheet(index: number): Promise<void>;
+    /** Returns the cell at canvas-client coordinates, or null if outside the cell grid. */
+    getCellAt(clientX: number, clientY: number): CellAddress | null;
+    /** Returns the CSS-pixel rect of a cell within canvasArea, or null if not computable. */
+    private getCellRect;
+    /** Returns the current selection, including mode. */
+    get selection(): CellRange_2 | null;
+    /**
+     * Returns what the header area contains at the given client coordinates.
+     * Returns null when the point is in the cell grid (not a header).
+     */
+    private getHeaderHit;
+    /** Copy the selected cell range as tab-separated text to the clipboard. */
+    private copySelection;
+    private updateSelectionOverlay;
+    private setupSelectionEvents;
     private buildTabs;
     private updateTabActive;
     private tabStyle;
@@ -1652,6 +1784,8 @@ declare interface XlsxViewerOptions {
     onReady?: (sheetNames: string[]) => void;
     onSheetChange?: (index: number, name: string) => void;
     onError?: (err: Error) => void;
+    /** Called when the selected cell range changes. null means no selection. */
+    onSelectionChange?: (selection: CellRange_2 | null) => void;
 }
 
 declare class XlsxWorkbook {

package/dist/types/pptx.d.ts

@@ -329,6 +329,8 @@ export declare class PptxPresentation {
  */
 export declare class PptxViewer {
     private readonly canvas;
+    private readonly wrapper;
+    private textLayer;
     private engine;
     private readonly opts;
     private currentSlide;
@@ -345,6 +347,7 @@ export declare class PptxViewer {
     /** The underlying <canvas> element. */
     get canvasElement(): HTMLCanvasElement;
     private renderCurrentSlide;
+    private _buildTextLayer;
     /** Clean up the viewer and terminate the background worker. */
     destroy(): void;
 }
@@ -367,6 +370,11 @@ export declare interface PptxViewerOptions extends RenderOptions {
      * badge over media posters.
      */
     enableMediaPlayback?: boolean;
+    /**
+     * When true, adds a transparent text overlay div over the canvas so the
+     * browser's native text selection works on slide content.
+     */
+    enableTextSelection?: boolean;
 }
 
 export declare interface Presentation {
@@ -412,7 +420,7 @@ export declare interface RenderOptions {
  * Render a single slide onto a <canvas> element.
  * Returns the canvas for convenience.
  */
-export declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: RenderOptions): Promise<HTMLCanvasElement | OffscreenCanvas>;
+export declare function renderSlide(canvas: HTMLCanvasElement | OffscreenCanvas, slide: Slide, slideWidth: number, slideHeight: number, opts?: RenderOptions, onTextRun?: TextRunCallback): Promise<HTMLCanvasElement | OffscreenCanvas>;
 
 /** Options for rendering a single slide onto a canvas. */
 export declare interface RenderSlideOptions {
@@ -420,6 +428,8 @@ export declare interface RenderSlideOptions {
     width?: number;
     /** Device pixel ratio. Defaults to window.devicePixelRatio or 1. */
     dpr?: number;
+    /** Called for each rendered text segment. Used to build a transparent text selection overlay. */
+    onTextRun?: TextRunCallback;
     /**
      * Skip drawing the play badge overlay on media elements. Used internally by
      * {@link PptxPresentation.presentSlide} so its interactive handle can draw
@@ -581,6 +591,8 @@ export declare interface TextBody {
 
 export declare type TextRun = TextRunData | LineBreak;
 
+export declare type TextRunCallback = (run: TextRunInfo) => void;
+
 export declare interface TextRunData {
     type: 'text';
     text: string;
@@ -601,4 +613,34 @@ export declare interface TextRunData {
     fieldType?: string;
 }
 
+/** Information about a rendered text segment for building a transparent selection overlay. */
+export declare interface TextRunInfo {
+    text: string;
+    /** X position in CSS px, relative to the shape's top-left corner. */
+    inShapeX: number;
+    /** Y position (top of line box) in CSS px, relative to the shape's top-left corner. */
+    inShapeY: number;
+    /** Measured text width in CSS px. */
+    w: number;
+    /** Line height in CSS px. */
+    h: number;
+    /** Font size in CSS px. */
+    fontSize: number;
+    /** Shape's left edge in canvas CSS px. */
+    shapeX: number;
+    /** Shape's top edge in canvas CSS px. */
+    shapeY: number;
+    /** Shape's width in canvas CSS px. */
+    shapeW: number;
+    /** Shape's height in canvas CSS px. */
+    shapeH: number;
+    /** Shape rotation in degrees (clockwise). */
+    rotation: number;
+    /**
+     * Additional rotation from a vertical text body (`vert="vert"` → 90,
+     * `vert="vert270"` → -90). The CSS overlay must add this to `rotation`.
+     */
+    textBodyRotation?: number;
+}
+
 export { }

package/dist/types/xlsx.d.ts

@@ -56,7 +56,18 @@ export declare interface Cell {
     formula?: string;
 }
 
-declare interface CellRange {
+export declare interface CellAddress {
+    row: number;
+    col: number;
+}
+
+export declare interface CellRange {
+    anchor: CellAddress;
+    active: CellAddress;
+    mode: SelectionMode_2;
+}
+
+declare interface CellRange_2 {
     top: number;
     left: number;
     bottom: number;
@@ -239,7 +250,7 @@ declare interface ChartData {
 }
 
 declare interface ConditionalFormat {
-    sqref: CellRange[];
+    sqref: CellRange_2[];
     rules: CfRule[];
 }
 
@@ -398,6 +409,8 @@ export declare interface RenderViewportOptions {
     cellScale?: number;
     /** Pre-loaded Image elements keyed by their dataUrl (for ImageAnchor rendering). */
     loadedImages?: Map<string, HTMLImageElement>;
+    /** Called once per cell that contains text, with canvas-pixel position and cell address. */
+    onTextRun?: (info: TextRunInfo) => void;
 }
 
 export declare interface Row {
@@ -421,6 +434,9 @@ declare interface RunFont {
     name?: string | null;
 }
 
+declare type SelectionMode_2 = 'cells' | 'rows' | 'cols' | 'all';
+export { SelectionMode_2 as SelectionMode }
+
 declare interface ShapeAnchor {
     fromCol: number;
     fromColOff: number;
@@ -502,7 +518,7 @@ export declare interface Styles {
 }
 
 declare interface TableInfo {
-    range: CellRange;
+    range: CellRange_2;
     styleName: string;
     headerRowCount: number;
     totalsRowCount: number;
@@ -522,6 +538,21 @@ declare interface TableInfo {
     headerRowDxf?: number;
 }
 
+/** Emitted once per cell that has text, with the cell's canvas-pixel bounds. */
+export declare interface TextRunInfo {
+    text: string;
+    /** Canvas CSS-pixel x of the cell's top-left corner. */
+    x: number;
+    /** Canvas CSS-pixel y of the cell's top-left corner. */
+    y: number;
+    /** Cell width in canvas CSS pixels. */
+    width: number;
+    /** Cell height in canvas CSS pixels. */
+    height: number;
+    row: number;
+    col: number;
+}
+
 export declare interface ViewportRange {
     row: number;
     col: number;
@@ -559,7 +590,7 @@ export declare interface Worksheet {
     /** Sheet tab color (ECMA-376 §18.3.1.79). */
     tabColor?: string | null;
     /** AutoFilter header range (ECMA-376 §18.3.1.2). */
-    autoFilter?: CellRange | null;
+    autoFilter?: CellRange_2 | null;
     /** Hyperlinks in this worksheet (ECMA-376 §18.3.1.47). */
     hyperlinks?: Hyperlink[];
     /** A1-style cell refs of commented cells (ECMA-376 §18.7.3). Rendered as a
@@ -612,9 +643,30 @@ export declare class XlsxViewer {
     private currentWorksheet;
     private opts;
     private resizeObserver;
+    private anchorCell;
+    private activeCell;
+    private selectionMode;
+    private isSelecting;
+    private selectionOverlay;
+    private keydownHandler;
     constructor(container: HTMLElement, opts?: XlsxViewerOptions);
     load(source: string | ArrayBuffer): Promise<void>;
     showSheet(index: number): Promise<void>;
+    /** Returns the cell at canvas-client coordinates, or null if outside the cell grid. */
+    getCellAt(clientX: number, clientY: number): CellAddress | null;
+    /** Returns the CSS-pixel rect of a cell within canvasArea, or null if not computable. */
+    private getCellRect;
+    /** Returns the current selection, including mode. */
+    get selection(): CellRange | null;
+    /**
+     * Returns what the header area contains at the given client coordinates.
+     * Returns null when the point is in the cell grid (not a header).
+     */
+    private getHeaderHit;
+    /** Copy the selected cell range as tab-separated text to the clipboard. */
+    private copySelection;
+    private updateSelectionOverlay;
+    private setupSelectionEvents;
     private buildTabs;
     private updateTabActive;
     private tabStyle;
@@ -630,6 +682,8 @@ export declare interface XlsxViewerOptions {
     onReady?: (sheetNames: string[]) => void;
     onSheetChange?: (index: number, name: string) => void;
     onError?: (err: Error) => void;
+    /** Called when the selected cell range changes. null means no selection. */
+    onSelectionChange?: (selection: CellRange | null) => void;
 }
 
 export declare class XlsxWorkbook {