@silurus/ooxml 0.4.0 → 0.6.0

package/dist/types/index.d.ts

@@ -219,6 +219,14 @@ declare interface ChartData {
     catAxisTitle?: string | null;
     /** Value axis title (c:valAx/c:title). */
     valAxisTitle?: string | null;
+    /** True when <c:legend> is present. Absence means the legend is hidden. */
+    showLegend?: boolean;
+    /** Chart title font size in OOXML hundredths of a point (e.g. 1400 = 14pt). */
+    titleFontSizeHpt?: number | null;
+    /** Chart title font color as a hex string without '#' (srgbClr only). */
+    titleFontColor?: string | null;
+    /** Chart title font family from `<a:latin typeface>` (ECMA-376 §20.1.4.2.24). */
+    titleFontFace?: string | null;
 }
 
 /**
@@ -255,6 +263,10 @@ declare interface ChartElement {
     catAxisMajorTickMark: 'cross' | 'out' | 'in' | 'none' | string;
     /** Title font size in OOXML hundredths of a point (1600 = 16pt). null = default. */
     titleFontSizeHpt: number | null;
+    /** Title font color as a hex string without '#'. null = default/theme. */
+    titleFontColor?: string | null;
+    /** Title font family (`<a:latin typeface>`). null = default/theme. */
+    titleFontFace?: string | null;
     /** `<c:catAx><c:txPr>` font size (hpt). null = proportional default. */
     catAxisFontSizeHpt: number | null;
     /** `<c:valAx><c:txPr>` font size (hpt). null = proportional default. */
@@ -454,6 +466,8 @@ declare interface Fill_2 {
     patternType: string;
     fgColor: string | null;
     bgColor: string | null;
+    /** Set when the style's `<fill>` was a `<gradientFill>`; patternType stays "none". */
+    gradient?: GradientFillSpec | null;
 }
 
 declare interface Font {
@@ -475,6 +489,22 @@ declare interface GradientFill {
     gradType: string;
 }
 
+declare interface GradientFillSpec {
+    /** "linear" (default) or "path". */
+    gradientType: string;
+    /** Rotation in degrees for linear gradients (0 = left→right). */
+    degree: number;
+    /** Path-gradient bounding box (0..1) — unused for linear. */
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    stops: {
+        position: number;
+        color: string;
+    }[];
+}
+
 declare interface GradientStop {
     position: number;
     color: string;
@@ -571,6 +601,11 @@ declare interface LineBreak {
 declare interface LineSpacing {
     value: number;
     rule: 'auto' | 'exact' | 'atLeast';
+    /** True when `w:spacing/@w:line` was set on the paragraph's own pPr or on a
+     *  named style (not inherited solely from docDefault). Per ECMA-376 §17.6.5,
+     *  an inherited-only paragraph in a docGrid section snaps to one grid pitch
+     *  per line, ignoring the multiplier. Defaults to false on JSON parse. */
+    explicit?: boolean;
 }
 
 /** Options for {@link PptxPresentation.load}. */
@@ -852,6 +887,7 @@ declare class PptxViewer {
     private engine;
     private readonly opts;
     private currentSlide;
+    private handle;
     constructor(container: HTMLElement, opts?: PptxViewerOptions);
     /** Load a PPTX from URL or ArrayBuffer and render the first slide. */
     load(source: string | ArrayBuffer): Promise<void>;
@@ -878,6 +914,14 @@ declare interface PptxViewerOptions extends RenderOptions {
      * default — see {@link PptxPresentation.load} for privacy implications.
      */
     useGoogleFonts?: boolean;
+    /**
+     * Enable interactive audio/video playback. When true, slides are rendered
+     * via {@link PptxPresentation.presentSlide} so media elements become
+     * clickable and the viewer draws its own play/pause chrome. When false
+     * (default) the viewer renders a static slide with a non-interactive play
+     * badge over media posters.
+     */
+    enableMediaPlayback?: boolean;
 }
 
 declare interface Presentation {
@@ -994,6 +1038,12 @@ declare interface SectionProps {
     footerDistance: number;
     titlePage: boolean;
     evenAndOddHeaders: boolean;
+    /** ECMA-376 §17.6.5 w:docGrid/@w:type — "default" | "lines" | "linesAndChars" | "snapToChars". */
+    docGridType?: string | null;
+    /** ECMA-376 §17.6.5 w:docGrid/@w:linePitch in pt. When docGridType is "lines" or
+     *  "linesAndChars", auto line spacing multiplies against this pitch instead of
+     *  the font's natural line height. */
+    docGridLinePitch?: number | null;
 }
 
 declare interface Shadow {
@@ -1284,6 +1334,9 @@ declare interface Worksheet {
     autoFilter?: CellRange | 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
+     *  small red triangle in each cell's top-right corner. */
+    commentRefs?: string[];
 }
 
 export declare namespace xlsx {

package/dist/types/pptx.d.ts

@@ -82,6 +82,10 @@ declare interface ChartElement {
     catAxisMajorTickMark: 'cross' | 'out' | 'in' | 'none' | string;
     /** Title font size in OOXML hundredths of a point (1600 = 16pt). null = default. */
     titleFontSizeHpt: number | null;
+    /** Title font color as a hex string without '#'. null = default/theme. */
+    titleFontColor?: string | null;
+    /** Title font family (`<a:latin typeface>`). null = default/theme. */
+    titleFontFace?: string | null;
     /** `<c:catAx><c:txPr>` font size (hpt). null = proportional default. */
     catAxisFontSizeHpt: number | null;
     /** `<c:valAx><c:txPr>` font size (hpt). null = proportional default. */
@@ -314,6 +318,7 @@ export declare class PptxViewer {
     private engine;
     private readonly opts;
     private currentSlide;
+    private handle;
     constructor(container: HTMLElement, opts?: PptxViewerOptions);
     /** Load a PPTX from URL or ArrayBuffer and render the first slide. */
     load(source: string | ArrayBuffer): Promise<void>;
@@ -340,6 +345,14 @@ export declare interface PptxViewerOptions extends RenderOptions {
      * default — see {@link PptxPresentation.load} for privacy implications.
      */
     useGoogleFonts?: boolean;
+    /**
+     * Enable interactive audio/video playback. When true, slides are rendered
+     * via {@link PptxPresentation.presentSlide} so media elements become
+     * clickable and the viewer draws its own play/pause chrome. When false
+     * (default) the viewer renders a static slide with a non-interactive play
+     * badge over media posters.
+     */
+    enableMediaPlayback?: boolean;
 }
 
 export declare interface Presentation {

package/dist/types/xlsx.d.ts

@@ -173,6 +173,14 @@ declare interface ChartData {
     catAxisTitle?: string | null;
     /** Value axis title (c:valAx/c:title). */
     valAxisTitle?: string | null;
+    /** True when <c:legend> is present. Absence means the legend is hidden. */
+    showLegend?: boolean;
+    /** Chart title font size in OOXML hundredths of a point (e.g. 1400 = 14pt). */
+    titleFontSizeHpt?: number | null;
+    /** Chart title font color as a hex string without '#' (srgbClr only). */
+    titleFontColor?: string | null;
+    /** Chart title font family from `<a:latin typeface>` (ECMA-376 §20.1.4.2.24). */
+    titleFontFace?: string | null;
 }
 
 declare interface ConditionalFormat {
@@ -190,6 +198,8 @@ export declare interface Fill {
     patternType: string;
     fgColor: string | null;
     bgColor: string | null;
+    /** Set when the style's `<fill>` was a `<gradientFill>`; patternType stays "none". */
+    gradient?: GradientFillSpec | null;
 }
 
 export declare interface Font {
@@ -202,6 +212,22 @@ export declare interface Font {
     name: string | null;
 }
 
+declare interface GradientFillSpec {
+    /** "linear" (default) or "path". */
+    gradientType: string;
+    /** Rotation in degrees for linear gradients (0 = left→right). */
+    degree: number;
+    /** Path-gradient bounding box (0..1) — unused for linear. */
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    stops: {
+        position: number;
+        color: string;
+    }[];
+}
+
 declare interface Hyperlink {
     col: number;
     row: number;
@@ -332,6 +358,9 @@ export declare interface Worksheet {
     autoFilter?: CellRange | 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
+     *  small red triangle in each cell's top-right corner. */
+    commentRefs?: string[];
 }
 
 /**