@s8fy/pptx-parser 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,1212 @@
+export interface Shadow {
+  h: number
+  v: number
+  blur: number
+  color: string
+  sx?: number
+  sy?: number
+}
+
+export interface Glow {
+  rad: number
+  color: string
+}
+
+export interface ColorFill {
+  type: 'color'
+  value: string
+}
+
+export type PictureFillMode = 'stretch' | 'tile'
+export type PictureFillAlignment = 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br'
+export type PictureFillFlip = 'none' | 'x' | 'y' | 'xy'
+
+export interface PictureFillRect {
+  /** Fraction of the source/target width from the left edge; 0.25 means 25%. */
+  l: number
+  /** Fraction of the source/target height from the top edge. */
+  t: number
+  /** Fraction of the source/target width from the right edge. */
+  r: number
+  /** Fraction of the source/target height from the bottom edge. */
+  b: number
+}
+
+export interface PictureFillTile {
+  /** Horizontal scale ratio; 1 means 100% of the image's natural display width. */
+  scaleX: number
+  /** Vertical scale ratio; 1 means 100% of the image's natural display height. */
+  scaleY: number
+  /** Horizontal tile offset in parser px. */
+  offsetX: number
+  /** Vertical tile offset in parser px. */
+  offsetY: number
+  align: PictureFillAlignment
+  flip: PictureFillFlip
+}
+
+interface PictureFillValueBase {
+  picBase64: string
+  opacity: number
+  sourceRect?: PictureFillRect
+  rotateWithShape: boolean
+  /** Positive DrawingML DPI override; omitted means use embedded image density. */
+  dpi?: number
+  duotone?: [string, string]
+}
+
+export interface StretchPictureFillValue extends PictureFillValueBase {
+  mode: 'stretch'
+  fillRect?: PictureFillRect
+  tile?: never
+}
+
+export interface TilePictureFillValue extends PictureFillValueBase {
+  mode: 'tile'
+  fillRect?: never
+  tile: PictureFillTile
+}
+
+export type PictureFillValue = StretchPictureFillValue | TilePictureFillValue
+
+export interface ImageFill {
+  type: 'image'
+  value: PictureFillValue
+}
+
+export interface GradientFill {
+  type: 'gradient'
+  value: {
+    path: 'line' | 'circle' | 'rect' | 'shape'
+    rot: number
+    colors: {
+      pos: string
+      color: string
+    }[]
+  }
+}
+
+export interface PatternFill {
+  type: 'pattern'
+  value: {
+    type: string
+    foregroundColor: string
+    backgroundColor: string
+  }
+}
+
+export type Fill = ColorFill | ImageFill | GradientFill | PatternFill
+
+// --- Structured text types ---
+
+export type TextColor = string | { colors: { color: string; pos: string }[]; rot: number }
+
+export interface TextRun {
+  text: string
+  fieldType?: string
+  color?: TextColor
+  fontSize?: string
+  fontFamily?: string
+  fontWeight?: string
+  fontStyle?: string
+  textDecoration?: string
+  textDecorationLine?: string
+  letterSpacing?: string
+  verticalAlign?: string
+  textShadow?: string
+  highlightColor?: string
+}
+
+export interface TextMathRun {
+  type: 'math'
+  latex: string
+  displayMode?: boolean
+  color?: TextColor
+  fontSize?: string
+  fontFamily?: string
+  fontWeight?: string
+  fontStyle?: string
+  textDecoration?: string
+  textDecorationLine?: string
+  letterSpacing?: string
+  verticalAlign?: string
+  textShadow?: string
+  highlightColor?: string
+}
+
+export interface TextLink extends TextRun {
+  linkURL: string
+  linkColor?: string
+  linkTooltip?: string
+  linkAction?: string
+}
+
+export interface TextBreak {
+  type: 'br'
+}
+
+export interface BulletInfo {
+  char?: string
+  marLPt: number
+  indentPt: number
+  fontSize?: string
+  fontFamily?: string
+  color?: string
+  autoNumType?: string
+  autoNumIndex?: number
+}
+
+export interface TextParagraph {
+  align: string
+  lineHeight?: number
+  spaceBefore?: string
+  spaceAfter?: string
+  marginLeft?: string
+  textIndent?: string
+  list?: {
+    type: 'ul' | 'ol'
+    level: number
+    bullet?: BulletInfo
+  }
+  runs: (TextRun | TextLink | TextMathRun | TextBreak)[]
+}
+
+export interface Border {
+  borderColor: string
+  borderWidth: number
+  borderType: 'solid' | 'dashed' | 'dotted'
+  borderGradient?: GradientFill['value']
+}
+
+export interface ArrowEndpoint {
+  type: 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow'
+  w?: 'sm' | 'med' | 'lg'
+  len?: 'sm' | 'med' | 'lg'
+}
+
+export interface AutoFit {
+  type: 'shape' | 'text'
+  fontScale?: number
+}
+
+/**
+ * Rendering layer metadata used by viewer-side sorting:
+ * -2: slide master, -1: slide layout, 0/undefined: current slide.
+ */
+export interface LayeredElementMeta {
+  _layer?: number
+  /** True when this element has an actual OOXML p:ph placeholder node. */
+  isPlaceholder?: boolean
+}
+
+export interface Shape {
+  type: 'shape'
+  left: number
+  top: number
+  width: number
+  height: number
+  borderColor: string
+  borderWidth: number
+  borderType: 'solid' | 'dashed' | 'dotted'
+  borderStrokeDasharray: string
+  borderGradient?: GradientFill['value']
+  shadow?: Shadow
+  glow?: Glow
+  fill: Fill
+  content: TextParagraph[]
+  isFlipV?: boolean
+  isFlipH?: boolean
+  rotate?: number
+  shapType: string
+  vAlign: string
+  path?: string
+  keypoints?: Record<string, number>
+  name: string
+  order: number
+  autoFit?: AutoFit
+  textOverflow?: 'overflow' | 'clip' | 'ellipsis'
+  spcFirstLastPara?: boolean
+  headEnd?: ArrowEndpoint
+  tailEnd?: ArrowEndpoint
+}
+
+export interface SlideText {
+  type: 'text'
+  left: number
+  top: number
+  width: number
+  height: number
+  borderColor: string
+  borderWidth: number
+  borderType: 'solid' | 'dashed' | 'dotted'
+  borderStrokeDasharray: string
+  borderGradient?: GradientFill['value']
+  shadow?: Shadow
+  glow?: Glow
+  fill: Fill
+  isFlipV?: boolean
+  isFlipH?: boolean
+  isVertical?: boolean
+  rotate?: number
+  content: TextParagraph[]
+  /** Optional backing geometry for filled/bordered text boxes. */
+  shapType?: string
+  /** SVG path for the backing geometry when present. */
+  path?: string
+  vAlign: string
+  name: string
+  order: number
+  autoFit?: AutoFit
+  textOverflow?: 'overflow' | 'clip' | 'ellipsis'
+  spcFirstLastPara?: boolean
+  headEnd?: ArrowEndpoint
+  tailEnd?: ArrowEndpoint
+}
+
+export interface SlideImage {
+  type: 'image'
+  left: number
+  top: number
+  width: number
+  height: number
+  src: string
+  /** Semantic image description from OOXML cNvPr descr, falling back to cNvPr name. */
+  name?: string
+  rotate?: number
+  isFlipH?: boolean
+  isFlipV?: boolean
+  order: number
+  /** Black/white threshold effect from OOXML <a:biLevel>, normalized to 0..1. */
+  biLevel?: number
+  rect?: {
+    t?: number
+    b?: number
+    l?: number
+    r?: number
+  }
+  geom: string
+  clipPathData?: string
+  keypoints?: Record<string, number>
+  borderColor: string
+  borderWidth: number
+  borderType: 'solid' | 'dashed' | 'dotted'
+  borderStrokeDasharray: string
+  borderGradient?: GradientFill['value']
+  /** Duotone recolor extracted from OOXML <a:duotone>. */
+  duotone?: [string, string]
+  filters?: {
+    sharpen?: number
+    colorTemperature?: number
+    saturation?: number
+    brightness?: number
+    contrast?: number
+  }
+}
+
+export interface TableCell {
+  text: TextParagraph[]
+  rowSpan?: number
+  colSpan?: number
+  vMerge?: number
+  hMerge?: number
+  fillColor?: string
+  fontColor?: string
+  fontBold?: boolean
+  vAlign?: 'up' | 'mid' | 'down'
+  padding?: {
+    left: number
+    top: number
+    right: number
+    bottom: number
+  }
+  borders: {
+    top?: Border
+    bottom?: Border
+    left?: Border
+    right?: Border
+  }
+  spcFirstLastPara?: boolean
+}
+export interface Table {
+  type: 'table'
+  left: number
+  top: number
+  width: number
+  height: number
+  data: TableCell[][]
+  borders: {
+    top?: Border
+    bottom?: Border
+    left?: Border
+    right?: Border
+  }
+  order: number
+  rowHeights: number[]
+  colWidths: number[]
+}
+
+export type OoxmlChartType =
+  | 'lineChart'
+  | 'line3DChart'
+  | 'barChart'
+  | 'bar3DChart'
+  | 'pieChart'
+  | 'pie3DChart'
+  | 'doughnutChart'
+  | 'areaChart'
+  | 'area3DChart'
+  | 'scatterChart'
+  | 'bubbleChart'
+  | 'radarChart'
+  | 'surfaceChart'
+  | 'surface3DChart'
+  | 'stockChart'
+  | 'waterfall'
+  | 'sunburst'
+  | 'treemap'
+  | 'histogram'
+  | 'boxWhisker'
+  | 'funnel'
+
+export type ChartType =
+  | 'bar'
+  | 'column'
+  | 'line'
+  | 'pie'
+  | 'ring'
+  | 'area'
+  | 'radar'
+  | 'scatter'
+  | 'bubble'
+  | 'stock'
+  | 'surface'
+  | 'waterfall'
+  | 'sunburst'
+  | 'treemap'
+  | 'histogram'
+  | 'boxWhisker'
+  | 'funnel'
+
+export interface ChartValue {
+  x: string
+  y: number
+  size?: number
+}
+export interface ChartXLabel {
+  [key: string]: string
+}
+export interface ChartItem {
+  key: string
+  values: ChartValue[]
+  xlabels?: ChartXLabel
+  smooth?: boolean
+}
+export interface ChartOutline {
+  color?: string
+  width?: number
+  style?: 'solid' | 'dashed' | 'dotted'
+  strokeDasharray?: string
+}
+export interface ChartSeriesStyle {
+  outline?: ChartOutline
+  fill?: string | GradientFill['value']
+  marker?: string
+  markerSize?: number
+  markerFill?: string | GradientFill['value']
+  markerOutline?: ChartOutline
+  smooth?: boolean
+  dataLabels?: ChartDataLabels
+  /**
+   * Per-series `c:shape` override of a 3D bar chart (`CT_BarSer/c:shape`),
+   * alongside the chart-group level `barShape`. Transcribed for fidelity; the
+   * bundled renderers degrade every shape to `box`.
+   */
+  shape?: ChartBarShape
+}
+/** A sparse `c:bandFmt` override, keyed by its required explicit `c:idx`. */
+export interface ChartBandFormat {
+  index: number
+  fill?: string | GradientFill['value']
+  outline?: ChartOutline
+}
+/** `ST_Shape` — the bar geometry of a 3D bar chart. */
+export type ChartBarShape = 'box' | 'cone' | 'coneToMax' | 'cylinder' | 'pyramid' | 'pyramidToMax'
+/**
+ * The fixed 3D camera of a legacy chart (`c:view3D`, `CT_View3D`).
+ *
+ * Every field is present only when the file declares it; the parser never
+ * substitutes the ECMA-376 attribute default, so `omitted` stays
+ * distinguishable from `explicit`. Renderers apply the defaults themselves
+ * (`rotX` 0, `rotY` 0, `rightAngleAxes` true, `perspective` 30,
+ * `depthPercent` 100, `heightPercent` 100). Values outside the schema ranges
+ * are transcribed faithfully rather than clamped.
+ */
+export interface ChartView3D {
+  /** `c:rotX`, degrees, schema range -90..90. */
+  rotX?: number
+  /** `c:rotY`, degrees, schema range 0..360. */
+  rotY?: number
+  /** `c:rAngAx`. Perspective has no visible effect while this is true. */
+  rightAngleAxes?: boolean
+  /** `c:perspective`, schema range 0..240. Only meaningful when `rightAngleAxes` is false. */
+  perspective?: number
+  /** `c:depthPercent`, chart depth as a percentage of width, schema range 20..2000. */
+  depthPercent?: number
+  /** `c:hPercent`, chart height as a percentage of width, schema range 5..500. */
+  heightPercent?: number
+}
+/**
+ * One face of the 3D plot cube: `c:floor`, `c:backWall` or `c:sideWall`
+ * (all `CT_Surface`).
+ *
+ * `CT_Surface` also allows `c:pictureOptions`; picture-filled walls are out of
+ * scope and are neither parsed nor rendered.
+ */
+export interface ChartSurface {
+  /** `c:thickness` as a percentage. */
+  thickness?: number
+  fill?: string | GradientFill['value']
+  outline?: ChartOutline
+}
+/** The three `CT_Surface` faces of a 3D chart, as authored on `c:chart`. */
+export interface ChartWalls {
+  floor?: ChartSurface
+  backWall?: ChartSurface
+  sideWall?: ChartSurface
+}
+export interface ChartDataTable {
+  showHorizontalBorder?: boolean
+  showVerticalBorder?: boolean
+  showOutline?: boolean
+  showKeys?: boolean
+  outline?: ChartOutline
+  textStyle?: ChartTextStyle
+}
+export interface ChartTrendlineLabel {
+  layout?: ChartLayout
+  numberFormat?: string
+  textStyle?: ChartTextStyle
+}
+export interface ChartTrendline {
+  name?: string
+  trendlineType: string
+  order?: number
+  period?: number
+  forward?: number
+  backward?: number
+  intercept?: number
+  displayEquation?: boolean
+  displayRSquared?: boolean
+  outline?: ChartOutline
+  label?: ChartTrendlineLabel
+}
+export interface ChartErrorBars {
+  direction?: string
+  barType: string
+  valueType: string
+  noEndCap?: boolean
+  value?: number
+  plusValues?: number[]
+  minusValues?: number[]
+  outline?: ChartOutline
+}
+export interface ChartSeriesDecorations {
+  trendlines: ChartTrendline[]
+  errorBars: ChartErrorBars[]
+}
+export interface ChartStockUpDownBars {
+  gapWidth?: number
+  upBars?: ChartSeriesStyle
+  downBars?: ChartSeriesStyle
+}
+export interface ChartTextStyle {
+  fontSize?: number
+  color?: string
+  bold?: boolean
+  fontFamily?: string
+  rotation?: number
+  textTransform?: 'uppercase' | 'lowercase'
+}
+export interface ChartGridLines {
+  visible: boolean
+  outline?: ChartOutline
+}
+export interface ChartDisplayUnitsLabel {
+  text?: string
+  textStyle?: ChartTextStyle
+}
+export interface ChartDisplayUnits {
+  builtInUnit?: string
+  customUnit?: number
+  label?: ChartDisplayUnitsLabel
+}
+export interface ChartDateAxis {
+  baseTimeUnit?: 'days' | 'months' | 'years'
+  majorTimeUnit?: 'days' | 'months' | 'years'
+  minorTimeUnit?: 'days' | 'months' | 'years'
+}
+export interface ChartAxis {
+  visible: boolean
+  position?: 'l' | 'r' | 't' | 'b'
+  orientation?: 'minMax' | 'maxMin'
+  tickLabelPosition?: string
+  /**
+   * `c:majorTickMark` / `c:minorTickMark`, verbatim (`cross` | `in` | `out` |
+   * `none`). Absent means the element was not written; renderers apply the
+   * schema default, which is `cross`.
+   */
+  majorTickMark?: string
+  minorTickMark?: string
+  numberFormat?: string
+  axisLine?: ChartOutline
+  title?: ChartTitle
+  majorGridLines?: ChartGridLines
+  minorGridLines?: ChartGridLines
+  textStyle?: ChartTextStyle
+  minorUnit?: number
+  displayUnits?: ChartDisplayUnits
+}
+export interface ChartCategoryAxis extends ChartAxis {
+  labels?: string[]
+  min?: number
+  max?: number
+  majorUnit?: number
+  dateAxis?: ChartDateAxis
+  crossBetween?: string
+  gapWidthRatio?: number
+}
+export interface ChartValueAxis extends ChartAxis {
+  min?: number
+  max?: number
+  majorUnit?: number
+  minorUnit?: number
+  crossBetween?: string
+  majorGridLines?: ChartGridLines
+  minorGridLines?: ChartGridLines
+  displayUnits?: ChartDisplayUnits
+}
+export interface ChartAxes {
+  category?: ChartCategoryAxis
+  value?: ChartValueAxis
+  /**
+   * The depth axis of a 3D chart (`c:serAx`). `CT_SerAx` is a proper subset of
+   * `CT_CatAx`, so it reuses the shared axis shape; its labels are the series
+   * names.
+   */
+  series?: ChartAxis
+}
+export interface ChartLegendItem {
+  label: string
+  color?: string
+  index?: number
+}
+export interface ChartLegend {
+  visible: boolean
+  position?: 'l' | 'r' | 't' | 'b'
+  overlay?: boolean
+  layout?: ChartLayout
+  items?: ChartLegendItem[]
+  textStyle?: ChartTextStyle
+}
+export interface ChartTitle {
+  text: string
+  overlay?: boolean
+  textStyle?: ChartTextStyle
+}
+export interface ChartDataLabels {
+  text?: string
+  layout?: ChartLayout
+  position?: string
+  showValue?: boolean
+  showCategoryName?: boolean
+  showSeriesName?: boolean
+  showPercent?: boolean
+  showLegendKey?: boolean
+  showBubbleSize?: boolean
+  showLeaderLines?: boolean
+  leaderLineOutline?: ChartOutline
+  separator?: string
+  /** ChartEx-only zero-based indexes whose data labels are hidden. */
+  hiddenPoints?: number[]
+  textStyle?: ChartTextStyle
+}
+export interface ChartLayout {
+  x?: number
+  y?: number
+  w?: number
+  h?: number
+}
+export interface ChartExPoint {
+  label: string
+  value: number
+  subtotal?: boolean
+}
+export interface ChartExHierarchyNode {
+  path: string[]
+  value: number
+}
+export interface ChartExBoxWhiskerSeries {
+  name: string
+  categories: string[]
+  values: number[]
+  visibility?: Record<string, string>
+  quartileMethod?: string
+}
+export type ChartExData =
+  | { type: 'waterfall'; points: ChartExPoint[]; connectorLines?: ChartOutline }
+  | { type: 'funnel'; points: ChartExPoint[]; autoContrastInsideLabels?: boolean }
+  | { type: 'sunburst' | 'treemap'; hierarchy: ChartExHierarchyNode[]; parentLabelLayout?: string }
+  | { type: 'histogram'; values: number[]; binning?: { intervalClosed?: string } }
+  | { type: 'boxWhisker'; series: ChartExBoxWhiskerSeries[] }
+export type ScatterChartData = [number[], number[]] | ChartItem[]
+export type BubbleChartData = ChartItem[]
+export interface CommonChart {
+  type: 'chart'
+  left: number
+  top: number
+  width: number
+  height: number
+  fill?: string
+  backgroundImage?: { src: string; opacity?: number }
+  data: ChartItem[]
+  colors: Array<string | null | undefined>
+  themeColors?: string[]
+  outline?: ChartOutline
+  roundedCorners?: boolean
+  layout?: ChartLayout
+  axes?: ChartAxes
+  title?: ChartTitle
+  legend?: ChartLegend
+  dataLabels?: ChartDataLabels
+  seriesStyles?: ChartSeriesStyle[]
+  /** Per-series, per-data-point styles for cartesian bar/column charts. */
+  seriesPointStyles?: ChartSeriesStyle[][]
+  pointStyles?: ChartSeriesStyle[]
+  dataTable?: ChartDataTable
+  seriesDecorations?: ChartSeriesDecorations[]
+  stockUpDownBars?: ChartStockUpDownBars
+  chartEx?: ChartExData
+  chartType: Exclude<ChartType, 'scatter' | 'bubble'>
+  rawChartType: Exclude<OoxmlChartType, 'scatterChart' | 'bubbleChart'>
+  barDir?: 'bar' | 'col'
+  marker?: boolean
+  holeSize?: number
+  pieExplosion?: number
+  firstSliceAngle?: number
+  grouping?: string
+  gapWidth?: number
+  overlap?: number
+  /**
+   * The legacy 3D scene. Present only when the chart declares `<c:view3D>`;
+   * renderers key off this rather than the chart kind, because `c:view3D` is
+   * schema-legal on 2D charts too.
+   */
+  view3D?: ChartView3D
+  /** Chart-group level `c:shape` of a 3D bar chart. */
+  barShape?: ChartBarShape
+  /** `c:gapDepth` — spacing between series along the depth axis, as a percentage. */
+  gapDepth?: number
+  /**
+   * `c:wireframe` of a surface chart group: draw the mesh as lines instead of
+   * filled value bands. Absent on every other chart group.
+   */
+  wireframe?: boolean
+  /** Sparse surface value-band styles from `c:bandFmts`; indexes are not re-numbered. */
+  bandFormats?: ChartBandFormat[]
+  /** `c:floor` / `c:backWall` / `c:sideWall` styling. */
+  walls?: ChartWalls
+  style?: string
+  order: number
+}
+export interface ScatterChart {
+  type: 'chart'
+  left: number
+  top: number
+  width: number
+  height: number
+  fill?: string
+  backgroundImage?: { src: string; opacity?: number }
+  data: ScatterChartData
+  colors: Array<string | null | undefined>
+  themeColors?: string[]
+  outline?: ChartOutline
+  roundedCorners?: boolean
+  layout?: ChartLayout
+  axes?: ChartAxes
+  title?: ChartTitle
+  legend?: ChartLegend
+  dataLabels?: ChartDataLabels
+  seriesStyles?: ChartSeriesStyle[]
+  dataTable?: ChartDataTable
+  seriesDecorations?: ChartSeriesDecorations[]
+  style?: string
+  chartType: 'scatter'
+  rawChartType: 'scatterChart'
+  order: number
+}
+export interface BubbleChart {
+  type: 'chart'
+  left: number
+  top: number
+  width: number
+  height: number
+  fill?: string
+  backgroundImage?: { src: string; opacity?: number }
+  data: BubbleChartData
+  colors: Array<string | null | undefined>
+  themeColors?: string[]
+  outline?: ChartOutline
+  roundedCorners?: boolean
+  layout?: ChartLayout
+  axes?: ChartAxes
+  title?: ChartTitle
+  legend?: ChartLegend
+  dataLabels?: ChartDataLabels
+  seriesStyles?: ChartSeriesStyle[]
+  dataTable?: ChartDataTable
+  seriesDecorations?: ChartSeriesDecorations[]
+  bubbleScale?: number
+  chartType: 'bubble'
+  rawChartType: 'bubbleChart'
+  order: number
+}
+export type Chart = CommonChart | ScatterChart | BubbleChart
+
+export interface SlideVideo {
+  type: 'video'
+  left: number
+  top: number
+  width: number
+  height: number
+  rotate: number
+  blob?: string
+  src?: string
+  poster?: string
+  ext?: string
+  order: number
+}
+
+export interface SlideAudio {
+  type: 'audio'
+  left: number
+  top: number
+  width: number
+  height: number
+  rotate: number
+  blob?: string
+  ext?: string
+  order: number
+}
+
+export interface Diagram {
+  type: 'diagram'
+  left: number
+  top: number
+  width: number
+  height: number
+  rotate?: number
+  isFlipV?: boolean
+  isFlipH?: boolean
+  name?: string
+  elements: (Shape | SlideText)[]
+  textList: TextParagraph[][]
+  points?: SmartArtPoint[]
+  connections?: SmartArtConnection[]
+  layoutType?: string
+  order: number
+}
+
+export interface SmartArtPoint {
+  modelId?: string
+  type?: string
+  cxnId?: string
+  text?: TextParagraph[]
+}
+
+export interface SmartArtConnection {
+  modelId?: string
+  /** Normalized to `parOf` when the OOXML connection omits its defaulted type. */
+  type: string
+  srcId?: string
+  destId?: string
+  srcOrd?: number
+  destOrd?: number
+  parTransId?: string
+  sibTransId?: string
+  presId?: string
+}
+
+export interface SlideMath {
+  type: 'math'
+  left: number
+  top: number
+  width: number
+  height: number
+  /** Inherited shape geometry retains its local transform and identity. */
+  rotate?: number
+  isFlipH?: boolean
+  isFlipV?: boolean
+  name?: string
+  shapeId?: string
+  phType?: string
+  isPlaceholder?: boolean
+  latex: string
+  picBase64: string
+  order: number
+  text?: TextParagraph[]
+}
+
+export type BaseElement = (
+  | Shape
+  | SlideText
+  | SlideImage
+  | Table
+  | Chart
+  | SlideVideo
+  | SlideAudio
+  | Diagram
+  | SlideMath
+) &
+  LayeredElementMeta
+
+export interface Group extends LayeredElementMeta {
+  type: 'group'
+  left: number
+  top: number
+  width: number
+  height: number
+  rotate?: number
+  elements: BaseElement[]
+  order: number
+  isFlipH?: boolean
+  isFlipV?: boolean
+}
+export type SlideElement = BaseElement | Group
+
+export interface ParsedAnimationRaw {
+  tag: string
+  attrs?: Record<string, string>
+}
+
+export interface ParsedSlideTiming {
+  root: ParsedTimingNode | null
+  buildList?: ParsedBuildListItem[]
+  unsupported: ParsedAnimationUnsupported[]
+  degraded?: ParsedAnimationDegraded[]
+}
+
+export interface ParsedBuildListItem {
+  targetShapeId: string
+  kind: 'paragraph' | 'diagram' | 'chart' | 'ole' | 'unknown'
+  buildMode?: 'all-at-once' | 'by-paragraph' | 'by-level' | 'by-series' | 'by-category'
+  level?: number
+  raw?: ParsedAnimationRaw
+}
+
+export interface ParsedAnimationUnsupported {
+  stepId?: string
+  targetShapeId?: string
+  code?: string
+  reason: string
+  raw?: ParsedAnimationRaw
+}
+
+export interface ParsedAnimationDegraded {
+  stepId?: string
+  targetShapeId?: string
+  code?: string
+  fromGranularity: 'word' | 'character' | 'unknown'
+  toGranularity: 'run' | 'paragraph' | 'shape'
+  reason: string
+  raw?: ParsedAnimationRaw
+}
+
+export interface ParsedTextTarget {
+  paragraphIndex?: number
+  runIndex?: number
+  granularity: 'paragraph' | 'run' | 'word' | 'character' | 'unknown'
+}
+
+export interface ParsedTimingEasing {
+  type: 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'unknown'
+  accelerate?: number
+  decelerate?: number
+}
+
+export type ParsedTimingNodeType =
+  | 'root'
+  | 'parallel'
+  | 'sequence'
+  | 'effect'
+  | 'motion'
+  | 'scale'
+  | 'rotate'
+  | 'set'
+  | 'property'
+  | 'command'
+  | 'unknown'
+
+export interface ParsedTimingNode {
+  id?: string
+  type: ParsedTimingNodeType
+  presetClass?: string
+  presetId?: string
+  presetSubtype?: string
+  nodeType?: string
+  targetShapeId?: string
+  targetTextRange?: ParsedTextTarget
+  trigger: ParsedTrigger
+  durationMs?: number
+  delayMs?: number
+  repeatCount?: number | 'indefinite'
+  repeatDurationMs?: number
+  autoReverse?: boolean
+  restart?: 'always' | 'when-not-active' | 'never' | 'unknown'
+  fill?: 'hold' | 'remove' | 'transition' | 'freeze' | 'unknown'
+  easing?: ParsedTimingEasing
+  effect?: ParsedEffectPayload
+  children?: ParsedTimingNode[]
+  raw?: ParsedAnimationRaw
+}
+
+export type ParsedTriggerKind =
+  | 'on-click'
+  | 'with-previous'
+  | 'after-previous'
+  | 'auto'
+  | 'interactive'
+  | 'unknown'
+
+export interface ParsedTrigger {
+  kind: ParsedTriggerKind
+  delayMs?: number
+  event?: string
+  sourceShapeId?: string
+}
+
+export interface ParsedEffectPayload {
+  kind:
+    | 'appear'
+    | 'fade'
+    | 'fly'
+    | 'wipe'
+    | 'split'
+    | 'zoom'
+    | 'grow-shrink'
+    | 'spin'
+    | 'motion-path'
+    | 'color'
+    | 'opacity'
+    | 'visibility'
+    | 'unknown'
+  direction?: 'left' | 'right' | 'up' | 'down' | 'in' | 'out' | 'horizontal' | 'vertical'
+  transition?: 'in' | 'out' | 'none'
+  filter?: string
+  by?: {
+    x?: number
+    y?: number
+    rotation?: number
+    rotationDeg?: number
+    scaleX?: number
+    scaleY?: number
+    opacity?: number
+  }
+  from?: Record<string, number | string>
+  to?: Record<string, number | string>
+  path?: string
+  origin?: string
+  pathEditMode?: string
+  autoRotate?: boolean
+}
+
+export interface SlideTransition {
+  type: string
+  duration: number
+  direction: string | null
+  autoNextAfter?: number
+}
+
+export interface SlideComment {
+  x: number
+  y: number
+  left: number
+  top: number
+  text: string
+  authorId?: string
+  dt?: string
+  idx?: string
+}
+
+export interface Slide {
+  fill: Fill
+  elements: SlideElement[]
+  layoutElements: SlideElement[]
+  note: string
+  comments?: SlideComment[]
+  transition?: SlideTransition | null
+  animations?: ParsedSlideTiming
+}
+
+export interface ParseOptions {
+  /** Cancel this request without terminating work owned by other callers. */
+  signal?: AbortSignal
+  /** Whether to extract embedded font binary data. Defaults to false. */
+  extractFonts?: boolean
+  /** Which parser engine to use. Defaults to 'js'. */
+  parser?: 'js' | 'wasm'
+  /** Which unzip engine to use (only applies when parser is 'wasm'). Defaults to 'wasm'. */
+  unzipMode?: 'js' | 'wasm'
+  /** Override the package-relative parser WASM URL. */
+  wasmUrl?: string | URL
+  /** Collect per-phase parser timing in the returned result. Defaults to false. */
+  timing?: boolean
+}
+
+export interface EmbeddedFontStyle {
+  path: string
+  data: ArrayBuffer
+}
+
+export interface EmbeddedFont {
+  typeface: string
+  styles: {
+    regular?: EmbeddedFontStyle
+    bold?: EmbeddedFontStyle
+    italic?: EmbeddedFontStyle
+    boldItalic?: EmbeddedFontStyle
+  }
+}
+
+export interface ParseTiming {
+  unzip: number
+  xmlParse: number
+  ooxml: number
+  total: number
+}
+
+export interface ParseResult {
+  slides: Slide[]
+  themeColors: string[]
+  hlinkColor: string | null
+  fonts: EmbeddedFont[]
+  size: {
+    width: number
+    height: number
+  }
+  _timing?: ParseTiming
+}
+
+export interface ResourceViolationDetails {
+  reason: string
+  stage: string
+  subject: string
+  limit: number
+  observed: number
+  unit: string
+  policyVersion: string
+  commercialUpgradeApplicable: false
+}
+
+export class ResourcePolicyError extends Error {
+  readonly details: ResourceViolationDetails
+  constructor(details: ResourceViolationDetails)
+}
+
+export const RESOURCE_POLICY_CONTRACT: {
+  readonly schemaVersion: 'xdoc-resource-policy-registry/v1'
+  readonly policyVersion: string
+  readonly profiles: readonly object[]
+  readonly stableReasons: readonly string[]
+  readonly configurationBoundary: string
+  readonly hostEnforcementResponsibilities: readonly [
+    'process-memory',
+    'cpu-quota',
+    'process-count',
+  ]
+  readonly precedence: readonly string[]
+}
+
+export interface PptxToPdfOptions {
+  /** Cancel only this request; a shared Worker remains available to other callers. */
+  signal?: AbortSignal
+  wasmBytes?: ArrayBuffer | Uint8Array
+  wasmUrl?: string | URL
+  /** Browser PDF Worker URL; ESM builds resolve it automatically. */
+  workerUrl?: string | URL
+  watermarks?: Array<{
+    kind: 'demo' | 'dynamic'
+    text: string
+    opacity: number
+    color: string
+    fontSize: number
+    rotate: number
+  }>
+  license?: unknown
+  licenseRuntime?: {
+    now?: number
+    origin?: string
+    hostname?: string
+    deploymentId?: string
+    sdkVersion?: string
+    inputBytes?: number
+    restrictionPolicySnapshot?: string
+  }
+  regularFonts?: Array<{
+    typeface: string
+    style?: 'regular' | 'bold' | 'italic' | 'boldItalic'
+    path?: string
+    data: ArrayBuffer | Uint8Array
+  }>
+  unicodeFallbackFont?: {
+    path?: string
+    url?: string | URL
+    data?: ArrayBuffer | Uint8Array
+  }
+  /**
+   * TrueType or WOFF2 emoji font used by browser PDF export for emoji-only
+   * icon/text runs. Native conversion resolves this automatically from system
+   * fonts; browser callers can provide a cached Apple/Segoe/Noto emoji font.
+   */
+  emojiFallbackFont?: {
+    path?: string
+    url?: string | URL
+    data?: ArrayBuffer | Uint8Array
+  }
+  /**
+   * Browser-only fallback that rasterizes the PPTX's used emoji glyphs through
+   * the current canvas/system emoji font stack and passes only those PNG images
+   * to the PDF converter. Enabled by default when a DOM canvas is available.
+   */
+  emojiBitmapFallback?:
+    | boolean
+    | {
+        fontFamily?: string
+        pixelSize?: number
+      }
+  /**
+   * TrueType or WOFF2 font that the math typesetter (`moon-tex`) consults when a
+   * math character lies outside the bundled KaTeX outline data. Typically a
+   * CJK-capable font (PingFang / Microsoft YaHei / Noto Sans CJK). When
+   * omitted, `unicodeFallbackFont` is reused (the same font usually covers
+   * both PDF body text and math content). Set `family` to the human-
+   * readable family name; it is used only as a key inside the renderer.
+   */
+  mathFallbackFont?: {
+    family?: string
+    data?: ArrayBuffer | Uint8Array
+    url?: string | URL
+  }
+  /**
+   * Use Office local fallback metrics for missing non-embedded fonts instead of
+   * resolving browser/cache copies of referenced fonts.
+   */
+  officeFontFallbacks?: boolean
+}
+
+export const parsePptx: (file: ArrayBuffer, options?: ParseOptions) => Promise<ParseResult>
+
+export function revokeBlobUrls(data: object): void
+/** Move owned Blob URL cleanup from a parser result to an adapted model; no byte copy. */
+export function transferBlobUrls(source: object, target: object): void
+export function pptxToPdf(file: ArrayBuffer, options?: PptxToPdfOptions): Promise<Uint8Array>
+export function pptxToPdfBlob(file: ArrayBuffer, options?: PptxToPdfOptions): Promise<Blob>