pptx-angular-viewer 1.1.19 → 1.1.20

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-angular-viewer",
-	"version": "1.1.19",
+	"version": "1.1.20",
 	"description": "Angular PowerPoint viewer/editor component — depends on pptx-viewer-core. Angular counterpart of the React `pptx-viewer` and Vue `pptx-vue-viewer` packages.",
 	"keywords": [
 		"angular",
@@ -43,7 +43,7 @@
 	"peerDependencies": {
 		"@angular/common": "^22.0.1",
 		"@angular/core": "^22.0.1",
-		"pptx-viewer-core": "^1.1.19",
+		"pptx-viewer-core": "^1.1.20",
 		"rxjs": "^7.8.0"
 	},
 	"module": "fesm2022/pptx-angular-viewer.mjs",

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 { Signal, OnInit, OnDestroy, OnChanges, SimpleChanges, 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, PptxElementAnimation, PptxSlideTransition, TablePptxElement, ChartPptxElement, PptxAnimationPreset, PptxAnimationTrigger, PptxAnimationTimingCurve, PptxAnimationRepeatMode, PptxAnimationDirection, PptxAnimationSequence, XmlObject, SignatureStatus, AccessibilityIssueSeverity, AccessibilityIssueType, PptxTransitionType, ShapeStyle } from 'pptx-viewer-core';
+import { PptxSlide, AccessibilityCheckOptions, AccessibilityIssue, PptxElement, PptxTheme, PptxSlideMaster, PptxEmbeddedFont, PptxCoreProperties, ParsedSignature, PptxComment, PptxTextWarpPreset, 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';
@@ -1673,6 +1673,113 @@ declare function routeOrthogonalConnector(start: Point, end: Point, obstacles: R
  */
 declare function waypointsToPathD(waypoints: ReadonlyArray<Point>): string;
 
+/**
+ * Text-warp (WordArt) descriptor resolver for the Angular viewer.
+ *
+ * Angular port of:
+ *   packages/react/src/viewer/utils/text-warp-classifier.ts
+ *   packages/react/src/viewer/utils/text-warp-css.tsx
+ *   packages/react/src/viewer/utils/warp-text-renderer.tsx  (descriptor shape)
+ *
+ * `getTextWarp(element)` resolves an element's OOXML `prstTxWarp` preset into a
+ * `TextWarpDef` that the Angular template can consume without any React/HTML
+ * string injection.  The descriptor selects one of two rendering strategies:
+ *
+ *   - `'path'`    — SVG `<textPath>` along a curved/arc/circle path.
+ *                   The `pathLines` array contains one entry per paragraph with a
+ *                   pre-computed SVG `d` attribute.  The template renders an inline
+ *                   `<svg>` with `<defs><path>` + `<text><textPath href>`.
+ *
+ *   - `'css'`     — A whole-block CSS transform approximation.  The template
+ *                   applies `cssTransform` and `cssTransformOrigin` to the
+ *                   existing `div.pptx-ng-text` wrapper (or a parent div) via
+ *                   `[ngStyle]`.  No SVG required.
+ *
+ * Presets classified as `'none'` (textNoShape, textPlain, unknown) return
+ * `undefined` so callers can skip extra rendering without an allowlist check.
+ */
+
+/** The four rendering strategy families. */
+type WarpCategory = 'path' | 'envelope' | 'simple' | 'none';
+/**
+ * Classify a warp preset into a rendering strategy category.
+ *
+ * Returns `'none'` for unknown or empty presets so callers can safely
+ * skip rendering without an explicit allowlist check.
+ */
+declare function getWarpCategory(preset: string | undefined): WarpCategory;
+/**
+ * A single pre-computed SVG path line for one text paragraph.
+ *
+ * The template renders this as:
+ *   `<path [id]="pathId" [attr.d]="d" fill="none" />`
+ * inside `<defs>`, then references it with `<textPath [attr.href]="'#'+pathId">`.
+ */
+interface WarpPathLine {
+    /** Unique DOM id for this `<path>` element (safe to use as `href` fragment). */
+    pathId: string;
+    /** SVG path data (`d` attribute). */
+    d: string;
+    /** The text segments that flow along this path. */
+    segments: TextSegment[];
+}
+/**
+ * Descriptor for SVG `<textPath>`-based warp rendering.
+ *
+ * One `WarpPathLine` per paragraph.  The template renders an inline `<svg>`
+ * covering the element bounds, defines each path in `<defs>`, then lays
+ * `<text><textPath href="#pathId">` on each path.
+ */
+interface TextWarpPathDef {
+    readonly strategy: 'path';
+    /** OOXML preset name (e.g. `'textArchUp'`). */
+    readonly preset: PptxTextWarpPreset;
+    /** One entry per paragraph. */
+    readonly pathLines: WarpPathLine[];
+    /** Element pixel width (for `<svg width>`). */
+    readonly width: number;
+    /** Element pixel height (for `<svg height>`). */
+    readonly height: number;
+    /** SVG `text-anchor` value derived from paragraph alignment. */
+    readonly textAnchor: 'start' | 'middle' | 'end';
+    /** SVG `<textPath startOffset>` value (e.g. `"0%"`, `"50%"`, `"100%"`). */
+    readonly startOffset: string;
+    /** Base font size in points from the element's text style. */
+    readonly baseFontSize: number;
+    /** Base font family string (already CSS-ready). */
+    readonly baseFontFamily: string;
+    /** Base text fill colour (hex). */
+    readonly baseColor: string;
+}
+/**
+ * Descriptor for CSS-transform-based warp rendering.
+ *
+ * The template applies `cssTransform` + `cssTransformOrigin` on the
+ * `div.pptx-ng-text` wrapper (or a containing div) via `[ngStyle]`.
+ */
+interface TextWarpCssDef {
+    readonly strategy: 'css';
+    /** OOXML preset name (e.g. `'textSlantUp'`). */
+    readonly preset: PptxTextWarpPreset;
+    /** CSS `transform` string (e.g. `"perspective(500px) rotateY(8deg) skewY(-4deg)"`). */
+    readonly cssTransform: string;
+    /** CSS `transform-origin` string (e.g. `"left center"`). */
+    readonly cssTransformOrigin: string;
+}
+/** Union of the two warp rendering strategies. */
+type TextWarpDef = TextWarpPathDef | TextWarpCssDef;
+/**
+ * Resolve a `PptxElement`'s text warp preset into a `TextWarpDef` descriptor,
+ * or `undefined` when the element carries no warp (or the preset is `textNoShape` /
+ * `textPlain` / unknown).
+ *
+ * @param element  Any `PptxElement`.  Elements without text properties always
+ *                 return `undefined`.
+ * @returns  A `TextWarpDef` with `strategy: 'path'` for SVG textPath warps, or
+ *           `strategy: 'css'` for CSS-transform approximations.
+ */
+declare function getTextWarp(element: PptxElement): TextWarpDef | undefined;
+
 interface TextRun {
     text: string;
     style: StyleMap;
@@ -1730,6 +1837,12 @@ declare class ElementRendererComponent {
     readonly shapeContainerStyle: _angular_core.Signal<StyleMap>;
     readonly textStyle: _angular_core.Signal<StyleMap>;
     readonly imageSrc: _angular_core.Signal<string | undefined>;
+    /** Text-warp (WordArt) descriptor for the element, if any. */
+    readonly textWarp: _angular_core.Signal<pptx_angular_viewer.TextWarpDef | undefined>;
+    /** Only the SVG-textPath warp variant (for the `<svg>` overlay branch). */
+    readonly pathWarp: _angular_core.Signal<TextWarpPathDef | undefined>;
+    /** Text block style, folding in a CSS-transform warp when present. */
+    readonly warpedTextStyle: _angular_core.Signal<StyleMap>;
     readonly children: _angular_core.Signal<PptxElement[]>;
     readonly isShapeLike: _angular_core.Signal<boolean>;
     readonly isImageLike: _angular_core.Signal<boolean>;
@@ -2081,6 +2194,8 @@ interface SvgText {
     fontWeight?: 'normal' | 'bold';
     dominantBaseline?: string;
     opacity?: number;
+    /** Optional SVG transform (e.g. `rotate(-90, x, y)` for a vertical axis title). */
+    transform?: string;
 }
 interface SvgPolygon {
     kind: 'polygon';
@@ -2638,6 +2753,174 @@ declare class AnimationPlaybackService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AnimationPlaybackService>;
 }
 
+/**
+ * presentation-annotations-helpers.ts — Pure geometry helpers for presentation
+ * ink annotations (pen, highlighter, eraser, laser).
+ *
+ * Ported from React:
+ *   packages/react/src/viewer/components/PresentationAnnotationOverlay.tsx
+ *   packages/react/src/viewer/hooks/usePresentationAnnotations.ts
+ *
+ * No Angular dependencies — all functions are pure so they can be unit-tested
+ * without TestBed.
+ */
+/** A single {x, y} coordinate in slide-space pixels. */
+interface AnnotationPoint {
+    x: number;
+    y: number;
+}
+/** An ink stroke: a sequence of points with visual properties. */
+interface AnnotationStroke {
+    id: string;
+    points: AnnotationPoint[];
+    color: string;
+    width: number;
+    /** 1 = opaque (pen); 0.4 = semi-transparent (highlighter). */
+    opacity: number;
+}
+/** The tool currently armed in presentation mode. */
+type PresentationTool = 'none' | 'pen' | 'highlighter' | 'eraser' | 'laser';
+/** Per-slide annotation storage: slide index → strokes. */
+type SlideAnnotationMap = Map<number, AnnotationStroke[]>;
+/** Transient laser-pointer position in slide-space pixels. */
+interface LaserPosition {
+    x: number;
+    y: number;
+}
+
+declare class PresentationAnnotationsService {
+    private readonly destroyRef;
+    private readonly _tool;
+    private readonly _penColor;
+    private readonly _highlighterColor;
+    private readonly _currentStroke;
+    private readonly _laserPosition;
+    private readonly _toolbarVisible;
+    /**
+     * Strokes visible on the current slide. Cleared / populated whenever
+     * `setActiveSlide()` is called.
+     */
+    private readonly _annotationStrokes;
+    /**
+     * Per-slide annotation storage. Strokes for the current slide are also kept
+     * in `_annotationStrokes` for rendering convenience; they are synchronised
+     * back into this map on `setActiveSlide()` or `endStroke()`.
+     */
+    private readonly _slideAnnotations;
+    /** Tracks whether a pointer-down initiated an erase gesture. */
+    private _isErasing;
+    /** Toolbar auto-hide timer handle. */
+    private _toolbarTimer;
+    /** Index of the slide currently being annotated. */
+    private _activeSlideIndex;
+    /** The currently-armed presentation tool. */
+    readonly tool: _angular_core.Signal<PresentationTool>;
+    /** Stroke colour used by the pen tool. */
+    readonly penColor: _angular_core.Signal<string>;
+    /** Stroke colour used by the highlighter tool. */
+    readonly highlighterColor: _angular_core.Signal<string>;
+    /** Committed strokes on the active slide (does not include the live stroke). */
+    readonly annotationStrokes: _angular_core.Signal<AnnotationStroke[]>;
+    /** The stroke currently being drawn, or null when not drawing. */
+    readonly currentStroke: _angular_core.Signal<AnnotationStroke | null>;
+    /** Laser pointer position in slide-space pixels, or null when not visible. */
+    readonly laserPosition: _angular_core.Signal<LaserPosition | null>;
+    /** Whether the annotation toolbar should be visible. */
+    readonly toolbarVisible: _angular_core.Signal<boolean>;
+    /**
+     * `true` when any annotations exist on any slide (used for the
+     * "keep / discard" dialog when exiting presentation mode).
+     */
+    readonly hasAnyAnnotations: _angular_core.Signal<boolean>;
+    constructor();
+    /**
+     * Arm `tool`. If it is already armed, toggle back to `'none'` (matches
+     * the React behaviour of `setPresentationTool`).
+     */
+    setTool(tool: PresentationTool): void;
+    /** Set the pen colour directly (without toggling the tool). */
+    setPenColor(color: string): void;
+    /** Set the highlighter colour directly. */
+    setHighlighterColor(color: string): void;
+    /** Show / hide the toolbar programmatically. */
+    setToolbarVisible(visible: boolean): void;
+    /**
+     * Notify the service that the visible slide has changed. Saves the
+     * in-progress strokes for the previous slide and loads the strokes
+     * for `newIndex`.
+     */
+    setActiveSlide(newIndex: number): void;
+    /**
+     * Begin a stroke at `(x, y)` in slide-space coordinates.
+     * Called on pointer-down when the pen or highlighter is armed.
+     */
+    beginStroke(x: number, y: number): void;
+    /**
+     * Extend the active stroke by appending `(x, y)`.
+     * Called on pointer-move while drawing.
+     */
+    extendStroke(x: number, y: number): void;
+    /**
+     * Commit the active stroke to the slide's annotation list.
+     * Called on pointer-up or pointer-leave while drawing.
+     * Strokes with fewer than 2 points are discarded.
+     */
+    endStroke(): void;
+    /**
+     * Begin an eraser gesture at `(x, y)`.
+     * Must be called on pointer-down when the eraser is armed.
+     */
+    beginErase(x: number, y: number): void;
+    /**
+     * Continue erasing at `(x, y)` during a pointer-move.
+     */
+    continueErase(x: number, y: number): void;
+    /**
+     * End an eraser gesture. Called on pointer-up or pointer-leave.
+     */
+    endErase(): void;
+    /**
+     * Update the laser dot position (slide-space coords).
+     * Only takes effect when the laser tool is armed.
+     */
+    moveLaser(x: number, y: number): void;
+    /**
+     * Hide the laser dot (called on pointer-leave).
+     */
+    hideLaser(): void;
+    /**
+     * Clear all annotations on the active slide.
+     */
+    clearAnnotations(): void;
+    /**
+     * Clear all annotations across every slide.
+     */
+    clearAllAnnotations(): void;
+    /**
+     * Return a snapshot of all annotations across every slide.
+     * The current slide's in-progress committed strokes are folded in.
+     *
+     * Used by the "keep as ink elements" dialog handler.
+     */
+    getAllSlideAnnotations(): SlideAnnotationMap;
+    /**
+     * Show the toolbar and schedule it to auto-hide after `delayMs` (default 3 s).
+     * Resets the timer if called repeatedly (debounce on mouse-move).
+     */
+    showToolbarTemporarily(delayMs?: number): void;
+    /**
+     * Reset transient presentation state (tool, current stroke, laser, toolbar
+     * timer). Does NOT clear stored strokes — those persist for the
+     * keep/discard dialog.
+     */
+    resetForExit(): void;
+    private _applyErase;
+    private _flushCurrentSlide;
+    private _clearToolbarTimer;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PresentationAnnotationsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PresentationAnnotationsService>;
+}
+
 /**
  * PresentationOverlayComponent — full-viewport black overlay that renders
  * slides in presentation (kiosk) mode.
@@ -2687,6 +2970,10 @@ declare class PresentationOverlayComponent implements OnInit, OnDestroy {
     } | null>;
     /** Click-stepped element-animation playback for the current slide. */
     protected readonly playback: AnimationPlaybackService;
+    /** Ink-annotation state (pen/highlighter/eraser/laser) for the show. */
+    protected readonly annotations: PresentationAnnotationsService;
+    /** Whether the live-caption bar is shown. */
+    protected readonly subtitlesVisible: _angular_core.WritableSignal<boolean>;
     /** The slide stage root — animation styles are applied to its elements. */
     private readonly stageRef;
     constructor();
@@ -2729,6 +3016,10 @@ declare class PresentationOverlayComponent implements OnInit, OnDestroy {
     onKeyDown(event: KeyboardEvent): void;
     /** Left-click on the slide area advances to the next visible slide. */
     protected onBodyClick(event: MouseEvent): void;
+    /** Toggle an annotation tool (clicking the active one disarms it). */
+    protected selectTool(tool: 'pen' | 'highlighter' | 'eraser' | 'laser'): void;
+    /** Toggle the live-caption (subtitle) bar. */
+    protected toggleSubtitles(): void;
     /** Close button click — stop propagation so it does not also advance. */
     protected onClose(event: MouseEvent): void;
     /**
@@ -5052,6 +5343,136 @@ declare class PrintSettingsPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PrintSettingsPanelComponent, "pptx-print-settings-panel", never, { "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "totalSlides": { "alias": "totalSlides"; "required": true; "isSignal": true; }; "activeSlideIndex": { "alias": "activeSlideIndex"; "required": true; "isSignal": true; }; }, { "settingsChange": "settingsChange"; }, never, never, true, never>;
 }
 
+declare class PresentationAnnotationOverlayComponent {
+    /** Logical canvas dimensions (the slide's authored size in pixels). */
+    readonly canvasSize: _angular_core.InputSignal<CanvasSize>;
+    /**
+     * The zoom factor currently applied to the slide stage.
+     * Pointer-event coordinates are divided by this value to obtain
+     * slide-space coordinates.
+     */
+    readonly zoom: _angular_core.InputSignal<number>;
+    protected readonly service: PresentationAnnotationsService;
+    private readonly svgRef;
+    /** True while a pointer-down is active in eraser mode. */
+    private _isErasing;
+    /** True when any tool other than 'none' is armed. */
+    protected readonly isArmed: _angular_core.Signal<boolean>;
+    /** SVG viewBox string that covers the full canvas. */
+    protected readonly viewBox: _angular_core.Signal<string>;
+    /** CSS cursor for the outer wrapper div. */
+    protected readonly wrapperStyle: _angular_core.Signal<Record<string, string>>;
+    /** Transform the SVG to match the slide's zoom level. */
+    protected readonly svgStyle: _angular_core.Signal<Record<string, string>>;
+    /** All strokes to render: committed + the live in-progress stroke. */
+    protected readonly allStrokes: _angular_core.Signal<pptx_angular_viewer.AnnotationStroke[]>;
+    protected strokePath(points: Array<{
+        x: number;
+        y: number;
+    }>): string;
+    protected laserDotStyle(x: number, y: number): Record<string, string>;
+    protected onPointerDown(event: PointerEvent): void;
+    protected onPointerMove(event: PointerEvent): void;
+    protected onPointerUp(event: PointerEvent): void;
+    protected onPointerLeave(_event: PointerEvent): void;
+    /**
+     * Map a client-space pointer position to slide-space coordinates by
+     * subtracting the SVG element's bounding rect and dividing by the zoom.
+     * Returns `null` when the SVG ref is not yet available.
+     */
+    private _toSlideCoords;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PresentationAnnotationOverlayComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PresentationAnnotationOverlayComponent, "pptx-presentation-annotation-overlay", never, { "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * presentation-subtitle-helpers.ts — Pure helpers for the subtitle/caption bar.
+ *
+ * Isolates all text-segment logic so it can be unit-tested without DOM or
+ * Angular dependencies.
+ *
+ * Ported from React:
+ *   packages/react/src/viewer/components/PresentationSubtitleBar.tsx
+ */
+/**
+ * A single speech recognition alternative (best-guess transcript + confidence).
+ * Matches the shape of the Web Speech API `SpeechRecognitionAlternative`.
+ */
+interface SpeechAlternative {
+    readonly transcript: string;
+    readonly confidence: number;
+}
+/**
+ * One result from the recognition engine — array of alternatives plus a
+ * `isFinal` flag that indicates whether this result is stable (true) or
+ * still being refined (false, i.e. interim).
+ */
+interface SpeechResult {
+    readonly isFinal: boolean;
+    readonly length: number;
+    readonly [index: number]: SpeechAlternative;
+}
+/**
+ * The list of all results accumulated in a recognition session.
+ */
+interface SpeechResultList {
+    readonly length: number;
+    readonly [index: number]: SpeechResult;
+}
+/**
+ * Subset of `SpeechRecognitionEvent` — just what we need.
+ */
+interface SpeechRecognitionEventLite {
+    readonly resultIndex: number;
+    readonly results: SpeechResultList;
+}
+/**
+ * Structural interface matching the Web Speech API `SpeechRecognition` object.
+ * Kept minimal so we only depend on what we actually use.
+ */
+interface SpeechRecognitionLite extends EventTarget {
+    continuous: boolean;
+    interimResults: boolean;
+    lang: string;
+    onresult: ((event: SpeechRecognitionEventLite) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    onend: (() => void) | null;
+    start: () => void;
+    stop: () => void;
+}
+/** Constructor signature for the speech recognition object. */
+type SpeechRecognitionCtor = new () => SpeechRecognitionLite;
+
+declare class PresentationSubtitleBarComponent implements OnChanges {
+    /** Show the subtitle bar and start speech recognition when true. */
+    readonly visible: _angular_core.InputSignal<boolean>;
+    private readonly _captionText;
+    private readonly _supportState;
+    /** The text string rendered in the caption bar. */
+    protected readonly displayText: _angular_core.WritableSignal<string>;
+    /**
+     * Whether the recognition session should remain running.
+     * Toggled on `visible` changes; checked in `onend` to decide whether
+     * to restart.
+     */
+    private _shouldRun;
+    /** Active recognition instance, or null when stopped. */
+    private _recognition;
+    private readonly _destroyRef;
+    constructor();
+    ngOnChanges(changes: SimpleChanges): void;
+    private _startRecognition;
+    private _stopRecognition;
+    /**
+     * Thin wrapper around {@link getSpeechRecognitionCtor} so tests can spy on
+     * or override this method without patching `globalThis`.
+     */
+    protected _getSpeechCtor(): SpeechRecognitionCtor | null;
+    private _updateDisplayText;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PresentationSubtitleBarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PresentationSubtitleBarComponent, "pptx-presentation-subtitle-bar", never, { "visible": { "alias": "visible"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * transition-helpers.ts
  *
@@ -5349,6 +5770,31 @@ declare function getResolvedShapeClipPathFor(shapeType: string | undefined, widt
  */
 declare function getResolvedShapeClipPath(element: PptxElement, width?: number, height?: number): string | undefined;
 
+/**
+ * SVG path generators for WordArt text warp presets.
+ *
+ * Angular port of `packages/react/src/viewer/utils/warp-path-generators.ts`
+ * and `packages/react/src/viewer/utils/warp-path-cascade.ts`.
+ *
+ * Each generator produces an SVG path `d` attribute for a single text line
+ * at a given normalised vertical position (t: 0 = top, 1 = bottom).
+ * All functions are pure and deterministic — no side-effects, no random/date.
+ */
+
+/**
+ * Presets that require SVG `<textPath>` rendering along a curved/circular path.
+ * All other warp presets (envelope: inflate/deflate/can; simple: slant/fade/
+ * cascade) are rendered with CSS transforms instead — see `text-warp.ts`'s
+ * `getWarpCategory`, which this set must stay in sync with (the `'path'`
+ * category). Listing a CSS preset here would wrongly route it to `<textPath>`.
+ */
+declare const SVG_WARP_PRESETS: ReadonlySet<string>;
+/** Returns `true` when the preset should use SVG `<textPath>` rendering. */
+declare function shouldUseSvgWarp(preset: PptxTextWarpPreset | undefined): boolean;
+/** Generate an SVG path `d` attribute for a warp preset at a given line position.
+ *  Optional adj/adj2 are raw OOXML adjustment values (1/60000th units). */
+declare function getWarpPath(preset: PptxTextWarpPreset, width: number, height: number, lineIndex: number, lineCount: number, adj?: number, adj2?: number): string;
+
 /**
  * Slide-background style resolution.
  *
@@ -5517,5 +5963,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, 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 };
+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, PresentationAnnotationOverlayComponent, PresentationAnnotationsService, PresentationOverlayComponent, PresentationSubtitleBarComponent, PresentationTransitionOverlayComponent, PresenterViewComponent, PrintDialogComponent, PrintService, PrintSettingsPanelComponent, PropertiesDialogComponent, RESIZE_HANDLES, SEVERITY_GROUPS, SEVERITY_LABELS, SLIDE_TRANSITION_KEYFRAMES, SVG_WARP_PRESETS, 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, getTextWarp, getWarpCategory, getWarpPath, 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, shouldUseSvgWarp, signatureCountLabel, signatureKey, signatureTimestamp, signerName, statusKind, statusLabel, themeStyle, themeToCssVars, toggleCommentResolvedInList, updateElementById, validatePrintSettings, validateRoomId, waypointsToPathD, worstStatus };
+export type { AccessibilityIssueGroup, AnimationClickGroup, AnnotationStroke, 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, PresentationTool, PresenterNotes, PrintColorMode, PrintDocumentOptions, PrintOrientation, PrintSettings, PrintSlideRange, PrintWhat, PropertiesDraft, RecordWebmOptions, RemoteCursor, RemotePresence, ReplaceResult, ResizeHandle, ResolvedFontVariant, ShareDefaults, ShareFormFields, SignatureStatusKind, SlideTransitionAnimations, StyleMap, TextWarpCssDef, TextWarpDef, TextWarpPathDef, TimerProgress, VideoPlanOptions, VideoSegmentPlan, ViewerTheme, ViewerThemeColors };