@extend-ai/react-pptx 0.1.0

package/dist/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/styles.css"],"sourcesContent":[".rpv-root {\n  --rpv-ink: #17211d;\n  --rpv-paper: #f8f5ee;\n  --rpv-panel: #ebe5d9;\n  --rpv-rule: #c7bfb1;\n  --rpv-accent: #d8663a;\n  color: var(--rpv-ink);\n  background: var(--rpv-paper);\n  border: 1px solid var(--rpv-rule);\n  font:\n    500 14px/1.4 ui-sans-serif,\n    system-ui,\n    sans-serif;\n  min-width: 0;\n}\n.rpv-root button {\n  color: inherit;\n  font: inherit;\n}\n.rpv-toolbar {\n  min-height: 48px;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 16px;\n  padding: 0 14px;\n  border-bottom: 1px solid var(--rpv-rule);\n  background: color-mix(in srgb, var(--rpv-paper) 90%, white);\n}\n.rpv-toolbar__cluster {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n}\n.rpv-toolbar button {\n  width: 30px;\n  height: 30px;\n  border: 0;\n  background: transparent;\n  cursor: pointer;\n}\n.rpv-toolbar button:hover:not(:disabled) {\n  background: var(--rpv-panel);\n}\n.rpv-toolbar button:focus-visible,\n.rpv-thumbnail:focus-visible {\n  outline: 3px solid color-mix(in srgb, var(--rpv-accent) 55%, transparent);\n  outline-offset: 2px;\n}\n.rpv-toolbar button:disabled {\n  opacity: 0.35;\n}\n.rpv-toolbar__count {\n  min-width: 66px;\n  text-align: center;\n  font-variant-numeric: tabular-nums;\n}\n.rpv-workspace {\n  display: flex;\n  min-height: var(--rpv-height);\n  max-height: var(--rpv-height);\n}\n.rpv-filmstrip {\n  width: 184px;\n  flex: 0 0 184px;\n  overflow: auto;\n  padding: 18px 14px 32px;\n  border-right: 1px solid var(--rpv-rule);\n  background: var(--rpv-panel);\n}\n.rpv-filmstrip__sizer {\n  position: relative;\n  width: 100%;\n}\n.rpv-filmstrip__item {\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n}\n.rpv-thumbnail {\n  position: relative;\n  display: block;\n  width: 100%;\n  padding: 0 0 15px 24px;\n  border: 0;\n  background: transparent;\n  cursor: pointer;\n  text-align: left;\n}\n.rpv-thumbnail__number {\n  position: absolute;\n  top: 4px;\n  left: 0;\n  color: #756d63;\n  font-size: 10px;\n  font-variant-numeric: tabular-nums;\n}\n.rpv-thumbnail__canvas {\n  display: block;\n  min-height: 76px;\n  overflow: hidden;\n  background: white;\n  border: 1px solid var(--rpv-rule);\n  transition:\n    transform 160ms cubic-bezier(0.22, 1, 0.36, 1),\n    border-color 160ms;\n}\n.rpv-thumbnail:hover .rpv-thumbnail__canvas {\n  transform: translateY(-2px);\n}\n.rpv-thumbnail[data-active] .rpv-thumbnail__canvas {\n  border: 2px solid var(--rpv-accent);\n}\n.rpv-stage {\n  position: relative;\n  flex: 1 1 auto;\n  min-width: 0;\n  overflow: hidden;\n  background: #d8d2c8;\n}\n.rpv-viewport {\n  width: 100%;\n  height: 100%;\n  overflow: auto;\n  overflow-anchor: none;\n  padding: 34px;\n  box-sizing: border-box;\n}\n.rpv-root[data-rpv-scroll-owner='external'] .rpv-workspace {\n  min-height: 0;\n  max-height: none;\n}\n.rpv-viewport[data-rpv-scroll-owner='external'] {\n  height: auto;\n  min-height: var(--rpv-height);\n  overflow: visible;\n}\n.rpv-viewport > * {\n  max-width: 100%;\n}\n.rpv-status {\n  position: absolute;\n  z-index: 5;\n  inset: 0;\n  display: grid;\n  place-content: center;\n  justify-items: center;\n  gap: 10px;\n  padding: 40px;\n  text-align: center;\n  background: #d8d2c8;\n}\n.rpv-status--error strong {\n  font-size: 18px;\n}\n.rpv-status--error span {\n  max-width: 52ch;\n  color: #645e56;\n}\n.rpv-spinner {\n  width: 25px;\n  height: 25px;\n  border: 2px solid #aaa197;\n  border-top-color: var(--rpv-accent);\n  border-radius: 50%;\n  animation: rpv-spin 0.8s linear infinite;\n}\n.rpv-slide-label {\n  position: absolute;\n  right: 14px;\n  bottom: 10px;\n  padding: 3px 7px;\n  background: color-mix(in srgb, var(--rpv-ink) 82%, transparent);\n  color: var(--rpv-paper);\n  font-size: 11px;\n}\n.rpv-diagnostics {\n  width: 270px;\n  flex: 0 0 270px;\n  overflow: auto;\n  border-left: 1px solid var(--rpv-rule);\n  padding: 20px;\n  background: var(--rpv-paper);\n}\n.rpv-diagnostics h2,\n.rpv-notes h2 {\n  margin: 0 0 16px;\n  font-size: 12px;\n  letter-spacing: 0.12em;\n  text-transform: uppercase;\n}\n.rpv-diagnostics dl {\n  margin: 0 0 24px;\n}\n.rpv-diagnostics dl div {\n  display: flex;\n  justify-content: space-between;\n  padding: 7px 0;\n  border-bottom: 1px solid var(--rpv-rule);\n}\n.rpv-diagnostics dd {\n  margin: 0;\n  font-variant-numeric: tabular-nums;\n}\n.rpv-diagnostics p {\n  padding: 10px 0;\n  margin: 0;\n  border-bottom: 1px solid var(--rpv-rule);\n  font-size: 12px;\n}\n.rpv-diagnostics p strong {\n  display: block;\n  color: var(--rpv-accent);\n}\n.rpv-notes {\n  padding: 20px 24px;\n  border-top: 1px solid var(--rpv-rule);\n}\n.rpv-notes p {\n  max-width: 72ch;\n}\n@keyframes rpv-spin {\n  to {\n    transform: rotate(360deg);\n  }\n}\n@media (max-width: 760px) {\n  .rpv-filmstrip {\n    width: 108px;\n    flex-basis: 108px;\n    padding-inline: 8px;\n  }\n  .rpv-thumbnail {\n    padding-left: 0;\n  }\n  .rpv-thumbnail__number {\n    display: none;\n  }\n  .rpv-diagnostics {\n    position: absolute;\n    right: 0;\n    z-index: 4;\n    height: 100%;\n    box-sizing: border-box;\n  }\n  .rpv-viewport {\n    padding: 18px;\n  }\n}\n@media (prefers-reduced-motion: reduce) {\n  .rpv-spinner {\n    animation: none;\n  }\n  .rpv-thumbnail__canvas {\n    transition: none;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,635 @@
+import * as react from 'react';
+import { HTMLAttributes, ReactNode, CSSProperties, Ref, RefCallback } from 'react';
+
+type PptxViewerErrorCode = 'aborted' | 'fetch-failed' | 'invalid-source' | 'unsupported-environment' | 'unsupported-format' | 'encrypted-document' | 'resource-limit' | 'parse-failed' | 'render-failed';
+declare class PptxViewerError extends Error {
+    readonly code: PptxViewerErrorCode;
+    readonly cause?: unknown;
+    readonly details?: Readonly<Record<string, unknown>>;
+    constructor(code: PptxViewerErrorCode, message: string, options?: {
+        cause?: unknown;
+        details?: Readonly<Record<string, unknown>>;
+    });
+}
+
+type PresentationFormat = 'pptx' | 'ppt';
+interface PresentationSize {
+    widthEmu: number;
+    heightEmu: number;
+}
+interface PresentationWarning {
+    code: 'unsupported-feature' | 'degraded-rendering' | 'missing-asset' | 'missing-font' | 'corrupt-content' | 'encrypted-document' | 'resource-limit' | (string & {});
+    message: string;
+    severity: 'info' | 'warning' | 'error';
+    slideIndex?: number;
+    nodeId?: string;
+    partName?: string;
+    feature?: string;
+}
+interface PresentationAsset {
+    id: string;
+    contentType: string;
+    byteLength: number;
+    fileName?: string;
+    data?: Uint8Array;
+    url?: string;
+}
+interface PresentationEmbeddedFont {
+    /** Typeface name declared by PowerPoint. */
+    family: string;
+    /** Asset containing a browser-loadable OpenType or TrueType font. */
+    assetId: string;
+    style: 'normal' | 'italic';
+    weight: '400' | '700';
+}
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface Transform extends Rect {
+    rotation?: number;
+    flipHorizontal?: boolean;
+    flipVertical?: boolean;
+}
+interface ColorValue {
+    value: string;
+    alpha?: number;
+}
+/** DrawingML picture recolor effects declared on an `a:blip`. */
+interface ImageEffects {
+    /** `a:biLevel` black/white threshold, normalized to 0..1. */
+    biLevelThreshold?: number;
+    /** `a:grayscl` grayscale recolor. */
+    grayscale?: boolean;
+    /** `a:duotone` two-color ramp, dark then light. */
+    duotone?: [ColorValue, ColorValue] | ColorValue[];
+    /** `a:lum` brightness, normalized to -1..1. */
+    brightness?: number;
+    /** `a:lum` contrast, normalized to -1..1. */
+    contrast?: number;
+}
+type FillStyle = {
+    type: 'none';
+} | {
+    type: 'solid';
+    color: ColorValue;
+} | {
+    type: 'gradient';
+    angle?: number;
+    stops: Array<{
+        position: number;
+        color: ColorValue;
+    }>;
+} | {
+    type: 'pattern';
+    preset: string;
+    foreground: ColorValue;
+    background: ColorValue;
+} | {
+    type: 'image';
+    assetId: string;
+    mode: 'stretch' | 'tile';
+    crop?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Opacity applied to the image fill only, normalized to 0..1. */
+    opacity?: number;
+    effects?: ImageEffects;
+};
+interface LineStyle {
+    color?: ColorValue;
+    width?: number;
+    dash?: string;
+    startArrow?: string;
+    endArrow?: string;
+}
+interface TextRun {
+    text: string;
+    fontFamily?: string;
+    /** Explicit East Asian typeface declared for this run. */
+    eastAsianFontFamily?: string;
+    /** Explicit complex-script typeface declared for this run. */
+    complexScriptFontFamily?: string;
+    /** Explicit symbol typeface declared for this run. */
+    symbolFontFamily?: string;
+    fontSizePt?: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    color?: ColorValue;
+    baseline?: number;
+    /** OOXML run character spacing, in points. */
+    characterSpacingPt?: number;
+    language?: string;
+    alternativeLanguage?: string;
+    /** Run-level bidi override from DrawingML. */
+    rightToLeft?: boolean;
+    /** Minimum font size, in points, at which pair kerning is enabled. */
+    kerningThresholdPt?: number;
+    hyperlink?: string;
+}
+interface TextTabStop {
+    positionEmu: number;
+    alignment: 'left' | 'center' | 'right' | 'decimal';
+}
+interface TextSpacing {
+    value: number;
+    /** Percent values are normalized factors: 1 is 100%. */
+    unit: 'points' | 'percent';
+}
+interface TextParagraph {
+    runs: TextRun[];
+    alignment?: 'left' | 'center' | 'right' | 'justify' | 'distributed';
+    level?: number;
+    bullet?: {
+        kind: 'character' | 'number' | 'picture';
+        value?: string;
+        fontFamily?: string;
+        fontSizePt?: number;
+        sizePercent?: number;
+        startAt?: number;
+    };
+    /** Structured values preserve OOXML units; numbers remain accepted for 0.1.x compatibility. */
+    lineSpacing?: TextSpacing | number;
+    spaceBefore?: TextSpacing | number;
+    spaceAfter?: TextSpacing | number;
+    rtl?: boolean;
+    /** Exact OOXML paragraph left margin, in EMUs. */
+    marginLeftEmu?: number;
+    /** Exact OOXML first-line or hanging indent, in EMUs. */
+    indentEmu?: number;
+    /** Default interval used for tabs without an explicit stop, in EMUs. */
+    defaultTabSizeEmu?: number;
+    /** Explicit DrawingML paragraph tab stops. */
+    tabStops?: TextTabStop[];
+    eastAsianLineBreak?: boolean;
+    latinLineBreak?: boolean;
+    hangingPunctuation?: boolean;
+}
+interface TextAutofit {
+    mode: 'none' | 'normal' | 'shape';
+    /** PowerPoint normal-autofit font scale, normalized to 0..1. */
+    fontScale?: number;
+    /** PowerPoint normal-autofit line-spacing reduction, normalized to 0..1. */
+    lineSpacingReduction?: number;
+}
+interface BaseSlideNode {
+    id: string;
+    name?: string;
+    transform: Transform;
+    hidden?: boolean;
+    opacity?: number;
+    hyperlink?: string;
+    altText?: string;
+    sourcePart?: string;
+}
+interface ShapeNode extends BaseSlideNode {
+    type: 'shape';
+    geometry: {
+        preset?: string;
+        path?: string;
+        adjustments?: Record<string, number>;
+    };
+    fill?: FillStyle;
+    line?: LineStyle;
+    paragraphs?: TextParagraph[];
+    verticalAlignment?: 'top' | 'middle' | 'bottom';
+    textInsets?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    autofit?: TextAutofit;
+    textRotation?: number;
+    verticalText?: string;
+    horizontalOverflow?: string;
+    verticalOverflow?: string;
+    textWrap?: 'none' | 'square' | (string & {});
+    columnCount?: number;
+    columnSpacing?: number;
+    rightToLeftColumns?: boolean;
+    spaceFirstLastParagraph?: boolean;
+}
+interface ImageNode extends BaseSlideNode {
+    type: 'image';
+    assetId: string;
+    crop?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    preserveAspectRatio?: boolean;
+    effects?: ImageEffects;
+}
+interface GroupNode extends BaseSlideNode {
+    type: 'group';
+    children: SlideNode[];
+    childTransform?: Transform;
+}
+interface TableCell {
+    rowSpan?: number;
+    colSpan?: number;
+    fill?: FillStyle;
+    borders?: Partial<Record<'top' | 'right' | 'bottom' | 'left', LineStyle>>;
+    paragraphs: TextParagraph[];
+    textInsets?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    verticalAlignment?: 'top' | 'middle' | 'bottom';
+    textRotation?: number;
+}
+interface TableNode extends BaseSlideNode {
+    type: 'table';
+    rows: TableCell[][];
+    columnWidths?: number[];
+    rowHeights?: number[];
+}
+interface ChartSeries {
+    name?: string;
+    categories?: Array<string | number>;
+    values: Array<number | null>;
+    color?: ColorValue;
+}
+interface ChartNode extends BaseSlideNode {
+    type: 'chart';
+    chartType: string;
+    title?: string;
+    series: ChartSeries[];
+    hasLegend?: boolean;
+    /**
+     * Raw DrawingML chart part XML (`c:chartSpace` or `cx:chartSpace`).
+     * Viewers use this for full-fidelity chart rendering; the parsed summary
+     * fields above remain available for search and fallbacks.
+     */
+    chartXml?: string;
+    /** Companion Microsoft chart style part (`style*.xml`), when present. */
+    chartStyleXml?: string;
+    /** Companion Microsoft chart color style part (`colors*.xml`), when present. */
+    chartColorsXml?: string;
+}
+interface MediaNode extends BaseSlideNode {
+    type: 'media';
+    mediaType: 'audio' | 'video' | 'ole' | 'unknown';
+    assetId?: string;
+    posterAssetId?: string;
+}
+interface UnknownNode extends BaseSlideNode {
+    type: 'unknown';
+    feature: string;
+    fallbackAssetId?: string;
+}
+type SlideNode = ShapeNode | ImageNode | GroupNode | TableNode | ChartNode | MediaNode | UnknownNode;
+interface PresentationTheme {
+    id: string;
+    name?: string;
+    colors: Record<string, string>;
+    majorFonts?: Partial<Record<'latin' | 'eastAsia' | 'complexScript', string>>;
+    minorFonts?: Partial<Record<'latin' | 'eastAsia' | 'complexScript', string>>;
+}
+interface SlideMaster {
+    id: string;
+    name?: string;
+    themeId?: string;
+    nodes: SlideNode[];
+}
+interface SlideLayout {
+    id: string;
+    name?: string;
+    masterId?: string;
+    nodes: SlideNode[];
+}
+interface SlideNote {
+    text: string;
+}
+interface SlideComment {
+    id: string;
+    author?: string;
+    text: string;
+    createdAt?: string;
+    x?: number;
+    y?: number;
+}
+interface PresentationSlide {
+    id: string;
+    index: number;
+    name?: string;
+    hidden?: boolean;
+    masterId?: string;
+    layoutId?: string;
+    background?: FillStyle;
+    nodes: SlideNode[];
+    notes?: SlideNote[];
+    comments?: SlideComment[];
+    warnings?: PresentationWarning[];
+    sourcePart?: string;
+}
+interface PresentationMetadata {
+    title?: string;
+    subject?: string;
+    creator?: string;
+    company?: string;
+    createdAt?: string;
+    modifiedAt?: string;
+}
+interface PresentationDocument {
+    format: PresentationFormat;
+    size: PresentationSize;
+    slides: PresentationSlide[];
+    masters: SlideMaster[];
+    layouts: SlideLayout[];
+    themes: PresentationTheme[];
+    assets: Record<string, PresentationAsset>;
+    /** Fonts embedded in the package and decoded by the native parser. */
+    embeddedFonts?: PresentationEmbeddedFont[];
+    warnings: PresentationWarning[];
+    metadata?: PresentationMetadata;
+}
+type Slide = PresentationSlide;
+interface PresentationSearchResult {
+    slideIndex: number;
+    nodeId: string;
+    nodeType: SlideNode['type'];
+    text: string;
+    matchStart: number;
+    matchEnd: number;
+    snippet: string;
+    bounds?: Rect;
+}
+
+type BinaryPresentationSource = ArrayBuffer | Uint8Array | Blob | string | URL;
+interface ParsedPresentation {
+    readonly kind: 'parsed-presentation';
+    readonly document: PresentationDocument;
+    readonly warnings: readonly PresentationWarning[];
+}
+type PresentationSource = BinaryPresentationSource | PresentationDocument | ParsedPresentation;
+type ViewerMode = 'slide' | 'continuous';
+type FitMode = 'contain' | 'none';
+interface ParsePresentationOptions {
+    signal?: AbortSignal;
+    formatHint?: PresentationFormat;
+    maxInputBytes?: number;
+    fetchInit?: Omit<RequestInit, 'signal'>;
+}
+interface VirtualizationOptions {
+    /**
+     * Mount only slides near the viewport in continuous mode, windowed with
+     * TanStack Virtual at fixed offsets so scrolling never shifts layout.
+     * Default `true`.
+     */
+    enabled?: boolean;
+    /**
+     * @deprecated The virtualized window is viewport-driven; this option is
+     * ignored and kept only for API compatibility.
+     */
+    initialSlides?: number;
+    /** Overscan measured in viewport heights. Default `1.5`. */
+    overscanViewport?: number;
+    /** Slides rendered per cooperative batch. Default `3`. */
+    batchSize?: number;
+    /**
+     * Scroll viewport owned by the host application. Pass the viewport element
+     * from Radix, Base UI, coss, or another custom scroll-area implementation.
+     */
+    scrollElement?: HTMLElement | null;
+}
+interface PptxFontSource {
+    /** Font family used by PowerPoint text runs. */
+    family: string;
+    /** URL/CSS font source or font bytes. */
+    source: string | ArrayBuffer | Uint8Array | Blob;
+    descriptors?: FontFaceDescriptors;
+}
+interface PptxFontOptions {
+    /** Host-provided web fonts. Embedded PPTX fonts are loaded automatically. */
+    sources?: readonly PptxFontSource[];
+    /** Per-family fallback overrides, keyed case-sensitively or in lowercase. */
+    fallbacks?: Readonly<Record<string, string | readonly string[]>>;
+    /** Extra script-complete families appended to every stack. */
+    fallbackFamilies?: readonly string[];
+    /** Apply built-in Office/CJK/RTL fallback stacks. Default `true`. */
+    useOfficeFallbacks?: boolean;
+    /** Load supported fonts embedded in the PPTX. Default `true`. */
+    loadEmbeddedFonts?: boolean;
+    /** Wait for registered fonts before rendering slides. Default `true`. */
+    waitForFonts?: boolean;
+    /** Report unavailable requested families through `onWarning`. Default `true`. */
+    reportMissingFonts?: boolean;
+    /** Maximum wait for each font and `document.fonts.ready`. Default `5000`. */
+    loadTimeoutMs?: number;
+    onFontLoaded?: (family: string, face: FontFace) => void;
+    onFontsReady?: () => void;
+}
+interface ViewerSearchOptions {
+    matchCase?: boolean;
+    wholeWord?: boolean;
+    useRegex?: boolean;
+    snippetRadius?: number;
+    includeShapes?: boolean;
+    includeTables?: boolean;
+    includeGroups?: boolean;
+}
+interface SearchHighlightOptions {
+    className?: string;
+    borderColor?: string;
+    backgroundColor?: string;
+    boxShadow?: string;
+    borderRadius?: number | string;
+    borderWidth?: number | string;
+    padding?: number;
+    zIndex?: number;
+    style?: Record<string, string | number | undefined>;
+    scrollIntoView?: boolean | ScrollIntoViewOptions;
+}
+interface ThumbnailRenderContext {
+    slideIndex: number;
+    slideCount: number;
+    isCurrent: boolean;
+    goToSlide: () => void;
+}
+type PptxSlideThumbnailResolution = number | {
+    maxHeight?: number;
+    maxWidth?: number;
+};
+interface PptxSlideThumbnailRenderOptions {
+    /** Rendered thumbnail width in CSS pixels. */
+    width?: number;
+}
+interface PptxSlideThumbnailRenderWindow {
+    /**
+     * Slide indexes whose attached thumbnail containers should render first.
+     *
+     * Use this for the thumbnails currently mounted in a virtualized rail.
+     */
+    visibleSlideIndexes?: readonly number[];
+    /**
+     * Slide indexes to render into a detached cache after visible thumbnails.
+     * Prefetched slides are adopted when their container mounts.
+     */
+    prefetchSlideIndexes?: readonly number[];
+}
+interface UsePptxViewerThumbnailsOptions {
+    /** Desired thumbnail bounds. A number constrains both dimensions. Default `160`. */
+    resolution?: PptxSlideThumbnailResolution;
+    /** Prioritizes and prefetches slides for consumer-owned virtualized thumbnail rails. */
+    renderWindow?: PptxSlideThumbnailRenderWindow;
+    /** Prevent rendering while preserving stable thumbnail metadata. Default `false`. */
+    disabled?: boolean;
+}
+type PptxSlideThumbnailStatus = 'idle' | 'rendering' | 'ready' | 'error';
+interface PptxSlideThumbnailItem {
+    /** Source slide aspect ratio. */
+    aspectRatio: number;
+    /** Natural slide height in CSS pixels. */
+    contentHeight: number;
+    /** Natural slide width in CSS pixels. */
+    contentWidth: number;
+    /** Stable ref callback that renders into an attached consumer-owned element. */
+    containerRef: (element: HTMLElement | null) => void;
+    /** Last thumbnail rendering error, if any. */
+    error?: Error;
+    /** Rendered thumbnail height in CSS pixels. */
+    height: number;
+    /** Normalized source slide represented by this thumbnail. */
+    slide: PresentationDocument['slides'][number];
+    /** Zero-based slide index. */
+    slideIndex: number;
+    /** One-based slide number for display. */
+    slideNumber: number;
+    /** Current thumbnail render status. */
+    status: PptxSlideThumbnailStatus;
+    /** Renders this thumbnail into a consumer-owned element. */
+    renderToContainer: (element: HTMLElement) => Promise<void>;
+    /** Rendered thumbnail width in CSS pixels. */
+    width: number;
+}
+interface PptxViewerThumbnails {
+    /** Renders the requested slide into a consumer-owned element. */
+    renderThumbnail: (slideIndex: number, element: HTMLElement) => Promise<void>;
+    /** Re-renders every thumbnail currently attached through `containerRef`. */
+    rerenderAttachedThumbnails: () => Promise<void>;
+    /** Thumbnail metadata and render helpers for each slide. */
+    thumbnails: PptxSlideThumbnailItem[];
+}
+interface PptxViewerController {
+    goToSlide(index: number, scrollOptions?: ScrollIntoViewOptions): Promise<void>;
+    next(): Promise<void>;
+    previous(): Promise<void>;
+    setZoom(percent: number): Promise<void>;
+    setFitMode(mode: FitMode): Promise<void>;
+    search(query: string | RegExp, options?: ViewerSearchOptions): PresentationSearchResult[];
+    highlightSearchResult(result: PresentationSearchResult, options?: SearchHighlightOptions): Promise<void>;
+    clearSearchHighlights(): void;
+    /** True after the slide renderer is ready to service thumbnail requests. */
+    isReady(): boolean;
+    /** Renders a detached slide thumbnail and returns its cleanup function. */
+    renderThumbnail(index: number, target: HTMLElement, options?: PptxSlideThumbnailRenderOptions): Promise<() => void>;
+    getDocument(): PresentationDocument | null;
+    getSlideIndex(): number;
+    getZoom(): number;
+}
+interface ReactPptxViewerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onError' | 'onLoad'> {
+    source: PresentationSource;
+    mode?: ViewerMode;
+    /** Controlled zero-based slide index. */
+    slideIndex?: number;
+    /** Initial zero-based slide index for uncontrolled usage. */
+    initialSlide?: number;
+    /** Controlled zoom percentage. */
+    zoom?: number;
+    defaultZoom?: number;
+    fitMode?: FitMode;
+    width?: number;
+    height?: number | string;
+    showToolbar?: boolean;
+    showThumbnails?: boolean;
+    showNotes?: boolean;
+    showDiagnostics?: boolean;
+    showSlideLabels?: boolean;
+    virtualization?: boolean | VirtualizationOptions;
+    /** Font loading, substitution, and missing-font diagnostics. */
+    fonts?: PptxFontOptions;
+    parseOptions?: ParsePresentationOptions;
+    searchQuery?: string | RegExp;
+    searchOptions?: ViewerSearchOptions;
+    activeSearchResult?: number | PresentationSearchResult | null;
+    searchHighlightOptions?: SearchHighlightOptions;
+    renderThumbnail?: (context: ThumbnailRenderContext) => ReactNode;
+    renderLoading?: () => ReactNode;
+    renderError?: (error: PptxViewerError) => ReactNode;
+    emptyState?: ReactNode;
+    toolbarClassName?: string;
+    viewportClassName?: string;
+    toolbarStyle?: CSSProperties;
+    viewportStyle?: CSSProperties;
+    onReady?: (controller: PptxViewerController) => void;
+    onLoad?: (presentation: ParsedPresentation) => void;
+    onError?: (error: PptxViewerError) => void;
+    onWarning?: (warning: PresentationWarning) => void;
+    onSlideChange?: (index: number) => void;
+    onSlideRendered?: (index: number, element: HTMLElement) => void;
+    onSlideUnmounted?: (index: number) => void;
+    onSearchResults?: (results: readonly PresentationSearchResult[]) => void;
+    onThumbnailRendered?: (index: number, element: HTMLElement) => void;
+    /** Supplies the internal slide surface to host integrations and test harnesses. */
+    onViewportReady?: (element: HTMLDivElement) => void;
+    ref?: Ref<PptxViewerController>;
+}
+
+declare const ReactPptxViewer: react.ForwardRefExoticComponent<Omit<ReactPptxViewerProps, "ref"> & react.RefAttributes<PptxViewerController>>;
+
+/**
+ * Parse a PowerPoint source into the format-neutral public model used by the
+ * package-owned renderer.
+ */
+declare function parsePresentation(source: PresentationSource, options?: ParsePresentationOptions): Promise<ParsedPresentation>;
+declare const presentationParsingDefaults: Readonly<{
+    maxInputBytes: number;
+}>;
+
+type WasmSource = string | URL | Request | Response | BufferSource | WebAssembly.Module;
+type WorkerWasmSource = string | ArrayBuffer | WebAssembly.Module;
+declare function setWasmSource(source: WasmSource): void;
+declare function initWasm(source?: WasmSource): Promise<void>;
+
+interface UsePptxPresentationState {
+    presentation: ParsedPresentation | null;
+    document: ParsedPresentation['document'] | null;
+    isLoading: boolean;
+    error: PptxViewerError | null;
+}
+/** Parse a presentation independently from the viewer, mirroring `useDocxModel`. */
+declare function usePptxPresentation(source?: PresentationSource | null, options?: ParsePresentationOptions): UsePptxPresentationState;
+/** Backwards-friendly model-oriented alias. */
+declare const usePptxModel: typeof usePptxPresentation;
+interface UsePptxViewerResult {
+    controller: PptxViewerController | null;
+    ref: RefCallback<PptxViewerController>;
+}
+/** Reactive access to the imperative viewer controller. */
+declare function usePptxViewer(): UsePptxViewerResult;
+
+/**
+ * Exposes detached slide previews for consumer-owned thumbnail rails.
+ *
+ * PPTX slides remain live DOM/SVG surfaces to preserve the main viewer's
+ * rendering fidelity. Attach `thumbnail.containerRef` to a sized element.
+ */
+declare function usePptxViewerThumbnails(controller: PptxViewerController | null | undefined, options?: UsePptxViewerThumbnailsOptions): PptxViewerThumbnails;
+
+/** Cross-platform, metrically similar substitutions for common Office typefaces. */
+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 PptxSlideThumbnailItem, type PptxSlideThumbnailRenderOptions, type PptxSlideThumbnailRenderWindow, type PptxSlideThumbnailResolution, type PptxSlideThumbnailStatus, 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 VirtualizationOptions, type WasmSource, type WorkerWasmSource, initWasm, parsePresentation, presentationParsingDefaults, resolvePptxFontFamily, setWasmSource, usePptxModel, usePptxPresentation, usePptxViewer, usePptxViewerThumbnails };