@silurus/ooxml 0.5.0 → 0.7.0

package/dist/types/index.d.ts

@@ -219,6 +219,20 @@ 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;
+    /** `<c:legendPos val>` — "r"|"l"|"t"|"b"|"tr". null/undefined = default ("r"). */
+    legendPos?: 'r' | 'l' | 't' | 'b' | 'tr' | null;
+    /** 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;
+    /** Category axis tick-label font size in hpt (ECMA-376 §21.2.2.17 c:txPr). */
+    catAxisFontSizeHpt?: number | null;
+    /** Value axis tick-label font size in hpt. */
+    valAxisFontSizeHpt?: number | null;
 }
 
 /**
@@ -255,6 +269,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. */
@@ -284,6 +302,14 @@ declare interface ChartSeries {
      * `ChartModel.categories` as X.
      */
     categories?: string[] | null;
+    /**
+     * Resolved marker visibility for line/scatter series. ECMA-376 §21.2.2.32
+     * `<c:marker><c:symbol>` defaults to "none" for line charts unless the
+     * chart-level `<c:marker val="1"/>` or a per-series symbol opts in. When
+     * undefined/null the renderer uses its own default (visible) so callers
+     * that don't parse markers (e.g. pptx today) keep their existing behavior.
+     */
+    showMarker?: boolean | null;
 }
 
 declare interface ConditionalFormat {
@@ -589,6 +615,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}. */
@@ -870,6 +901,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>;
@@ -896,6 +928,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 {
@@ -1012,6 +1052,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 {
@@ -1053,6 +1099,11 @@ declare interface ShapeElement {
     adj3: number | null;
     /** Fourth adjustment value from prstGeom avLst (e.g. callout tip y). Range 0–100000. */
     adj4: number | null;
+    /** adj5-adj8: extra polyline vertices for callouts like accentBorderCallout3. */
+    adj5: number | null;
+    adj6: number | null;
+    adj7: number | null;
+    adj8: number | null;
     /** Drop shadow from effectLst > outerShdw (null if not present). */
     shadow: Shadow | null;
 }
@@ -1346,6 +1397,9 @@ declare interface XlsxChartSeries {
     values: (number | null)[];
     /** Explicit fill color hex (from c:spPr). Undefined = use palette. */
     color?: string | null;
+    /** Marker visibility resolved from `<c:marker>`/chart-level default
+     *  (ECMA-376 §21.2.2.32). */
+    showMarker?: boolean;
 }
 
 declare class XlsxViewer {

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. */
@@ -111,6 +115,14 @@ declare interface ChartSeries {
      * `ChartModel.categories` as X.
      */
     categories?: string[] | null;
+    /**
+     * Resolved marker visibility for line/scatter series. ECMA-376 §21.2.2.32
+     * `<c:marker><c:symbol>` defaults to "none" for line charts unless the
+     * chart-level `<c:marker val="1"/>` or a per-series symbol opts in. When
+     * undefined/null the renderer uses its own default (visible) so callers
+     * that don't parse markers (e.g. pptx today) keep their existing behavior.
+     */
+    showMarker?: boolean | null;
 }
 
 export declare type Fill = SolidFill | NoFill | GradientFill;
@@ -314,6 +326,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 +353,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 {
@@ -440,6 +461,11 @@ export declare interface ShapeElement {
     adj3: number | null;
     /** Fourth adjustment value from prstGeom avLst (e.g. callout tip y). Range 0–100000. */
     adj4: number | null;
+    /** adj5-adj8: extra polyline vertices for callouts like accentBorderCallout3. */
+    adj5: number | null;
+    adj6: number | null;
+    adj7: number | null;
+    adj8: number | null;
     /** Drop shadow from effectLst > outerShdw (null if not present). */
     shadow: Shadow | null;
 }

package/dist/types/xlsx.d.ts

@@ -173,6 +173,20 @@ 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;
+    /** `<c:legendPos val>` — "r"|"l"|"t"|"b"|"tr". null/undefined = default ("r"). */
+    legendPos?: 'r' | 'l' | 't' | 'b' | 'tr' | null;
+    /** 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;
+    /** Category axis tick-label font size in hpt (ECMA-376 §21.2.2.17 c:txPr). */
+    catAxisFontSizeHpt?: number | null;
+    /** Value axis tick-label font size in hpt. */
+    valAxisFontSizeHpt?: number | null;
 }
 
 declare interface ConditionalFormat {
@@ -367,6 +381,9 @@ declare interface XlsxChartSeries {
     values: (number | null)[];
     /** Explicit fill color hex (from c:spPr). Undefined = use palette. */
     color?: string | null;
+    /** Marker visibility resolved from `<c:marker>`/chart-level default
+     *  (ECMA-376 §21.2.2.32). */
+    showMarker?: boolean;
 }
 
 export declare class XlsxViewer {