pptx-react-viewer 1.11.0 → 1.13.0

package/dist/{PowerPointViewer-88hWoBGx.d.ts → types-ui-DlsqFx7_.d.ts}

@@ -1,5 +1,4 @@
-import { l, P, $, f, i, X, U, R, h, V } from './presentation-CLc4eS3z.js';
-import * as React from 'react';
+import { l, P, $, U, f, i, X, R, h } from './presentation-CLc4eS3z.js';
 import React__default from 'react';
 import { ViewerTheme } from './theme/index.js';
 
@@ -159,6 +158,130 @@ interface CollaborationConfig {
      */
     writeBackDebounceMs?: number;
 }
+/** Snapshot of a single element's animation state at a point in the timeline. */
+interface ElementAnimationState {
+    /** Whether the element should be visible. */
+    visible: boolean;
+    /** CSS animation shorthand to apply (undefined = no active animation). */
+    cssAnimation: string | undefined;
+}
+
+/**
+ * slide-compare — pure, framework-agnostic slide-diff engine shared by every
+ * binding (React / Vue / Angular).
+ *
+ * Provides two entry points over the same element-diff core:
+ *   - `comparePresentation(base, compare)` — diffs two full `PptxData` documents
+ *     (the React surface).
+ *   - `compareSlides(base, compare)` — diffs two `PptxSlide[]` arrays directly
+ *     (the Vue editor-foundation surface), plus `compareSlide` for a single
+ *     slide pair and `diffSlideElements` for the flattened element trees.
+ *
+ * DOM-free and side-effect-free.
+ */
+
+type SlideDiffStatus = 'added' | 'removed' | 'changed' | 'unchanged';
+type ElementChangeKind = 'added' | 'removed' | 'moved' | 'resized' | 'textChanged';
+interface ElementChange {
+    elementId: string;
+    label: string;
+    kind: ElementChangeKind;
+    description: string;
+}
+interface SlideDiff {
+    status: SlideDiffStatus;
+    /** Index in the base (current) presentation, or -1 for added slides. */
+    baseIndex: number;
+    /** Index in the compare (other) presentation, or -1 for removed slides. */
+    compareIndex: number;
+    /** The base slide data (undefined for added slides). */
+    baseSlide?: l;
+    /** The compare slide data (undefined for removed slides). */
+    compareSlide?: l;
+    /** Per-element changes when status is `changed`. */
+    changes: ElementChange[];
+}
+interface CompareResult {
+    diffs: SlideDiff[];
+    baseSlideCount: number;
+    compareSlideCount: number;
+    addedCount: number;
+    removedCount: number;
+    changedCount: number;
+    unchangedCount: number;
+}
+
+/**
+ * mobile-viewport.ts: framework-agnostic viewport / touch / orientation
+ * detection shared by the React, Vue, and Angular bindings.
+ *
+ * These are the pure predicates and feature-detection helpers behind each
+ * binding's `useIsMobile` / `IsMobileService`. The reactive wiring (React
+ * state, Vue refs, Angular signals) stays in the binding; the breakpoint maths
+ * and DOM capability probes live here so all three frameworks switch chrome at
+ * exactly the same thresholds.
+ *
+ * SSR / test safe: every probe feature-detects `window` / `navigator` /
+ * `screen` and returns a sensible default when absent.
+ */
+/** Mobile breakpoint: below this width is considered mobile. */
+declare const MOBILE_BREAKPOINT = 768;
+/** Tablet breakpoint: below this width (but >= MOBILE) is tablet. */
+declare const TABLET_BREAKPOINT = 1024;
+/** Device orientation as reported by the screen / viewport aspect ratio. */
+type DeviceOrientation = 'portrait' | 'landscape';
+interface TouchGestureCallbacks {
+    /** Called continuously during a pinch gesture with the new (clamped) scale. */
+    onPinchZoom?: (newScale: number) => void;
+    /** Called when a horizontal swipe is detected. direction: -1 = left, 1 = right. */
+    onSwipe?: (direction: -1 | 1) => void;
+    /** Called when a long-press is detected, with the press coordinates. */
+    onLongPress?: (clientX: number, clientY: number) => void;
+}
+
+/**
+ * Pure handout layout calculations, shared by every binding's print path.
+ *
+ * Handles distributing slides across pages, computing grid dimensions, and
+ * positioning cells within A4 page space. No DOM/framework dependency: callers
+ * render the resulting rectangles however their view layer prefers.
+ */
+/** Supported slides-per-page values. */
+type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9;
+
+/**
+ * Pure print helpers shared by every binding's print path: settings validation,
+ * slide-range / colour-filter resolution, page-count estimation, HTML markup
+ * builders, escaping, and the full print-document assembler.
+ *
+ * No DOM side effects and no `window.print()`: everything is deterministic and
+ * the binding writes the returned HTML string into a print window. The handout
+ * grid geometry lives in `handout-layout`; this module reuses it.
+ *
+ * ng-packagr constraint honoured here (the Angular binding inlines this source
+ * and compiles it through ng-packagr): NO `String.prototype.replaceAll`
+ * (`escapeHtml` uses `.split(x).join(y)` instead).
+ */
+
+/** What to print. */
+type PrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+/** Page orientation for the printed output. */
+type PrintOrientation = 'portrait' | 'landscape';
+/** Colour mode for the printed output. */
+type PrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+/** Slide range mode. */
+type PrintSlideRange = 'all' | 'current' | 'custom';
+/** Resolved print settings emitted on confirm. */
+interface PrintSettings {
+    printWhat: PrintWhat;
+    orientation: PrintOrientation;
+    colorMode: PrintColorMode;
+    frameSlides: boolean;
+    slidesPerPage: HandoutSlidesPerPage;
+    slideRange: PrintSlideRange;
+    customRangeFrom: number;
+    customRangeTo: number;
+}
 
 /**
  * Core data-model types for the PowerPoint viewer/editor plugin.
@@ -575,24 +698,4 @@ interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI {
     getContent: () => Promise<Uint8Array>;
 }
 
-/**
- * Thin adapter shim: the initial-style resolution now lives in
- * `pptx-viewer-shared` (`render/animation-effects`). Shared returns a neutral
- * `AnimationStyle` (camelCase inline-style map); these wrappers re-type the
- * result as `React.CSSProperties` so React consumers/tests are unchanged.
- */
-
-declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation?: V): React__default.CSSProperties;
-
-/**
- * Root React component for the PowerPoint viewer/editor.
- *
- * Accepts binary `.pptx` content and renders a full-featured editor with
- * slide canvas, toolbar, inspector panels, presentation mode, and more.
- *
- * Uses `forwardRef` to expose a `PowerPointViewerHandle` for imperative
- * access (e.g. serialising the current content for saving).
- */
-declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
-
-export { type AccessibilityIssue as A, type SlideTransitionOption as B, type CollaborationRole as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type StrokeDashOption as G, type SupportedShapeType as H, type ToolbarSection as I, type MarqueeSelectionState as M, PowerPointViewer as P, type ResizeHandle as R, type ShapeAdjustmentDragState as S, type TableCellEditorState as T, type ViewerMode as V, type PowerPointViewerAPI as a, type PowerPointViewerHandle as b, type PowerPointViewerProps as c, type CollaborationConfig as d, type AnimationPresetOption as e, type CanvasSize as f, getAnimationInitialStyle as g, type ConnectorArrowOption as h, type ConnectorGeometryOption as i, type ConnectorGeometryType as j, type ConnectorPathGeometry as k, type DrawingTool as l, type ElementBounds as m, type ElementClipboardPayload as n, type ElementContextMenuAction as o, type ElementContextMenuState as p, type ParsedTableCell as q, type ParsedTableData as r, type PresentationAnimationRuntime as s, type ResizeState as t, type ShapeAdjustmentHandleDescriptor as u, type ShapePreset as v, type ShapeQuickStyle as w, type ShortcutReferenceItem as x, type SlideAlignment as y, type SlideSectionGroup as z };
+export { type AccessibilityIssue as A, type SupportedShapeType as B, type CollaborationConfig as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type ToolbarSection as G, type ElementAnimationState as H, type PrintSettings as I, type CompareResult as J, type DeviceOrientation as K, type TouchGestureCallbacks as L, type MarqueeSelectionState as M, MOBILE_BREAKPOINT as N, TABLET_BREAKPOINT as O, type PowerPointViewerAPI as P, type ResizeHandle as R, type ShapeAdjustmentDragState as S, type TableCellEditorState as T, type ViewerMode as V, type PowerPointViewerHandle as a, type PowerPointViewerProps as b, type AnimationPresetOption as c, type CanvasSize as d, type CollaborationRole as e, type ConnectorArrowOption as f, type ConnectorGeometryOption as g, type ConnectorGeometryType as h, type ConnectorPathGeometry as i, type DrawingTool as j, type ElementBounds as k, type ElementClipboardPayload as l, type ElementContextMenuAction as m, type ElementContextMenuState as n, type ParsedTableCell as o, type ParsedTableData as p, type PresentationAnimationRuntime as q, type ResizeState as r, type ShapeAdjustmentHandleDescriptor as s, type ShapePreset as t, type ShapeQuickStyle as u, type ShortcutReferenceItem as v, type SlideAlignment as w, type SlideSectionGroup as x, type SlideTransitionOption as y, type StrokeDashOption as z };