pptx-viewer-core 1.5.0 → 1.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/dist/{SvgExporter-CWAfTaRU.d.mts → SvgExporter-Csx19PZz.d.mts} +1 -1
- package/dist/{SvgExporter-CVRYDmB3.d.ts → SvgExporter-CxE3LpEi.d.ts} +1 -1
- package/dist/cli/index.d.mts +2 -2
- package/dist/cli/index.d.ts +2 -2
- package/dist/cli/index.js +30715 -23031
- package/dist/cli/index.mjs +30716 -23032
- package/dist/converter/index.d.mts +3 -3
- package/dist/converter/index.d.ts +3 -3
- package/dist/converter/index.js +1921 -42
- package/dist/converter/index.mjs +1921 -42
- package/dist/index.d.mts +506 -276
- package/dist/index.d.ts +506 -276
- package/dist/index.js +21226 -13049
- package/dist/index.mjs +21213 -13050
- package/dist/{presentation-BAMjUmQZ.d.mts → presentation-BLbjWKxK.d.mts} +498 -27
- package/dist/{presentation-BAMjUmQZ.d.ts → presentation-BLbjWKxK.d.ts} +498 -27
- package/dist/{text-operations-DZ1WQcRn.d.ts → text-operations-B0rbI4l2.d.ts} +1 -1
- package/dist/{text-operations-BkiHFUME.d.mts → text-operations-Beui0_5d.d.mts} +1 -1
- package/package.json +3 -3
|
@@ -435,6 +435,8 @@ interface CustomGeometryPath {
|
|
|
435
435
|
* and the text rectangle are not lost when a custGeom is edited and saved.
|
|
436
436
|
*/
|
|
437
437
|
interface CustomGeometryRawData {
|
|
438
|
+
/** Raw `a:avLst` XML content (adjustment value list). */
|
|
439
|
+
avLstXml?: unknown;
|
|
438
440
|
/** Raw `a:gdLst` XML content (guide list). */
|
|
439
441
|
gdLstXml?: unknown;
|
|
440
442
|
/** Raw `a:ahLst` XML content (adjustment handles). */
|
|
@@ -575,7 +577,7 @@ interface PptxCustomPathProperties {
|
|
|
575
577
|
pathHeight?: number;
|
|
576
578
|
/** Structured custom geometry paths for editing (maps to a:custGeom/a:pathLst). */
|
|
577
579
|
customGeometryPaths?: CustomGeometryPath[];
|
|
578
|
-
/** Raw
|
|
580
|
+
/** Raw adjustment/guide/handle/connection/text-rectangle XML preserved for serialization. */
|
|
579
581
|
customGeometryRawData?: CustomGeometryRawData;
|
|
580
582
|
/**
|
|
581
583
|
* Typed XY adjustment handles parsed from `a:custGeom/a:ahLst/a:ahXY`.
|
|
@@ -786,6 +788,12 @@ type PptxTextWarpPreset = 'textNoShape' | 'textPlain' | 'textStop' | 'textTriang
|
|
|
786
788
|
* @module pptx-types/shape-style
|
|
787
789
|
*/
|
|
788
790
|
|
|
791
|
+
interface PptxCustomDashSegment {
|
|
792
|
+
/** Dash length as a non-negative percentage in thousandths of one percent. */
|
|
793
|
+
dash: number;
|
|
794
|
+
/** Space length as a non-negative percentage in thousandths of one percent. */
|
|
795
|
+
space: number;
|
|
796
|
+
}
|
|
789
797
|
/**
|
|
790
798
|
* Comprehensive visual style for a shape, connector, or image element.
|
|
791
799
|
*
|
|
@@ -1018,11 +1026,12 @@ interface ShapeStyle {
|
|
|
1018
1026
|
connectorStartConnection?: ConnectorConnectionPoint;
|
|
1019
1027
|
/** Connection point for the end of a connector. */
|
|
1020
1028
|
connectorEndConnection?: ConnectorConnectionPoint;
|
|
1021
|
-
/** Custom dash
|
|
1022
|
-
customDashSegments?:
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1029
|
+
/** Custom dash pattern, measured relative to line width in thousandths of one percent. */
|
|
1030
|
+
customDashSegments?: PptxCustomDashSegment[];
|
|
1031
|
+
/** Original `a:ds` payloads retained by index for lossless edits. */
|
|
1032
|
+
customDashSegmentXml?: XmlObject[];
|
|
1033
|
+
/** Original `a:custDash` payload retained for lossless edits. */
|
|
1034
|
+
customDashXml?: XmlObject;
|
|
1026
1035
|
/** 3D scene/camera settings from `a:scene3d`. */
|
|
1027
1036
|
scene3d?: Pptx3DScene;
|
|
1028
1037
|
/** 3D shape extrusion/bevel from `a:sp3d`. */
|
|
@@ -1134,6 +1143,8 @@ interface ShapeStyle {
|
|
|
1134
1143
|
* ```
|
|
1135
1144
|
*/
|
|
1136
1145
|
interface TextStyle {
|
|
1146
|
+
/** Original `a:rPr` XML retained by projections that share the shape-text model. */
|
|
1147
|
+
runPropertiesXml?: XmlObject;
|
|
1137
1148
|
fontFamily?: string;
|
|
1138
1149
|
fontSize?: number;
|
|
1139
1150
|
/** When true, renderer should shrink text to fit the shape bounds. */
|
|
@@ -1917,10 +1928,104 @@ interface PptxChartAxisLabelFormatting {
|
|
|
1917
1928
|
labelAlignment?: 'ctr' | 'l' | 'r';
|
|
1918
1929
|
/** Category/date label distance, from 0 through 1000 percent. */
|
|
1919
1930
|
labelOffset?: number;
|
|
1931
|
+
/** Number of category/date labels between rendered labels. */
|
|
1932
|
+
tickLabelSkip?: number;
|
|
1933
|
+
/** Number of category/date tick positions between major tick marks. */
|
|
1934
|
+
tickMarkSkip?: number;
|
|
1920
1935
|
/** Suppress multi-level category labels (`c:noMultiLvlLbl`). */
|
|
1921
1936
|
noMultiLevelLabels?: boolean;
|
|
1922
1937
|
}
|
|
1923
1938
|
|
|
1939
|
+
interface PptxChartPivotFormat {
|
|
1940
|
+
index: number;
|
|
1941
|
+
shapePropertiesXml?: XmlObject | null;
|
|
1942
|
+
markerXml?: XmlObject | null;
|
|
1943
|
+
dataLabelXml?: XmlObject | null;
|
|
1944
|
+
extensionListXml?: XmlObject | null;
|
|
1945
|
+
rawXml?: XmlObject;
|
|
1946
|
+
}
|
|
1947
|
+
/** Editable classic ChartML `c:pivotFmts` collection. */
|
|
1948
|
+
interface PptxChartPivotFormats {
|
|
1949
|
+
formats: PptxChartPivotFormat[];
|
|
1950
|
+
rawXml?: XmlObject;
|
|
1951
|
+
}
|
|
1952
|
+
|
|
1953
|
+
/** Editable classic ChartML `c:pivotSource` metadata. */
|
|
1954
|
+
interface PptxChartPivotSource {
|
|
1955
|
+
/** Pivot table reference stored as `c:name` text. */
|
|
1956
|
+
name: string;
|
|
1957
|
+
/** Required unsigned format identifier stored in `c:fmtId/@val`. */
|
|
1958
|
+
formatId: number;
|
|
1959
|
+
/** Internal source subtree used to preserve extensions and foreign markup. */
|
|
1960
|
+
rawXml?: XmlObject;
|
|
1961
|
+
}
|
|
1962
|
+
|
|
1963
|
+
/** Headers and footers used when a classic ChartML chart is printed. */
|
|
1964
|
+
interface PptxChartPrintHeaderFooter {
|
|
1965
|
+
oddHeader?: string;
|
|
1966
|
+
oddFooter?: string;
|
|
1967
|
+
evenHeader?: string;
|
|
1968
|
+
evenFooter?: string;
|
|
1969
|
+
firstHeader?: string;
|
|
1970
|
+
firstFooter?: string;
|
|
1971
|
+
alignWithMargins?: boolean;
|
|
1972
|
+
differentOddEven?: boolean;
|
|
1973
|
+
differentFirst?: boolean;
|
|
1974
|
+
/** Original subtree retained for foreign attributes and extension children. */
|
|
1975
|
+
rawXml?: unknown;
|
|
1976
|
+
}
|
|
1977
|
+
/** Required page margins from ChartML `c:pageMargins`, measured in inches. */
|
|
1978
|
+
interface PptxChartPageMargins {
|
|
1979
|
+
left: number;
|
|
1980
|
+
right: number;
|
|
1981
|
+
top: number;
|
|
1982
|
+
bottom: number;
|
|
1983
|
+
header: number;
|
|
1984
|
+
footer: number;
|
|
1985
|
+
/** Original leaf retained for foreign attributes. */
|
|
1986
|
+
rawXml?: unknown;
|
|
1987
|
+
}
|
|
1988
|
+
/** Printer page configuration from ChartML `c:pageSetup`. */
|
|
1989
|
+
interface PptxChartPageSetup {
|
|
1990
|
+
paperSize?: number;
|
|
1991
|
+
firstPageNumber?: number;
|
|
1992
|
+
orientation?: 'default' | 'portrait' | 'landscape';
|
|
1993
|
+
blackAndWhite?: boolean;
|
|
1994
|
+
draft?: boolean;
|
|
1995
|
+
useFirstPageNumber?: boolean;
|
|
1996
|
+
horizontalDpi?: number;
|
|
1997
|
+
verticalDpi?: number;
|
|
1998
|
+
copies?: number;
|
|
1999
|
+
/** Original leaf retained for foreign attributes. */
|
|
2000
|
+
rawXml?: unknown;
|
|
2001
|
+
}
|
|
2002
|
+
/** Editable `c:printSettings` content from a classic ChartML chart space. */
|
|
2003
|
+
interface PptxChartPrintSettings {
|
|
2004
|
+
headerFooter?: PptxChartPrintHeaderFooter | null;
|
|
2005
|
+
pageMargins?: PptxChartPageMargins | null;
|
|
2006
|
+
pageSetup?: PptxChartPageSetup | null;
|
|
2007
|
+
/** `null` removes the legacy header/footer drawing relationship element. */
|
|
2008
|
+
legacyDrawingHeaderFooterRelationshipId?: string | null;
|
|
2009
|
+
/** Original subtree retained for unknown and extension content. */
|
|
2010
|
+
rawXml?: unknown;
|
|
2011
|
+
}
|
|
2012
|
+
|
|
2013
|
+
/** Editable classic ChartML `c:protection` settings. */
|
|
2014
|
+
interface PptxChartProtection {
|
|
2015
|
+
/** Prevent editing the chart object. */
|
|
2016
|
+
chartObject?: boolean | null;
|
|
2017
|
+
/** Prevent editing the chart data. */
|
|
2018
|
+
data?: boolean | null;
|
|
2019
|
+
/** Prevent editing chart formatting. */
|
|
2020
|
+
formatting?: boolean | null;
|
|
2021
|
+
/** Prevent selecting chart elements. */
|
|
2022
|
+
selection?: boolean | null;
|
|
2023
|
+
/** Prevent chart user-interface operations. */
|
|
2024
|
+
userInterface?: boolean | null;
|
|
2025
|
+
/** Internal source subtree used to preserve foreign markup during edits. */
|
|
2026
|
+
rawXml?: XmlObject;
|
|
2027
|
+
}
|
|
2028
|
+
|
|
1924
2029
|
/**
|
|
1925
2030
|
* Chart types: chart categories, series data, style metadata, data tables,
|
|
1926
2031
|
* trendlines, error bars, and the composite `PptxChartData`.
|
|
@@ -2077,6 +2182,7 @@ interface PptxChartUpDownBars {
|
|
|
2077
2182
|
/** Marker appearance on a chart series or data point. */
|
|
2078
2183
|
interface PptxChartMarker {
|
|
2079
2184
|
symbol: PptxChartMarkerSymbol;
|
|
2185
|
+
/** Marker size in points, constrained by ST_MarkerSize to 2 through 72. */
|
|
2080
2186
|
size?: number;
|
|
2081
2187
|
spPr?: PptxChartShapeProps;
|
|
2082
2188
|
}
|
|
@@ -2087,6 +2193,8 @@ interface PptxChartDataPoint {
|
|
|
2087
2193
|
explosion?: number;
|
|
2088
2194
|
invertIfNegative?: boolean;
|
|
2089
2195
|
marker?: PptxChartMarker;
|
|
2196
|
+
/** Render a bubble-chart point with a 3-D appearance. */
|
|
2197
|
+
bubble3D?: boolean;
|
|
2090
2198
|
}
|
|
2091
2199
|
/** Schema values accepted by `c:dLblPos`. */
|
|
2092
2200
|
type PptxChartDataLabelPosition = 'bestFit' | 'b' | 'ctr' | 'inBase' | 'inEnd' | 'l' | 'outEnd' | 'r' | 't';
|
|
@@ -2129,6 +2237,12 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
|
|
|
2129
2237
|
axisId?: number;
|
|
2130
2238
|
/** Cross-axis identifier — the axis this axis crosses. */
|
|
2131
2239
|
crossAxisId?: number;
|
|
2240
|
+
/** Automatic crossing mode (`c:crosses`). Mutually exclusive with `crossesAt`. */
|
|
2241
|
+
crosses?: 'autoZero' | 'min' | 'max';
|
|
2242
|
+
/** Explicit crossing value (`c:crossesAt`). Units depend on the axis type. */
|
|
2243
|
+
crossesAt?: number;
|
|
2244
|
+
/** Whether a value axis crosses between or at category tick marks. */
|
|
2245
|
+
crossBetween?: 'between' | 'midCat';
|
|
2132
2246
|
numFmt?: PptxChartAxisNumFmt;
|
|
2133
2247
|
titleText?: string;
|
|
2134
2248
|
spPr?: PptxChartShapeProps;
|
|
@@ -2146,6 +2260,8 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
|
|
|
2146
2260
|
min?: number;
|
|
2147
2261
|
/** Maximum axis value override (c:max/@val). */
|
|
2148
2262
|
max?: number;
|
|
2263
|
+
/** Axis value direction (`c:scaling/c:orientation/@val`). */
|
|
2264
|
+
orientation?: 'minMax' | 'maxMin';
|
|
2149
2265
|
/** Whether the axis is deleted/hidden (c:delete/@val). */
|
|
2150
2266
|
deleted?: boolean;
|
|
2151
2267
|
/**
|
|
@@ -2169,12 +2285,69 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
|
|
|
2169
2285
|
majorUnit?: number;
|
|
2170
2286
|
/** Minor-unit interval between secondary tick marks (c:minorUnit/@val). */
|
|
2171
2287
|
minorUnit?: number;
|
|
2288
|
+
/** Calendar unit used to interpret date-axis serial values. */
|
|
2289
|
+
baseTimeUnit?: 'days' | 'months' | 'years';
|
|
2290
|
+
majorTimeUnit?: 'days' | 'months' | 'years';
|
|
2291
|
+
minorTimeUnit?: 'days' | 'months' | 'years';
|
|
2172
2292
|
}
|
|
2173
2293
|
/** 3D wall or floor element formatting. */
|
|
2174
2294
|
interface PptxChart3DSurface {
|
|
2175
2295
|
thickness?: number;
|
|
2176
2296
|
spPr?: PptxChartShapeProps;
|
|
2177
2297
|
}
|
|
2298
|
+
/** Office 2016 ChartEx box-and-whisker series layout options. */
|
|
2299
|
+
interface PptxChartBoxWhiskerOptions {
|
|
2300
|
+
quartileMethod?: 'inclusive' | 'exclusive';
|
|
2301
|
+
showMeanLine?: boolean;
|
|
2302
|
+
showMeanMarker?: boolean;
|
|
2303
|
+
/** Show non-outlier (inner) data points. */
|
|
2304
|
+
showInnerPoints?: boolean;
|
|
2305
|
+
showOutlierPoints?: boolean;
|
|
2306
|
+
}
|
|
2307
|
+
/** Office 2016 ChartEx histogram and Pareto series layout options. */
|
|
2308
|
+
interface PptxChartHistogramOptions {
|
|
2309
|
+
/** Maps to `clusteredColumn` for histogram columns or `paretoLine`. */
|
|
2310
|
+
layout?: 'histogram' | 'pareto';
|
|
2311
|
+
/** Exactly one of binSize and binCount is emitted by the ChartEx writer. */
|
|
2312
|
+
binSize?: number;
|
|
2313
|
+
binCount?: number;
|
|
2314
|
+
intervalClosed?: 'l' | 'r';
|
|
2315
|
+
underflow?: number | 'auto';
|
|
2316
|
+
overflow?: number | 'auto';
|
|
2317
|
+
}
|
|
2318
|
+
/** Office 2016 ChartEx waterfall series layout options. */
|
|
2319
|
+
interface PptxChartWaterfallOptions {
|
|
2320
|
+
/** Zero-based data point indexes rendered as absolute subtotal or total bars. */
|
|
2321
|
+
subtotalIndices?: number[];
|
|
2322
|
+
/** Whether connector lines are visible between adjacent bars. */
|
|
2323
|
+
connectorLines?: boolean;
|
|
2324
|
+
}
|
|
2325
|
+
/** Office 2016 ChartEx geographic series dimensions and layout options. */
|
|
2326
|
+
interface PptxChartRegionMapOptions {
|
|
2327
|
+
/** Optional provider entity identifiers aligned with categories and values. */
|
|
2328
|
+
entityIds?: string[];
|
|
2329
|
+
/** Original `cx:pt/@idx` values for category points. */
|
|
2330
|
+
categorySourceIndices?: number[];
|
|
2331
|
+
/** Original `cx:pt/@idx` values for colour-value points. */
|
|
2332
|
+
valueSourceIndices?: number[];
|
|
2333
|
+
/** Original `cx:pt/@idx` values for entity-ID points. */
|
|
2334
|
+
entityIdSourceIndices?: number[];
|
|
2335
|
+
regionLabelLayout?: 'none' | 'bestFitOnly' | 'showAll';
|
|
2336
|
+
projectionType?: 'mercator' | 'miller' | 'robinson' | 'albers';
|
|
2337
|
+
viewedRegionType?: 'dataOnly' | 'postalCode' | 'county' | 'state' | 'countryRegion' | 'countryRegionList' | 'world';
|
|
2338
|
+
cultureLanguage?: string;
|
|
2339
|
+
/** ISO-3166-1 alpha-2 region code. */
|
|
2340
|
+
cultureRegion?: string;
|
|
2341
|
+
attribution?: string;
|
|
2342
|
+
/** Opaque authored provider cache under `cx:geography/cx:geoCache`. */
|
|
2343
|
+
geographyCache?: XmlObject;
|
|
2344
|
+
}
|
|
2345
|
+
/** Layout for parent category labels in a hierarchical ChartEx treemap. */
|
|
2346
|
+
type PptxChartParentLabelLayout = 'none' | 'banner' | 'overlapping';
|
|
2347
|
+
/** Per-series layout options for an Office 2016+ ChartEx treemap. */
|
|
2348
|
+
interface PptxChartTreemapOptions {
|
|
2349
|
+
parentLabelLayout?: PptxChartParentLabelLayout;
|
|
2350
|
+
}
|
|
2178
2351
|
/**
|
|
2179
2352
|
* A single data series within a chart.
|
|
2180
2353
|
*
|
|
@@ -2210,6 +2383,11 @@ interface PptxChartSeries {
|
|
|
2210
2383
|
* series.
|
|
2211
2384
|
*/
|
|
2212
2385
|
seriesChartType?: PptxChartType;
|
|
2386
|
+
boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
|
|
2387
|
+
histogramOptions?: PptxChartHistogramOptions;
|
|
2388
|
+
waterfallOptions?: PptxChartWaterfallOptions;
|
|
2389
|
+
regionMapOptions?: PptxChartRegionMapOptions;
|
|
2390
|
+
treemapOptions?: PptxChartTreemapOptions;
|
|
2213
2391
|
}
|
|
2214
2392
|
/**
|
|
2215
2393
|
* Chart-level data-label options (`c:dLbls` directly under a chart-type
|
|
@@ -2415,6 +2593,16 @@ interface PptxEmbeddedWorkbookData {
|
|
|
2415
2593
|
name: string;
|
|
2416
2594
|
values: number[];
|
|
2417
2595
|
}>;
|
|
2596
|
+
/** Whether the workbook uses the 1904 date system. */
|
|
2597
|
+
date1904?: boolean;
|
|
2598
|
+
}
|
|
2599
|
+
/** Raw numeric category cache used by a classic ChartML date axis. */
|
|
2600
|
+
interface PptxChartDateCategories {
|
|
2601
|
+
values: number[];
|
|
2602
|
+
/** False/default uses Excel's 1900 date system; true uses the 1904 system. */
|
|
2603
|
+
date1904?: boolean;
|
|
2604
|
+
/** Number format copied from the numeric category cache. */
|
|
2605
|
+
formatCode?: string;
|
|
2418
2606
|
}
|
|
2419
2607
|
/**
|
|
2420
2608
|
* Complete parsed chart data for a {@link ChartPptxElement}.
|
|
@@ -2438,6 +2626,13 @@ interface PptxChartData {
|
|
|
2438
2626
|
title?: string;
|
|
2439
2627
|
chartType: PptxChartType;
|
|
2440
2628
|
categories: string[];
|
|
2629
|
+
/**
|
|
2630
|
+
* Hierarchical category levels in source XML order for ChartEx hierarchy charts.
|
|
2631
|
+
* Level 0 contains the leaf labels and remains mirrored by {@link categories}
|
|
2632
|
+
* for consumers that only understand a flat category axis.
|
|
2633
|
+
*/
|
|
2634
|
+
categoryLevels?: string[][];
|
|
2635
|
+
dateCategories?: PptxChartDateCategories;
|
|
2441
2636
|
series: PptxChartSeries[];
|
|
2442
2637
|
/** Chart style/formatting metadata. */
|
|
2443
2638
|
style?: PptxChartStyle;
|
|
@@ -2474,12 +2669,7 @@ interface PptxChartData {
|
|
|
2474
2669
|
* The chart still renders using its cached series data; this field
|
|
2475
2670
|
* is metadata about the data origin, preserved for round-trip fidelity.
|
|
2476
2671
|
*/
|
|
2477
|
-
pivotSource?:
|
|
2478
|
-
/** Pivot table reference name, e.g. "[workbook.xlsx]Sheet1!PivotTable1". */
|
|
2479
|
-
name: string;
|
|
2480
|
-
/** Format identifier from c:fmtId/@val. */
|
|
2481
|
-
formatId?: number;
|
|
2482
|
-
};
|
|
2672
|
+
pivotSource?: PptxChartPivotSource | null;
|
|
2483
2673
|
/**
|
|
2484
2674
|
* Whether only visible cells are plotted (c:plotVisOnly).
|
|
2485
2675
|
* When `true` (the default), hidden cells are excluded from the chart.
|
|
@@ -2502,6 +2692,12 @@ interface PptxChartData {
|
|
|
2502
2692
|
* - `"acrossLinear"` — gradient across series
|
|
2503
2693
|
*/
|
|
2504
2694
|
colorMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
|
|
2695
|
+
/** Internal source color-style part path used for lossless dirty saves. */
|
|
2696
|
+
colorStylePartPath?: string;
|
|
2697
|
+
/** Internal parsed palette snapshot used to detect actual edits. */
|
|
2698
|
+
colorStyleOriginalPalette?: string[];
|
|
2699
|
+
/** Internal parsed method snapshot used to detect actual edits. */
|
|
2700
|
+
colorStyleOriginalMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
|
|
2505
2701
|
/**
|
|
2506
2702
|
* Pie-of-pie / Bar-of-pie options (`c:ofPieChart`, CT_OfPieChart).
|
|
2507
2703
|
*
|
|
@@ -2527,6 +2723,10 @@ interface PptxChartData {
|
|
|
2527
2723
|
* source data, so absence does not produce empty `<c:…/>` placeholders.
|
|
2528
2724
|
*/
|
|
2529
2725
|
chartChrome?: PptxChartChrome;
|
|
2726
|
+
/** `c:chartSpace/c:printSettings`; `null` removes the container on save. */
|
|
2727
|
+
printSettings?: PptxChartPrintSettings | null;
|
|
2728
|
+
/** `c:chartSpace/c:protection`; `null` removes the container on save. */
|
|
2729
|
+
protection?: PptxChartProtection | null;
|
|
2530
2730
|
/** Editable manual placement for the title, plot area, and legend. */
|
|
2531
2731
|
layouts?: PptxChartLayouts;
|
|
2532
2732
|
/**
|
|
@@ -2545,7 +2745,8 @@ interface PptxChartData {
|
|
|
2545
2745
|
* for charts whose data originates from a PivotTable. Preserved
|
|
2546
2746
|
* verbatim for round-trip fidelity.
|
|
2547
2747
|
*/
|
|
2548
|
-
|
|
2748
|
+
/** Typed pivot-chart format persistence; `null` removes `c:pivotFmts`. */
|
|
2749
|
+
pivotFormats?: PptxChartPivotFormats | null;
|
|
2549
2750
|
/**
|
|
2550
2751
|
* Color-map override (`c:clrMapOvr`) carrying 12 attributes that
|
|
2551
2752
|
* remap theme colour roles for this chart only. Preserved as a flat
|
|
@@ -2556,7 +2757,7 @@ interface PptxChartData {
|
|
|
2556
2757
|
|
|
2557
2758
|
type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
|
|
2558
2759
|
type EffectDagContainerType = 'sib' | 'tree';
|
|
2559
|
-
type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagPresetShadow | EffectDagRawLeaf;
|
|
2760
|
+
type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagAlphaOutset | EffectDagPresetShadow | EffectDagRawLeaf;
|
|
2560
2761
|
interface EffectDagContainer {
|
|
2561
2762
|
kind: 'cont';
|
|
2562
2763
|
type: EffectDagContainerType;
|
|
@@ -2589,6 +2790,12 @@ interface EffectDagBlur {
|
|
|
2589
2790
|
grow?: boolean;
|
|
2590
2791
|
xml: XmlObject;
|
|
2591
2792
|
}
|
|
2793
|
+
/** Typed CT_AlphaOutsetEffect with original XML retained for lossless edits. */
|
|
2794
|
+
interface EffectDagAlphaOutset {
|
|
2795
|
+
kind: 'alphaOutset';
|
|
2796
|
+
radiusEmu?: number;
|
|
2797
|
+
xml: XmlObject;
|
|
2798
|
+
}
|
|
2592
2799
|
/** Typed CT_PresetShadowEffect with colour and extension XML retained verbatim. */
|
|
2593
2800
|
interface EffectDagPresetShadow {
|
|
2594
2801
|
kind: 'prstShdw';
|
|
@@ -2628,6 +2835,8 @@ interface PptxImageEffects {
|
|
|
2628
2835
|
duotone?: {
|
|
2629
2836
|
color1: string;
|
|
2630
2837
|
color2: string;
|
|
2838
|
+
/** Original effect XML, retained while the resolved colours are unchanged. */
|
|
2839
|
+
rawXml?: XmlObject;
|
|
2631
2840
|
};
|
|
2632
2841
|
/** Grayscale flag. */
|
|
2633
2842
|
grayscale?: boolean;
|
|
@@ -2642,8 +2851,10 @@ interface PptxImageEffects {
|
|
|
2642
2851
|
artisticEffect?: string;
|
|
2643
2852
|
/** Artistic effect radius/amount. */
|
|
2644
2853
|
artisticRadius?: number;
|
|
2645
|
-
/** Alpha modulation fixed
|
|
2854
|
+
/** Alpha modulation fixed: non-negative percentage (100 means unchanged opacity). */
|
|
2646
2855
|
alphaModFix?: number;
|
|
2856
|
+
/** Original alpha modulation fixed node, including foreign attributes. */
|
|
2857
|
+
alphaModFixRawXml?: XmlObject;
|
|
2647
2858
|
/** Bi-level threshold — converts to 1-bit black/white (0-100). */
|
|
2648
2859
|
biLevel?: number;
|
|
2649
2860
|
/** Colour change — swap one colour range for another (used for transparency keying). */
|
|
@@ -2652,7 +2863,13 @@ interface PptxImageEffects {
|
|
|
2652
2863
|
clrTo: string;
|
|
2653
2864
|
/** Whether the target colour is fully transparent (alpha = 0). */
|
|
2654
2865
|
clrToTransparent?: boolean;
|
|
2866
|
+
/** Original effect XML, including colour transforms and extensions. */
|
|
2867
|
+
rawXml?: XmlObject;
|
|
2655
2868
|
};
|
|
2869
|
+
/** Original grayscale node, including extension or foreign attributes. */
|
|
2870
|
+
grayscaleRawXml?: XmlObject;
|
|
2871
|
+
/** Original bi-level node, including extension or foreign attributes. */
|
|
2872
|
+
biLevelRawXml?: XmlObject;
|
|
2656
2873
|
/**
|
|
2657
2874
|
* Alpha inverse effect (`a:alphaInv`). Inverts the alpha channel; an optional
|
|
2658
2875
|
* colour child shifts the inversion baseline.
|
|
@@ -2660,11 +2877,17 @@ interface PptxImageEffects {
|
|
|
2660
2877
|
alphaInv?: {
|
|
2661
2878
|
/** Optional baseline colour (hex). */
|
|
2662
2879
|
color?: string;
|
|
2880
|
+
/** Original effect XML, including colour transforms and foreign attributes. */
|
|
2881
|
+
rawXml?: XmlObject;
|
|
2663
2882
|
};
|
|
2664
2883
|
/** Alpha ceiling (`a:alphaCeiling`) — clamps any non-zero alpha to fully opaque. Boolean flag. */
|
|
2665
2884
|
alphaCeiling?: boolean;
|
|
2885
|
+
/** Original alpha ceiling node, including foreign attributes. */
|
|
2886
|
+
alphaCeilingRawXml?: XmlObject;
|
|
2666
2887
|
/** Alpha floor (`a:alphaFloor`) — clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
|
|
2667
2888
|
alphaFloor?: boolean;
|
|
2889
|
+
/** Original alpha floor node, including foreign attributes. */
|
|
2890
|
+
alphaFloorRawXml?: XmlObject;
|
|
2668
2891
|
/**
|
|
2669
2892
|
* Alpha modulate (`a:alphaMod`). The schema requires a single `cont` (effect
|
|
2670
2893
|
* container) child; we preserve the inner XML opaquely for round-trip.
|
|
@@ -2672,11 +2895,17 @@ interface PptxImageEffects {
|
|
|
2672
2895
|
alphaMod?: {
|
|
2673
2896
|
/** Raw opaque XML for the `a:cont` child to preserve on save. */
|
|
2674
2897
|
contRawXml?: Record<string, unknown>;
|
|
2898
|
+
/** Original effect XML, including foreign attributes. */
|
|
2899
|
+
rawXml?: XmlObject;
|
|
2675
2900
|
};
|
|
2676
2901
|
/** Alpha replace (`a:alphaRepl`) — replaces alpha with the given fixed-percent value (0..100). */
|
|
2677
2902
|
alphaRepl?: number;
|
|
2903
|
+
/** Original alpha replace node, including foreign attributes. */
|
|
2904
|
+
alphaReplRawXml?: XmlObject;
|
|
2678
2905
|
/** Alpha bi-level (`a:alphaBiLevel`) — threshold (0..100) above which alpha becomes fully opaque. */
|
|
2679
2906
|
alphaBiLevel?: number;
|
|
2907
|
+
/** Original alpha bi-level node, including foreign attributes. */
|
|
2908
|
+
alphaBiLevelRawXml?: XmlObject;
|
|
2680
2909
|
/**
|
|
2681
2910
|
* Colour replace (`a:clrRepl`) — replaces all colour information in an image
|
|
2682
2911
|
* with the given solid colour. Stores the raw colour child to preserve scheme
|
|
@@ -2819,6 +3048,7 @@ declare module './shape-style' {
|
|
|
2819
3048
|
*
|
|
2820
3049
|
* @module pptx-types/media
|
|
2821
3050
|
*/
|
|
3051
|
+
|
|
2822
3052
|
/**
|
|
2823
3053
|
* Discriminator for embedded media element types.
|
|
2824
3054
|
*
|
|
@@ -2833,6 +3063,8 @@ type PptxMediaReferenceKind = 'audioCd' | 'wavAudioFile' | 'audioFile' | 'videoF
|
|
|
2833
3063
|
interface PptxAudioCdPosition {
|
|
2834
3064
|
track: number;
|
|
2835
3065
|
time?: number;
|
|
3066
|
+
/** Original `st` or `end` node, retained for lossless edits. */
|
|
3067
|
+
rawXml?: XmlObject;
|
|
2836
3068
|
}
|
|
2837
3069
|
/**
|
|
2838
3070
|
* A named bookmark within a media clip timeline.
|
|
@@ -2910,7 +3142,39 @@ interface MediaCaptionTrack {
|
|
|
2910
3142
|
isDefault?: boolean;
|
|
2911
3143
|
}
|
|
2912
3144
|
|
|
3145
|
+
type PptxSmartArtConstraintRelationship = 'self' | 'ch' | 'des';
|
|
3146
|
+
type PptxSmartArtConstraintOperator = 'none' | 'equ' | 'gte' | 'lte';
|
|
3147
|
+
type PptxSmartArtConstraintPointType = 'all' | 'doc' | 'node' | 'norm' | 'nonNorm' | 'asst' | 'nonAsst' | 'parTrans' | 'pres' | 'sibTrans';
|
|
3148
|
+
interface PptxSmartArtConstraintTarget {
|
|
3149
|
+
for?: PptxSmartArtConstraintRelationship;
|
|
3150
|
+
forName?: string;
|
|
3151
|
+
pointType?: PptxSmartArtConstraintPointType;
|
|
3152
|
+
}
|
|
3153
|
+
/** Editable DiagramML CT_Constraint. */
|
|
3154
|
+
interface PptxSmartArtConstraint extends PptxSmartArtConstraintTarget {
|
|
3155
|
+
type: string;
|
|
3156
|
+
referenceType?: string;
|
|
3157
|
+
referenceFor?: PptxSmartArtConstraintRelationship;
|
|
3158
|
+
referenceForName?: string;
|
|
3159
|
+
referencePointType?: PptxSmartArtConstraintPointType;
|
|
3160
|
+
operator?: PptxSmartArtConstraintOperator;
|
|
3161
|
+
value?: number;
|
|
3162
|
+
factor?: number;
|
|
3163
|
+
/** Original constraint retained for foreign attributes and extension content. */
|
|
3164
|
+
rawXml?: XmlObject;
|
|
3165
|
+
}
|
|
3166
|
+
/** Editable DiagramML CT_NumericRule. */
|
|
3167
|
+
interface PptxSmartArtNumericRule extends PptxSmartArtConstraintTarget {
|
|
3168
|
+
type: string;
|
|
3169
|
+
value?: number;
|
|
3170
|
+
factor?: number;
|
|
3171
|
+
max?: number;
|
|
3172
|
+
/** Original rule retained for foreign attributes and extension content. */
|
|
3173
|
+
rawXml?: XmlObject;
|
|
3174
|
+
}
|
|
3175
|
+
|
|
2913
3176
|
/** Typed, editable metadata from a DiagramML layout-definition part. */
|
|
3177
|
+
|
|
2914
3178
|
interface PptxSmartArtLocalizedText {
|
|
2915
3179
|
value: string;
|
|
2916
3180
|
language?: string;
|
|
@@ -2919,12 +3183,56 @@ interface PptxSmartArtLayoutCategory {
|
|
|
2919
3183
|
type: string;
|
|
2920
3184
|
priority: number;
|
|
2921
3185
|
}
|
|
3186
|
+
interface PptxSmartArtAlgorithmParameter {
|
|
3187
|
+
type: string;
|
|
3188
|
+
value?: string;
|
|
3189
|
+
}
|
|
3190
|
+
/** Typed DiagramML CT_Algorithm data attached to a layout node. */
|
|
3191
|
+
interface PptxSmartArtLayoutAlgorithm {
|
|
3192
|
+
type: string;
|
|
3193
|
+
revision?: number;
|
|
3194
|
+
parameters?: PptxSmartArtAlgorithmParameter[];
|
|
3195
|
+
}
|
|
3196
|
+
interface PptxSmartArtIteratorAttributes {
|
|
3197
|
+
name?: string;
|
|
3198
|
+
reference?: string;
|
|
3199
|
+
axis?: string[];
|
|
3200
|
+
pointTypes?: string[];
|
|
3201
|
+
hideLastTransition?: boolean[];
|
|
3202
|
+
start?: number[];
|
|
3203
|
+
count?: number[];
|
|
3204
|
+
step?: number[];
|
|
3205
|
+
}
|
|
3206
|
+
interface PptxSmartArtForEach extends PptxSmartArtIteratorAttributes {
|
|
3207
|
+
rawXml?: XmlObject;
|
|
3208
|
+
}
|
|
3209
|
+
interface PptxSmartArtWhen extends PptxSmartArtIteratorAttributes {
|
|
3210
|
+
function: string;
|
|
3211
|
+
argument?: string;
|
|
3212
|
+
operator: string;
|
|
3213
|
+
value: string;
|
|
3214
|
+
rawXml?: XmlObject;
|
|
3215
|
+
}
|
|
3216
|
+
interface PptxSmartArtChoose {
|
|
3217
|
+
name?: string;
|
|
3218
|
+
when: PptxSmartArtWhen[];
|
|
3219
|
+
otherwise?: {
|
|
3220
|
+
name?: string;
|
|
3221
|
+
rawXml?: XmlObject;
|
|
3222
|
+
} | null;
|
|
3223
|
+
rawXml?: XmlObject;
|
|
3224
|
+
}
|
|
2922
3225
|
/** Identity and ordering metadata from DiagramML CT_LayoutNode. */
|
|
2923
3226
|
interface PptxSmartArtLayoutNode {
|
|
2924
3227
|
name?: string;
|
|
2925
3228
|
styleLabel?: string;
|
|
2926
3229
|
childOrder?: 'b' | 't';
|
|
2927
3230
|
moveWith?: string;
|
|
3231
|
+
algorithm?: PptxSmartArtLayoutAlgorithm;
|
|
3232
|
+
forEach?: PptxSmartArtForEach[];
|
|
3233
|
+
choose?: PptxSmartArtChoose[];
|
|
3234
|
+
constraints?: PptxSmartArtConstraint[];
|
|
3235
|
+
rules?: PptxSmartArtNumericRule[];
|
|
2928
3236
|
children?: PptxSmartArtLayoutNode[];
|
|
2929
3237
|
}
|
|
2930
3238
|
/** Metadata and root node from DiagramML CT_DiagramDefinition. */
|
|
@@ -2936,6 +3244,8 @@ interface PptxSmartArtLayoutDefinition {
|
|
|
2936
3244
|
descriptions?: PptxSmartArtLocalizedText[];
|
|
2937
3245
|
categories?: PptxSmartArtLayoutCategory[];
|
|
2938
3246
|
rootNode: PptxSmartArtLayoutNode;
|
|
3247
|
+
/** Original definition retained for constraint evaluation and foreign rules. */
|
|
3248
|
+
rawXml?: XmlObject;
|
|
2939
3249
|
}
|
|
2940
3250
|
|
|
2941
3251
|
/**
|
|
@@ -2947,6 +3257,7 @@ interface PptxSmartArtLayoutDefinition {
|
|
|
2947
3257
|
*
|
|
2948
3258
|
* @module pptx-types/smart-art-node
|
|
2949
3259
|
*/
|
|
3260
|
+
|
|
2950
3261
|
/**
|
|
2951
3262
|
* A single run of text inside a SmartArt node, capturing the run text and the
|
|
2952
3263
|
* raw `a:rPr` run-properties object verbatim so per-run formatting (bold,
|
|
@@ -2970,6 +3281,54 @@ interface PptxSmartArtTextRun {
|
|
|
2970
3281
|
* round-trip. Untyped XML, hence the loose record shape.
|
|
2971
3282
|
*/
|
|
2972
3283
|
rPr?: Record<string, unknown>;
|
|
3284
|
+
/** Resolved standard shape-text style derived from {@link rPr}. */
|
|
3285
|
+
style?: TextStyle;
|
|
3286
|
+
/** Raw run XML used to retain unmodelled extension children on save. */
|
|
3287
|
+
rawXml?: Record<string, unknown>;
|
|
3288
|
+
/** Original direct-child order, including unmodelled extension children. */
|
|
3289
|
+
childOrder?: string[];
|
|
3290
|
+
}
|
|
3291
|
+
/** An ordered item within a SmartArt text paragraph. */
|
|
3292
|
+
type PptxSmartArtTextParagraphItem = {
|
|
3293
|
+
kind: 'run';
|
|
3294
|
+
run: PptxSmartArtTextRun;
|
|
3295
|
+
} | {
|
|
3296
|
+
kind: 'break';
|
|
3297
|
+
rPr?: Record<string, unknown>;
|
|
3298
|
+
style?: TextStyle;
|
|
3299
|
+
rawXml?: Record<string, unknown>;
|
|
3300
|
+
childOrder?: string[];
|
|
3301
|
+
} | {
|
|
3302
|
+
kind: 'field';
|
|
3303
|
+
id?: string;
|
|
3304
|
+
fieldType?: string;
|
|
3305
|
+
text: string;
|
|
3306
|
+
rPr?: Record<string, unknown>;
|
|
3307
|
+
style?: TextStyle;
|
|
3308
|
+
pPr?: Record<string, unknown>;
|
|
3309
|
+
rawXml?: Record<string, unknown>;
|
|
3310
|
+
childOrder?: string[];
|
|
3311
|
+
} | {
|
|
3312
|
+
kind: 'tab';
|
|
3313
|
+
rawXml?: Record<string, unknown>;
|
|
3314
|
+
childOrder?: string[];
|
|
3315
|
+
} | {
|
|
3316
|
+
kind: 'raw';
|
|
3317
|
+
name: string;
|
|
3318
|
+
value: unknown;
|
|
3319
|
+
};
|
|
3320
|
+
/** A complete `a:p` paragraph in a SmartArt data-model text body. */
|
|
3321
|
+
interface PptxSmartArtTextParagraph {
|
|
3322
|
+
/** Paragraph properties (`a:pPr`) preserved verbatim. */
|
|
3323
|
+
pPr?: Record<string, unknown>;
|
|
3324
|
+
/** Text children in source order. */
|
|
3325
|
+
items: PptxSmartArtTextParagraphItem[];
|
|
3326
|
+
/** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
|
|
3327
|
+
endParaRPr?: Record<string, unknown>;
|
|
3328
|
+
/** Resolved style for the paragraph terminator. */
|
|
3329
|
+
endParaStyle?: TextStyle;
|
|
3330
|
+
/** Raw paragraph XML used to retain unmodelled extension children on save. */
|
|
3331
|
+
rawXml?: Record<string, unknown>;
|
|
2973
3332
|
}
|
|
2974
3333
|
/**
|
|
2975
3334
|
* Per-node visual override for a SmartArt node.
|
|
@@ -3039,6 +3398,11 @@ interface PptxSmartArtNode {
|
|
|
3039
3398
|
* is not flattened. When {@link text} diverges, the runs are ignored.
|
|
3040
3399
|
*/
|
|
3041
3400
|
runs?: PptxSmartArtTextRun[];
|
|
3401
|
+
/**
|
|
3402
|
+
* Complete typed paragraph model. Unlike {@link runs}, this retains every
|
|
3403
|
+
* paragraph and the ordered run, field, break, and tab children within it.
|
|
3404
|
+
*/
|
|
3405
|
+
paragraphs?: PptxSmartArtTextParagraph[];
|
|
3042
3406
|
/**
|
|
3043
3407
|
* Optional per-node visual override (fill / line / font colour, bold /
|
|
3044
3408
|
* italic). Read at parse time from the point's `spPr` / first-run `rPr`, set
|
|
@@ -3202,7 +3566,7 @@ interface PptxSmartArtConnection {
|
|
|
3202
3566
|
* // => satisfies PptxSmartArtDrawingShape
|
|
3203
3567
|
* ```
|
|
3204
3568
|
*/
|
|
3205
|
-
interface PptxSmartArtDrawingShape {
|
|
3569
|
+
interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
|
|
3206
3570
|
/** Shape ID within the drawing. */
|
|
3207
3571
|
id: string;
|
|
3208
3572
|
/** Preset geometry type (e.g. "roundRect", "ellipse"). */
|
|
@@ -3226,6 +3590,8 @@ interface PptxSmartArtDrawingShape {
|
|
|
3226
3590
|
strokeWidth?: number;
|
|
3227
3591
|
/** Text content of the shape. */
|
|
3228
3592
|
text?: string;
|
|
3593
|
+
/** Standard rich-text segments projected from the associated SmartArt node. */
|
|
3594
|
+
textSegments?: TextSegment[];
|
|
3229
3595
|
/** Font size in points. */
|
|
3230
3596
|
fontSize?: number;
|
|
3231
3597
|
/** Font colour (hex). */
|
|
@@ -3923,6 +4289,8 @@ interface MediaPptxElement extends PptxElementBase {
|
|
|
3923
4289
|
mediaMimeType?: string;
|
|
3924
4290
|
mediaReferenceKind?: PptxMediaReferenceKind;
|
|
3925
4291
|
mediaReferenceName?: string;
|
|
4292
|
+
/** Explicit DrawingML `audioFile/@contentType` value when present. */
|
|
4293
|
+
mediaReferenceContentType?: string;
|
|
3926
4294
|
audioCdStart?: PptxAudioCdPosition;
|
|
3927
4295
|
audioCdEnd?: PptxAudioCdPosition;
|
|
3928
4296
|
rawMediaReferenceXml?: XmlObject;
|
|
@@ -4046,6 +4414,10 @@ interface ContentPartPptxElement extends PptxElementBase {
|
|
|
4046
4414
|
type: 'contentPart';
|
|
4047
4415
|
/** Ink strokes contained in this content part. */
|
|
4048
4416
|
inkStrokes?: ContentPartInkStroke[];
|
|
4417
|
+
/** Package path of the related InkML part. */
|
|
4418
|
+
inkPartPath?: string;
|
|
4419
|
+
/** Parsed InkML root retained for unknown-node preservation on dirty save. */
|
|
4420
|
+
inkPartRawXml?: XmlObject;
|
|
4049
4421
|
}
|
|
4050
4422
|
/**
|
|
4051
4423
|
* A Slide Zoom or Section Zoom element (PowerPoint Zoom Object).
|
|
@@ -4066,12 +4438,32 @@ interface ContentPartPptxElement extends PptxElementBase {
|
|
|
4066
4438
|
*/
|
|
4067
4439
|
interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
|
|
4068
4440
|
type: 'zoom';
|
|
4069
|
-
/** Type of zoom: slide-level or section
|
|
4070
|
-
zoomType: 'slide' | 'section';
|
|
4441
|
+
/** Type of zoom: slide-level, section-level, or a multi-section summary. */
|
|
4442
|
+
zoomType: 'slide' | 'section' | 'summary';
|
|
4071
4443
|
/** Zero-based index of the target slide. */
|
|
4072
4444
|
targetSlideIndex: number;
|
|
4073
4445
|
/** Section ID for section zoom. */
|
|
4074
4446
|
targetSectionId?: string;
|
|
4447
|
+
/** Ordered section tiles in a Summary Zoom container. */
|
|
4448
|
+
summaryTargets?: SummaryZoomTarget[];
|
|
4449
|
+
/** Layout mode authored on the Summary Zoom container. */
|
|
4450
|
+
summaryLayout?: 'grid' | 'fixed';
|
|
4451
|
+
}
|
|
4452
|
+
/** A single section tile within a PowerPoint Summary Zoom container. */
|
|
4453
|
+
interface SummaryZoomTarget extends PptxImageProperties {
|
|
4454
|
+
sectionId: string;
|
|
4455
|
+
targetSlideIndex: number;
|
|
4456
|
+
x: number;
|
|
4457
|
+
y: number;
|
|
4458
|
+
width: number;
|
|
4459
|
+
height: number;
|
|
4460
|
+
title?: string;
|
|
4461
|
+
description?: string;
|
|
4462
|
+
offsetFactorX?: number;
|
|
4463
|
+
offsetFactorY?: number;
|
|
4464
|
+
scaleFactorX?: number;
|
|
4465
|
+
scaleFactorY?: number;
|
|
4466
|
+
rawXml?: XmlObject;
|
|
4075
4467
|
}
|
|
4076
4468
|
/**
|
|
4077
4469
|
* A 3D model object embedded via `p16:model3D` inside an
|
|
@@ -4729,6 +5121,33 @@ interface PptxElementAnimation {
|
|
|
4729
5121
|
stopSound?: boolean;
|
|
4730
5122
|
}
|
|
4731
5123
|
|
|
5124
|
+
interface PptxEmbeddedFontDataId {
|
|
5125
|
+
/** Required relationship identifier from `r:id`. */
|
|
5126
|
+
relationshipId?: string | null;
|
|
5127
|
+
/** Original leaf retained for unknown attribute preservation. */
|
|
5128
|
+
rawXml?: XmlObject;
|
|
5129
|
+
}
|
|
5130
|
+
interface PptxEmbeddedFontDescriptor {
|
|
5131
|
+
typeface?: string | null;
|
|
5132
|
+
panose?: string | null;
|
|
5133
|
+
pitchFamily?: string | null;
|
|
5134
|
+
charset?: string | null;
|
|
5135
|
+
rawXml?: XmlObject;
|
|
5136
|
+
}
|
|
5137
|
+
interface PptxEmbeddedFontListEntry {
|
|
5138
|
+
font: PptxEmbeddedFontDescriptor;
|
|
5139
|
+
regular?: PptxEmbeddedFontDataId | null;
|
|
5140
|
+
bold?: PptxEmbeddedFontDataId | null;
|
|
5141
|
+
italic?: PptxEmbeddedFontDataId | null;
|
|
5142
|
+
boldItalic?: PptxEmbeddedFontDataId | null;
|
|
5143
|
+
rawXml?: XmlObject;
|
|
5144
|
+
}
|
|
5145
|
+
interface PptxEmbeddedFontList {
|
|
5146
|
+
fonts: PptxEmbeddedFontListEntry[];
|
|
5147
|
+
/** Original list retained for unknown attribute and child preservation. */
|
|
5148
|
+
rawXml?: XmlObject;
|
|
5149
|
+
}
|
|
5150
|
+
|
|
4732
5151
|
/**
|
|
4733
5152
|
* Metadata types: slide comments, compatibility warnings, tags,
|
|
4734
5153
|
* custom properties, core/app document properties.
|
|
@@ -4884,9 +5303,17 @@ interface PptxTag {
|
|
|
4884
5303
|
*/
|
|
4885
5304
|
interface PptxTagCollection {
|
|
4886
5305
|
/** File path within the PPTX archive. */
|
|
4887
|
-
path
|
|
5306
|
+
path?: string;
|
|
5307
|
+
/** Package owner of the tags relationship. New collections default to presentation. */
|
|
5308
|
+
owner?: 'presentation' | 'slide' | 'part';
|
|
5309
|
+
/** Source OPC part that owns the relationship, e.g. ppt/slides/slide1.xml. */
|
|
5310
|
+
sourcePartPath?: string;
|
|
5311
|
+
/** Durable relationship identifier from the owning part. */
|
|
5312
|
+
relationshipId?: string;
|
|
4888
5313
|
/** Tags in this collection. */
|
|
4889
5314
|
tags: PptxTag[];
|
|
5315
|
+
/** Parsed tag-list XML retained for unknown-node preservation. */
|
|
5316
|
+
rawXml?: XmlObject;
|
|
4890
5317
|
}
|
|
4891
5318
|
/**
|
|
4892
5319
|
* A custom document property from `docProps/custom.xml`.
|
|
@@ -4992,6 +5419,19 @@ interface PptxAppProperties {
|
|
|
4992
5419
|
hyperlinkBase?: string;
|
|
4993
5420
|
}
|
|
4994
5421
|
|
|
5422
|
+
type PptxPrintOutput = 'slides' | 'handouts1' | 'handouts2' | 'handouts3' | 'handouts4' | 'handouts6' | 'handouts9' | 'notes' | 'outline';
|
|
5423
|
+
type PptxPrintColorMode = 'bw' | 'gray' | 'clr';
|
|
5424
|
+
/** PresentationML `CT_PrintProperties` (`p:prnPr`). */
|
|
5425
|
+
interface PptxPresentationPrintProperties {
|
|
5426
|
+
printWhat?: PptxPrintOutput | null;
|
|
5427
|
+
colorMode?: PptxPrintColorMode | null;
|
|
5428
|
+
hiddenSlides?: boolean | null;
|
|
5429
|
+
scaleToFitPaper?: boolean | null;
|
|
5430
|
+
frameSlides?: boolean | null;
|
|
5431
|
+
/** Original subtree retained for unknown attributes and `p:extLst`. */
|
|
5432
|
+
rawXml?: XmlObject;
|
|
5433
|
+
}
|
|
5434
|
+
|
|
4995
5435
|
/**
|
|
4996
5436
|
* Theme object model — colour scheme, font scheme, and format scheme
|
|
4997
5437
|
* parsed from `ppt/theme/theme1.xml`.
|
|
@@ -5399,6 +5839,11 @@ interface PptxViewScale {
|
|
|
5399
5839
|
n: number;
|
|
5400
5840
|
/** Denominator of the scale percentage (e.g. 100 for 100%). */
|
|
5401
5841
|
d: number;
|
|
5842
|
+
/** Optional independent vertical scale. When absent, the X scale is used. */
|
|
5843
|
+
sy?: {
|
|
5844
|
+
n: number;
|
|
5845
|
+
d: number;
|
|
5846
|
+
};
|
|
5402
5847
|
}
|
|
5403
5848
|
/**
|
|
5404
5849
|
* Origin point for a view (x, y in twips or EMU).
|
|
@@ -5407,6 +5852,16 @@ interface PptxViewOrigin {
|
|
|
5407
5852
|
x: number;
|
|
5408
5853
|
y: number;
|
|
5409
5854
|
}
|
|
5855
|
+
/** A horizontal or vertical drawing guide in slide coordinates. */
|
|
5856
|
+
interface PptxViewGuide {
|
|
5857
|
+
orientation?: 'horz' | 'vert';
|
|
5858
|
+
position?: number;
|
|
5859
|
+
}
|
|
5860
|
+
/** Positive grid spacing from `p:gridSpacing`. */
|
|
5861
|
+
interface PptxGridSpacing {
|
|
5862
|
+
cx: number;
|
|
5863
|
+
cy: number;
|
|
5864
|
+
}
|
|
5410
5865
|
/**
|
|
5411
5866
|
* Restored region dimensions for normal view splitter.
|
|
5412
5867
|
* Represents `p:restoredLeft` or `p:restoredTop`.
|
|
@@ -5448,6 +5903,10 @@ interface PptxCommonSlideViewProperties {
|
|
|
5448
5903
|
snapToObjects?: boolean;
|
|
5449
5904
|
/** Whether drawing guides are shown. */
|
|
5450
5905
|
showGuides?: boolean;
|
|
5906
|
+
/** Whether the application may vary the scale automatically. */
|
|
5907
|
+
variableScale?: boolean;
|
|
5908
|
+
/** Drawing guides shown in this slide view. */
|
|
5909
|
+
guides?: PptxViewGuide[];
|
|
5451
5910
|
/** View origin (scroll position). */
|
|
5452
5911
|
origin?: PptxViewOrigin;
|
|
5453
5912
|
/** View scale. */
|
|
@@ -5475,6 +5934,8 @@ interface PptxViewProperties {
|
|
|
5475
5934
|
};
|
|
5476
5935
|
/** Notes view properties. */
|
|
5477
5936
|
notesViewPr?: PptxCommonSlideViewProperties;
|
|
5937
|
+
/** Grid spacing in positive DrawingML coordinates. */
|
|
5938
|
+
gridSpacing?: PptxGridSpacing;
|
|
5478
5939
|
/** Raw XML preserved for lossless round-trip of unparsed attributes. */
|
|
5479
5940
|
rawXml?: Record<string, unknown>;
|
|
5480
5941
|
}
|
|
@@ -5489,12 +5950,16 @@ interface PptxViewProperties {
|
|
|
5489
5950
|
* @see ECMA-376 Part 1, §19.2.1.3 (custDataLst), §19.3.1.6 (custData)
|
|
5490
5951
|
*/
|
|
5491
5952
|
interface PptxCustomerData {
|
|
5492
|
-
/** Resolved part path inside the package (e.g. `
|
|
5493
|
-
id
|
|
5953
|
+
/** Resolved part path inside the package (e.g. `customXml/item1.xml`). */
|
|
5954
|
+
id?: string;
|
|
5494
5955
|
/** Relationship ID referencing the custom data part. */
|
|
5495
|
-
relId
|
|
5956
|
+
relId?: string;
|
|
5496
5957
|
/** Raw string content of the custom data part (if resolvable). */
|
|
5497
5958
|
data?: string;
|
|
5959
|
+
/** OPC content type for the custom data part. */
|
|
5960
|
+
contentType?: string;
|
|
5961
|
+
/** Raw `p:custData` XML retained for unknown-node preservation. */
|
|
5962
|
+
rawXml?: XmlObject;
|
|
5498
5963
|
}
|
|
5499
5964
|
/**
|
|
5500
5965
|
* An ActiveX control reference from `p:controls / p:control`.
|
|
@@ -5743,11 +6208,13 @@ interface PptxPresentationProperties {
|
|
|
5743
6208
|
showSlidesTo?: number;
|
|
5744
6209
|
/** Whether to show subtitles/captions during presentation mode. */
|
|
5745
6210
|
showSubtitles?: boolean;
|
|
5746
|
-
/**
|
|
6211
|
+
/** Typed `p:prnPr` settings. Set to null during save to remove the element. */
|
|
6212
|
+
printProperties?: PptxPresentationPrintProperties | null;
|
|
6213
|
+
/** @deprecated Use `printProperties.printWhat`; retained as a handout compatibility alias. */
|
|
5747
6214
|
printSlidesPerPage?: number;
|
|
5748
|
-
/**
|
|
6215
|
+
/** @deprecated Use `printProperties.frameSlides`. */
|
|
5749
6216
|
printFrameSlides?: boolean;
|
|
5750
|
-
/**
|
|
6217
|
+
/** @deprecated Use `printProperties.colorMode`. */
|
|
5751
6218
|
printColorMode?: 'clr' | 'gray' | 'bw';
|
|
5752
6219
|
/** Most-recently-used colours from the presentation palette. */
|
|
5753
6220
|
mruColors?: string[];
|
|
@@ -5884,11 +6351,13 @@ interface PptxPhotoAlbum {
|
|
|
5884
6351
|
*/
|
|
5885
6352
|
interface PptxKinsoku {
|
|
5886
6353
|
/** Language code (e.g. "ja-JP", "zh-CN"). */
|
|
5887
|
-
lang?: string;
|
|
6354
|
+
lang?: string | null;
|
|
5888
6355
|
/** Characters that cannot begin a line. */
|
|
5889
6356
|
invalStChars?: string;
|
|
5890
6357
|
/** Characters that cannot end a line. */
|
|
5891
6358
|
invalEndChars?: string;
|
|
6359
|
+
/** Original leaf retained for unknown attribute preservation. */
|
|
6360
|
+
rawXml?: XmlObject;
|
|
5892
6361
|
}
|
|
5893
6362
|
/**
|
|
5894
6363
|
* Root data structure returned by {@link PptxHandlerCore.load}.
|
|
@@ -5939,6 +6408,8 @@ interface PptxData {
|
|
|
5939
6408
|
isPasswordProtected?: boolean;
|
|
5940
6409
|
/** Embedded font data (name + binary data URL) extracted from the presentation. */
|
|
5941
6410
|
embeddedFonts?: PptxEmbeddedFont[];
|
|
6411
|
+
/** Typed `p:embeddedFontLst` package metadata, including unresolved variants. */
|
|
6412
|
+
embeddedFontList?: PptxEmbeddedFontList;
|
|
5942
6413
|
/** Most-recently-used colour list from presentation properties. */
|
|
5943
6414
|
mruColors?: string[];
|
|
5944
6415
|
/** Parsed notes master data if present in the PPTX. */
|
|
@@ -6097,4 +6568,4 @@ interface PptxEmbeddedFont {
|
|
|
6097
6568
|
originalPartBytes?: Uint8Array;
|
|
6098
6569
|
}
|
|
6099
6570
|
|
|
6100
|
-
export { type
|
|
6571
|
+
export { type PptxComment as $, type PptxCoreProperties as A, type PptxAppProperties as B, type ConnectorPptxElement as C, type PptxCustomProperty as D, type PptxNotesMaster as E, type PptxHandoutMaster as F, type PptxSlideMaster as G, type PptxSlideLayout as H, type InkPptxElement as I, type PptxTagCollection as J, type PptxCustomerData as K, type PptxPhotoAlbum as L, type PptxKinsoku as M, type PptxModifyVerifier as N, type PptxViewProperties as O, type PptxSlide as P, type ParsedTableStyleMap as Q, type PptxEmbeddedFont as R, type ShapePptxElement as S, type TextPptxElement as T, type PptxEmbeddedFontList as U, type PptxExportOptions as V, type PptxMediaReferenceKind as W, type XmlObject as X, type PptxThemeFormatScheme as Y, type ZoomPptxElement as Z, type TextSegment as _, type PptxElement as a, type PptxChartOfPieOptions as a$, type PptxModernCommentPart as a0, type PptxSlideBackgroundPattern as a1, type PptxSlideTransition as a2, type PptxElementAnimation as a3, type PptxNativeAnimation as a4, type PptxActiveXControl as a5, type AnimationCondition as a6, type PptxGraphicBuild as a7, type PptxAnimationTarget as a8, type ShapeStyle as a9, type PptxChartLayouts as aA, type PptxChartManualLayout as aB, type PptxBubbleChartOptions as aC, type PptxSmartArtLayoutNode as aD, type PptxChartUpDownBars as aE, type PptxAudioCdPosition as aF, type MediaPptxElement as aG, type PptxCustomXmlPart as aH, type PptxCommentAuthor as aI, type PptxTableData as aJ, type PptxTheme as aK, type PptxThemeOption as aL, type PptxModernCommentAuthor as aM, type PlaceholderDefaults as aN, type PptxMasterTextStyles as aO, type PptxThemeObjectDefaults as aP, type ParsedTableStyleFill as aQ, type ParsedTableBackground as aR, type ParsedTableStyleText as aS, type PptxImageEffects as aT, type MediaBookmark as aU, type PptxChartStyle as aV, type TablePptxElement as aW, type ChartPptxElement as aX, type OlePptxElement as aY, type GroupPptxElement as aZ, type PlaceholderTextLevelStyle as a_, type TextStyle as aa, type ElementAction as ab, type PptxAction as ac, type ContentPartInkStroke as ad, type OleObjectType as ae, type PptxSmartArtNodeStyle as af, type PptxSmartArtDrawingShape as ag, type PptxChartDataTable as ah, type PptxChartLineStyle as ai, type PptxChartErrBars as aj, type PptxChartTrendline as ak, type PptxChartDataLabel as al, type PptxChartMarker as am, type PptxChartDataPoint as an, type PptxChartShapeProps as ao, type PptxChart3DSurface as ap, type PptxChartAxisFormatting as aq, type PptxEmbeddedWorkbookData as ar, type PptxDrawingGuide as as, type SmartArtLayoutType as at, type PptxSmartArtNode as au, type PptxSmartArtLayoutDefinition as av, type PptxSmartArtColorStyleLabel as aw, type PptxSmartArtDefinitionMetadata as ax, type PptxSmartArtQuickStyleLabel as ay, type PptxTableCellStyle as az, type PptxElementWithShapeStyle as b, type PptxChartDataLabelPosition as b$, type PptxChartView3D as b0, type PptxChartChrome as b1, type PptxChartSeries as b2, type SmartArtPptxElement as b3, type Model3DPptxElement as b4, type ContentPartPptxElement as b5, type GeometryAdjustmentHandle as b6, type CustomGeometryRawData as b7, type AdjustHandleXY as b8, type AdjustHandlePolar as b9, type EffectDagBlendMode as bA, type EffectDagBlur as bB, type EffectDagContainer as bC, type EffectDagContainerType as bD, type EffectDagNode as bE, type EffectDagPresetShadow as bF, type EffectDagRawLeaf as bG, type EffectDagRelOff as bH, type EffectDagXfrm as bI, type ElementActionType as bJ, type MasterViewTab as bK, type MaterialPresetType as bL, type MediaCaptionTrack as bM, type MediaMetadata as bN, type ParsedTableStyleEntry as bO, type PicturePptxElement as bP, type Pptx3DScene as bQ, type Pptx3DShape as bR, type PptxAfterAnimationAction as bS, type PptxAnimationDirection as bT, type PptxAnimationIterate as bU, type PptxAnimationKeyframe as bV, type PptxAnimationRepeatMode as bW, type PptxAnimationSequence as bX, type PptxAnimationTimingCurve as bY, type PptxChartAxisLabelFormatting as bZ, type PptxChartAxisNumFmt as b_, type ConnectionSite as ba, type CustomGeometryTextRect as bb, type CustomGeometryPath as bc, type BulletInfo as bd, type PptxShapeLocks as be, type PptxTextStyleLevels as bf, type PptxThemeFillStyle as bg, type PptxThemeLineStyle as bh, type PptxThemeEffectStyle as bi, type PptxSmartArtTextRun as bj, type PptxSmartArtChrome as bk, type PptxSmartArtColorTransform as bl, type PptxSmartArtConnection as bm, type PptxSmartArtQuickStyle as bn, type PptxExternalData as bo, type CustomGeometryPoint as bp, type ImagePptxElement as bq, type PptxChartDataLabelOptions as br, type PptxChartMarkerSymbol as bs, type ActionButtonPreset as bt, type AnimationConditionEvent as bu, type BevelPresetType as bv, type ConnectorConnectionPoint as bw, type CustomGeometrySegment as bx, type EffectDagAlphaOutset as by, type EffectDagBlend as bz, type PptxElementWithText as c, type PptxSmartArtWhen as c$, type PptxChartDateCategories as c0, type PptxChartDisplayUnitsLabel as c1, type PptxChartErrBarDir as c2, type PptxChartErrBarType as c3, type PptxChartErrValType as c4, type PptxChartLegendEntry as c5, type PptxChartLegendTextStyle as c6, type PptxChartPageMargins as c7, type PptxChartPageSetup as c8, type PptxChartParentLabelLayout as c9, type PptxNormalViewProperties as cA, type PptxPresentationPrintProperties as cB, type PptxPrintColorMode as cC, type PptxPrintOutput as cD, type PptxRestoredRegion as cE, type PptxShapeProperties as cF, type PptxSlideSyncProperties as cG, type PptxSmartArtAlgorithmParameter as cH, type PptxSmartArtChoose as cI, type PptxSmartArtColorApplicationMethod as cJ, type PptxSmartArtColorListMetadata as cK, type PptxSmartArtConstraint as cL, type PptxSmartArtConstraintOperator as cM, type PptxSmartArtConstraintPointType as cN, type PptxSmartArtConstraintRelationship as cO, type PptxSmartArtConstraintTarget as cP, type PptxSmartArtDefinitionCategory as cQ, type PptxSmartArtDefinitionText as cR, type PptxSmartArtForEach as cS, type PptxSmartArtHueDirection as cT, type PptxSmartArtIteratorAttributes as cU, type PptxSmartArtLayoutAlgorithm as cV, type PptxSmartArtLayoutCategory as cW, type PptxSmartArtLocalizedText as cX, type PptxSmartArtNumericRule as cY, type PptxSmartArtTextParagraph as cZ, type PptxSmartArtTextParagraphItem as c_, type PptxChartPivotFormat as ca, type PptxChartPivotFormats as cb, type PptxChartPivotSource as cc, type PptxChartPrintHeaderFooter as cd, type PptxChartPrintSettings as ce, type PptxChartProtection as cf, type PptxChartTickMark as cg, type PptxChartTrendlineLabel as ch, type PptxChartTrendlineType as ci, type PptxColorAnimation as cj, type PptxCommonSlideViewProperties as ck, type PptxCropShape as cl, type PptxCustomDashSegment as cm, type PptxCustomPathProperties as cn, type PptxElementBase as co, type PptxElementType as cp, type PptxEmbeddedFontDataId as cq, type PptxEmbeddedFontDescriptor as cr, type PptxEmbeddedFontListEntry as cs, type PptxExportFormat as ct, type PptxGraphicFrameExtension as cu, type PptxGridSpacing as cv, type PptxHeaderFooterFlags as cw, type PptxImageProperties as cx, type PptxMediaType as cy, type PptxNativeAnimationKind as cz, type PptxImageLikeElement as d, type PptxSplitDirection as d0, type PptxSplitOrientation as d1, type PptxStripDirection as d2, type PptxTableCell as d3, type PptxTableRow as d4, type PptxTag as d5, type PptxTextAnimationTarget as d6, type PptxTextBuildType as d7, type PptxTextProperties as d8, type PptxTextWarpPreset as d9, type PptxThemeFontGroup as da, type PptxTransitionDirection4 as db, type PptxTransitionDirection8 as dc, type PptxTransitionSpeed as dd, type PptxViewGuide as de, type PptxViewOrigin as df, type PptxViewScale as dg, type ShadowEffect as dh, type SmartArtColorScheme as di, type SmartArtLayout as dj, type SmartArtStyle as dk, type SummaryZoomTarget as dl, THEME_COLOR_SCHEME_KEYS as dm, TRANSITION_VALID_DIRECTIONS as dn, type Text3DStyle as dp, type UnderlineStyle as dq, type UnknownPptxElement as dr, type PptxThemeColorScheme as e, type PptxThemeFontScheme as f, type PptxAnimationPreset as g, type PptxAnimationTrigger as h, type PptxChartBoxWhiskerOptions as i, type PptxChartHistogramOptions as j, type PptxChartWaterfallOptions as k, type PptxChartRegionMapOptions as l, type PptxChartTreemapOptions as m, type StrokeDashType as n, type ConnectorArrowType as o, type PptxTransitionType as p, type PptxChartType as q, type PptxData as r, type PptxCompatibilityWarning as s, type PptxLayoutOption as t, type PptxChartData as u, type PptxSmartArtData as v, type PptxHeaderFooter as w, type PptxPresentationProperties as x, type PptxCustomShow as y, type PptxSection as z };
|