pptx-angular-viewer 1.1.17 → 1.1.19

package/types/pptx-angular-viewer.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { Signal, OnInit, OnDestroy, InjectionToken, Provider } from '@angular/core';
 import * as pptx_viewer_core from 'pptx-viewer-core';
-import { PptxSlide, AccessibilityCheckOptions, AccessibilityIssue, PptxElement, PptxTheme, PptxSlideMaster, PptxEmbeddedFont, PptxCoreProperties, ParsedSignature, PptxComment, TextSegment, TextStyle, PptxTableCell, Model3DPptxElement, ZoomPptxElement, PptxSlideTransition, TablePptxElement, ChartPptxElement, XmlObject, SignatureStatus, AccessibilityIssueSeverity, AccessibilityIssueType, PptxElementAnimation, PptxTransitionType, ShapeStyle } from 'pptx-viewer-core';
+import { PptxSlide, AccessibilityCheckOptions, AccessibilityIssue, PptxElement, PptxTheme, PptxSlideMaster, PptxEmbeddedFont, PptxCoreProperties, ParsedSignature, PptxComment, TextSegment, TextStyle, PptxTableCell, Model3DPptxElement, ZoomPptxElement, PptxElementAnimation, PptxSlideTransition, TablePptxElement, ChartPptxElement, PptxAnimationPreset, PptxAnimationTrigger, PptxAnimationTimingCurve, PptxAnimationRepeatMode, PptxAnimationDirection, PptxAnimationSequence, XmlObject, SignatureStatus, AccessibilityIssueSeverity, AccessibilityIssueType, PptxTransitionType, ShapeStyle } from 'pptx-viewer-core';
 import * as pptx_angular_viewer from 'pptx-angular-viewer';
 import { Options } from 'html2canvas-pro';
 import { SafeHtml } from '@angular/platform-browser';
@@ -657,6 +657,62 @@ declare function replaceMatch(slides: readonly PptxSlide[], allResults: readonly
  */
 declare function replaceInSlides(slides: readonly PptxSlide[], query: string, replacement: string, opts?: FindOptions): ReplaceResult;
 
+/**
+ * Decide whether the current environment is "mobile" based on two signals:
+ * - `width` is the viewport / container width in pixels
+ * - `coarsePointer` is true when `(pointer: coarse)` matches
+ *
+ * Either condition alone is sufficient (narrow viewport OR touch device).
+ *
+ * @pure — no side effects, fully testable without a DOM.
+ */
+declare function computeIsMobile(width: number, coarsePointer: boolean): boolean;
+/**
+ * Decide whether the current environment is "tablet" based on width only.
+ * A coarse-pointer device at tablet width is still treated as mobile
+ * (handled by `computeIsMobile`).
+ *
+ * @pure
+ */
+declare function computeIsTablet(width: number, coarsePointer: boolean): boolean;
+/**
+ * `IsMobileService` — provides reactive signals for the current viewport /
+ * pointer kind so components can switch between mobile and desktop chrome
+ * without subscribing to resize events themselves.
+ *
+ * Inject at the component level (or provide at root) — the service cleans up
+ * its `MediaQueryList` listeners automatically via `DestroyRef`.
+ *
+ * ```ts
+ * providers: [IsMobileService]
+ * // or globally:
+ * // provideIsMobile()  (see factory below)
+ * ```
+ *
+ * ```ts
+ * protected readonly mobile = inject(IsMobileService);
+ * // in template:  @if (mobile.isMobile()) { … }
+ * ```
+ */
+declare class IsMobileService {
+    /** True when the primary pointer is coarse (touch / stylus). */
+    readonly isCoarsePointer: _angular_core.WritableSignal<boolean>;
+    /** True when the viewport width is below {@link MOBILE_BREAKPOINT}. */
+    readonly isNarrowViewport: _angular_core.WritableSignal<boolean>;
+    /**
+     * True when either the pointer is coarse OR the viewport is narrow.
+     * Use this as the single gate for showing mobile chrome.
+     */
+    readonly isMobile: _angular_core.WritableSignal<boolean>;
+    /** True when the viewport is in the tablet range (desktop pointer only). */
+    readonly isTablet: _angular_core.WritableSignal<boolean>;
+    constructor();
+    /** Recompute derived `isMobile` signal from the two raw conditions. */
+    private _update;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IsMobileService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<IsMobileService>;
+}
+
 /**
  * `LoadContentService` — Angular port of the React `useLoadContent` hook and
  * the Vue `useLoadContent` composable.
@@ -922,6 +978,7 @@ declare class PowerPointViewerComponent {
     protected readonly collab: CollaborationService;
     protected readonly accessibility: AccessibilityService;
     protected readonly print: PrintService;
+    protected readonly mobile: IsMobileService;
     /** The `<main>` host; used to locate the live `.pptx-ng-canvas-stage`. */
     private readonly mainEl;
     /** True while a PNG/PDF export is in progress (disables the buttons). */
@@ -944,6 +1001,8 @@ declare class PowerPointViewerComponent {
     protected readonly presenterStartTime: _angular_core.WritableSignal<number | null>;
     /** Slide-sorter grid overlay visibility. */
     protected readonly showSorter: _angular_core.WritableSignal<boolean>;
+    /** Open mobile bottom-sheet (slides / menu), or null. */
+    protected readonly mobileSheet: _angular_core.WritableSignal<"slides" | "menu" | null>;
     /** Speaker-notes strip visibility. */
     protected readonly showNotes: _angular_core.WritableSignal<boolean>;
     /** Find-in-slides bar visibility. */
@@ -2448,6 +2507,137 @@ declare class ZoomRendererComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZoomRendererComponent, "pptx-zoom-renderer", never, { "element": { "alias": "element"; "required": true; "isSignal": true; }; "zIndex": { "alias": "zIndex"; "required": false; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * animation-playback-helpers.ts
+ *
+ * Pure functions backing {@link AnimationPlaybackService} and
+ * {@link AnimationPanelComponent}. Exported separately so they can be
+ * unit-tested without TestBed (vitest + happy-dom).
+ *
+ * A slide carries an ordered list of {@link PptxElementAnimation}s. PowerPoint
+ * groups them into "click groups": an animation triggered `onClick` /
+ * `onShapeClick` / `onHover` starts a new group, while `withPrevious` /
+ * `afterPrevious` / `afterDelay` animations fold into the group that precedes
+ * them (running together or sequentially within that group). Advancing the
+ * presentation one step reveals one more click group.
+ *
+ * Everything here is framework-light: only the preset → CSS mapping is
+ * delegated to {@link resolveAnimationCss} / {@link initialHiddenStyle} from
+ * the shared render layer.
+ */
+
+/** Minimal CSS-properties shape: kebab-case property → value. */
+type CSSProperties = Record<string, string>;
+/** A single click-triggered group of animations that play as one step. */
+interface AnimationClickGroup {
+    /** Animations belonging to this group, in document order. */
+    animations: PptxElementAnimation[];
+}
+/**
+ * Splits an ordered animation list into click groups. The first animation
+ * always begins a group even if it isn't explicitly `onClick` (PowerPoint shows
+ * the first build on the first advance). Subsequent `withPrevious` /
+ * `afterPrevious` animations attach to the group in progress.
+ */
+declare function buildClickGroups(animations: readonly PptxElementAnimation[]): AnimationClickGroup[];
+/** Clamp a step into `[0, count]`. */
+declare function clampStep(value: number, count: number): number;
+/**
+ * Reveal the next click group. Returns the next step, clamped to `count`.
+ * Equivalent to `clampStep(step + 1, count)`.
+ */
+declare function advanceStep(step: number, count: number): number;
+/** Parse the numeric ms duration out of a resolved style's `animation-duration`. */
+declare function durationOf(style: CSSProperties): number;
+/**
+ * Resolve the CSS for every animation in the revealed groups (the first `step`
+ * groups). Within a group, `afterPrevious` animations are pushed back by the
+ * accumulated duration of the preceding animations so sequential chains play in
+ * order; `withPrevious` shares the running delay. The last write for an element
+ * id wins (a later emphasis/exit overrides an earlier entrance), matching how a
+ * single CSS `animation` shorthand can only hold one running effect.
+ */
+declare function revealedElementStyles(groups: readonly AnimationClickGroup[], step: number): Map<string, CSSProperties>;
+/**
+ * Elements with a pending entrance (in a not-yet-revealed group, i.e. groups at
+ * or beyond `step`) that should be hidden until their group plays. An element
+ * an already-revealed group made visible is never re-hidden.
+ */
+declare function pendingElementStyles(groups: readonly AnimationClickGroup[], step: number): Map<string, CSSProperties>;
+
+declare class AnimationPlaybackService {
+    private readonly destroyRef;
+    /** The current slide's animations, in document/timeline order. */
+    private readonly animations;
+    /**
+     * Externally-controlled playback step (e.g. derived from a parent click
+     * counter). `undefined` means there is no external driver. The internal
+     * manual step (set via advance/play/reset) takes precedence when present.
+     */
+    private readonly externalIndex;
+    /**
+     * Internal, unclamped step. `null` means "follow the external index"; any
+     * number means the host has taken manual control via advance/play/reset.
+     */
+    private readonly manualStep;
+    /** Click groups for the current slide's animations. */
+    readonly groups: _angular_core.Signal<AnimationClickGroup[]>;
+    /** Number of click groups on this slide (i.e. how many `advance()` steps). */
+    readonly groupCount: _angular_core.Signal<number>;
+    /**
+     * The current playback step: how many click groups have been revealed.
+     * Always clamped to the current group count. The manual override wins;
+     * otherwise it follows the external index, defaulting to 0.
+     */
+    readonly step: _angular_core.Signal<number>;
+    /** True when every click group has been revealed. */
+    readonly isComplete: _angular_core.Signal<boolean>;
+    /**
+     * Reactive map of `elementId → CSS properties` to apply for the current step.
+     * Only elements in revealed click groups appear.
+     */
+    readonly elementStyles: _angular_core.Signal<Map<string, CSSProperties>>;
+    /**
+     * Reactive map of `elementId → CSS properties` for elements whose entrance
+     * has not yet been revealed (they should be hidden so they don't flash
+     * visible before their group plays).
+     */
+    readonly pendingStyles: _angular_core.Signal<Map<string, CSSProperties>>;
+    /** Handle of the scheduled rAF auto-advance, or null when idle. */
+    private rafHandle;
+    constructor();
+    /** Feed the current slide's animation list. Resets manual control. */
+    setAnimations(animations: readonly PptxElementAnimation[] | undefined): void;
+    /** Update the external playback index (parent-driven build counter). */
+    setExternalIndex(index: number | undefined): void;
+    /**
+     * Reveal the next click group. Returns `true` if a group was revealed,
+     * `false` if playback was already complete (so the caller can fall through
+     * to slide navigation).
+     */
+    advance(): boolean;
+    /** Reveal every click group at once (jump to the slide's final state). */
+    play(): void;
+    /** Reset playback to before the first click group. */
+    reset(): void;
+    /**
+     * Jump directly to a given step (clamped to the group count) and take manual
+     * control. Useful for scrubbing.
+     */
+    setStep(step: number): void;
+    /**
+     * Auto-advance through every remaining click group on the animation frame,
+     * one group per frame. Stops automatically once playback completes or the
+     * service is destroyed. A no-op when already complete or when
+     * `requestAnimationFrame` is unavailable (SSR).
+     */
+    autoPlay(): void;
+    /** Cancel any in-flight rAF auto-advance. */
+    cancelAutoPlay(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AnimationPlaybackService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AnimationPlaybackService>;
+}
+
 /**
  * PresentationOverlayComponent — full-viewport black overlay that renders
  * slides in presentation (kiosk) mode.
@@ -2495,6 +2685,17 @@ declare class PresentationOverlayComponent implements OnInit, OnDestroy {
         outgoing: PptxSlide;
         transition: PptxSlideTransition;
     } | null>;
+    /** Click-stepped element-animation playback for the current slide. */
+    protected readonly playback: AnimationPlaybackService;
+    /** The slide stage root — animation styles are applied to its elements. */
+    private readonly stageRef;
+    constructor();
+    /**
+     * Imperatively apply animation reveal / pending CSS to the slide's element
+     * nodes (mirrors the Vue `applyAnimationStyles`). Every renderer emits a
+     * `data-element-id`, so this needs no per-element renderer plumbing.
+     */
+    private applyAnimationStyles;
     /** Viewport dimensions — updated on resize. */
     private readonly viewportW;
     private readonly viewportH;
@@ -2741,6 +2942,10 @@ declare class InspectorPanelComponent {
     protected onPatch(patch: Partial<PptxElement>): void;
     /** Commit a fully-replaced element (table/chart data editors) as one history entry. */
     protected onElementReplace(updated: PptxElement): void;
+    /** The active slide's element-animation list (animations live on the slide). */
+    protected readonly slideAnimations: _angular_core.Signal<readonly PptxElementAnimation[]>;
+    /** Commit an updated slide-level animation list as one history entry. */
+    protected onAnimationsChange(animations: PptxElementAnimation[]): void;
     protected onPositionChange(event: Event, axis: 'x' | 'y'): void;
     protected onSizeChange(event: Event, dim: 'width' | 'height'): void;
     protected onRotationChange(event: Event): void;
@@ -3031,6 +3236,271 @@ declare class ChartDataEditorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartDataEditorComponent, "pptx-chart-data-editor", never, { "element": { "alias": "element"; "required": true; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; }, { "elementChange": "elementChange"; }, never, never, true, never>;
 }
 
+declare class AnimationAuthorPanelComponent {
+    /** The selected element whose animation settings are being authored. */
+    readonly element: _angular_core.InputSignal<PptxElement>;
+    /** Zero-based index of the active slide (used by the orchestrator to commit). */
+    readonly slideIndex: _angular_core.InputSignal<number>;
+    /**
+     * The active slide's full `PptxElementAnimation[]` array. Animations are
+     * stored on the slide, NOT on the element — this component reads and
+     * emits the entire array.
+     */
+    readonly animations: _angular_core.InputSignal<readonly PptxElementAnimation[]>;
+    /**
+     * Whether editing controls are enabled. When `false` all selects/inputs are
+     * disabled. Defaults to `true`.
+     */
+    readonly canEdit: _angular_core.InputSignal<boolean>;
+    /**
+     * Emits the full updated `PptxElementAnimation[]` whenever a change is made.
+     * The orchestrator should apply this via:
+     *   `EditorStateService.updateSlide(slideIndex(), { animations: $event })`
+     */
+    readonly animationsChange: _angular_core.OutputEmitterRef<PptxElementAnimation[]>;
+    protected readonly entrancePresets: readonly {
+        value: PptxAnimationPreset;
+        label: string;
+    }[];
+    protected readonly exitPresets: readonly {
+        value: PptxAnimationPreset;
+        label: string;
+    }[];
+    protected readonly emphasisPresets: readonly {
+        value: PptxAnimationPreset;
+        label: string;
+    }[];
+    protected readonly triggerOptions: readonly {
+        value: PptxAnimationTrigger;
+        label: string;
+    }[];
+    protected readonly timingCurveOptions: readonly {
+        value: PptxAnimationTimingCurve;
+        label: string;
+    }[];
+    protected readonly repeatModeOptions: readonly {
+        value: "none" | PptxAnimationRepeatMode;
+        label: string;
+    }[];
+    protected readonly directionOptions: readonly {
+        value: PptxAnimationDirection;
+        label: string;
+        arrow: string;
+    }[];
+    protected readonly sequenceOptions: readonly {
+        value: PptxAnimationSequence;
+        label: string;
+    }[];
+    /**
+     * Changes only when a *different* element is selected. Used as the
+     * `data-el-key` attribute to key number inputs so Angular's [value]
+     * binding is never rewritten mid-edit.
+     */
+    protected readonly elementKey: _angular_core.Signal<string>;
+    /** The animation entry for the currently selected element, if any. */
+    protected readonly current: _angular_core.Signal<PptxElementAnimation | undefined>;
+    /** True when the element has at least one effect (entrance/exit/emphasis). */
+    protected readonly currentHasAnimation: _angular_core.Signal<boolean>;
+    /** True when the active preset exposes a direction picker. */
+    protected readonly currentShowDirection: _angular_core.Signal<boolean>;
+    /**
+     * Stable seed for number inputs — recomputed only on element change so
+     * live typing does not reset the input value while the user is mid-edit.
+     */
+    protected readonly seed: _angular_core.Signal<{
+        durationMs: number;
+        delayMs: number;
+        repeatCount: number;
+    }>;
+    /** Human-readable order label (1-based, e.g. "2 of 4"). */
+    protected readonly orderLabel: _angular_core.Signal<string>;
+    /**
+     * Elements on the slide excluding the selected element — used to populate
+     * the trigger-shape selector. The slide's elements are not available in this
+     * component's inputs, so the orchestrator must pass them in via
+     * `[animations]` indirectly; here we surface only what we have access to.
+     *
+     * NOTE: The trigger-shape dropdown is limited to element ids because this
+     * panel does not receive the full slide element list. The orchestrator can
+     * replace this with a richer element label by wrapping the component or
+     * projecting content. This matches the React implementation which used
+     * `activeSlide.elements`.
+     */
+    protected readonly otherElements: _angular_core.Signal<{
+        id: string;
+    }[]>;
+    private emit;
+    protected onEntranceChange(event: Event): void;
+    protected onExitChange(event: Event): void;
+    protected onEmphasisChange(event: Event): void;
+    protected onTriggerChange(event: Event): void;
+    protected onTriggerShapeChange(event: Event): void;
+    protected onDurationChange(event: Event): void;
+    protected onDelayChange(event: Event): void;
+    protected onTimingCurveChange(event: Event): void;
+    protected onRepeatCountChange(event: Event): void;
+    protected onRepeatModeChange(event: Event): void;
+    protected onDirectionChange(dir: PptxAnimationDirection): void;
+    protected onSequenceChange(event: Event): void;
+    protected onMoveUp(): void;
+    protected onMoveDown(): void;
+    protected onRemove(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AnimationAuthorPanelComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AnimationAuthorPanelComponent, "pptx-animation-author-panel", never, { "element": { "alias": "element"; "required": true; "isSignal": true; }; "slideIndex": { "alias": "slideIndex"; "required": true; "isSignal": true; }; "animations": { "alias": "animations"; "required": true; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; }, { "animationsChange": "animationsChange"; }, never, never, true, never>;
+}
+
+/** Internal action descriptor used to build the bar. */
+interface BarAction {
+    key: string;
+    label: string;
+    /** SVG path data for the icon (24 × 24 view-box). */
+    svgPath: string;
+    disabled: boolean;
+    active?: boolean;
+    badge?: number;
+    emit: () => void;
+}
+declare class MobileBottomBarComponent {
+    /** Zero-based index of the currently displayed slide. */
+    readonly activeIndex: _angular_core.InputSignal<number>;
+    /** Total number of slides in the presentation. */
+    readonly slideCount: _angular_core.InputSignal<number>;
+    /** Whether the "Present" action should be available. */
+    readonly canPresent: _angular_core.InputSignal<boolean>;
+    /** Whether the mobile-menu sheet is currently open (highlights the button). */
+    readonly menuOpen: _angular_core.InputSignal<boolean>;
+    /** Whether the slides thumbnail sheet is currently open. */
+    readonly slidesOpen: _angular_core.InputSignal<boolean>;
+    /** User tapped the previous-slide button. */
+    readonly prev: _angular_core.OutputEmitterRef<void>;
+    /** User tapped the next-slide button. */
+    readonly next: _angular_core.OutputEmitterRef<void>;
+    /** User tapped the Present button. */
+    readonly present: _angular_core.OutputEmitterRef<void>;
+    /** User tapped the Slide Sorter button. */
+    readonly openSorter: _angular_core.OutputEmitterRef<void>;
+    /** User tapped the Find button. */
+    readonly openFind: _angular_core.OutputEmitterRef<void>;
+    /** User tapped the Slides thumbnail strip button. */
+    readonly openSlides: _angular_core.OutputEmitterRef<void>;
+    /** User tapped the menu (⋯) button. */
+    readonly toggleMenu: _angular_core.OutputEmitterRef<void>;
+    readonly actions: _angular_core.Signal<BarAction[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MobileBottomBarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MobileBottomBarComponent, "pptx-mobile-bottom-bar", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "slideCount": { "alias": "slideCount"; "required": false; "isSignal": true; }; "canPresent": { "alias": "canPresent"; "required": false; "isSignal": true; }; "menuOpen": { "alias": "menuOpen"; "required": false; "isSignal": true; }; "slidesOpen": { "alias": "slidesOpen"; "required": false; "isSignal": true; }; }, { "prev": "prev"; "next": "next"; "present": "present"; "openSorter": "openSorter"; "openFind": "openFind"; "openSlides": "openSlides"; "toggleMenu": "toggleMenu"; }, never, never, true, never>;
+}
+
+/** Descriptor for a single menu row. */
+interface MenuRow {
+    key: string;
+    label: string;
+    sublabel?: string;
+    /** SVG path data (24 × 24 view-box). */
+    svgPath: string;
+    disabled?: boolean;
+    active?: boolean;
+    danger?: boolean;
+    emit: () => void;
+}
+declare class MobileMenuSheetComponent {
+    /** Whether the sheet is visible. */
+    readonly open: _angular_core.InputSignal<boolean>;
+    /** Total slide count — gates export/present actions. */
+    readonly slideCount: _angular_core.InputSignal<number>;
+    /** True while an export is running (labels update, actions are disabled). */
+    readonly exporting: _angular_core.InputSignal<boolean>;
+    /** Whether the speaker-notes panel is currently open. */
+    readonly showNotes: _angular_core.InputSignal<boolean>;
+    /** Whether editor-only actions (find-replace etc.) are available. */
+    readonly canEdit: _angular_core.InputSignal<boolean>;
+    /** Sheet dismissed (backdrop tap, swipe, or Escape). */
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** Open the find-in-slides bar. */
+    readonly openFind: _angular_core.OutputEmitterRef<void>;
+    /** Open the slide-sorter overlay. */
+    readonly openSorter: _angular_core.OutputEmitterRef<void>;
+    /** Toggle the speaker-notes panel. */
+    readonly toggleNotes: _angular_core.OutputEmitterRef<void>;
+    /** Start the fullscreen presentation mode. */
+    readonly present: _angular_core.OutputEmitterRef<void>;
+    /** Export the current slide as PNG. */
+    readonly exportPng: _angular_core.OutputEmitterRef<void>;
+    /** Export the deck as PDF. */
+    readonly exportPdf: _angular_core.OutputEmitterRef<void>;
+    /** Export the deck as an animated GIF. */
+    readonly exportGif: _angular_core.OutputEmitterRef<void>;
+    /** Export the deck as a video. */
+    readonly exportVideo: _angular_core.OutputEmitterRef<void>;
+    /** Open the print dialog. */
+    readonly print: _angular_core.OutputEmitterRef<void>;
+    readonly rows: _angular_core.Signal<MenuRow[]>;
+    /**
+     * Emit the row's action and close the sheet so the user returns to the
+     * presentation immediately.
+     */
+    onRowClick(row: MenuRow): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MobileMenuSheetComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MobileMenuSheetComponent, "pptx-mobile-menu-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "slideCount": { "alias": "slideCount"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "showNotes": { "alias": "showNotes"; "required": false; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; }, { "closed": "closed"; "openFind": "openFind"; "openSorter": "openSorter"; "toggleNotes": "toggleNotes"; "present": "present"; "exportPng": "exportPng"; "exportPdf": "exportPdf"; "exportGif": "exportGif"; "exportVideo": "exportVideo"; "print": "print"; }, never, never, true, never>;
+}
+
+declare class MobileSlidesSheetComponent {
+    /** Whether the sheet is visible. */
+    readonly open: _angular_core.InputSignal<boolean>;
+    /** The full slide array to display as thumbnails. */
+    readonly slides: _angular_core.InputSignal<readonly PptxSlide[]>;
+    /** Natural (100 %) canvas dimensions forwarded to each SlideCanvasComponent. */
+    readonly canvasSize: _angular_core.InputSignal<CanvasSize>;
+    /** Media asset lookup table forwarded to each SlideCanvasComponent. */
+    readonly mediaDataUrls: _angular_core.InputSignal<Map<string, string>>;
+    /** Zero-based index of the currently active slide (highlighted). */
+    readonly activeIndex: _angular_core.InputSignal<number>;
+    /** Emits when the user dismisses the sheet without selecting a slide. */
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits the zero-based index of the slide the user tapped. The orchestrator
+     * should call `goTo(index)` and then close this sheet.
+     */
+    readonly jumpToSlide: _angular_core.OutputEmitterRef<number>;
+    /** Zoom level that fits THUMB_W pixels wide. */
+    readonly thumbZoom: _angular_core.Signal<number>;
+    /** Pixel height for the clip box (aspect-correct). */
+    readonly thumbH: _angular_core.Signal<number>;
+    /** ngStyle for the clipping wrapper. */
+    readonly clipStyle: _angular_core.Signal<Record<string, string>>;
+    onThumbClick(index: number): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MobileSlidesSheetComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MobileSlidesSheetComponent, "pptx-mobile-slides-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "slides": { "alias": "slides"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; }, { "closed": "closed"; "jumpToSlide": "jumpToSlide"; }, never, never, true, never>;
+}
+
+declare class MobileSheetComponent {
+    /** Controls whether the sheet is visible. */
+    readonly open: _angular_core.InputSignal<boolean>;
+    /** Optional header text displayed above the body. */
+    readonly title: _angular_core.InputSignal<string>;
+    /**
+     * Height of the sheet as a fraction of the viewport height (0–1).
+     * Ignored when `fullScreen` is true.
+     */
+    readonly heightFraction: _angular_core.InputSignal<number>;
+    /** When true, the sheet occupies the full viewport height. */
+    readonly fullScreen: _angular_core.InputSignal<boolean>;
+    /** Emits when the user closes the sheet (backdrop tap, swipe, or Escape). */
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    private _dragStartY;
+    private _dragPointerId;
+    /** Current translateY applied during an active drag (px). */
+    readonly dragY: _angular_core.WritableSignal<number>;
+    /** Whether a drag is in progress (suppresses CSS transition during drag). */
+    readonly isDragging: _angular_core.WritableSignal<boolean>;
+    readonly panelStyle: _angular_core.Signal<Record<string, string>>;
+    onDocumentKeydown(event: KeyboardEvent): void;
+    onPointerDown(event: PointerEvent): void;
+    onPointerMove(event: PointerEvent): void;
+    onPointerUp(event: PointerEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MobileSheetComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MobileSheetComponent, "pptx-mobile-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "heightFraction": { "alias": "heightFraction"; "required": false; "isSignal": true; }; "fullScreen": { "alias": "fullScreen"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*"], true, never>;
+}
+
 /**
  * SlidesPanelComponent — vertical slide-strip for the editor sidebar.
  *
@@ -4228,64 +4698,6 @@ interface EmbeddedFontStyles {
  */
 declare function buildEmbeddedFontStyles(fonts: readonly PptxEmbeddedFont[] | null | undefined, mintObjectUrl: ObjectUrlFactory): EmbeddedFontStyles;
 
-/**
- * animation-playback-helpers.ts
- *
- * Pure functions backing {@link AnimationPlaybackService} and
- * {@link AnimationPanelComponent}. Exported separately so they can be
- * unit-tested without TestBed (vitest + happy-dom).
- *
- * A slide carries an ordered list of {@link PptxElementAnimation}s. PowerPoint
- * groups them into "click groups": an animation triggered `onClick` /
- * `onShapeClick` / `onHover` starts a new group, while `withPrevious` /
- * `afterPrevious` / `afterDelay` animations fold into the group that precedes
- * them (running together or sequentially within that group). Advancing the
- * presentation one step reveals one more click group.
- *
- * Everything here is framework-light: only the preset → CSS mapping is
- * delegated to {@link resolveAnimationCss} / {@link initialHiddenStyle} from
- * the shared render layer.
- */
-
-/** Minimal CSS-properties shape: kebab-case property → value. */
-type CSSProperties = Record<string, string>;
-/** A single click-triggered group of animations that play as one step. */
-interface AnimationClickGroup {
-    /** Animations belonging to this group, in document order. */
-    animations: PptxElementAnimation[];
-}
-/**
- * Splits an ordered animation list into click groups. The first animation
- * always begins a group even if it isn't explicitly `onClick` (PowerPoint shows
- * the first build on the first advance). Subsequent `withPrevious` /
- * `afterPrevious` animations attach to the group in progress.
- */
-declare function buildClickGroups(animations: readonly PptxElementAnimation[]): AnimationClickGroup[];
-/** Clamp a step into `[0, count]`. */
-declare function clampStep(value: number, count: number): number;
-/**
- * Reveal the next click group. Returns the next step, clamped to `count`.
- * Equivalent to `clampStep(step + 1, count)`.
- */
-declare function advanceStep(step: number, count: number): number;
-/** Parse the numeric ms duration out of a resolved style's `animation-duration`. */
-declare function durationOf(style: CSSProperties): number;
-/**
- * Resolve the CSS for every animation in the revealed groups (the first `step`
- * groups). Within a group, `afterPrevious` animations are pushed back by the
- * accumulated duration of the preceding animations so sequential chains play in
- * order; `withPrevious` shares the running delay. The last write for an element
- * id wins (a later emphasis/exit overrides an earlier entrance), matching how a
- * single CSS `animation` shorthand can only hold one running effect.
- */
-declare function revealedElementStyles(groups: readonly AnimationClickGroup[], step: number): Map<string, CSSProperties>;
-/**
- * Elements with a pending entrance (in a not-yet-revealed group, i.e. groups at
- * or beyond `step`) that should be hidden until their group plays. An element
- * an already-revealed group made visible is never re-hidden.
- */
-declare function pendingElementStyles(groups: readonly AnimationClickGroup[], step: number): Map<string, CSSProperties>;
-
 /** A single rendered playback step (one click group). */
 interface AnimationStepView {
     /** 1-based step number for display. */
@@ -4314,79 +4726,6 @@ declare class AnimationPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AnimationPanelComponent, "pptx-animation-panel", never, { "groups": { "alias": "groups"; "required": true; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "isPlaying": { "alias": "isPlaying"; "required": false; "isSignal": true; }; }, { "playRequested": "playRequested"; "pauseRequested": "pauseRequested"; "stepRequested": "stepRequested"; "resetRequested": "resetRequested"; "seek": "seek"; }, never, never, true, never>;
 }
 
-declare class AnimationPlaybackService {
-    private readonly destroyRef;
-    /** The current slide's animations, in document/timeline order. */
-    private readonly animations;
-    /**
-     * Externally-controlled playback step (e.g. derived from a parent click
-     * counter). `undefined` means there is no external driver. The internal
-     * manual step (set via advance/play/reset) takes precedence when present.
-     */
-    private readonly externalIndex;
-    /**
-     * Internal, unclamped step. `null` means "follow the external index"; any
-     * number means the host has taken manual control via advance/play/reset.
-     */
-    private readonly manualStep;
-    /** Click groups for the current slide's animations. */
-    readonly groups: _angular_core.Signal<AnimationClickGroup[]>;
-    /** Number of click groups on this slide (i.e. how many `advance()` steps). */
-    readonly groupCount: _angular_core.Signal<number>;
-    /**
-     * The current playback step: how many click groups have been revealed.
-     * Always clamped to the current group count. The manual override wins;
-     * otherwise it follows the external index, defaulting to 0.
-     */
-    readonly step: _angular_core.Signal<number>;
-    /** True when every click group has been revealed. */
-    readonly isComplete: _angular_core.Signal<boolean>;
-    /**
-     * Reactive map of `elementId → CSS properties` to apply for the current step.
-     * Only elements in revealed click groups appear.
-     */
-    readonly elementStyles: _angular_core.Signal<Map<string, CSSProperties>>;
-    /**
-     * Reactive map of `elementId → CSS properties` for elements whose entrance
-     * has not yet been revealed (they should be hidden so they don't flash
-     * visible before their group plays).
-     */
-    readonly pendingStyles: _angular_core.Signal<Map<string, CSSProperties>>;
-    /** Handle of the scheduled rAF auto-advance, or null when idle. */
-    private rafHandle;
-    constructor();
-    /** Feed the current slide's animation list. Resets manual control. */
-    setAnimations(animations: readonly PptxElementAnimation[] | undefined): void;
-    /** Update the external playback index (parent-driven build counter). */
-    setExternalIndex(index: number | undefined): void;
-    /**
-     * Reveal the next click group. Returns `true` if a group was revealed,
-     * `false` if playback was already complete (so the caller can fall through
-     * to slide navigation).
-     */
-    advance(): boolean;
-    /** Reveal every click group at once (jump to the slide's final state). */
-    play(): void;
-    /** Reset playback to before the first click group. */
-    reset(): void;
-    /**
-     * Jump directly to a given step (clamped to the group count) and take manual
-     * control. Useful for scrubbing.
-     */
-    setStep(step: number): void;
-    /**
-     * Auto-advance through every remaining click group on the animation frame,
-     * one group per frame. Stops automatically once playback completes or the
-     * service is destroyed. A no-op when already complete or when
-     * `requestAnimationFrame` is unavailable (SSR).
-     */
-    autoPlay(): void;
-    /** Cancel any in-flight rAF auto-advance. */
-    cancelAutoPlay(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AnimationPlaybackService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AnimationPlaybackService>;
-}
-
 /** A positioned cursor view-model used by the template. */
 interface PositionedCursor {
     clientId: number | string;
@@ -5178,5 +5517,5 @@ declare function themeStyle(theme: ViewerTheme | undefined): Record<string, stri
 type ClassValue = string | number | false | null | undefined;
 declare function cn(...values: ClassValue[]): string;
 
-export { AccessibilityPanelComponent, AccessibilityService, AnimationPanelComponent, AnimationPlaybackService, BroadcastDialogComponent, CURSOR_PALETTE, ChartDataEditorComponent, ChartRendererComponent, CollaborationCursorsComponent, CollaborationService, CommentsPanelComponent, CommentsService, ConnectorRendererComponent, ConnectorTextOverlayComponent, DEFAULT_BROADCAST_SERVER_URL, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_FILL_COLOR, DEFAULT_PRINT_SETTINGS, DEFAULT_SLIDE_BACKGROUND, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_COLOR, EMBEDDED_FONTS_STYLE_ID, EditorContextMenuComponent, EditorHistory, EditorStateService, EditorToolbarComponent, EffectsPanelComponent, ElementRendererComponent, EmbeddedFontsService, EquationRendererComponent, ExportService, FindBarComponent, FindReplaceBarComponent, GradientPickerComponent, HANDOUT_OPTIONS, HyperlinkDialogComponent, InkRendererComponent, InspectorPanelComponent, LoadContentService, ModalDialogComponent, Model3DRendererComponent, OleRendererComponent, PowerPointViewerComponent, PresentationOverlayComponent, PresentationTransitionOverlayComponent, PresenterViewComponent, PrintDialogComponent, PrintService, PrintSettingsPanelComponent, PropertiesDialogComponent, RESIZE_HANDLES, SEVERITY_GROUPS, SEVERITY_LABELS, SLIDE_TRANSITION_KEYFRAMES, ShareDialogComponent, SignaturesPanelComponent, SignaturesService, SlideCanvasComponent, SlideSorterOverlayComponent, SlidesPanelComponent, SmartArtRendererComponent, TYPE_LABELS, TableDataEditorComponent, TableRendererComponent, TextAdvancedPanelComponent, VIEWER_THEME, WEBM_MIME_CANDIDATES, ZoomRendererComponent, addCommentToList, advanceStep, applyFindReplacements, applyMove, applyResize, assignUserColor, bringForward, bringToFront, buildBroadcastConfig, buildBroadcastViewerUrl, buildClearHyperlinkPatch, buildClickGroups, buildCollaborationConfig, buildCssGradientFromShapeStyle, buildDuotoneFilter, buildDuotoneFilterId, buildEmbeddedFontStyles, buildFontFaceRule, buildHyperlinkPatch, buildPatternFillCss, buildPrintDocument, buildPropertiesPatch, buildShareUrl, bulletIndentPx, canStartBroadcast, canStartShare, canUseClipboard, clampCursorPosition, clampGifDimensions, clampNotesFontSize, clampStep, cn, collectAccessibilityIssues, collectElementText, collectSlideText, computeHandoutLayout, computePageCount, computeSlideIndices, computeTimerProgress, convertOmmlToMathMl, countAccessibilityIssues, defaultCssVars, defaultRadius, defaultThemeColors, deleteElementsByIds, derivePresenceList, duplicateElementById, durationOf, encodeGif, estimatePageCount, findInSlides, fontMimeForFormat, formatAutoNumber, formatCursorLabel, formatElapsed, formatPropertyDate, formatTime, fpsToFrameIntervalMs, generateBroadcastRoomId, generateCommentId, getContainerStyle, getDuotoneFilterDef, getImageSrc, getPatternSvg, getResolvedShapeClipPath, getResolvedShapeClipPathFor, getShapeFillStrokeStyle, getSlideBackgroundStyle, getSlideTransitionAnimations, getTextBlockStyle, groupIssuesBySeverity, hasExistingLink, headerLabel, isInjectableUrl, isPpactionUrl, isSigned, isUrlSafe, isValidRoomId, issueTrackKey, issueTypeLabel, moveElementBy, msToFrameDelayCs, normalizeFontFormat, normalizeSlidesPerPage, ommlToMathml, overallStatus, pendingElementStyles, pickSupportedMimeType, planGifFrames, planVideoSegments, presenceToCursors, provideViewerTheme, recordWebm, removeCommentFromList, renderToCanvas, replaceInSlides, replaceMatch, resizeElement, resolveFontVariant, resolveHyperlinkHref, resolveParagraphBullet, resolvePresenterNotes, resolveTransitionDuration, revealedElementStyles, routeOrthogonalConnector, sanitizeColor, sanitizeSlideIndex, sanitizeUserName, searchSlides, seedBroadcastFields, seedHyperlinkDraft, seedPropertiesDraft, seedShareFields, segmentFrameCount, sendBackward, sendToBack, setElementPosition, signatureCountLabel, signatureKey, signatureTimestamp, signerName, statusKind, statusLabel, themeStyle, themeToCssVars, toggleCommentResolvedInList, updateElementById, validatePrintSettings, validateRoomId, waypointsToPathD, worstStatus };
+export { AccessibilityPanelComponent, AccessibilityService, AnimationAuthorPanelComponent, AnimationPanelComponent, AnimationPlaybackService, BroadcastDialogComponent, CURSOR_PALETTE, ChartDataEditorComponent, ChartRendererComponent, CollaborationCursorsComponent, CollaborationService, CommentsPanelComponent, CommentsService, ConnectorRendererComponent, ConnectorTextOverlayComponent, DEFAULT_BROADCAST_SERVER_URL, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_FILL_COLOR, DEFAULT_PRINT_SETTINGS, DEFAULT_SLIDE_BACKGROUND, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_COLOR, EMBEDDED_FONTS_STYLE_ID, EditorContextMenuComponent, EditorHistory, EditorStateService, EditorToolbarComponent, EffectsPanelComponent, ElementRendererComponent, EmbeddedFontsService, EquationRendererComponent, ExportService, FindBarComponent, FindReplaceBarComponent, GradientPickerComponent, HANDOUT_OPTIONS, HyperlinkDialogComponent, InkRendererComponent, InspectorPanelComponent, IsMobileService, LoadContentService, MobileBottomBarComponent, MobileMenuSheetComponent, MobileSheetComponent, MobileSlidesSheetComponent, ModalDialogComponent, Model3DRendererComponent, OleRendererComponent, PowerPointViewerComponent, PresentationOverlayComponent, PresentationTransitionOverlayComponent, PresenterViewComponent, PrintDialogComponent, PrintService, PrintSettingsPanelComponent, PropertiesDialogComponent, RESIZE_HANDLES, SEVERITY_GROUPS, SEVERITY_LABELS, SLIDE_TRANSITION_KEYFRAMES, ShareDialogComponent, SignaturesPanelComponent, SignaturesService, SlideCanvasComponent, SlideSorterOverlayComponent, SlidesPanelComponent, SmartArtRendererComponent, TYPE_LABELS, TableDataEditorComponent, TableRendererComponent, TextAdvancedPanelComponent, VIEWER_THEME, WEBM_MIME_CANDIDATES, ZoomRendererComponent, addCommentToList, advanceStep, applyFindReplacements, applyMove, applyResize, assignUserColor, bringForward, bringToFront, buildBroadcastConfig, buildBroadcastViewerUrl, buildClearHyperlinkPatch, buildClickGroups, buildCollaborationConfig, buildCssGradientFromShapeStyle, buildDuotoneFilter, buildDuotoneFilterId, buildEmbeddedFontStyles, buildFontFaceRule, buildHyperlinkPatch, buildPatternFillCss, buildPrintDocument, buildPropertiesPatch, buildShareUrl, bulletIndentPx, canStartBroadcast, canStartShare, canUseClipboard, clampCursorPosition, clampGifDimensions, clampNotesFontSize, clampStep, cn, collectAccessibilityIssues, collectElementText, collectSlideText, computeHandoutLayout, computeIsMobile, computeIsTablet, computePageCount, computeSlideIndices, computeTimerProgress, convertOmmlToMathMl, countAccessibilityIssues, defaultCssVars, defaultRadius, defaultThemeColors, deleteElementsByIds, derivePresenceList, duplicateElementById, durationOf, encodeGif, estimatePageCount, findInSlides, fontMimeForFormat, formatAutoNumber, formatCursorLabel, formatElapsed, formatPropertyDate, formatTime, fpsToFrameIntervalMs, generateBroadcastRoomId, generateCommentId, getContainerStyle, getDuotoneFilterDef, getImageSrc, getPatternSvg, getResolvedShapeClipPath, getResolvedShapeClipPathFor, getShapeFillStrokeStyle, getSlideBackgroundStyle, getSlideTransitionAnimations, getTextBlockStyle, groupIssuesBySeverity, hasExistingLink, headerLabel, isInjectableUrl, isPpactionUrl, isSigned, isUrlSafe, isValidRoomId, issueTrackKey, issueTypeLabel, moveElementBy, msToFrameDelayCs, normalizeFontFormat, normalizeSlidesPerPage, ommlToMathml, overallStatus, pendingElementStyles, pickSupportedMimeType, planGifFrames, planVideoSegments, presenceToCursors, provideViewerTheme, recordWebm, removeCommentFromList, renderToCanvas, replaceInSlides, replaceMatch, resizeElement, resolveFontVariant, resolveHyperlinkHref, resolveParagraphBullet, resolvePresenterNotes, resolveTransitionDuration, revealedElementStyles, routeOrthogonalConnector, sanitizeColor, sanitizeSlideIndex, sanitizeUserName, searchSlides, seedBroadcastFields, seedHyperlinkDraft, seedPropertiesDraft, seedShareFields, segmentFrameCount, sendBackward, sendToBack, setElementPosition, signatureCountLabel, signatureKey, signatureTimestamp, signerName, statusKind, statusLabel, themeStyle, themeToCssVars, toggleCommentResolvedInList, updateElementById, validatePrintSettings, validateRoomId, waypointsToPathD, worstStatus };
 export type { AccessibilityIssueGroup, AnimationClickGroup, Box, BroadcastConfig, BroadcastDefaults, CSSProperties, CanvasSize, ClassValue, CollaborationConfig, CollaborationRole, Rect as ConnectorObstacle, Point as ConnectorPoint, ConnectorRouting, DocumentProperties, DuotoneFilterDef, EmbeddedFontStyles, FindOptions, FindResult, GifFrame, GifFramePlan, GifPlanOptions, HandoutSlidesPerPage, HyperlinkDraft, NotesSegmentViewModel, ObjectUrlFactory, OverallSignatureStatus, PresenterNotes, PrintColorMode, PrintDocumentOptions, PrintOrientation, PrintSettings, PrintSlideRange, PrintWhat, PropertiesDraft, RecordWebmOptions, RemoteCursor, RemotePresence, ReplaceResult, ResizeHandle, ResolvedFontVariant, ShareDefaults, ShareFormFields, SignatureStatusKind, SlideTransitionAnimations, StyleMap, TimerProgress, VideoPlanOptions, VideoSegmentPlan, ViewerTheme, ViewerThemeColors };