@paperjsx/json-to-pptx-pro 0.0.1

package/dist-pro/types/core/src/types/ast.d.ts

@@ -0,0 +1,1090 @@
+import { ACTION_BUTTON_SHAPES, ARROW_CALLOUT_SHAPES, ARROW_HEAD_SIZES, ARROW_HEAD_TYPES, ARROW_SHAPES, BASIC_SHAPES, BRACKET_BRACE_SHAPES, CALLOUT_SHAPES, CHART_TYPES, CONNECTOR_SHAPES, CONNECTOR_TYPES, FLOWCHART_SHAPES, MATH_SHAPES, PATTERN_TYPES, PLACEHOLDER_TYPES, STAR_SHAPES, TAB_SHAPES } from "./literals.js";
+export type Dimension = number | `${number}%`;
+export type BasicShape = (typeof BASIC_SHAPES)[number];
+export type ArrowShape = (typeof ARROW_SHAPES)[number];
+export type ArrowCalloutShape = (typeof ARROW_CALLOUT_SHAPES)[number];
+export type FlowchartShape = (typeof FLOWCHART_SHAPES)[number];
+export type ActionButtonShape = (typeof ACTION_BUTTON_SHAPES)[number];
+export type CalloutShape = (typeof CALLOUT_SHAPES)[number];
+export type MathShape = (typeof MATH_SHAPES)[number];
+export type StarShape = (typeof STAR_SHAPES)[number];
+export type BracketBraceShape = (typeof BRACKET_BRACE_SHAPES)[number];
+export type TabShape = (typeof TAB_SHAPES)[number];
+export type ConnectorShape = (typeof CONNECTOR_SHAPES)[number];
+/** Full ECMA-376 §20.1.10.56 shape type union. */
+export type ShapeType = BasicShape | ArrowShape | ArrowCalloutShape | FlowchartShape | ActionButtonShape | CalloutShape | MathShape | StarShape | BracketBraceShape | TabShape | ConnectorShape;
+/** OOXML placeholder types per ECMA-376 §19.7.9 (ST_PlaceholderType). */
+export type PlaceholderType = (typeof PLACEHOLDER_TYPES)[number];
+export interface PlaceholderRef {
+    type?: PlaceholderType;
+    idx?: number;
+}
+export interface ColorModifier {
+    scheme: string;
+    tint?: number;
+    shade?: number;
+    lumMod?: number;
+    lumOff?: number;
+    satMod?: number;
+    satOff?: number;
+    hueMod?: number;
+    hueOff?: number;
+    comp?: boolean;
+    inv?: boolean;
+    gray?: boolean;
+}
+export type ColorValue = string | ColorModifier;
+export interface GradientStop {
+    color: ColorValue;
+    position: number;
+    alpha?: number;
+}
+export interface GradientFill {
+    type: "linear" | "radial";
+    angle?: number;
+    stops: GradientStop[];
+}
+export interface SolidFill {
+    type: "solid";
+    color: ColorValue;
+}
+export type PatternType = (typeof PATTERN_TYPES)[number];
+export interface PatternFill {
+    type: "pattern";
+    pattern: PatternType;
+    foreground: ColorValue;
+    background: ColorValue;
+}
+export interface ImageFill {
+    type: "image";
+    src: string;
+    tile?: boolean;
+    stretch?: boolean;
+}
+export type Fill = SolidFill | GradientFill | PatternFill | ImageFill;
+export interface DropShadow {
+    color: ColorValue;
+    offsetX: number;
+    offsetY: number;
+    blurRadius: number;
+    opacity?: number;
+}
+export interface Glow {
+    color: ColorValue;
+    radius: number;
+    opacity?: number;
+}
+export interface Reflection {
+    blurRadius?: number;
+    startOpacity?: number;
+    endOpacity?: number;
+    distance?: number;
+    direction?: number;
+    size?: number;
+}
+export interface SoftEdge {
+    radius: number;
+}
+export interface InnerShadow {
+    color: ColorValue;
+    offsetX: number;
+    offsetY: number;
+    blurRadius: number;
+    opacity?: number;
+}
+export type CameraPreset = "orthographicFront" | "isometricTopUp" | "isometricTopDown" | "isometricBottomUp" | "isometricBottomDown" | "isometricLeftUp" | "isometricLeftDown" | "isometricRightUp" | "isometricRightDown" | "isometricOffAxis1Left" | "isometricOffAxis1Right" | "isometricOffAxis1Top" | "isometricOffAxis2Left" | "isometricOffAxis2Right" | "isometricOffAxis2Top" | "isometricOffAxis3Left" | "isometricOffAxis3Bottom" | "isometricOffAxis4Left" | "isometricOffAxis4Bottom" | "obliqueTopLeft" | "obliqueTop" | "obliqueTopRight" | "obliqueLeft" | "obliqueRight" | "obliqueBottomLeft" | "obliqueBottom" | "obliqueBottomRight" | "perspectiveFront" | "perspectiveLeft" | "perspectiveRight" | "perspectiveAbove" | "perspectiveBelow" | "perspectiveAboveLeftFacing" | "perspectiveAboveRightFacing" | "perspectiveContrastingLeftFacing" | "perspectiveContrastingRightFacing" | "perspectiveHeroicLeftFacing" | "perspectiveHeroicRightFacing" | "perspectiveHeroicExtremeLeftFacing" | "perspectiveHeroicExtremeRightFacing" | "perspectiveRelaxed" | "perspectiveRelaxedModerately";
+export type LightRigType = "balanced" | "brightRoom" | "chilly" | "contrasting" | "flat" | "flood" | "freezing" | "glow" | "harsh" | "legacyFlat1" | "legacyFlat2" | "legacyFlat3" | "legacyFlat4" | "legacyHarsh1" | "legacyHarsh2" | "legacyHarsh3" | "legacyHarsh4" | "legacyNormal1" | "legacyNormal2" | "legacyNormal3" | "legacyNormal4" | "morning" | "soft" | "sunrise" | "sunset" | "threePt" | "twoPt";
+export type LightRigDirection = "t" | "b" | "l" | "r" | "tl" | "tr" | "bl" | "br";
+export type BevelPreset = "angle" | "artDeco" | "circle" | "convex" | "coolSlant" | "cross" | "divot" | "hardEdge" | "relaxedInset" | "riblet" | "slope" | "softRound";
+export type MaterialPreset = "clear" | "dkEdge" | "flat" | "legacyMatte" | "legacyMetal" | "legacyPlastic" | "legacyWireframe" | "matte" | "metal" | "plastic" | "powder" | "softEdge" | "softmetal" | "translucentPowder" | "warmMatte";
+export interface Scene3D {
+    camera: {
+        preset: CameraPreset;
+        fov?: number;
+    };
+    lightRig: {
+        type: LightRigType;
+        direction: LightRigDirection;
+    };
+}
+export interface BevelConfig {
+    width?: number;
+    height?: number;
+    preset: BevelPreset;
+}
+export interface Sp3D {
+    material?: MaterialPreset;
+    bevelTop?: BevelConfig;
+    bevelBottom?: BevelConfig;
+    extrudeHeight?: number;
+    extrudeColor?: ColorValue;
+    contourWidth?: number;
+    contourColor?: ColorValue;
+}
+export interface ImageEffects {
+    brightness?: number;
+    contrast?: number;
+    grayscale?: boolean;
+    biLevel?: number;
+    duotone?: {
+        color1: ColorValue;
+        color2: ColorValue;
+    };
+    blur?: number;
+}
+export interface Effects {
+    dropShadow?: DropShadow;
+    innerShadow?: InnerShadow;
+    glow?: Glow;
+    reflection?: Reflection;
+    softEdge?: SoftEdge;
+    scene3d?: Scene3D;
+    sp3d?: Sp3D;
+}
+export interface FlexStyle {
+    flexDirection?: "row" | "column";
+    justifyContent?: "flex-start" | "flex-end" | "center" | "space-between" | "space-around";
+    alignItems?: "flex-start" | "flex-end" | "center" | "stretch";
+    width?: Dimension;
+    height?: Dimension;
+    padding?: number;
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    margin?: number;
+    marginTop?: number;
+    marginRight?: number;
+    marginBottom?: number;
+    marginLeft?: number;
+    position?: "relative" | "absolute";
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    zIndex?: number;
+    backgroundColor?: ColorValue;
+    flexWrap?: "nowrap" | "wrap" | "wrap-reverse";
+    flexGrow?: number;
+    flexShrink?: number;
+    flexBasis?: Dimension;
+    gap?: number;
+    rowGap?: number;
+    columnGap?: number;
+    minWidth?: Dimension;
+    maxWidth?: Dimension;
+    minHeight?: Dimension;
+    maxHeight?: Dimension;
+    alignSelf?: "auto" | "flex-start" | "flex-end" | "center" | "stretch";
+    aspectRatio?: number;
+    display?: "flex" | "none";
+    fill?: Fill;
+    borderWidth?: number;
+    borderColor?: ColorValue;
+    borderStyle?: "solid" | "dashed" | "dotted" | "dotDash";
+    borderCap?: "flat" | "round" | "square";
+    borderCompound?: "single" | "double" | "thickThin" | "thinThick" | "triple";
+    effects?: Effects;
+    rotation?: number;
+    opacity?: number;
+    flipH?: boolean;
+    flipV?: boolean;
+}
+export interface TextInsets {
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+}
+export type TextWarpPreset = "textNoShape" | "textPlain" | "textStop" | "textTriangle" | "textTriangleInverted" | "textChevron" | "textChevronInverted" | "textRingInside" | "textRingOutside" | "textArchUp" | "textArchDown" | "textCircle" | "textButton" | "textArchUpPour" | "textArchDownPour" | "textCirclePour" | "textButtonPour" | "textCurveUp" | "textCurveDown" | "textCanUp" | "textCanDown" | "textWave1" | "textWave2" | "textDoubleWave1" | "textWave4" | "textInflate" | "textDeflate" | "textInflateBottom" | "textDeflateBottom" | "textInflateTop" | "textDeflateTop" | "textDeflateInflate" | "textDeflateInflateDeflate" | "textFadeRight" | "textFadeLeft" | "textFadeUp" | "textFadeDown" | "textSlantUp" | "textSlantDown" | "textCascadeUp" | "textCascadeDown";
+export interface TextStyle extends FlexStyle {
+    color?: ColorValue;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: "normal" | "bold";
+    fontStyle?: "normal" | "italic";
+    textAlign?: "left" | "center" | "right" | "justify";
+    lineHeight?: number;
+    fontFallback?: string[];
+    textDecorationLine?: "none" | "underline" | "strikethrough" | "underline-strikethrough";
+    textDecorationStyle?: "solid" | "double" | "dotted" | "dashed";
+    verticalAlign?: "top" | "middle" | "bottom";
+    textInsets?: TextInsets;
+    textDirection?: "horizontal" | "vertical" | "verticalEA";
+    rtl?: boolean;
+    columns?: number;
+    columnSpacing?: number;
+    lang?: string;
+    textWarp?: TextWarpPreset;
+}
+export interface TextRunStyle {
+    color?: ColorValue;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: "normal" | "bold";
+    fontStyle?: "normal" | "italic";
+    textDecorationLine?: "none" | "underline" | "strikethrough" | "underline-strikethrough";
+    textDecorationStyle?: "solid" | "double" | "dotted" | "dashed";
+    baseline?: "superscript" | "subscript";
+    letterSpacing?: number;
+    shadow?: DropShadow;
+    outline?: {
+        width: number;
+        color: ColorValue;
+    };
+    textTransform?: "uppercase" | "lowercase" | "capitalize" | "none";
+    gradientFill?: GradientFill;
+    lang?: string;
+    altLang?: string;
+    highlight?: ColorValue;
+    kerning?: number;
+}
+/**
+ * Hyperlink target. Specify exactly one of: url, mailto, slide, action.
+ * If multiple are set, resolution priority is: action > slide > mailto > url.
+ */
+export interface HyperlinkTarget {
+    url?: string;
+    mailto?: string;
+    slide?: number;
+    action?: "firstSlide" | "lastSlide" | "nextSlide" | "previousSlide" | "endShow";
+    tooltip?: string;
+}
+export interface TextRun {
+    text: string;
+    style?: TextRunStyle;
+    hyperlink?: string | HyperlinkTarget;
+}
+export interface BulletChar {
+    type?: "char";
+    char: string;
+    color?: ColorValue;
+    size?: number;
+    fontFamily?: string;
+}
+export interface BulletAutoNum {
+    type: "autoNum";
+    scheme: AutoNumScheme;
+    startAt?: number;
+}
+export type AutoNumScheme = "arabicPeriod" | "arabicParenR" | "romanUcPeriod" | "romanLcPeriod" | "alphaUcPeriod" | "alphaLcPeriod" | "alphaLcParenR" | "alphaUcParenR";
+export interface BulletNone {
+    type: "none";
+}
+export type BulletConfig = BulletChar | BulletAutoNum | BulletNone;
+export type TabAlignType = "l" | "ctr" | "r" | "dec";
+export interface TabStop {
+    position: number;
+    align?: TabAlignType;
+}
+export interface Paragraph {
+    runs: TextRun[];
+    align?: "left" | "center" | "right" | "justify";
+    lineHeight?: number;
+    lineSpacingMode?: "points" | "percentage";
+    spaceBefore?: number;
+    spaceAfter?: number;
+    spaceBeforePercent?: number;
+    spaceAfterPercent?: number;
+    level?: number;
+    indent?: number;
+    marginLeft?: number;
+    bullet?: BulletConfig;
+    rtl?: boolean;
+    tabStops?: TabStop[];
+    hangingIndent?: number;
+}
+export interface ShapeLocks {
+    noGrp?: boolean;
+    noSelect?: boolean;
+    noRot?: boolean;
+    noChangeAspect?: boolean;
+    noMove?: boolean;
+    noResize?: boolean;
+    noEditPoints?: boolean;
+    noAdjustHandles?: boolean;
+    noChangeArrowheads?: boolean;
+    noChangeShapeType?: boolean;
+    noTextEdit?: boolean;
+}
+export type PathCommand = {
+    type: "moveTo";
+    x: number;
+    y: number;
+} | {
+    type: "lineTo";
+    x: number;
+    y: number;
+} | {
+    type: "cubicBezTo";
+    cp1x: number;
+    cp1y: number;
+    cp2x: number;
+    cp2y: number;
+    x: number;
+    y: number;
+} | {
+    type: "quadBezTo";
+    cpx: number;
+    cpy: number;
+    x: number;
+    y: number;
+} | {
+    type: "arcTo";
+    wR: number;
+    hR: number;
+    stAng: number;
+    swAng: number;
+} | {
+    type: "close";
+};
+export interface CustomGeometryPath {
+    commands: PathCommand[];
+    width?: number;
+    height?: number;
+    fill?: "norm" | "none" | "lighten" | "darken";
+}
+export interface CustomGeometry {
+    paths: CustomGeometryPath[];
+}
+export interface PaperView {
+    type: "View";
+    style?: FlexStyle;
+    children?: PaperNode[];
+    shapeType?: ShapeType;
+    shapeAdjustments?: number[];
+    shapeAdjustmentMap?: Record<string, number>;
+    customGeometry?: CustomGeometry;
+    placeholder?: PlaceholderRef;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    hyperlink?: string | HyperlinkTarget;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+    locks?: ShapeLocks;
+    textContent?: string | TextRun[];
+    textParagraphs?: Paragraph[];
+    textStyle?: TextStyle;
+}
+export interface PaperText {
+    type: "Text";
+    style?: TextStyle;
+    content?: string | TextRun[];
+    paragraphs?: Paragraph[];
+    autoFit?: boolean;
+    placeholder?: PlaceholderRef;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+}
+export interface ImageCrop {
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+}
+export interface PaperImage {
+    type: "Image";
+    style?: FlexStyle;
+    src: string;
+    svgSrc?: string;
+    crop?: ImageCrop;
+    borderRadius?: number;
+    placeholder?: PlaceholderRef;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    hyperlink?: string | HyperlinkTarget;
+    decorative?: boolean;
+    readingOrder?: number;
+    locks?: ShapeLocks;
+    imageEffects?: ImageEffects;
+}
+export interface TableCellBorder {
+    width?: number;
+    color?: ColorValue;
+}
+export interface TableCellBorders {
+    top?: TableCellBorder;
+    right?: TableCellBorder;
+    bottom?: TableCellBorder;
+    left?: TableCellBorder;
+    diagonalDown?: TableCellBorder;
+    diagonalUp?: TableCellBorder;
+}
+export interface TableCellStyle {
+    fill?: ColorValue | GradientFill;
+    borders?: TableCellBorders;
+    fontWeight?: "normal" | "bold";
+    fontStyle?: "normal" | "italic";
+    fontSize?: number;
+    fontFamily?: string;
+    color?: ColorValue;
+    textAlign?: "left" | "center" | "right";
+    verticalAlign?: "top" | "middle" | "bottom";
+    padding?: number;
+    textDirection?: "horizontal" | "vertical" | "verticalEA";
+}
+export interface TableCell {
+    text: string;
+    style?: TableCellStyle;
+    colSpan?: number;
+    rowSpan?: number;
+    vMerge?: boolean;
+    hMerge?: boolean;
+    content?: TextRun[];
+    paragraphs?: Paragraph[];
+}
+export interface TableRow {
+    height?: number;
+    minHeight?: number;
+    cells: TableCell[];
+}
+export interface TableStyle {
+    bandRow?: boolean;
+    bandCol?: boolean;
+    firstRow?: boolean;
+    lastRow?: boolean;
+    firstCol?: boolean;
+    lastCol?: boolean;
+    headerRowStyle?: TableCellStyle;
+    footerRowStyle?: TableCellStyle;
+    firstColStyle?: TableCellStyle;
+    lastColStyle?: TableCellStyle;
+    bandRowEvenStyle?: TableCellStyle;
+    bandRowOddStyle?: TableCellStyle;
+    outerBorder?: TableCellBorder;
+    innerBorderH?: TableCellBorder;
+    innerBorderV?: TableCellBorder;
+}
+export interface TableData {
+    columns: number[];
+    rows: TableRow[];
+    style?: TableStyle;
+    autoFit?: boolean | "distribute";
+}
+export interface PaperTable {
+    type: "Table";
+    style?: FlexStyle;
+    tableData: TableData;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+}
+export type ChartType = (typeof CHART_TYPES)[number];
+export interface TreemapCategory {
+    name: string;
+    value?: number;
+    children?: TreemapCategory[];
+    color?: string;
+}
+export interface TreemapData {
+    categories: TreemapCategory[];
+    dataLabels?: ChartDataLabels;
+}
+export interface SunburstData {
+    categories: TreemapCategory[];
+    dataLabels?: ChartDataLabels;
+}
+export interface HistogramData {
+    values: number[];
+    binCount?: number;
+    binWidth?: number;
+    overflow?: number;
+    underflow?: number;
+    seriesName?: string;
+    color?: string;
+    dataLabels?: ChartDataLabels;
+}
+export interface BoxWhiskerData {
+    categories: string[];
+    series: Array<{
+        name: string;
+        values: number[];
+        color?: string;
+    }>;
+    quartileMethod?: "inclusive" | "exclusive";
+    showOutliers?: boolean;
+    showMeanMarker?: boolean;
+    showMeanLine?: boolean;
+    showInnerPoints?: boolean;
+    showConnectorLines?: boolean;
+    dataLabels?: ChartDataLabels;
+}
+export type BarGrouping = "clustered" | "stacked" | "percentStacked";
+export type LineGrouping = "standard" | "stacked" | "percentStacked";
+export type AreaGrouping = "standard" | "stacked" | "percentStacked";
+export interface XYDataPoint {
+    x: number;
+    y: number;
+    size?: number;
+}
+export interface XYSeries {
+    name: string;
+    dataPoints: XYDataPoint[];
+    color?: string;
+}
+export type MarkerSymbol = "circle" | "square" | "diamond" | "triangle" | "x" | "star" | "plus" | "dot" | "dash" | "none";
+export interface MarkerConfig {
+    symbol: MarkerSymbol;
+    size?: number;
+    color?: string;
+}
+export interface TrendlineConfig {
+    type: "linear" | "exponential" | "logarithmic" | "polynomial" | "power" | "movingAvg";
+    order?: number;
+    period?: number;
+    forward?: number;
+    backward?: number;
+    displayEquation?: boolean;
+    displayRSquared?: boolean;
+    color?: string;
+}
+export interface ErrorBarsConfig {
+    direction: "x" | "y" | "both";
+    type: "fixedVal" | "percentage" | "stdDev" | "stdErr";
+    value?: number;
+}
+export interface ChartSeries {
+    name: string;
+    values: number[];
+    color?: string;
+    overrideType?: "bar" | "line" | "area";
+    targetAxis?: "primary" | "secondary";
+    pointColors?: string[];
+    marker?: MarkerConfig;
+    trendline?: TrendlineConfig;
+    errorBars?: ErrorBarsConfig;
+    dataLabels?: ChartDataLabels;
+}
+export interface ChartGridlines {
+    major?: boolean;
+    minor?: boolean;
+    color?: string;
+}
+export interface ChartAxisConfig {
+    title?: string;
+    fontFamily?: string;
+    fontSize?: number;
+    fontColor?: string;
+    min?: number;
+    max?: number;
+    visible?: boolean;
+    numberFormat?: string;
+    gridlines?: ChartGridlines;
+    tickMark?: {
+        major?: "cross" | "in" | "out" | "none";
+        minor?: "cross" | "in" | "out" | "none";
+    };
+    labelRotation?: number;
+    labelFont?: {
+        fontFamily?: string;
+        fontSize?: number;
+        fontColor?: string;
+        bold?: boolean;
+        italic?: boolean;
+    };
+    crossesAt?: number;
+}
+export interface ChartDataLabels {
+    showVal?: boolean;
+    showCatName?: boolean;
+    showSerName?: boolean;
+    showPercent?: boolean;
+    formatCode?: string;
+    position?: "outEnd" | "inEnd" | "ctr" | "inBase" | "bestFit";
+    fontFamily?: string;
+    fontSize?: number;
+    fontColor?: string;
+}
+export interface ChartAreaStyle {
+    fill?: string;
+    borderColor?: string;
+    borderWidth?: number;
+}
+export interface WaterfallData {
+    categories: string[];
+    values: number[];
+    totalIndices?: number[];
+    increaseColor?: string;
+    decreaseColor?: string;
+    totalColor?: string;
+    connectorLines?: boolean;
+}
+export interface StockData {
+    categories: string[];
+    open: number[];
+    high: number[];
+    low: number[];
+    close: number[];
+    hiLowLines?: boolean;
+    upDownBars?: boolean;
+    upColor?: string;
+    downColor?: string;
+}
+export interface FunnelData {
+    categories: string[];
+    values: number[];
+    colors?: string[];
+}
+export interface ChartDataTable {
+    showKeys?: boolean;
+    showHorzBorder?: boolean;
+    showVertBorder?: boolean;
+    showOutline?: boolean;
+    fontFamily?: string;
+    fontSize?: number;
+}
+export interface ChartData {
+    chartType: ChartType;
+    dataLabels?: ChartDataLabels;
+    barGrouping?: BarGrouping;
+    lineGrouping?: LineGrouping;
+    areaGrouping?: AreaGrouping;
+    barDirection?: "col" | "bar";
+    smooth?: boolean;
+    marker?: MarkerConfig;
+    explosion?: number;
+    categories?: string[];
+    series?: ChartSeries[];
+    xySeries?: XYSeries[];
+    holeSize?: number;
+    title?: {
+        text?: string;
+        fontFamily?: string;
+        fontSize?: number;
+        fontColor?: string;
+        bold?: boolean;
+    };
+    categoryAxis?: ChartAxisConfig;
+    valueAxis?: ChartAxisConfig;
+    secondaryValueAxis?: ChartAxisConfig;
+    secondaryCategoryAxis?: ChartAxisConfig;
+    legend?: {
+        position?: "bottom" | "top" | "left" | "right" | "none";
+        fontFamily?: string;
+        fontSize?: number;
+        fontColor?: string;
+        border?: {
+            color?: string;
+            width?: number;
+        };
+        fill?: string;
+    };
+    gapWidth?: number;
+    overlap?: number;
+    firstSliceAng?: number;
+    plotArea?: ChartAreaStyle;
+    chartArea?: ChartAreaStyle;
+    dispBlanksAs?: "gap" | "zero" | "span";
+    radarStyle?: "radar" | "filled";
+    waterfallData?: WaterfallData;
+    stockData?: StockData;
+    funnelData?: FunnelData;
+    dataTable?: ChartDataTable;
+    treemapData?: TreemapData;
+    sunburstData?: SunburstData;
+    histogramData?: HistogramData;
+    boxWhiskerData?: BoxWhiskerData;
+    annotations?: ChartAnnotation[];
+}
+export interface ChartAnnotation {
+    text: string;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    fontFamily?: string;
+    fontSize?: number;
+    fontColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    fill?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    shapeType?: "rect" | "roundRect" | "ellipse" | "wedgeRectCallout";
+}
+export interface ChartAnimation {
+    buildType: "bySeries" | "byCategory" | "byElement" | "allAtOnce";
+    trigger?: AnimationTrigger;
+    effect?: AnimationEffect;
+    duration?: number;
+}
+export interface PaperChart {
+    type: "Chart";
+    style?: FlexStyle;
+    chartData: ChartData;
+    chartAnimation?: ChartAnimation;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+}
+export interface PaperGroup {
+    type: "Group";
+    style?: FlexStyle;
+    children: PaperNode[];
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+    locks?: ShapeLocks;
+}
+export type ConnectorType = (typeof CONNECTOR_TYPES)[number];
+export interface ConnectorPoint {
+    x: number;
+    y: number;
+}
+export type ArrowHeadType = (typeof ARROW_HEAD_TYPES)[number];
+export type ArrowHeadSize = (typeof ARROW_HEAD_SIZES)[number];
+export interface ArrowHeadConfig {
+    type: ArrowHeadType;
+    width?: ArrowHeadSize;
+    length?: ArrowHeadSize;
+}
+export interface ConnectorShapeRef {
+    shapeId: number;
+    site: number;
+}
+export interface PaperConnector {
+    type: "Connector";
+    style?: FlexStyle;
+    connectorType: ConnectorType;
+    start: ConnectorPoint;
+    end: ConnectorPoint;
+    lineWidth?: number;
+    lineColor?: ColorValue;
+    lineDashStyle?: "solid" | "dashed" | "dotted" | "dotDash";
+    arrowStart?: boolean | ArrowHeadConfig;
+    arrowEnd?: boolean | ArrowHeadConfig;
+    startShape?: ConnectorShapeRef;
+    endShape?: ConnectorShapeRef;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+    locks?: ShapeLocks;
+}
+export interface MediaPlaybackOptions {
+    loop?: boolean;
+    volume?: number;
+    trimStart?: number;
+    trimEnd?: number;
+    autoPlay?: boolean;
+    hideOnClick?: boolean;
+}
+export interface PaperVideo {
+    type: "Video";
+    style?: FlexStyle;
+    src: string;
+    poster?: string;
+    mimeType?: string;
+    playback?: MediaPlaybackOptions;
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+}
+export interface PaperAudio {
+    type: "Audio";
+    style?: FlexStyle;
+    src: string;
+    mimeType?: string;
+    playback?: MediaPlaybackOptions;
+    playAcrossSlides?: boolean;
+    icon?: "speaker" | "none";
+    animations?: AnimationIntent[];
+    animationGroups?: AnimationGroup[];
+    morphId?: string;
+    altText?: string;
+    decorative?: boolean;
+    readingOrder?: number;
+}
+export interface HeaderFooter {
+    slideNumber?: boolean;
+    footer?: string;
+    dateTime?: boolean;
+}
+export type TransitionType = "fade" | "push" | "wipe" | "cover" | "zoom" | "morph" | "split" | "blinds" | "checker" | "dissolve" | "comb";
+export type TransitionDirection = "up" | "down" | "left" | "right";
+export interface SlideTransition {
+    type: TransitionType;
+    duration?: number;
+    direction?: TransitionDirection;
+    advanceOnClick?: boolean;
+    advanceAfterTime?: number;
+}
+export type AnimationType = "entrance" | "exit" | "emphasis";
+export type AnimationEffect = "fade" | "fly" | "zoom" | "spin" | "appear" | "bounce" | "float" | "grow" | "shrink" | "growShrink" | "pulse" | "teeter" | "wipe" | "split" | "dissolve" | "swivel" | "motionPath" | "colorReveal" | "colorChange" | "boldFlash" | "wave" | "flip";
+export type AnimationTrigger = "onClick" | "withPrevious" | "afterPrevious";
+export type AnimationDirection = "up" | "down" | "left" | "right";
+export type AnimationEasing = "linear" | "easeIn" | "easeOut" | "easeInOut" | "bounce";
+export type MotionPathType = "line" | "arc" | "custom";
+export type AnimationBuildGrouping = "byParagraph" | "byFirstLevel" | "allAtOnce";
+export interface MotionPath {
+    path: string;
+    pathType?: MotionPathType;
+    origin?: "layout" | "parent";
+}
+export interface AnimationBuild {
+    nested?: boolean;
+    grouping?: AnimationBuildGrouping;
+    dimAfter?: string;
+}
+export interface AnimationIntent {
+    type: AnimationType;
+    effect: AnimationEffect;
+    trigger: AnimationTrigger;
+    duration?: number;
+    delay?: number;
+    direction?: AnimationDirection;
+    easing?: AnimationEasing;
+    motionPath?: MotionPath;
+    autoReverse?: boolean;
+    toColor?: string;
+    scaleFactor?: number;
+    rotationAngle?: number;
+    repeat?: number | "indefinite";
+    repeatCount?: number | "indefinite";
+    build?: AnimationBuild;
+    buildType?: AnimationBuildGrouping;
+}
+export interface AnimationGroup {
+    type: "parallel" | "sequence";
+    animations: AnimationIntent[];
+    trigger?: AnimationTrigger;
+}
+export type PaperNode = PaperView | PaperText | PaperImage | PaperTable | PaperChart | PaperGroup | PaperConnector | PaperVideo | PaperAudio;
+export interface SolidBackground {
+    type: "solid";
+    color: ColorValue;
+}
+export interface GradientBackground {
+    type: "gradient";
+    angle?: number;
+    stops: GradientStop[];
+}
+export interface PatternBackground {
+    type: "pattern";
+    pattern: PatternType;
+    foreground: ColorValue;
+    background: ColorValue;
+}
+export interface ImageBackground {
+    type: "image";
+    src: string;
+    tile?: boolean;
+}
+export type SlideBackground = SolidBackground | GradientBackground | PatternBackground | ImageBackground;
+export interface SlideComment {
+    author: string;
+    text: string;
+    date?: string;
+    x?: number;
+    y?: number;
+}
+export interface PaperSlide {
+    type: "Slide";
+    style?: FlexStyle;
+    layoutName?: string;
+    masterName?: string;
+    transition?: SlideTransition;
+    background?: SlideBackground;
+    notes?: string | Paragraph[];
+    headerFooter?: HeaderFooter;
+    comments?: SlideComment[];
+    children: PaperNode[];
+}
+export interface SlideSize {
+    width: number;
+    height: number;
+}
+export interface ThemeColorScheme {
+    dk1?: string;
+    lt1?: string;
+    dk2?: string;
+    lt2?: string;
+    accent1?: string;
+    accent2?: string;
+    accent3?: string;
+    accent4?: string;
+    accent5?: string;
+    accent6?: string;
+    hlink?: string;
+    folHlink?: string;
+}
+export interface ThemeFontScheme {
+    majorLatin?: string;
+    minorLatin?: string;
+    majorEa?: string;
+    minorEa?: string;
+}
+export interface ThemeConfig {
+    name?: string;
+    colorScheme?: ThemeColorScheme;
+    fontScheme?: ThemeFontScheme;
+}
+export interface SlideLayoutConfig {
+    name: string;
+    placeholders?: PlaceholderRef[];
+}
+export interface SlideMasterConfig {
+    name: string;
+    layouts: SlideLayoutConfig[];
+    background?: SlideBackground;
+}
+export interface FontEmbedConfig {
+    fontFamily: string;
+    src: string;
+    bold?: boolean;
+    italic?: boolean;
+}
+export interface SlideSection {
+    name: string;
+    slideIndices: number[];
+}
+export interface DocumentProtection {
+    modifyPassword?: string;
+    readOnly?: boolean;
+}
+export interface CustomShow {
+    name: string;
+    slideIndices: number[];
+}
+export interface CustomProperty {
+    name: string;
+    value: string | number | boolean | Date;
+}
+export interface PrintSettings {
+    colorMode?: "clr" | "gray" | "bw";
+    frameSlides?: boolean;
+    scaleToFitPaper?: boolean;
+}
+export interface DiagramItem {
+    text: string;
+    children?: DiagramItem[];
+    color?: ColorValue;
+    icon?: string;
+}
+export interface DiagramStyle {
+    accentColor?: ColorValue;
+    fontFamily?: string;
+    fontSize?: number;
+    connectorStyle?: "arrow" | "line" | "none";
+    spacing?: number;
+}
+export interface DiagramConfig {
+    type: "process" | "hierarchy" | "cycle" | "matrix" | "pyramid" | "list";
+    items: DiagramItem[];
+    style?: DiagramStyle;
+    direction?: "horizontal" | "vertical";
+}
+export type AccessibilityLevel = "A" | "AA" | "AAA";
+export interface AccessibilityConfig {
+    level: AccessibilityLevel;
+    language?: string;
+    title?: string;
+    autoAltText?: boolean;
+    enforceHeadingHierarchy?: boolean;
+    enforceTableHeaders?: boolean;
+}
+export interface PaperDocument {
+    type: "Document";
+    meta: {
+        title?: string;
+        author?: string;
+        language?: string;
+    };
+    accessible?: boolean | AccessibilityConfig;
+    template?: Buffer;
+    slideSize?: SlideSize;
+    notesSize?: SlideSize;
+    theme?: ThemeConfig;
+    sections?: SlideSection[];
+    masters?: SlideMasterConfig[];
+    embeddedFonts?: FontEmbedConfig[];
+    protection?: DocumentProtection;
+    customShows?: CustomShow[];
+    customProperties?: CustomProperty[];
+    handoutLayout?: "1" | "2" | "3" | "4" | "6" | "9";
+    printSettings?: PrintSettings;
+    chartFallbackImages?: boolean;
+    slides: PaperSlide[];
+}
+export type ImageFormat = "png" | "jpeg";
+export interface ImageRenderOptions {
+    /** Output width in pixels. Default: 400 (free) / 1920 (pro). */
+    width?: number;
+    /** Output height in pixels. Auto-calculated from aspect ratio if omitted. */
+    height?: number;
+    /** Output format. Default: 'png'. */
+    format?: ImageFormat;
+    /** JPEG quality 0–100. Default: 85. Ignored for PNG. */
+    quality?: number;
+    /** Override slide background with a solid hex color (e.g. '#FFFFFF'). */
+    background?: string;
+    /** Scale factor applied after width/height. Default: 1.0. */
+    scale?: number;
+    /** Specific slide indices to render (0-based). Default: all slides. */
+    slides?: number[];
+    /** Cancellation signal — checked before each slide render. */
+    signal?: AbortSignal;
+    /** Progress callback fired after each slide completes. */
+    onProgress?: (slideIndex: number, totalSlides: number) => void;
+}
+export interface SlideImage {
+    /** 0-based index of the slide in the original document. */
+    slideIndex: number;
+    /** Rendered image data (PNG or JPEG). */
+    buffer: Buffer;
+    /** Actual pixel width of the rendered image. */
+    width: number;
+    /** Actual pixel height of the rendered image. */
+    height: number;
+    /** Format of the rendered image. */
+    format: ImageFormat;
+}
+export interface SvgRenderOptions {
+    /** Output width in pixels. Default: slide width. */
+    width?: number;
+    /** Output height in pixels. Auto-calculated from aspect ratio if omitted. */
+    height?: number;
+    /** Scale factor applied after width/height. Default: 1.0. */
+    scale?: number;
+    /** Override slide background with a solid hex color or CSS color. */
+    background?: string;
+    /** Specific slide indices to render (0-based). Default: all slides. */
+    slides?: number[];
+    /** Cancellation signal — checked before each slide render. */
+    signal?: AbortSignal;
+    /** Progress callback fired after each slide completes. */
+    onProgress?: (slideIndex: number, totalSlides: number) => void;
+}
+export interface SlideSvg {
+    /** 0-based index of the slide in the original document. */
+    slideIndex: number;
+    /** Standalone SVG markup for the slide. */
+    svg: string;
+    /** Actual pixel width of the rendered SVG viewport. */
+    width: number;
+    /** Actual pixel height of the rendered SVG viewport. */
+    height: number;
+}
+export declare function traverseAST(node: PaperNode): void;
+//# sourceMappingURL=ast.d.ts.map