@extend-ai/react-pptx 0.2.4 → 0.3.0

package/dist/index.d.ts

@@ -12,6 +12,229 @@ declare class PptxViewerError extends Error {
     });
 }
 
+/** Finite quantity or indefinite; durations are milliseconds and percentages are fractions. */
+type AnimationNumber = number | 'indefinite';
+type AnimationValue = {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'boolean';
+    value: boolean;
+} | {
+    kind: 'integer' | 'number';
+    value: number;
+} | {
+    kind: 'color';
+    value: ColorValue;
+} | {
+    kind: 'point';
+    value: AnimationPoint;
+} | {
+    kind: 'rgbDelta' | 'hslDelta';
+    value: [number, number, number];
+};
+interface SlideTransition {
+    effect?: TransitionEffect;
+    speed: string;
+    durationMs?: number;
+    advanceOnClick: boolean;
+    advanceAfterMs?: number;
+    sound?: TransitionSound;
+    sourceXml: string;
+}
+interface TransitionEffect {
+    kind: string;
+    namespace: string;
+    direction?: string;
+    orientation?: string;
+    throughBlack?: boolean;
+    spokes?: number;
+    parameters: Record<string, string>;
+}
+interface TransitionSound {
+    action: string;
+    loopSound: boolean;
+    source?: AnimationSound;
+}
+interface AnimationSound {
+    relationshipId?: string;
+    target?: string;
+    assetId?: string;
+    external: boolean;
+    name?: string;
+    builtin?: boolean;
+}
+interface SlideTiming {
+    nodes?: AnimationNode[];
+    builds?: AnimationBuild[];
+    unsupported?: string[];
+    sourceXml: string;
+}
+interface AnimationNode {
+    kind: string;
+    time?: AnimationTime;
+    behavior?: AnimationBehavior;
+    sequence?: AnimationSequence;
+    media?: AnimationMedia;
+    parameters: AnimationParameters;
+}
+interface AnimationTime {
+    id?: number;
+    presetId?: number;
+    presetClass?: string;
+    presetSubtype?: number;
+    durationMs?: AnimationNumber;
+    repeatCount: AnimationNumber;
+    repeatDurationMs?: AnimationNumber;
+    speed: number;
+    acceleration: number;
+    deceleration: number;
+    autoReverse: boolean;
+    restart?: string;
+    fill?: string;
+    syncBehavior?: string;
+    timeFilter?: string;
+    eventFilter?: string;
+    display?: boolean;
+    masterRelation?: string;
+    buildLevel?: number;
+    groupId?: number;
+    afterEffect?: boolean;
+    nodeType?: string;
+    placeholder?: boolean;
+    startConditions?: AnimationCondition[];
+    endConditions?: AnimationCondition[];
+    endSync?: AnimationCondition;
+    iterate?: AnimationIteration;
+    children?: AnimationNode[];
+    subNodes?: AnimationNode[];
+}
+interface AnimationCondition {
+    event?: string;
+    delayMs?: AnimationNumber;
+    target?: AnimationTarget;
+    timeNodeId?: number;
+    runtimeNode?: string;
+}
+interface AnimationIteration {
+    kind: string;
+    backwards: boolean;
+    intervalMs?: AnimationNumber;
+    intervalFraction?: number;
+}
+interface AnimationTarget {
+    kind: string;
+    /** Identifier scoped to the owning part, matching object source identity. */
+    shapeId?: string;
+    subShapeId?: string;
+    background?: boolean;
+    text?: AnimationTextRange;
+    chart?: AnimationChartTarget;
+    diagram?: AnimationDiagramTarget;
+    sound?: AnimationSound;
+}
+interface AnimationTextRange {
+    kind: string;
+    start?: number;
+    end?: number;
+}
+interface AnimationChartTarget {
+    kind: string;
+    level?: number;
+    seriesIndex?: number;
+    categoryIndex?: number;
+}
+interface AnimationDiagramTarget {
+    id?: string;
+    buildStep?: string;
+}
+interface AnimationBehavior {
+    target?: AnimationTarget;
+    attributeNames?: string[];
+    additive?: string;
+    accumulate?: string;
+    transformType?: string;
+    from?: string;
+    to?: string;
+    by?: string;
+    runtimeContext?: string;
+    overrideMode?: string;
+}
+interface AnimationSequence {
+    concurrent?: boolean;
+    previousAction?: string;
+    nextAction?: string;
+    previousConditions?: AnimationCondition[];
+    nextConditions?: AnimationCondition[];
+}
+interface AnimationMedia {
+    target?: AnimationTarget;
+    volume: number;
+    mute: boolean;
+    slideCount: number;
+    showWhenStopped: boolean;
+    narration?: boolean;
+    fullScreen?: boolean;
+}
+interface AnimationParameters {
+    from?: AnimationValue;
+    to?: AnimationValue;
+    by?: AnimationValue;
+    calculationMode?: string;
+    valueType?: string;
+    keyframes?: AnimationKeyframe[];
+    colorSpace?: string;
+    direction?: string;
+    transition?: string;
+    filter?: string;
+    properties?: string;
+    progress?: AnimationValue;
+    origin?: string;
+    path?: string;
+    pathEditMode?: string;
+    rotationCenter?: AnimationPoint;
+    rotationDegrees?: number;
+    pointTypes?: string;
+    zoomContents?: boolean;
+    commandType?: string;
+    command?: string;
+}
+interface AnimationPoint {
+    x: number;
+    y: number;
+}
+interface AnimationKeyframe {
+    time: AnimationNumber;
+    formula: string;
+    value?: AnimationValue;
+}
+interface AnimationBuild {
+    kind: string;
+    /** Identifier scoped to the owning part, matching object source identity. */
+    shapeId?: string;
+    groupId?: number;
+    uiExpand: boolean;
+    build?: string;
+    level?: number;
+    animateBackground?: boolean;
+    autoUpdateBackground?: boolean;
+    reverse?: boolean;
+    advanceAfterMs?: AnimationNumber;
+    asOne?: boolean;
+    graphicBuild?: AnimationGraphicBuild;
+    templates?: AnimationTemplate[];
+}
+interface AnimationGraphicBuild {
+    kind: string;
+    build?: string;
+    reverse?: boolean;
+    animateBackground?: boolean;
+}
+interface AnimationTemplate {
+    level: number;
+    nodes?: AnimationNode[];
+}
+
 type PresentationFormat = 'pptx' | 'ppt';
 interface PresentationSize {
     widthEmu: number;
@@ -108,8 +331,28 @@ interface LineStyle {
     startArrow?: string;
     endArrow?: string;
 }
-interface TextRun {
+interface MathElement {
+    name: string;
+    namespace?: string;
+    attributes?: {
+        name: string;
+        namespace?: string;
+        value: string;
+    }[];
+    children?: MathElement[];
+    text?: string;
+}
+interface OfficeMath {
     text: string;
+    display: boolean;
+    sourceXml: string;
+    root?: MathElement;
+    justification?: string;
+    mathMl: string;
+    fontSizePt?: number;
+    unsupported?: string[];
+}
+interface TextRunProperties {
     fontFamily?: string;
     /** Explicit East Asian typeface declared for this run. */
     eastAsianFontFamily?: string;
@@ -134,6 +377,30 @@ interface TextRun {
     kerningThresholdPt?: number;
     hyperlink?: string;
 }
+interface TextRun extends TextRunProperties {
+    math?: OfficeMath;
+    text: string;
+    field?: TextField;
+}
+interface TextField {
+    id?: string;
+    type?: string;
+    hasCachedText: boolean;
+    paragraphProperties?: TextFieldParagraphProperties;
+    sourcePart?: string;
+    sourceXml: string;
+}
+interface TextFieldParagraphProperties extends Omit<TextParagraph, 'runs'> {
+    marginRightEmu?: number;
+    fontAlignment?: string;
+    bulletNone?: boolean;
+    bulletColor?: ColorValue;
+    bulletColorFollowText?: boolean;
+    bulletFontFollowText?: boolean;
+    bulletSizeFollowText?: boolean;
+    bulletImageAssetId?: string;
+    defaultRunProperties?: TextRunProperties;
+}
 interface TextTabStop {
     positionEmu: number;
     alignment: 'left' | 'center' | 'right' | 'decimal';
@@ -179,6 +446,21 @@ interface TextAutofit {
     /** PowerPoint normal-autofit line-spacing reduction, normalized to 0..1. */
     lineSpacingReduction?: number;
 }
+interface ObjectAction {
+    relationshipId?: string;
+    target?: string;
+    external?: boolean;
+    action?: string;
+    tooltip?: string;
+    targetFrame?: string;
+    invalidUrl?: string;
+    history?: boolean;
+    highlightClick?: boolean;
+    endSound?: boolean;
+    soundAssetId?: string;
+    soundName?: string;
+    soundBuiltin?: boolean;
+}
 interface BaseSlideNode {
     id: string;
     name?: string;
@@ -187,10 +469,53 @@ interface BaseSlideNode {
     opacity?: number;
     hyperlink?: string;
     altText?: string;
+    accessibilityTitle?: string;
+    description?: string;
+    decorative?: boolean;
+    clickAction?: ObjectAction;
+    hoverAction?: ObjectAction;
     sourcePart?: string;
+    sourceId?: string;
+    editing?: ObjectEditing;
+}
+interface ObjectEditing {
+    kind: 'shape' | 'connector' | 'picture' | 'group' | 'graphicFrame' | 'contentPart';
+    locks?: ObjectLocks;
+    connector?: ConnectorConnections;
+    textBox?: boolean;
+    preferRelativeResize?: boolean;
+    isComment?: boolean;
+    sourceXml: string;
+}
+interface ObjectLocks {
+    noGrouping?: boolean;
+    noUngrouping?: boolean;
+    noSelection?: boolean;
+    noRotation?: boolean;
+    noChangeAspect?: boolean;
+    noMove?: boolean;
+    noResize?: boolean;
+    noEditPoints?: boolean;
+    noAdjustHandles?: boolean;
+    noChangeArrowheads?: boolean;
+    noChangeShapeType?: boolean;
+    noTextEdit?: boolean;
+    noCrop?: boolean;
+    noDrilldown?: boolean;
+}
+interface ConnectorConnections {
+    start?: ConnectorEndpoint;
+    end?: ConnectorEndpoint;
+}
+interface ConnectorEndpoint {
+    shapeId: number;
+    connectionSite: number;
 }
 interface ShapeNode extends BaseSlideNode {
     type: 'shape';
+    shapeSvg?: string;
+    paintBounds?: PicturePaintBounds;
+    sourceXml?: string;
     geometry: {
         preset?: string;
         path?: string;
@@ -208,6 +533,7 @@ interface ShapeNode extends BaseSlideNode {
     };
     autofit?: TextAutofit;
     textRotation?: number;
+    textTransform?: Transform;
     verticalText?: string;
     horizontalOverflow?: string;
     verticalOverflow?: string;
@@ -217,8 +543,66 @@ interface ShapeNode extends BaseSlideNode {
     rightToLeftColumns?: boolean;
     spaceFirstLastParagraph?: boolean;
 }
+interface PicturePaintBounds {
+    xPx: number;
+    yPx: number;
+    widthPx: number;
+    heightPx: number;
+    layoutWidthPx: number;
+    layoutHeightPx: number;
+}
+interface Model3DAsset {
+    partName: string;
+    contentType: string;
+    data?: Uint8Array;
+}
+interface Model3DPreview {
+    modelRelationshipId?: string;
+    rasterRelationshipId: string;
+    renderer?: string;
+    rendererVersion?: string;
+}
+interface Model3D {
+    modelRelationshipId?: string;
+    linkedModelRelationshipId?: string;
+    asset?: Model3DAsset;
+    preview?: Model3DPreview;
+    sourceXml: string;
+}
 interface ImageNode extends BaseSlideNode {
     type: 'image';
+    model3d?: Model3D;
+    ink?: {
+        assetId?: string;
+        sourceXml?: string;
+        drawing?: {
+            sourceBounds: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+            strokes: Array<{
+                id?: string;
+                timeOffset?: string;
+                points: Array<{
+                    x: number;
+                    y: number;
+                    pressure: number;
+                    contact: boolean;
+                }>;
+                brush: {
+                    width: number;
+                    height: number;
+                    color: string;
+                    opacity: number;
+                    rectangle: boolean;
+                    pencil: boolean;
+                    ignorePressure: boolean;
+                };
+            }>;
+        };
+    };
     assetId: string;
     crop?: {
         top: number;
@@ -226,8 +610,16 @@ interface ImageNode extends BaseSlideNode {
         bottom: number;
         left: number;
     };
+    fallbackAssetId?: string;
     preserveAspectRatio?: boolean;
     effects?: ImageEffects;
+    pictureSvg?: string;
+    fallbackPicture?: {
+        svg: string;
+        paintBounds?: PicturePaintBounds | null;
+    };
+    paintBounds?: PicturePaintBounds;
+    sourceXml?: string;
 }
 interface GroupNode extends BaseSlideNode {
     type: 'group';
@@ -235,6 +627,14 @@ interface GroupNode extends BaseSlideNode {
     childTransform?: Transform;
 }
 interface TableCell {
+    merge?: {
+        horizontal: boolean;
+        vertical: boolean;
+        origin?: {
+            row: number;
+            column: number;
+        };
+    };
     rowSpan?: number;
     colSpan?: number;
     fill?: FillStyle;
@@ -282,9 +682,44 @@ interface ChartNode extends BaseSlideNode {
 }
 interface MediaNode extends BaseSlideNode {
     type: 'media';
-    mediaType: 'audio' | 'video' | 'ole' | 'unknown';
+    mediaType: 'audio' | 'video' | 'ole' | 'control' | 'unknown';
     assetId?: string;
     posterAssetId?: string;
+    sourceUrl?: string;
+    poster?: ImageNode;
+    playback?: {
+        trimStartMs?: number;
+        /** Duration removed from the end of the media. */
+        trimEndMs?: number;
+        fadeInMs?: number;
+        fadeOutMs?: number;
+        bookmarks?: {
+            name: string;
+            timeMs: number;
+        }[];
+    };
+    embeddedObject?: {
+        control?: {
+            classId?: string;
+            persistence?: string;
+            sourceXml?: string;
+            binaryAssetIds?: string[];
+            properties?: Array<{
+                name: string;
+                value?: string;
+            }>;
+        };
+        programId?: string;
+        name?: string;
+        relationshipId?: string;
+        linked: boolean;
+        showAsIcon?: boolean;
+        previewWidthEmu?: number;
+        previewHeightEmu?: number;
+        followColorScheme?: string;
+        updateAutomatic?: boolean;
+    };
+    sourceXml?: string;
 }
 interface UnknownNode extends BaseSlideNode {
     type: 'unknown';
@@ -293,6 +728,7 @@ interface UnknownNode extends BaseSlideNode {
 }
 type SlideNode = ShapeNode | ImageNode | GroupNode | TableNode | ChartNode | MediaNode | UnknownNode;
 interface PresentationTheme {
+    formatSchemeXml?: string;
     id: string;
     name?: string;
     colors: Record<string, string>;
@@ -303,25 +739,77 @@ interface SlideMaster {
     id: string;
     name?: string;
     themeId?: string;
+    transition?: SlideTransition;
+    timing?: SlideTiming;
     nodes: SlideNode[];
 }
 interface SlideLayout {
     id: string;
     name?: string;
     masterId?: string;
+    transition?: SlideTransition;
+    timing?: SlideTiming;
     nodes: SlideNode[];
 }
 interface SlideNote {
     text: string;
+    paragraphs?: TextParagraph[];
 }
 interface SlideComment {
     id: string;
     author?: string;
+    authorId?: string;
+    authorInitials?: string;
+    sourceIndex?: number;
+    sourcePart?: string;
     text: string;
+    paragraphs?: TextParagraph[];
+    replies?: SlideComment[];
+    modern?: ModernComment;
     createdAt?: string;
+    modifiedAt?: string;
+    position?: {
+        x: number;
+        y: number;
+        unit: 'eighthPoint';
+    };
     x?: number;
     y?: number;
 }
+interface ModernComment {
+    status: string;
+    authorUserId?: string;
+    authorProviderId?: string;
+    authorExtensionsXml?: string;
+    anchors?: CommentAnchor[];
+    positionEmu?: {
+        x: number;
+        y: number;
+        sourceX: string;
+        sourceY: string;
+    };
+    task?: CommentTask;
+    extensionsXml?: string;
+}
+interface CommentTask {
+    startDate?: string;
+    dueDate?: string;
+    assignedTo: string[];
+    title: string;
+    completion: string;
+    completionFraction?: number;
+}
+interface CommentAnchor {
+    kind: 'slide' | 'drawingElement' | 'textRange' | 'unknown';
+    monikers: CommentMoniker[];
+}
+interface CommentMoniker {
+    namespace: string;
+    name: string;
+    attributes: Record<string, string>;
+    children?: CommentMoniker[];
+    text?: string;
+}
 interface PresentationSlide {
     id: string;
     index: number;
@@ -330,6 +818,8 @@ interface PresentationSlide {
     masterId?: string;
     layoutId?: string;
     background?: FillStyle;
+    transition?: SlideTransition;
+    timing?: SlideTiming;
     nodes: SlideNode[];
     notes?: SlideNote[];
     comments?: SlideComment[];
@@ -395,6 +885,7 @@ type ViewerZoomState = {
     resolvedZoom: number;
 };
 interface ParsePresentationOptions {
+    include3dModels?: boolean;
     signal?: AbortSignal;
     formatHint?: PresentationFormat;
     maxInputBytes?: number;
@@ -675,6 +1166,7 @@ declare const ReactPptxViewer: react.ForwardRefExoticComponent<Omit<ReactPptxVie
 declare function parsePresentation(source: PresentationSource, options?: ParsePresentationOptions): Promise<ParsedPresentation>;
 declare const presentationParsingDefaults: Readonly<{
     maxInputBytes: number;
+    include3dModels: false;
 }>;
 
 type WasmSource = string | URL | Request | Response | BufferSource | WebAssembly.Module;
@@ -713,4 +1205,4 @@ declare function createPptxThumbnailRenderer(presentation: ParsedPresentation, o
 declare const OFFICE_FONT_FALLBACKS: Readonly<Record<string, readonly string[]>>;
 declare function resolvePptxFontFamily(fontFamily: string, options?: Pick<PptxFontOptions, 'fallbacks' | 'fallbackFamilies' | 'useOfficeFallbacks'>): string;
 
-export { type BinaryPresentationSource, type FitMode, OFFICE_FONT_FALLBACKS, type ParsePresentationOptions, type ParsedPresentation, type PptxFontOptions, type PptxFontSource, type PptxPerformanceMeasurement, type PptxPerformancePhase, type PptxSlideThumbnailItem, type PptxSlideThumbnailRenderOptions, type PptxSlideThumbnailRenderWindow, type PptxSlideThumbnailResolution, type PptxSlideThumbnailStatus, type PptxThumbnailOutput, type PptxThumbnailRenderOptions, type PptxThumbnailRenderResult, type PptxThumbnailRenderer, type PptxThumbnailRendererOptions, type PptxViewerController, PptxViewerError, type PptxViewerThumbnails, type PresentationAsset, type PresentationDocument, type PresentationEmbeddedFont, type PresentationFormat, type PresentationMetadata, type PresentationSearchResult, type PresentationSlide, type PresentationSource, type PresentationTheme, type PresentationWarning, ReactPptxViewer, type ReactPptxViewerProps, type SearchHighlightOptions, type Slide, type SlideComment, type SlideLayout, type SlideMaster, type SlideNode, type SlideNote, type ThumbnailRenderContext, type UsePptxPresentationState, type UsePptxViewerResult, type UsePptxViewerThumbnailsOptions, type ViewerMode, type ViewerSearchOptions, type ViewerZoomLevel, type ViewerZoomMode, type ViewerZoomState, type VirtualizationOptions, type WasmSource, type WorkerWasmSource, createPptxThumbnailRenderer, initWasm, parsePresentation, presentationParsingDefaults, resolvePptxFontFamily, setWasmSource, usePptxModel, usePptxPresentation, usePptxViewer, usePptxViewerThumbnails };
+export { type BinaryPresentationSource, type CommentAnchor, type CommentMoniker, type CommentTask, type FitMode, type ModernComment, OFFICE_FONT_FALLBACKS, type ParsePresentationOptions, type ParsedPresentation, type PicturePaintBounds, type PptxFontOptions, type PptxFontSource, type PptxPerformanceMeasurement, type PptxPerformancePhase, type PptxSlideThumbnailItem, type PptxSlideThumbnailRenderOptions, type PptxSlideThumbnailRenderWindow, type PptxSlideThumbnailResolution, type PptxSlideThumbnailStatus, type PptxThumbnailOutput, type PptxThumbnailRenderOptions, type PptxThumbnailRenderResult, type PptxThumbnailRenderer, type PptxThumbnailRendererOptions, type PptxViewerController, PptxViewerError, type PptxViewerThumbnails, type PresentationAsset, type PresentationDocument, type PresentationEmbeddedFont, type PresentationFormat, type PresentationMetadata, type PresentationSearchResult, type PresentationSlide, type PresentationSource, type PresentationTheme, type PresentationWarning, ReactPptxViewer, type ReactPptxViewerProps, type SearchHighlightOptions, type Slide, type SlideComment, type SlideLayout, type SlideMaster, type SlideNode, type SlideNote, type ThumbnailRenderContext, type UsePptxPresentationState, type UsePptxViewerResult, type UsePptxViewerThumbnailsOptions, type ViewerMode, type ViewerSearchOptions, type ViewerZoomLevel, type ViewerZoomMode, type ViewerZoomState, type VirtualizationOptions, type WasmSource, type WorkerWasmSource, createPptxThumbnailRenderer, initWasm, parsePresentation, presentationParsingDefaults, resolvePptxFontFamily, setWasmSource, usePptxModel, usePptxPresentation, usePptxViewer, usePptxViewerThumbnails };