@silurus/ooxml 0.27.0 → 0.29.0

package/dist/types/pptx.d.ts

@@ -222,7 +222,15 @@ declare interface ChartSeriesDataLabels {
     fontSizeHpt?: number;
 }
 
-export declare type Fill = SolidFill | NoFill | GradientFill;
+export declare type Fill = SolidFill | NoFill | GradientFill | PatternFill;
+
+/** ECMA-376 §20.1.8.17 (CT_GlowEffect) — coloured halo with blur radius. */
+declare interface Glow {
+    color: string;
+    alpha: number;
+    /** Blur radius in EMU. */
+    radius: number;
+}
 
 declare interface GradientFill {
     fillType: 'gradient';
@@ -341,6 +349,20 @@ declare type PathCmd = {
     cmd: 'close';
 };
 
+/**
+ * Preset pattern fill — ECMA-376 §20.1.8.40 (CT_PatternFillProperties)
+ * with `preset` drawn from §20.1.10.59 (ST_PresetPatternVal).
+ */
+declare interface PatternFill {
+    fillType: 'pattern';
+    /** Foreground hex colour — used for the "1" pixels of the preset bitmap. */
+    fg: string;
+    /** Background hex colour — used for the "0" pixels. */
+    bg: string;
+    /** Preset name, e.g. "pct25", "horz", "diagCross", "lgGrid". */
+    preset: string;
+}
+
 export declare interface PictureElement {
     type: 'picture';
     x: number;
@@ -492,6 +514,10 @@ export declare interface Presentation {
     majorFont: string | null;
     /** Theme minor (body) font family name (e.g. "Aptos", "Nunito Sans"). Null if not set. */
     minorFont: string | null;
+    /** Theme hyperlink colour (hex 6 chars). Used to colour hyperlink runs that have no explicit colour. */
+    hlinkColor?: string;
+    /** Theme followed-hyperlink colour. Reserved for future visited-link styling. */
+    folHlinkColor?: string;
 }
 
 declare interface PresentationHandle {
@@ -500,12 +526,36 @@ declare interface PresentationHandle {
     dispose(): void;
 }
 
+/** ECMA-376 §20.1.8.27 (CT_ReflectionEffect) — mirrored copy below the
+ *  shape with a linear alpha gradient. Carries the spec attributes whose
+ *  defaults the renderer needs to interpret correctly. */
+declare interface Reflection {
+    blur: number;
+    dist: number;
+    /** Direction in degrees, clockwise from East. */
+    dir: number;
+    /** Start alpha (0–1). Default 1.0. */
+    stA: number;
+    /** Start position along the gradient (0–1). Default 0. */
+    stPos: number;
+    /** End alpha. Default 0. */
+    endA: number;
+    /** End position. Default 1.0. */
+    endPos: number;
+    /** Horizontal scale (1.0 = same width). */
+    sx: number;
+    /** Vertical scale (-1.0 = full mirror). */
+    sy: number;
+}
+
 export declare interface RenderOptions {
     width?: number;
     defaultTextColor?: string | null;
     dpr?: number;
     majorFont?: string | null;
     minorFont?: string | null;
+    /** Theme hyperlink colour (hex 6 chars). Used to colour hyperlink runs without an explicit colour. */
+    hlinkColor?: string | null;
     /**
      * Lazily resolve an archive-internal asset (by zip path) to a Blob. The
      * renderer uses this to fetch posters and other large embedded assets on
@@ -589,6 +639,14 @@ export declare interface ShapeElement {
     adj8: number | null;
     /** Drop shadow from effectLst > outerShdw (null if not present). */
     shadow: Shadow | null;
+    /** Inner (inset) shadow from effectLst > innerShdw. ECMA-376 §20.1.8.21. */
+    innerShadow?: Shadow;
+    /** Coloured glow halo from effectLst > glow. ECMA-376 §20.1.8.17. */
+    glow?: Glow;
+    /** Soft (feathered) edge — ECMA-376 §20.1.8.31. */
+    softEdge?: SoftEdge;
+    /** Mirrored reflection — ECMA-376 §20.1.8.27. */
+    reflection?: Reflection;
 }
 
 export declare interface Slide {
@@ -601,6 +659,11 @@ export declare interface Slide {
 
 export declare type SlideElement = ShapeElement | PictureElement | TableElement | ChartElement | MediaElement;
 
+/** ECMA-376 §20.1.8.31 (CT_SoftEdgesEffect) — feather radius in EMU. */
+declare interface SoftEdge {
+    radius: number;
+}
+
 export declare interface SolidFill {
     fillType: 'solid';
     color: string;
@@ -624,6 +687,11 @@ export declare interface Stroke {
     headEnd?: ArrowEnd;
     /** Arrow head at the end of the line */
     tailEnd?: ArrowEnd;
+    /**
+     * ECMA-376 §20.1.8.42 ST_CompoundLine. "sng" (default) | "dbl" |
+     * "thinThick" | "thickThin" | "tri". Absent means single line.
+     */
+    cmpd?: string;
 }
 
 declare interface TableCell {
@@ -706,16 +774,58 @@ export declare interface TextRunData {
     /** null = not set, inherit from paragraph/body defaults */
     italic: boolean | null;
     underline: boolean;
-    /** true when rPr strike = "sngStrike" or "dblStrike" */
+    /**
+     * Specific underline style when not the default single line. Values come
+     * from ECMA-376 §21.1.2.3.16 (ST_TextUnderlineType): "dbl", "heavy",
+     * "dotted", "dottedHeavy", "dash", "dashHeavy", "dashLong",
+     * "dashLongHeavy", "dotDash", "dotDashHeavy", "dotDotDash",
+     * "dotDotDashHeavy", "wavy", "wavyHeavy", "wavyDbl". Absent means either
+     * no underline (when `underline` is false) or the default single line.
+     */
+    underlineStyle?: string;
+    /**
+     * Underline-only colour from rPr > uFill (ECMA-376 §21.1.2.3.20). Absent
+     * means the underline follows the text colour (uFillTx default).
+     */
+    underlineColor?: string;
+    /** True when rPr strike is sngStrike or dblStrike. */
     strikethrough: boolean;
+    /**
+     * True only when rPr strike = "dblStrike". Lets the renderer draw two parallel
+     * lines instead of one. ECMA-376 §21.1.2.3.10 (ST_TextStrikeType).
+     */
+    strikeDouble?: boolean;
     /** Font size in points */
     fontSize: number | null;
     color: string | null;
     fontFamily: string | null;
+    /**
+     * East Asian font family from rPr > a:ea (ECMA-376 §21.1.2.3.7),
+     * resolved through the theme. Renderer uses this for CJK glyphs when
+     * present; absent means CJK falls back to fontFamily.
+     */
+    fontFamilyEa?: string;
     /** Baseline shift in thousandths of a point. Positive = superscript, negative = subscript. */
     baseline?: number;
+    /**
+     * Capitalisation transform — ECMA-376 §21.1.2.3.13 (ST_TextCapsType).
+     * 'all' renders text in upper case; 'small' uses small caps (rendered as
+     * upper case at ~80% size when no smcp font feature is available).
+     * 'none' or omitted leaves the text unchanged.
+     */
+    caps?: 'none' | 'small' | 'all';
+    /**
+     * Inter-character spacing in 100ths of a point — ECMA-376 §21.1.2.3.5
+     * (rPr @spc). Positive values add space, negative values tighten.
+     */
+    letterSpacing?: number;
     /** Set for OOXML field runs (e.g. "slidenum"). When set, renderer replaces text with field value. */
     fieldType?: string;
+    /**
+     * Hyperlink target URL resolved from rPr > a:hlinkClick @r:id via the slide's _rels.
+     * Undefined for runs without a hyperlink. ECMA-376 §21.1.2.3.5 (CT_Hyperlink).
+     */
+    hyperlink?: string;
 }
 
 /** Information about a rendered text segment for building a transparent selection overlay. */

package/dist/types/xlsx.d.ts

@@ -360,6 +360,10 @@ export declare interface Font {
     size: number;
     color: string | null;
     name: string | null;
+    /** ECMA-376 §18.4.13 ST_UnderlineValues — see RunFont.underlineStyle. */
+    underlineStyle?: string;
+    /** ECMA-376 §18.4.6 ST_VerticalAlignRun on a cell-level <font>. */
+    vertAlign?: 'superscript' | 'subscript';
 }
 
 declare interface GradientFillSpec {
@@ -542,6 +546,17 @@ declare interface RunFont {
     size?: number;
     color?: string | null;
     name?: string | null;
+    /**
+     * Underline style when not the default single line. ECMA-376 §18.4.13
+     * (`ST_UnderlineValues`): "double" | "singleAccounting" | "doubleAccounting".
+     * Absent means single (when `underline` is true) or no underline.
+     */
+    underlineStyle?: string;
+    /**
+     * ECMA-376 §18.4.6 (`ST_VerticalAlignRun`): "superscript" | "subscript".
+     * Absent leaves the run on the baseline.
+     */
+    vertAlign?: 'superscript' | 'subscript';
 }
 
 declare type SelectionMode_2 = 'cells' | 'rows' | 'cols' | 'all';
@@ -898,7 +913,12 @@ export declare class XlsxViewer {
     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. */
+    /** Returns the CSS-pixel rect of a cell within canvasArea, or null if not
+     *  computable. Mirrors the renderer's per-cell rounding (Math.round(px * cs))
+     *  so the selection overlay sits exactly on the canvas's drawn cell borders;
+     *  multiplying logical accumulators by `cs` once at the end (the previous
+     *  approach) drifted by up to 1 px per cell at non-integer scales.
+     */
     private getCellRect;
     /** Returns the current selection, including mode. */
     get selection(): CellRange | null;