@silurus/ooxml 0.11.0 → 0.13.0

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';
 } | {
@@ -252,6 +263,36 @@ declare interface ChartData {
     catAxisFontSizeHpt?: number | null;
     /** Value axis tick-label font size in hpt. */
     valAxisFontSizeHpt?: number | null;
+    /** Outer chartSpace background (ECMA-376 §21.2.2.5 `<c:spPr>`). Hex without
+     *  '#' for a solid fill, undefined for `<a:noFill/>` or an absent spPr.
+     *  Combine with `hasChartSpPr` to distinguish explicit-transparent from
+     *  default-opaque-white. */
+    chartBg?: string | null;
+    /** True when the parser saw a `<c:chartSpace><c:spPr>` element. Lets the
+     *  adapter tell "spec said noFill → transparent" from "no spPr → default". */
+    hasChartSpPr?: boolean;
+    /** `<c:legend><c:manualLayout>` fractions of chart space (§21.2.2.31). */
+    legendManualLayout?: LegendManualLayout | null;
+    /** `<c:catAx><c:delete val="1"/>` — hide the category axis (§21.2.2.40). */
+    catAxisHidden?: boolean;
+    /** `<c:valAx><c:delete val="1"/>` — hide the value axis (§21.2.2.40). */
+    valAxisHidden?: boolean;
+    /** `<c:valAx><c:numFmt@formatCode>` — number format for value-axis tick
+     *  labels (ECMA-376 §21.2.2.21). */
+    valAxisFormatCode?: string | null;
+    /** `<c:barChart><c:gapWidth>` — space between category groups as a percent
+     *  of bar width (§21.2.2.13). */
+    barGapWidth?: number | null;
+    /** `<c:barChart><c:overlap>` — signed percent overlap between bars in a
+     *  cluster (§21.2.2.25). Negative = gap. */
+    barOverlap?: number | null;
+    /** `<c:dLbls><c:dLblPos>` — data label position (§21.2.2.16). */
+    dataLabelPosition?: string | null;
+    /** Hex (no `#`) for data label text color, resolved from `<c:dLbls><c:txPr>`. */
+    dataLabelFontColor?: string | null;
+    /** `<c:dLbls><c:numFmt@formatCode>` — chart-level override for data label
+     *  number format (§21.2.2.35). */
+    dataLabelFormatCode?: string | null;
 }
 
 /**
@@ -329,6 +370,12 @@ declare interface ChartSeries {
      * that don't parse markers (e.g. pptx today) keep their existing behavior.
      */
     showMarker?: boolean | null;
+    /**
+     * Excel number-format code for this series' values (ECMA-376 §21.2.2.37,
+     * `<c:val>/<c:numRef>/<c:formatCode>`). Used to format data labels when the
+     * chart-level `<c:dLbls><c:numFmt>` is not set. null = no series-level code.
+     */
+    valFormatCode?: string | null;
 }
 
 declare interface ConditionalFormat {
@@ -435,7 +482,8 @@ export declare namespace docx {
         DocRun,
         TextRun_2 as TextRun,
         ImageRun,
-        RenderPageOptions
+        RenderPageOptions,
+        DocxTextRunInfo
     }
 }
 
@@ -453,29 +501,57 @@ 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 {
     font: Font | null;
     fill: Fill_2 | null;
     border: Border | null;
+    /** Number format override from the dxf (ECMA-376 §18.8.17). When a
+     *  conditional-formatting rule matches, this numFmt replaces the cell's own
+     *  style numFmt for rendering — e.g. switching a calendar cell from `d` to
+     *  `m"月"d"日"` on the first day of each month. */
+    numFmt?: NumFmt | null;
 }
 
 declare interface FieldRun {
@@ -632,6 +708,15 @@ declare interface ImageRun {
     wrapSide?: string;
 }
 
+declare interface LegendManualLayout {
+    xMode: string;
+    yMode: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+
 declare interface LineBreak {
     type: 'break';
 }
@@ -778,6 +863,41 @@ declare type PathCmd = {
 };
 
 declare type PathCmd_2 = {
+    op: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    op: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    op: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x3: number;
+    y3: number;
+} | {
+    op: 'quadBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/** ECMA-376 §20.1.9.3. stAng/swAng in 60000ths of a degree. wr/hr in
+*  the path's own coordinate units. Pen position is the arc start. */
+| {
+    op: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    op: 'close';
+};
+
+declare type PathCmd_3 = {
     cmd: 'moveTo';
     x: number;
     y: number;
@@ -803,6 +923,12 @@ declare type PathCmd_2 = {
     cmd: 'close';
 };
 
+declare interface PathInfo {
+    w: number;
+    h: number;
+    commands: PathCmd_2[];
+}
+
 declare interface PictureElement {
     type: 'picture';
     x: number;
@@ -839,6 +965,8 @@ export declare namespace pptx {
         RenderSlideOptions,
         renderSlide,
         RenderOptions,
+        TextRunInfo,
+        TextRunCallback,
         autoResize,
         AutoResizeOptions,
         Presentation,
@@ -922,6 +1050,8 @@ declare class PptxPresentation {
  */
 declare class PptxViewer {
     private readonly canvas;
+    private readonly wrapper;
+    private textLayer;
     private engine;
     private readonly opts;
     private currentSlide;
@@ -938,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;
 }
@@ -960,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 {
@@ -1006,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 {
@@ -1020,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
@@ -1042,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 {
@@ -1084,6 +1233,8 @@ declare interface SectionProps {
     docGridLinePitch?: number | null;
 }
 
+declare type SelectionMode_2 = 'cells' | 'rows' | 'cols' | 'all';
+
 declare interface Shadow {
     color: string;
     alpha: number;
@@ -1093,6 +1244,18 @@ declare interface Shadow {
     dir: number;
 }
 
+declare interface ShapeAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    shapes: ShapeInfo[];
+}
+
 declare interface ShapeElement {
     type: 'shape';
     x: number;
@@ -1142,6 +1305,36 @@ declare type ShapeFill = {
     gradType: string;
 };
 
+declare type ShapeGeom = {
+    type: 'preset';
+    name: string;
+} | {
+    type: 'custom';
+    paths: PathInfo[];
+}
+/** Bitmap picture leaf inside a `<xdr:grpSp>`. `dataUrl` is a pre-encoded
+*  `data:<mime>;base64,…` produced by the Rust parser from the drawing's
+*  relationship target. */
+| {
+    type: 'image';
+    dataUrl: string;
+};
+
+declare interface ShapeInfo {
+    /** Normalized [0,1] position/size relative to the anchor rect. */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** Rotation in degrees, clockwise. */
+    rot: number;
+    fillColor?: string;
+    strokeColor?: string;
+    /** Stroke width in EMU. 0 = no stroke. */
+    strokeWidth: number;
+    geom: ShapeGeom;
+}
+
 declare interface ShapeRun {
     widthPt: number;
     heightPt: number;
@@ -1156,7 +1349,7 @@ declare interface ShapeRun {
     /** Document-order index within a group; lower values render first. */
     zOrder: number;
     /** Normalized [0,1] custom-geometry sub-paths */
-    subpaths: PathCmd_2[][];
+    subpaths: PathCmd_3[][];
     fill: ShapeFill | null;
     stroke: string | null;
     strokeWidth?: number;
@@ -1175,6 +1368,24 @@ declare interface SheetMeta {
     rId: string;
 }
 
+declare interface SlicerAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    caption: string;
+    items: SlicerItem[];
+}
+
+declare interface SlicerItem {
+    name: string;
+    selected: boolean;
+}
+
 declare interface Slide {
     index: number;
     /** 1-based slide number (index + 1); used to render slidenum fields */
@@ -1346,6 +1557,8 @@ declare interface TextRun_2 {
     highlight?: string | null;
 }
 
+declare type TextRunCallback = (run: TextRunInfo) => void;
+
 declare interface TextRunData {
     type: 'text';
     text: string;
@@ -1366,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;
@@ -1390,6 +1648,10 @@ declare interface Worksheet {
     conditionalFormats: ConditionalFormat[];
     images: ImageAnchor[];
     charts: ChartAnchor[];
+    /** Grouped shapes from `<xdr:grpSp>` inside twoCellAnchors
+     *  (ECMA-376 §20.5.2.17). Each anchor holds leaf shapes pre-flattened
+     *  with normalized [0,1] geometry relative to the anchor rect. */
+    shapeGroups?: ShapeAnchor[];
     /** Whether to display zero values (ECMA-376 §18.3.1.94). Defaults to true. */
     showZeros?: boolean;
     /** Whether to draw default grid lines (ECMA-376 §18.3.1.83
@@ -1412,6 +1674,10 @@ declare interface Worksheet {
     /** Excel Tables on this sheet (ECMA-376 §18.5). The renderer overlays a
      *  built-in style (bold header, banded rows) on the given ranges. */
     tables?: TableInfo[];
+    /** Pivot / table slicers (Office 2010+ extension). Each anchor carries a
+     *  caption and the saved item list (with selection flags) so the renderer
+     *  can draw a static button bank without the live pivot engine. */
+    slicers?: SlicerAnchor[];
 }
 
 export declare namespace xlsx {
@@ -1419,6 +1685,9 @@ export declare namespace xlsx {
         XlsxWorkbook,
         XlsxViewer,
         XlsxViewerOptions,
+        CellAddress,
+        CellRange_2 as CellRange,
+        SelectionMode_2 as SelectionMode,
         autoResize,
         AutoResizeOptions,
         Workbook,
@@ -1437,7 +1706,8 @@ export declare namespace xlsx {
         MergeCell,
         ParsedWorkbook,
         ViewportRange,
-        RenderViewportOptions
+        RenderViewportOptions,
+        TextRunInfo_2 as TextRunInfo
     }
 }
 
@@ -1456,6 +1726,11 @@ declare interface XlsxChartSeries {
     /** Marker visibility resolved from `<c:marker>`/chart-level default
      *  (ECMA-376 §21.2.2.32). */
     showMarker?: boolean;
+    /** `<c:val>/<c:numRef>/<c:formatCode>` — Excel number format for series
+     *  values (ECMA-376 §21.2.2.37). */
+    valFormatCode?: string | null;
+    /** `<c:ser><c:order>` — stacking/legend display order (§21.2.2.28). */
+    order?: number;
 }
 
 declare class XlsxViewer {
@@ -1470,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;
@@ -1488,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

@@ -123,6 +123,12 @@ declare interface ChartSeries {
      * that don't parse markers (e.g. pptx today) keep their existing behavior.
      */
     showMarker?: boolean | null;
+    /**
+     * Excel number-format code for this series' values (ECMA-376 §21.2.2.37,
+     * `<c:val>/<c:numRef>/<c:formatCode>`). Used to format data labels when the
+     * chart-level `<c:dLbls><c:numFmt>` is not set. null = no series-level code.
+     */
+    valFormatCode?: string | null;
 }
 
 export declare type Fill = SolidFill | NoFill | GradientFill;
@@ -323,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;
@@ -339,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;
 }
@@ -361,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 {
@@ -406,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 {
@@ -414,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
@@ -575,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;
@@ -595,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 { }