@silurus/ooxml 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,1172 @@
+declare interface ArrowEnd {
+    /** OOXML type: "none" | "triangle" | "stealth" | "diamond" | "oval" | "arrow" */
+    type: string;
+    /** Width multiplier: "sm" | "med" | "lg" */
+    w: string;
+    /** Length multiplier: "sm" | "med" | "lg" */
+    len: string;
+}
+
+declare type BodyElement = {
+    type: 'paragraph';
+} & DocParagraph | {
+    type: 'table';
+} & DocTable | {
+    type: 'pageBreak';
+};
+
+declare interface Border {
+    left: BorderEdge | null;
+    right: BorderEdge | null;
+    top: BorderEdge | null;
+    bottom: BorderEdge | null;
+    diagonalUp?: BorderEdge | null;
+    diagonalDown?: BorderEdge | null;
+}
+
+declare interface BorderEdge {
+    style: string;
+    color: string | null;
+}
+
+declare interface BorderSpec {
+    width: number;
+    color: string | null;
+    style: string;
+}
+
+declare type Bullet = {
+    type: 'none';
+} | {
+    type: 'inherit';
+} | {
+    type: 'char';
+    char: string;
+    color: string | null;
+    sizePct: number | null;
+    fontFamily: string | null;
+} | {
+    type: 'autoNum';
+    numType: string;
+    startAt: number | null;
+};
+
+declare interface Cell {
+    col: number;
+    row: number;
+    colRef: string;
+    value: CellValue;
+    styleIndex: number;
+}
+
+declare interface CellBorders {
+    top: BorderSpec | null;
+    bottom: BorderSpec | null;
+    left: BorderSpec | null;
+    right: BorderSpec | null;
+}
+
+declare interface CellRange {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+
+declare type CellValue = {
+    type: 'empty';
+} | {
+    type: 'text';
+    text: string;
+    runs?: Run[];
+} | {
+    type: 'number';
+    number: number;
+} | {
+    type: 'bool';
+    bool: boolean;
+} | {
+    type: 'error';
+    error: string;
+};
+
+declare interface CellXf {
+    fontId: number;
+    fillId: number;
+    borderId: number;
+    numFmtId: number;
+    alignH: string | null;
+    alignV: string | null;
+    wrapText: boolean;
+    /** Indentation level (each level ≈ 3 characters, ECMA-376 §18.8.44) */
+    indent?: number;
+    /** Text rotation: 1–90 = counter-clockwise °, 91–180 = (val−90)° clockwise, 255 = stacked */
+    textRotation?: number;
+    shrinkToFit?: boolean;
+}
+
+declare type CfRule = {
+    type: 'cellIs';
+    operator: string;
+    formulas: string[];
+    dxfId: number | null;
+    priority: number;
+} | {
+    type: 'expression';
+    formula: string;
+    dxfId: number | null;
+    priority: number;
+} | {
+    type: 'colorScale';
+    stops: CfStop[];
+    priority: number;
+} | {
+    type: 'dataBar';
+    color: string;
+    min: CfValue;
+    max: CfValue;
+    priority: number;
+} | {
+    type: 'top10';
+    top: boolean;
+    percent: boolean;
+    rank: number;
+    dxfId: number | null;
+    priority: number;
+} | {
+    type: 'aboveAverage';
+    aboveAverage: boolean;
+    dxfId: number | null;
+    priority: number;
+} | {
+    type: 'iconSet';
+    iconSet: string;
+    cfvos: CfValue[];
+    reverse: boolean;
+    priority: number;
+} | {
+    type: 'other';
+    kind: string;
+    priority: number;
+};
+
+declare interface CfStop {
+    kind: string;
+    value: string | null;
+    color: string;
+}
+
+declare interface CfValue {
+    kind: string;
+    value: string | null;
+}
+
+declare interface ChartAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    chart: ChartData;
+}
+
+/**
+ * XLSX parser's raw chart output. Retains parser-native `barDir` + `grouping`
+ * which the renderer combines into a canonical `ChartModel.chartType` (e.g.
+ * `clusteredBarH`, `stackedBarPct`) at render time.
+ */
+declare interface ChartData {
+    /** Primary chart type: "bar"|"line"|"area"|"pie"|"doughnut"|"radar"|"scatter" */
+    chartType: string;
+    /** "col" (vertical bars) | "row" (horizontal bars) */
+    barDir: string;
+    /** "clustered"|"stacked"|"standard"|"percentStacked" */
+    grouping: string;
+    title: string | null;
+    categories: string[];
+    series: XlsxChartSeries[];
+    /** Whether data labels are enabled (c:dLbls showVal/showPercent). */
+    showDataLabels?: boolean;
+    /** Category axis title (c:catAx/c:title). */
+    catAxisTitle?: string | null;
+    /** Value axis title (c:valAx/c:title). */
+    valAxisTitle?: string | null;
+}
+
+/**
+ * PPTX chart element. The Rust parser emits ChartModel fields flat at the
+ * top level, alongside the element position (x/y/width/height in EMU).
+ * Pass this straight to `renderChart` from `@silurus/ooxml-core`.
+ */
+declare interface ChartElement {
+    type: 'chart';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    chartType: string;
+    title: string | null;
+    categories: string[];
+    series: ChartSeries[];
+    valMax: number | null;
+    valMin: number | null;
+    subtotalIndices: number[];
+    showDataLabels: boolean;
+    catAxisHidden: boolean;
+    valAxisHidden: boolean;
+    plotAreaBg: string | null;
+}
+
+declare interface ChartSeries {
+    name: string;
+    /** Hex without '#'. null = fall back to palette. */
+    color: string | null;
+    /** Numeric values; null = missing data point. */
+    values: (number | null)[];
+    /**
+     * Per-data-point colors (pie / doughnut). Hex without '#'. null inside the
+     * array = use palette for that slice. Omit entirely for non-pie series.
+     */
+    dataPointColors?: (string | null)[] | null;
+    /**
+     * Mixed chart: per-series chart type override. Currently only "line" (XLSX)
+     * is honoured; other values are treated as the chart's primary type.
+     */
+    seriesType?: string | null;
+    /**
+     * Scatter-only X values (as strings). When null the series uses
+     * `ChartModel.categories` as X.
+     */
+    categories?: string[] | null;
+}
+
+declare interface ConditionalFormat {
+    sqref: CellRange[];
+    rules: CfRule[];
+}
+
+declare interface DocParagraph {
+    alignment: 'left' | 'center' | 'right' | 'justify';
+    indentLeft: number;
+    indentRight: number;
+    indentFirst: number;
+    spaceBefore: number;
+    spaceAfter: number;
+    lineSpacing: LineSpacing | null;
+    numbering: NumberingInfo | null;
+    tabStops: TabStop_2[];
+    runs: DocRun[];
+    /** Paragraph background hex color (w:shd fill) */
+    shading?: string | null;
+    /** Force a page break before this paragraph (w:pageBreakBefore) */
+    pageBreakBefore?: boolean;
+    /** Suppress spacing between adjacent same-style paragraphs (w:contextualSpacing) */
+    contextualSpacing?: boolean;
+    /** Paragraph borders (w:pBdr) */
+    borders?: ParagraphBorders | null;
+    /** Style ID of the applied paragraph style */
+    styleId?: string | null;
+    /** Default font size (pt) inherited from style + direct pPr/rPr. Falls back to 10pt. */
+    defaultFontSize?: number;
+}
+
+declare type DocRun = {
+    type: 'text';
+} & TextRun_2 | {
+    type: 'image';
+} & ImageRun | {
+    type: 'break';
+    breakType: 'line' | 'page' | 'column';
+} | {
+    type: 'field';
+} & FieldRun;
+
+declare interface DocTable {
+    colWidths: number[];
+    rows: DocTableRow[];
+    borders: TableBorders;
+    cellMarginTop: number;
+    cellMarginBottom: number;
+    cellMarginLeft: number;
+    cellMarginRight: number;
+}
+
+declare interface DocTableCell {
+    content: DocParagraph[];
+    colSpan: number;
+    vMerge: boolean | null;
+    borders: CellBorders;
+    background: string | null;
+    vAlign: 'top' | 'center' | 'bottom';
+    widthPt: number | null;
+}
+
+declare interface DocTableRow {
+    cells: DocTableCell[];
+    rowHeight: number | null;
+    isHeader: boolean;
+}
+
+declare interface Document_2 {
+    section: SectionProps;
+    body: BodyElement[];
+    headers: HeadersFooters;
+    footers: HeadersFooters;
+}
+
+export declare namespace docx {
+    export {
+        DocxDocument,
+        DocxViewer,
+        Document_2 as Document,
+        SectionProps,
+        DocParagraph,
+        DocRun,
+        TextRun_2 as TextRun,
+        ImageRun,
+        RenderPageOptions
+    }
+}
+
+declare class DocxDocument {
+    private _document;
+    private _pages;
+    private _worker;
+    private constructor();
+    static load(source: string | ArrayBuffer): Promise<DocxDocument>;
+    private _parse;
+    destroy(): void;
+    get pageCount(): number;
+    get document(): Document_2;
+    private _getPages;
+    renderPage(target: HTMLCanvasElement | OffscreenCanvas, pageIndex: number, opts?: RenderPageOptions): Promise<void>;
+}
+
+declare class DocxViewer {
+    private _doc;
+    private _currentPage;
+    private _canvas;
+    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;
+    private _render;
+}
+
+declare interface DocxViewerOptions extends RenderPageOptions {
+    container?: HTMLElement;
+}
+
+declare interface Dxf {
+    font: Font | null;
+    fill: Fill_2 | null;
+    border: Border | null;
+}
+
+declare interface FieldRun {
+    /** "page" | "numPages" | "other" */
+    fieldType: string;
+    instruction: string;
+    fallbackText: string;
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    fontSize: number;
+    color: string | null;
+    fontFamily: string | null;
+    background: string | null;
+    vertAlign: 'super' | 'sub' | null;
+    allCaps?: boolean;
+    smallCaps?: boolean;
+    doubleStrikethrough?: boolean;
+    highlight?: string | null;
+}
+
+declare type Fill = SolidFill | NoFill | GradientFill;
+
+declare interface Fill_2 {
+    patternType: string;
+    fgColor: string | null;
+    bgColor: string | null;
+}
+
+declare interface Font {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strike: boolean;
+    size: number;
+    color: string | null;
+    name: string | null;
+}
+
+declare interface GradientFill {
+    fillType: 'gradient';
+    stops: GradientStop[];
+    /** degrees: 0 = left→right, 90 = top→bottom */
+    angle: number;
+    /** 'linear' | 'radial' */
+    gradType: string;
+}
+
+declare interface GradientStop {
+    position: number;
+    color: string;
+}
+
+declare interface HeaderFooter {
+    body: BodyElement[];
+}
+
+declare interface HeadersFooters {
+    default: HeaderFooter | null;
+    first: HeaderFooter | null;
+    even: HeaderFooter | null;
+}
+
+declare interface Hyperlink {
+    col: number;
+    row: number;
+    url: string | null;
+}
+
+/**
+ * Image anchored to a rectangle of cells (EMU offsets within the anchor cells).
+ * 914400 EMU = 1 inch, 9525 EMU = 1 px @ 96 DPI.
+ */
+declare interface ImageAnchor {
+    fromCol: number;
+    fromColOff: number;
+    fromRow: number;
+    fromRowOff: number;
+    toCol: number;
+    toColOff: number;
+    toRow: number;
+    toRowOff: number;
+    /** Data URL (data:image/png;base64,...) */
+    dataUrl: string;
+}
+
+declare interface ImageRun {
+    dataUrl: string;
+    widthPt: number;
+    heightPt: number;
+    /** true = wp:anchor (absolute positioned), false/undefined = wp:inline (flows with text) */
+    anchor?: boolean;
+    /** X offset in pt (anchor only) */
+    anchorXPt?: number;
+    /** Y offset in pt (anchor only) */
+    anchorYPt?: number;
+    /**
+     * If true, anchorXPt is relative to the left margin — add section.marginLeft to get page X.
+     * If false/absent, anchorXPt is already page-absolute.
+     */
+    anchorXFromMargin?: boolean;
+    /**
+     * If true, anchorYPt is relative to the paragraph's top Y in the renderer.
+     * If false/absent, anchorYPt is already page-absolute.
+     */
+    anchorYFromPara?: boolean;
+    /**
+     * When set, the renderer replaces all pixels of this hex color (e.g. "FFFFFF") with full
+     * transparency. Implements a:clrChange (make-background-transparent).
+     */
+    colorReplaceFrom?: string;
+    /**
+     * Wrap mode for anchor images:
+     *   "square" | "topAndBottom" | "none" | "tight" | "through"
+     * Inline images and undetermined cases leave this undefined.
+     * MVP renders "tight" and "through" as "square".
+     */
+    wrapMode?: string;
+    /** Padding top (pt). Anchor-only. */
+    distTop?: number;
+    /** Padding bottom (pt). Anchor-only. */
+    distBottom?: number;
+    /** Padding left (pt). Anchor-only. */
+    distLeft?: number;
+    /** Padding right (pt). Anchor-only. */
+    distRight?: number;
+    /** wrapText attribute: "bothSides" | "left" | "right" | "largest". */
+    wrapSide?: string;
+}
+
+declare interface LineBreak {
+    type: 'break';
+}
+
+declare interface LineSpacing {
+    value: number;
+    rule: 'auto' | 'exact' | 'atLeast';
+}
+
+declare interface MergeCell {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+
+declare interface NoFill {
+    fillType: 'none';
+}
+
+declare interface NumberingInfo {
+    numId: number;
+    level: number;
+    format: string;
+    text: string;
+    indentLeft: number;
+    tab: number;
+}
+
+declare interface NumFmt {
+    numFmtId: number;
+    formatCode: string;
+}
+
+declare interface ParaBorderEdge {
+    style: string;
+    color: string | null;
+    /** pt (sz / 8) */
+    width: number;
+    /** pt spacing between border and text */
+    space: number;
+}
+
+declare interface Paragraph {
+    /** Alignment: "l" | "ctr" | "r" | "just" */
+    alignment: string;
+    /** Left margin in EMU */
+    marL: number;
+    /** Right margin in EMU */
+    marR: number;
+    /** First-line indent in EMU (negative = hanging indent) */
+    indent: number;
+    spaceBefore: number | null;
+    spaceAfter: number | null;
+    spaceLine: SpaceLine | null;
+    /** List nesting level (0–8) */
+    lvl: number;
+    bullet: Bullet;
+    defFontSize: number | null;
+    defColor: string | null;
+    defBold: boolean | null;
+    defItalic: boolean | null;
+    defFontFamily: string | null;
+    /** Tab stops from pPr > tabLst */
+    tabStops: TabStop[];
+    runs: TextRun[];
+}
+
+declare interface ParagraphBorders {
+    top: ParaBorderEdge | null;
+    bottom: ParaBorderEdge | null;
+    left: ParaBorderEdge | null;
+    right: ParaBorderEdge | null;
+    between: ParaBorderEdge | null;
+}
+
+declare interface ParsedWorkbook {
+    workbook: Workbook;
+    styles: Styles;
+    sharedStrings: SharedString[];
+}
+
+declare type PathCmd = {
+    cmd: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    cmd: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    cmd: 'close';
+};
+
+declare interface PictureElement {
+    type: 'picture';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+    flipH: boolean;
+    flipV: boolean;
+    /** Data URL, e.g. "data:image/png;base64,..." */
+    dataUrl: string;
+    /** OOXML adj value (0–100000) for roundRect clip, null = plain rectangle */
+    clipAdjust: number | null;
+    /**
+     * ECMA-376 a:srcRect — source image crop as fractions (0..1) of the source
+     * width/height. Omitted when the image is not cropped.
+     */
+    srcRect?: {
+        l?: number;
+        t?: number;
+        r?: number;
+        b?: number;
+    };
+}
+
+export declare namespace pptx {
+    export {
+        PptxViewer,
+        PptxViewerOptions,
+        PptxPresentation,
+        RenderSlideOptions,
+        renderSlide,
+        RenderOptions,
+        Presentation,
+        Slide,
+        SlideElement,
+        ShapeElement,
+        PictureElement,
+        Fill,
+        SolidFill,
+        NoFill,
+        Stroke,
+        TextBody,
+        Paragraph,
+        TextRun,
+        TextRunData,
+        LineBreak
+    }
+}
+
+/**
+ * Headless PPTX rendering engine.
+ *
+ * Parses `.pptx` archives in a background worker (WASM) but renders slides
+ * synchronously on the main thread, so the canvas shares the document's
+ * `FontFaceSet` — avoiding subtle wrap differences between system fallback
+ * fonts and theme-declared webfonts (e.g. Nunito Sans).
+ *
+ * Construct via the static `load` factory. A single instance can drive any
+ * number of canvases (scroll view, thumbnail grid, master-detail, etc.).
+ *
+ * @example
+ * const pres = await PptxPresentation.load(buffer);
+ * await pres.renderSlide(canvas, 0, { width: 960 });
+ */
+declare class PptxPresentation {
+    private readonly _worker;
+    private _presentation;
+    private _pendingParseCallbacks;
+    private _nextId;
+    private _workerReady;
+    private _workerReadyCallbacks;
+    private constructor();
+    /** Parse a PPTX from URL or ArrayBuffer. */
+    static load(source: string | ArrayBuffer): Promise<PptxPresentation>;
+    private _waitForWorker;
+    private _parse;
+    /** Total number of slides in the loaded presentation. */
+    get slideCount(): number;
+    /** Slide width in EMU. */
+    get slideWidth(): number;
+    /** Slide height in EMU. */
+    get slideHeight(): number;
+    /** Render a slide onto the given canvas. */
+    renderSlide(canvas: HTMLCanvasElement, slideIndex: number, opts?: RenderSlideOptions): Promise<void>;
+    /** Terminate the worker and release all resources. */
+    destroy(): void;
+}
+
+/**
+ * Opinionated single-canvas PPTX viewer.
+ *
+ * Creates a <canvas> element, appends it to the provided container, and manages
+ * slide navigation.
+ *
+ * For custom layouts (multi-canvas, thumbnails, scroll view) use PptxPresentation directly.
+ */
+declare class PptxViewer {
+    private readonly canvas;
+    private engine;
+    private readonly opts;
+    private currentSlide;
+    constructor(container: HTMLElement, opts?: PptxViewerOptions);
+    /** Load a PPTX from URL or ArrayBuffer and render the first slide. */
+    load(source: string | ArrayBuffer): Promise<void>;
+    /** Navigate to a specific slide (0-indexed). */
+    goToSlide(index: number): Promise<void>;
+    nextSlide(): Promise<void>;
+    prevSlide(): Promise<void>;
+    get slideIndex(): number;
+    get slideCount(): number;
+    /** The underlying <canvas> element. */
+    get canvasElement(): HTMLCanvasElement;
+    private renderCurrentSlide;
+    /** Clean up the viewer and terminate the background worker. */
+    destroy(): void;
+}
+
+declare interface PptxViewerOptions extends RenderOptions {
+    /** Called when a slide finishes rendering */
+    onSlideChange?: (index: number, total: number) => void;
+    /** Called on parse or render errors */
+    onError?: (err: Error) => void;
+}
+
+declare interface Presentation {
+    slideWidth: number;
+    slideHeight: number;
+    slides: Slide[];
+    /** Theme dk1 color (e.g. "383838"). Used as fallback text color when no explicit color is set. */
+    defaultTextColor: string | null;
+    /** Theme major (heading) font family name (e.g. "Aptos Display", "Nunito Sans"). Null if not set. */
+    majorFont: string | null;
+    /** Theme minor (body) font family name (e.g. "Aptos", "Nunito Sans"). Null if not set. */
+    minorFont: string | null;
+}
+
+declare interface RenderOptions {
+    width?: number;
+    defaultTextColor?: string | null;
+    dpr?: number;
+    majorFont?: string | null;
+    minorFont?: string | null;
+}
+
+declare interface RenderPageOptions {
+    /** Canvas CSS width in px; height is auto-computed from page aspect ratio */
+    width?: number;
+    dpr?: number;
+    defaultTextColor?: string;
+}
+
+/**
+ * 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>;
+
+/** Options for rendering a single slide onto a canvas. */
+declare interface RenderSlideOptions {
+    /** Display width in CSS pixels. Defaults to canvas.offsetWidth or 960. */
+    width?: number;
+    /** Device pixel ratio. Defaults to window.devicePixelRatio or 1. */
+    dpr?: number;
+}
+
+declare interface RenderViewportOptions {
+    width?: number;
+    height?: number;
+    dpr?: number;
+    defaultFontFamily?: string;
+    defaultFontSize?: number;
+    scrollOffsetX?: number;
+    scrollOffsetY?: number;
+    freezeRows?: number;
+    freezeCols?: number;
+    /** Scale factor applied to all cell/header dimensions (default 1). */
+    cellScale?: number;
+    /** Pre-loaded Image elements keyed by their dataUrl (for ImageAnchor rendering). */
+    loadedImages?: Map<string, HTMLImageElement>;
+}
+
+declare interface Row {
+    index: number;
+    height: number | null;
+    cells: Cell[];
+}
+
+declare interface Run {
+    text: string;
+    font?: RunFont;
+}
+
+declare interface RunFont {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strike: boolean;
+    size?: number;
+    color?: string | null;
+    name?: string | null;
+}
+
+declare interface SectionProps {
+    pageWidth: number;
+    pageHeight: number;
+    marginTop: number;
+    marginRight: number;
+    marginBottom: number;
+    marginLeft: number;
+    headerDistance: number;
+    footerDistance: number;
+    titlePage: boolean;
+    evenAndOddHeaders: boolean;
+}
+
+declare interface Shadow {
+    color: string;
+    alpha: number;
+    blur: number;
+    dist: number;
+    /** degrees clockwise from East */
+    dir: number;
+}
+
+declare interface ShapeElement {
+    type: 'shape';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Rotation in degrees, clockwise */
+    rotation: number;
+    /** Horizontal mirror (a:xfrm flipH) */
+    flipH: boolean;
+    /** Vertical mirror (a:xfrm flipV) */
+    flipV: boolean;
+    /** OOXML preset name or "custGeom" when custom paths are used */
+    geometry: string;
+    fill: Fill | null;
+    stroke: Stroke | null;
+    textBody: TextBody | null;
+    /** Default text color from p:style > fontRef (hex). Used when run/para has no explicit color. */
+    defaultTextColor: string | null;
+    /** Custom geometry sub-paths (set only when geometry === "custGeom").
+     *  Outer array: one entry per <a:path>; inner: path commands with coords in [0,1]. */
+    custGeom: PathCmd[][] | null;
+    /** First adjustment value from prstGeom avLst (e.g. trapezoid inset). Range 0–100000. */
+    adj: number | null;
+    /** Second adjustment value from prstGeom avLst (e.g. arrow head width). Range 0–100000. */
+    adj2: number | null;
+    /** Third adjustment value from prstGeom avLst (e.g. callout tip x). Range 0–100000. */
+    adj3: number | null;
+    /** Fourth adjustment value from prstGeom avLst (e.g. callout tip y). Range 0–100000. */
+    adj4: number | null;
+    /** Drop shadow from effectLst > outerShdw (null if not present). */
+    shadow: Shadow | null;
+}
+
+declare interface SharedString {
+    text: string;
+    runs?: Run[];
+}
+
+declare interface SheetMeta {
+    name: string;
+    sheetId: number;
+    rId: string;
+}
+
+declare interface Slide {
+    index: number;
+    /** 1-based slide number (index + 1); used to render slidenum fields */
+    slideNumber: number;
+    background: Fill | null;
+    elements: SlideElement[];
+}
+
+declare type SlideElement = ShapeElement | PictureElement | TableElement | ChartElement;
+
+declare interface SolidFill {
+    fillType: 'solid';
+    color: string;
+}
+
+declare type SpaceLine = {
+    type: 'pct';
+    val: number;
+} | {
+    type: 'pts';
+    val: number;
+};
+
+declare interface Stroke {
+    color: string;
+    /** Width in EMU */
+    width: number;
+    /** OOXML prstDash value: "dash", "dot", "dashDot", "lgDash", "lgDashDot", etc. */
+    dashStyle?: string;
+    /** Arrow head at the start of the line */
+    headEnd?: ArrowEnd;
+    /** Arrow head at the end of the line */
+    tailEnd?: ArrowEnd;
+}
+
+declare interface Styles {
+    fonts: Font[];
+    fills: Fill_2[];
+    borders: Border[];
+    cellXfs: CellXf[];
+    numFmts: NumFmt[];
+    dxfs: Dxf[];
+}
+
+declare interface TableBorders {
+    top: BorderSpec | null;
+    bottom: BorderSpec | null;
+    left: BorderSpec | null;
+    right: BorderSpec | null;
+    insideH: BorderSpec | null;
+    insideV: BorderSpec | null;
+}
+
+declare interface TableCell {
+    textBody: TextBody | null;
+    fill: Fill | null;
+    borderL: Stroke | null;
+    borderR: Stroke | null;
+    borderT: Stroke | null;
+    borderB: Stroke | null;
+    /** Diagonal from top-left to bottom-right */
+    diagonalTL?: Stroke | null;
+    /** Diagonal from top-right to bottom-left */
+    diagonalTR?: Stroke | null;
+    /** Column span */
+    gridSpan: number;
+    /** Row span */
+    rowSpan: number;
+    /** Horizontal merge continuation */
+    hMerge: boolean;
+    /** Vertical merge continuation */
+    vMerge: boolean;
+}
+
+declare interface TableElement {
+    type: 'table';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Column widths in EMU */
+    cols: number[];
+    rows: TableRow[];
+}
+
+declare interface TableRow {
+    /** Row height in EMU */
+    height: number;
+    cells: TableCell[];
+}
+
+declare interface TabStop {
+    /** Position in EMU from the left edge of the text area (after lIns) */
+    pos: number;
+    /** Alignment: "l" | "r" | "ctr" | "dec" */
+    algn: string;
+}
+
+declare interface TabStop_2 {
+    /** tab stop position in pt (from the left of paragraph content area) */
+    pos: number;
+    alignment: 'left' | 'center' | 'right' | 'decimal' | 'bar' | 'clear';
+    leader: 'none' | 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
+}
+
+declare interface TextBody {
+    /** Vertical anchor: "t" | "ctr" | "b" */
+    verticalAnchor: string;
+    paragraphs: Paragraph[];
+    /** Default pt size from lstStyle (overrides renderer default when present) */
+    defaultFontSize: number | null;
+    /** Inherited bold from layout/master defRPr (null = not set, use false as final default) */
+    defaultBold: boolean | null;
+    /** Inherited italic from layout/master defRPr (null = not set, use false as final default) */
+    defaultItalic: boolean | null;
+    /** Text insets in EMU (defaults: lIns=rIns=91440, tIns=bIns=45720) */
+    lIns: number;
+    rIns: number;
+    tIns: number;
+    bIns: number;
+    /** "square" = wrap, "none" = no wrap */
+    wrap: string;
+    /** Text direction: "horz" | "vert" | "vert270" | "eaVert" etc. */
+    vert: string;
+    /** Auto-fit: "sp" = shape grows to fit text, "norm" = font shrinks, "none" = no fit */
+    autoFit: string;
+}
+
+declare type TextRun = TextRunData | LineBreak;
+
+declare interface TextRun_2 {
+    text: string;
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    fontSize: number;
+    color: string | null;
+    fontFamily: string | null;
+    isLink: boolean;
+    background: string | null;
+    vertAlign: 'super' | 'sub' | null;
+    /** Target URL for hyperlinks (resolved from relationships.xml) */
+    hyperlink: string | null;
+    allCaps?: boolean;
+    smallCaps?: boolean;
+    doubleStrikethrough?: boolean;
+    highlight?: string | null;
+}
+
+declare interface TextRunData {
+    type: 'text';
+    text: string;
+    /** null = not set, inherit from paragraph/body defaults */
+    bold: boolean | null;
+    /** null = not set, inherit from paragraph/body defaults */
+    italic: boolean | null;
+    underline: boolean;
+    /** true when rPr strike = "sngStrike" or "dblStrike" */
+    strikethrough: boolean;
+    /** Font size in points */
+    fontSize: number | null;
+    color: string | null;
+    fontFamily: string | null;
+    /** Baseline shift in thousandths of a point. Positive = superscript, negative = subscript. */
+    baseline?: number;
+    /** Set for OOXML field runs (e.g. "slidenum"). When set, renderer replaces text with field value. */
+    fieldType?: string;
+}
+
+declare interface ViewportRange {
+    row: number;
+    col: number;
+    rows: number;
+    cols: number;
+}
+
+declare interface Workbook {
+    sheets: SheetMeta[];
+}
+
+declare interface Worksheet {
+    name: string;
+    rows: Row[];
+    colWidths: Record<number, number>;
+    rowHeights: Record<number, number>;
+    defaultColWidth: number;
+    defaultRowHeight: number;
+    mergeCells: MergeCell[];
+    freezeRows: number;
+    freezeCols: number;
+    conditionalFormats: ConditionalFormat[];
+    images: ImageAnchor[];
+    charts: ChartAnchor[];
+    /** Whether to display zero values (ECMA-376 §18.3.1.94). Defaults to true. */
+    showZeros?: boolean;
+    /** Sheet tab color (ECMA-376 §18.3.1.79). */
+    tabColor?: string | null;
+    /** AutoFilter header range (ECMA-376 §18.3.1.2). */
+    autoFilter?: CellRange | null;
+    /** Hyperlinks in this worksheet (ECMA-376 §18.3.1.47). */
+    hyperlinks?: Hyperlink[];
+}
+
+export declare namespace xlsx {
+    export {
+        XlsxWorkbook,
+        XlsxViewer,
+        XlsxViewerOptions,
+        Workbook,
+        SheetMeta,
+        Worksheet,
+        Row,
+        Cell,
+        CellValue,
+        Styles,
+        Font,
+        Fill_2 as Fill,
+        Border,
+        BorderEdge,
+        CellXf,
+        NumFmt,
+        MergeCell,
+        ParsedWorkbook,
+        ViewportRange,
+        RenderViewportOptions
+    }
+}
+
+/**
+ * XLSX parser's raw chart series (includes XLSX-only `seriesType` for mixed
+ * charts). Adapted to `ChartSeries` from @silurus/ooxml-core before rendering.
+ */
+declare interface XlsxChartSeries {
+    name: string;
+    /** Chart sub-type for this series (allows mixed charts). */
+    seriesType: string;
+    categories: string[];
+    values: (number | null)[];
+    /** Explicit fill color hex (from c:spPr). Undefined = use palette. */
+    color?: string | null;
+}
+
+declare class XlsxViewer {
+    private wb;
+    private canvas;
+    private canvasArea;
+    private scrollHost;
+    private spacer;
+    private tabBar;
+    private tabs;
+    private currentSheet;
+    private currentWorksheet;
+    private opts;
+    private resizeObserver;
+    constructor(container: HTMLElement, opts?: XlsxViewerOptions);
+    load(source: string | ArrayBuffer): Promise<void>;
+    showSheet(index: number): Promise<void>;
+    private buildTabs;
+    private updateTabActive;
+    private tabStyle;
+    private updateSpacerSize;
+    private renderCurrentSheet;
+    get sheetNames(): string[];
+    destroy(): void;
+}
+
+declare interface XlsxViewerOptions {
+    /** Scale factor for cell/header dimensions (default 1). 0.5 = half size. */
+    cellScale?: number;
+    onReady?: (sheetNames: string[]) => void;
+    onSheetChange?: (index: number, name: string) => void;
+    onError?: (err: Error) => void;
+}
+
+declare class XlsxWorkbook {
+    private worker;
+    private parsedWorkbook;
+    private sheetCache;
+    /** Cache of loaded images keyed by their data URL. Shared across sheets. */
+    private imageCache;
+    private rawData;
+    constructor();
+    load(source: string | ArrayBuffer): Promise<void>;
+    get sheetNames(): string[];
+    get sheetCount(): number;
+    getWorksheet(sheetIndex: number): Promise<Worksheet>;
+    renderViewport(target: HTMLCanvasElement | OffscreenCanvas, sheetIndex: number, viewport: ViewportRange, opts?: RenderViewportOptions): Promise<void>;
+    destroy(): void;
+    private sendMessage;
+}
+
+export { }