pptx-react-viewer 4.62.0 → 4.62.1

package/dist/internals.d.ts

@@ -6,7 +6,6 @@ import * as Y from 'yjs';
 import { Doc } from 'yjs';
 import React$1, { MutableRefObject, Dispatch, SetStateAction, RefObject, ForwardedRef } from 'react';
 
-//#region src/viewer/types-core.d.ts
 /**
  * Union of all shape preset types that the viewer can insert or render.
  * Maps to OOXML `a:prstGeom` preset values (e.g. "rect", "ellipse").
@@ -95,8 +94,6 @@ interface EditorHistorySnapshot {
   theme?: HistoryTheme;
   actionLabel?: string;
 }
-//#endregion
-//#region src/viewer/hooks/collaboration/types.d.ts
 /** Connection lifecycle states for the Yjs WebSocket provider. */
 type ConnectionStatus$1 = 'disconnected' | 'connecting' | 'connected' | 'error';
 /**
@@ -153,8 +150,6 @@ interface CollaborationContextValue {
   /** Called by the document sync with the write-back status (undefined clears it). */
   reportWriteBack?: (state: CollaborationWriteBackState | undefined) => void;
 }
-//#endregion
-//#region src/viewer/types-ui.d.ts
 /**
  * Base handle interface for file viewer components.
  * Defined locally to avoid dependency on external file-viewer plugin packages.
@@ -237,7 +232,6 @@ interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI,
   getContent: () => Promise<Uint8Array>;
 }
 
-//#region src/viewer/components/toolbar/toolbar-types.d.ts
 interface ToolbarProps {
   fileName?: string;
   mode: ViewerMode;
@@ -504,8 +498,6 @@ interface ToolbarProps {
    */
   onQuickCommand?: (id: string) => void;
 }
-//#endregion
-//#region src/viewer/hooks/useInlineEditingState.d.ts
 interface PendingInlineEditReader {
   elementId: string;
   read: () => InlineListReadResult;
@@ -521,8 +513,6 @@ interface InlineEditingState {
   inlineEditingReaderRef?: MutableRefObject<PendingInlineEditReader | undefined>;
   registerInlineEditReader?: (elementId: string, read: () => InlineListReadResult) => () => void;
 }
-//#endregion
-//#region src/viewer/hooks/pointer-handler-types.d.ts
 interface UsePointerHandlersInput {
   editorScale: number;
   canvasStageRef: React.RefObject<HTMLDivElement | null>;
@@ -580,16 +570,12 @@ interface UsePointerHandlersInput {
    */
   gestureRef?: React.MutableRefObject<CanvasGestures | null>;
 }
-//#endregion
-//#region src/viewer/hooks/canvas-gestures.d.ts
 interface CanvasGestures {
   /** Start the gesture armed in `dragStateRef` (move) or `resizeStateRef` (resize). */
   begin(kind: Exclude<GestureKind, 'rotate'>, id: string, pointer: PointerLike): void;
   isActive(): boolean;
   dispose(): void;
 }
-//#endregion
-//#region src/viewer/hooks/canvas-interaction-types.d.ts
 /**
  * Shared type for canvas interaction handler signatures.
  */
@@ -610,8 +596,6 @@ interface CanvasInteractionHandlers {
   handleFormatText: (updates: Partial<TextStyle>) => void;
   handleInlineEditCommit: () => void;
 }
-//#endregion
-//#region src/viewer/hooks/useEditorHistory.d.ts
 interface EditorHistoryInput {
   slides: PptxSlide[];
   canvasSize: CanvasSize$1;
@@ -708,8 +692,6 @@ interface EditorHistoryResult {
   buildHistorySnapshot: (actionLabel?: string) => EditorHistorySnapshot;
 }
 declare function useEditorHistory(input: EditorHistoryInput): EditorHistoryResult;
-//#endregion
-//#region src/viewer/hooks/element-operations-types.d.ts
 /**
  * View > Slide Master routing.
  *
@@ -793,11 +775,7 @@ interface ElementOperations {
   updateActiveElements: (updater: (els: PptxElement[]) => PptxElement[]) => void;
   serializeSlides: () => Promise<Uint8Array | null>;
 }
-//#endregion
-//#region src/viewer/hooks/useElementOperations.d.ts
 declare function useElementOperations(input: UseElementOperationsInput): ElementOperations;
-//#endregion
-//#region src/viewer/hooks/useCanvasInteractions.d.ts
 interface UseCanvasInteractionsInput {
   mode: ViewerMode;
   canEdit: boolean;
@@ -860,8 +838,6 @@ interface UseCanvasInteractionsInput {
   transformCommittedText?: (text: string, previous?: string) => string;
 }
 declare function useCanvasInteractions(input: UseCanvasInteractionsInput): CanvasInteractionHandlers;
-//#endregion
-//#region src/viewer/hooks/useComments-helpers.d.ts
 interface UseCommentsInput {
   slides: PptxSlide[];
   activeSlideIndex: number;
@@ -899,11 +875,7 @@ interface UseCommentsResult {
   handleReplyDraftChange: (commentId: string, draft: string, mentions?: PptxCommentMention[]) => void;
   handleSubmitReply: (slideIndex: number, commentId: string) => void;
 }
-//#endregion
-//#region src/viewer/hooks/useComments.d.ts
 declare function useComments({ slides, canEdit, userName, selectedElementId, onUpdateSlides, onMarkDirty }: UseCommentsInput): UseCommentsResult;
-//#endregion
-//#region src/viewer/hooks/element-manipulation-types.d.ts
 interface UseElementManipulationInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
@@ -995,11 +967,7 @@ interface GroupAlignLayerHandlers {
   handleMergeShapes: (operation: MergeShapeOperation) => void;
   canMergeShapes: boolean;
 }
-//#endregion
-//#region src/viewer/hooks/useElementManipulation.d.ts
 declare function useElementManipulation(input: UseElementManipulationInput): ElementManipulationHandlers;
-//#endregion
-//#region src/viewer/hooks/useFindReplace.d.ts
 interface UseFindReplaceInput {
   slides: PptxSlide[];
   mode: string;
@@ -1036,8 +1004,6 @@ interface UseFindReplaceResult {
   handleReplaceAll: () => void;
 }
 declare function useFindReplace({ slides, mode, onShowMatch, onUpdateSlides, onMarkDirty, keyboard }: UseFindReplaceInput): UseFindReplaceResult;
-//#endregion
-//#region src/viewer/components/hyperlink-edit-types.d.ts
 /** The type of hyperlink target. */
 type HyperlinkTargetType = 'url' | 'email' | 'slide' | 'file' | 'action';
 /** Supported action verbs for action hyperlinks. */
@@ -1053,8 +1019,6 @@ interface HyperlinkEditData {
   filePath: string;
   actionVerb: HyperlinkActionVerb;
 }
-//#endregion
-//#region src/viewer/hooks/useInsertElements.d.ts
 interface UseInsertElementsInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
@@ -1084,8 +1048,6 @@ interface InsertElementHandlers {
   handleMediaFileChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
 }
 declare function useInsertElements(input: UseInsertElementsInput): InsertElementHandlers;
-//#endregion
-//#region src/viewer/hooks/usePasteSpecial.d.ts
 /** The pasted element the "Paste Options" toolbar is currently anchored to. */
 interface PasteOptionsToolbarState {
   elementId: string;
@@ -1106,8 +1068,6 @@ interface UsePasteSpecialResult {
   reformatPastedElement: (format: PasteSpecialFormat) => Promise<void>;
   dismissPasteOptionsToolbar: () => void;
 }
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useCustomShowRunner.d.ts
 /**
  * useCustomShowRunner: the runtime side of `ppaction://customshow?id=<id>[&return=true]`.
  *
@@ -1131,8 +1091,6 @@ interface CustomShowDescriptor {
   id: string;
   slideRIds: string[];
 }
-//#endregion
-//#region src/viewer/hooks/presentation-mode/types.d.ts
 /**
  * How a forward/backward slide advance was requested.
  *
@@ -1356,11 +1314,7 @@ interface UsePresentationModeResult {
   updatePresenterSnapshot: (patch: Partial<PresentationSnapshot>) => void;
   swapPresenterDisplays: () => Promise<boolean>;
 }
-//#endregion
-//#region src/viewer/hooks/usePresentationMode.d.ts
 declare function usePresentationMode(input: UsePresentationModeInput): UsePresentationModeResult;
-//#endregion
-//#region src/viewer/hooks/useSectionOperations.d.ts
 interface UseSectionOperationsInput {
   sections: PptxSection[];
   setSections: React.Dispatch<React.SetStateAction<PptxSection[]>>;
@@ -1383,8 +1337,6 @@ interface SectionOperations {
   toggleSectionCollapse: (sectionId: string) => void;
 }
 declare function useSectionOperations(input: UseSectionOperationsInput): SectionOperations;
-//#endregion
-//#region src/viewer/hooks/useSlideManagement.d.ts
 interface UseSlideManagementInput {
   slides: PptxSlide[];
   activeSlide: PptxSlide | undefined;
@@ -1417,8 +1369,6 @@ interface SlideManagementHandlers {
   handleInsertSlideFromTemplate: (templateId: SlideTemplateId) => void;
 }
 declare function useSlideManagement(input: UseSlideManagementInput): SlideManagementHandlers;
-//#endregion
-//#region src/viewer/hooks/table-operation-types.d.ts
 interface UseTableOperationsInput {
   selectedElement: PptxElement | null;
   tableEditorState: TableCellEditorState | null;
@@ -1446,11 +1396,7 @@ interface TableMergeHandlers {
   handleSplitCell: () => void;
 }
 type TableOperationHandlers = TableStructHandlers & TableMergeHandlers;
-//#endregion
-//#region src/viewer/hooks/useTableOperations.d.ts
 declare function useTableOperations(input: UseTableOperationsInput): TableOperationHandlers;
-//#endregion
-//#region src/viewer/hooks/viewer-dialog-types.d.ts
 /**
  * Input dependencies required by the {@link useViewerDialogs} hook.
  *
@@ -1646,11 +1592,7 @@ interface ViewerDialogsResult {
   /** Runs an accessibility check across all slides and opens the results panel. */
   handleRunAccessibilityCheck: () => void;
 }
-//#endregion
-//#region src/viewer/hooks/useViewerDialogs.d.ts
 declare function useViewerDialogs(input: UseViewerDialogsInput): ViewerDialogsResult;
-//#endregion
-//#region src/viewer/hooks/useCropSessionState.d.ts
 interface CropSessionState {
   /** The open crop session, or null outside crop mode. */
   cropSession: CropSession | null;
@@ -1659,8 +1601,6 @@ interface CropSessionState {
   /** Open or close the session; keeps the ref and the state in step. */
   setCropSession: (session: CropSession | null) => void;
 }
-//#endregion
-//#region src/viewer/hooks/useEditPointsState.d.ts
 /**
  * Viewer state for the two outline-authoring modes: Edit Points on one shape,
  * and the armed Freeform: Shape / Curve drawing tool. At most one is active;
@@ -1674,16 +1614,12 @@ interface EditPointsModeState {
   activeFreeformTool: FreeformToolKind | null;
   setActiveFreeformTool: (tool: FreeformToolKind | null) => void;
 }
-//#endregion
-//#region src/viewer/hooks/useSlideChangeSelection.d.ts
 interface SlideChangeSelection {
   /** The slide the last {@link showSlideSelection} selected on, until the next slide change. */
   slideSelectionRef: MutableRefObject<number | null>;
   /** Go to `slideIndex` and select `elementId` there (nothing, for null), across the slide change. */
   showSlideSelection: (slideIndex: number, elementId: string | null) => void;
 }
-//#endregion
-//#region src/viewer/hooks/viewer-core-state-types.d.ts
 /**
  * Input parameters for the {@link useViewerCoreState} hook.
  *
@@ -1944,8 +1880,6 @@ interface ViewerCoreState extends InlineEditingState, EditPointsModeState, Slide
   /** Elements for the handout master (when handout tab is active). */
   handoutMasterElements: PptxElement[];
 }
-//#endregion
-//#region src/viewer/hooks/useViewerCoreState.d.ts
 /**
  * Initializes and returns the core viewer state (refs, useState values,
  * and derived element/master state).
@@ -1957,8 +1891,6 @@ interface ViewerCoreState extends InlineEditingState, EditPointsModeState, Slide
  *   value, setter, and derived field.
  */
 declare function useViewerCoreState(_input: UseViewerCoreStateInput): ViewerCoreState;
-//#endregion
-//#region src/viewer/hooks/useViewerUIState.d.ts
 interface ViewerUIState {
   isCompactToolbarOpen: boolean;
   setIsCompactToolbarOpen: React.Dispatch<React.SetStateAction<boolean>>;
@@ -2052,8 +1984,6 @@ interface ViewerUIState {
   setEyedropperActive: React.Dispatch<React.SetStateAction<boolean>>;
 }
 declare function useViewerUIState(inspectorInitiallyOpen?: boolean): ViewerUIState;
-//#endregion
-//#region src/viewer/hooks/useViewerState.d.ts
 /**
  * Input parameters for the {@link useViewerState} hook.
  *
@@ -2081,8 +2011,6 @@ type ViewerState = ViewerCoreState & ViewerUIState & CropSessionState;
  * @returns The merged {@link ViewerState} containing every ref, state value, and setter.
  */
 declare function useViewerState(input: UseViewerStateInput): ViewerState;
-//#endregion
-//#region src/viewer/hooks/useEditorOperations.d.ts
 interface UseEditorOperationsInput {
   state: ViewerState;
   history: EditorHistoryResult;
@@ -2138,11 +2066,7 @@ interface EditorOperationsResult {
   pasteFormatToSelection: (targetIds: string[]) => void;
 }
 declare function useEditorOperations(input: UseEditorOperationsInput): EditorOperationsResult;
-//#endregion
-//#region src/viewer/hooks/useCanvasImagePaste.d.ts
 type CanvasImagePasteHandlers = Pick<EditorImagePasteOptions, 'getTarget' | 'insertElement'>;
-//#endregion
-//#region src/viewer/utils/table-band-style.d.ts
 /**
  * Table band / header / emphasis styling for the React table renderer.
  *
@@ -2160,8 +2084,6 @@ interface TableStyleContext {
   tableStyleMap?: ParsedTableStyleMap;
   theme?: PptxTheme;
 }
-//#endregion
-//#region src/viewer/components/canvas/OutlineAuthoringLayer.d.ts
 /** Wiring for Edit Points and the Freeform: Shape / Curve tools. */
 interface OutlineAuthoringProps {
   /** The shape in Edit Points mode, or null. */
@@ -2177,8 +2099,6 @@ interface OutlineAuthoringProps {
   onFreeformCommit: (element: ShapePptxElement) => void;
   onFreeformCancel: () => void;
 }
-//#endregion
-//#region src/viewer/components/canvas/canvas-types.d.ts
 interface ZoomViewport {
   canvasViewportRef: React$1.RefObject<HTMLDivElement | null>;
   /** Optional mount notification for hook-owned fit and wheel listeners. */
@@ -2327,8 +2247,6 @@ interface SlideCanvasProps {
   aiActive?: boolean;
   outlineAuthoring?: OutlineAuthoringProps;
 }
-//#endregion
-//#region src/viewer/components/slides-pane/types.d.ts
 interface SlidesPaneSidebarProps {
   slides: PptxSlide[];
   templateElementsBySlideId: Record<string, PptxElement[]>;
@@ -2370,8 +2288,6 @@ interface SlidesPaneSidebarProps {
   /** Theme + table style map so thumbnails resolve table band/header colours. */
   tableStyleContext?: TableStyleContext;
 }
-//#endregion
-//#region src/viewer/hooks/useAutosave.d.ts
 /** The one autosave status every binding renders (`PptxAutosaveStatus` in `ooxml-ui/pptx`). */
 type AutosaveStatus = PptxAutosaveStatus;
 interface UseAutosaveInput {
@@ -2423,8 +2339,6 @@ interface UseAutosaveResult {
   triggerAutosave: () => Promise<void>;
 }
 declare function useAutosave(input: UseAutosaveInput): UseAutosaveResult;
-//#endregion
-//#region src/viewer/hooks/useViewerBuildingBlocks-types.d.ts
 interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   /** Optional collaboration, including a host-owned document and presence session. */
   collaboration?: CollaborationInput;
@@ -2521,11 +2435,8 @@ interface ViewerBuildingBlocksResult {
   /** Current autosave-to-localStorage recovery status. */
   autosaveStatus: AutosaveStatus;
 }
-//#endregion
-//#region src/viewer/hooks/useViewerBuildingBlocks.d.ts
 declare function useViewerBuildingBlocks(input: UseViewerBuildingBlocksInput): ViewerBuildingBlocksResult;
 
-//#region src/viewer/hooks/useThemeSwitching.d.ts
 interface UseThemeSwitchingInput {
   /** Ref to the PptxHandler instance. */
   handlerRef: RefObject<PptxHandler | null>;
@@ -2582,8 +2493,6 @@ interface ThemeSwitchingResult {
  * ```
  */
 declare function useThemeSwitching(input: UseThemeSwitchingInput): ThemeSwitchingResult;
-//#endregion
-//#region ../../../../node_modules/.bun/lib0@0.2.119/node_modules/lib0/observable.d.ts
 /**
  * Handles named events.
  *
@@ -2623,8 +2532,6 @@ declare class Observable<N> {
   emit(name: N, args: Array<any>): void;
   destroy(): void;
 }
-//#endregion
-//#region ../../../../node_modules/.bun/y-protocols@1.0.7+dd3713061a4ad7f6/node_modules/y-protocols/awareness.d.ts
 /**
  * @typedef {Object} MetaClientState
  * @property {number} MetaClientState.clock
@@ -2701,8 +2608,6 @@ type MetaClientState = {
    */
   lastUpdated: number;
 };
-//#endregion
-//#region src/viewer/hooks/collaboration/useYjsProvider.d.ts
 interface UseYjsProviderInput {
   /**
    * Collaboration config, or `undefined` when collaboration is inactive. The
@@ -2741,8 +2646,6 @@ interface UseYjsProviderResult {
  * (or the full/headless viewer) to attach a host-owned external session.
  */
 declare function useYjsProvider({ config: inputConfig }: UseYjsProviderInput): UseYjsProviderResult;
-//#endregion
-//#region src/viewer/hooks/collaboration/usePresenceTracking.d.ts
 interface UsePresenceTrackingInput {
   awareness: Awareness | BorrowedCollaborationAwareness | null;
   localClientId: number | null;
@@ -2761,8 +2664,6 @@ interface UsePresenceTrackingResult {
   broadcastPresence: (update: Partial<Omit<UserPresence, 'clientId'>>) => void;
 }
 declare function usePresenceTracking({ awareness, localClientId, userName, userColor, userAvatar, role, canvasWidth, canvasHeight }: UsePresenceTrackingInput): UsePresenceTrackingResult;
-//#endregion
-//#region src/viewer/hooks/collaboration/useCollaborativeState.d.ts
 interface UseCollaborativeStateInput {
   /**
    * Collaboration config, or `undefined` when collaboration is inactive. The
@@ -2775,8 +2676,6 @@ interface UseCollaborativeStateInput {
   canvasHeight: number;
 }
 declare function useCollaborativeState({ config: requested, canvasWidth, canvasHeight }: UseCollaborativeStateInput): CollaborationContextValue | null;
-//#endregion
-//#region src/viewer/hooks/collaboration/useCollaborativeHistory.d.ts
 interface UseCollaborativeHistoryInput {
   /** The local user's client ID (from Yjs awareness). */
   localClientId: number | null;
@@ -2800,8 +2699,6 @@ interface UseCollaborativeHistoryResult {
   canRedo: boolean;
 }
 declare function useCollaborativeHistory({ localClientId: _localClientId, handleUndo, handleRedo, canUndo, canRedo }: UseCollaborativeHistoryInput): UseCollaborativeHistoryResult;
-//#endregion
-//#region src/viewer/hooks/collaboration/useYjsDocumentSync.d.ts
 interface UseYjsDocumentSyncInput {
   doc: Doc | null;
   slides: PptxSlide[];
@@ -2821,8 +2718,6 @@ interface UseYjsDocumentSyncInput {
   onWriteBackStatus?: (state: CollaborationWriteBackState | undefined) => void;
 }
 declare function useYjsDocumentSync(input: UseYjsDocumentSyncInput): void;
-//#endregion
-//#region src/viewer/hooks/collaboration/useBroadcastFollower.d.ts
 interface UseBroadcastFollowerInput {
   /** The collaboration context (null when collaboration is disabled). */
   collab: CollaborationContextValue | null;
@@ -2839,8 +2734,6 @@ interface UseBroadcastFollowerInput {
   paused?: boolean;
 }
 declare function useBroadcastFollower({ collab, activeSlideIndex, setActiveSlideIndex, slideCount, paused }: UseBroadcastFollowerInput): void;
-//#endregion
-//#region src/viewer/hooks/collaboration/useFollowMode.d.ts
 interface UseFollowModeInput {
   /** The collaboration context (null when collaboration is disabled). */
   collab: CollaborationContextValue | null;
@@ -2875,7 +2768,6 @@ interface UsePresenterWindowResult {
 }
 declare function usePresenterWindow(input: UsePresenterWindowInput): UsePresenterWindowResult;
 
-//#region src/viewer/hooks/useZoomViewport.d.ts
 /** Axis-aligned bounding box used by zoom / viewport helpers. */
 interface SelectionBounds {
   minX: number;
@@ -2913,8 +2805,6 @@ interface UseZoomViewportResult {
   } | null;
 }
 declare function useZoomViewport({ canvasSize, selectedElements, fitPadding, maxFitScale }: UseZoomViewportInput): UseZoomViewportResult;
-//#endregion
-//#region src/viewer/hooks/usePresentationAnnotations.types.d.ts
 /**
  * Types for presentation annotation state.
  */
@@ -2978,11 +2868,7 @@ interface UsePresentationAnnotationsResult {
   /** Clear all annotations across all slides. */
   clearAllAnnotations: () => void;
 }
-//#endregion
-//#region src/viewer/hooks/usePresentationAnnotations.d.ts
 declare function usePresentationAnnotations(input: UsePresentationAnnotationsInput): UsePresentationAnnotationsResult;
-//#endregion
-//#region src/viewer/hooks/useSheetDismissDrag.d.ts
 interface SheetDismissDragHandlers {
   onPointerDown: (e: React$1.PointerEvent) => void;
   onPointerMove: (e: React$1.PointerEvent) => void;
@@ -3006,8 +2892,6 @@ interface SheetDismissDrag {
  * be swiped closed while the inspector's handle was purely decorative.
  */
 declare function useSheetDismissDrag(onClose: () => void, threshold?: number): SheetDismissDrag;
-//#endregion
-//#region src/viewer/hooks/useModalDismissDrag.d.ts
 interface ModalDismissDragHandlers {
   onPointerDown: (e: React$1.PointerEvent) => void;
   onPointerMove: (e: React$1.PointerEvent) => void;
@@ -3030,8 +2914,6 @@ interface ModalDismissDrag {
  *  - dragging the header down past `threshold` px invokes `onClose`.
  */
 declare function useModalDismissDrag(onClose: () => void, threshold?: number): ModalDismissDrag;
-//#endregion
-//#region src/viewer/hooks/useLoadContent.d.ts
 interface UseLoadContentInput {
   content: ArrayBuffer | Uint8Array | null | undefined;
   clearSelection: () => void;
@@ -3128,11 +3010,7 @@ interface UseLoadContentResult {
   handlerRef: React.MutableRefObject<PptxHandler | null>;
 }
 declare function useLoadContent({ content, clearSelection, history, setSlides, setTemplateElementsBySlideId, mediaDataUrls, setCanvasSize, setSlideSizeEmu, setHeaderFooter, setFirstSlideNumber, setLayoutOptions, setSlideMasters, setModernCommentAuthors, setRecentColors, setTheme, setTableStyleMap, setTableStylesDefaultId, setTableStylesToDelete, setThemeOptions, setCustomShows, setActiveCustomShowId, setSections, setPresentationProperties, setViewProperties, setNotesMaster, setHandoutMaster, setNotesCanvasSize, setCustomProperties, setTagCollections, setCoreProperties, setAppProperties, setEmbeddedFonts, setActiveSlideIndex, setHasMacros, setHasDigitalSignatures, setDigitalSignatureCount, setGuides, setReadOnlyRecommendation, setModifyVerifier, setCompatToasts, setLoading, setError, setIsDirty, setIsEncrypted, onContentApplied, allowExternalImages, initialSlide, limits }: UseLoadContentInput): UseLoadContentResult;
-//#endregion
-//#region src/viewer/hooks/usePointerHandlers.d.ts
 declare function usePointerHandlers(input: UsePointerHandlersInput): void;
-//#endregion
-//#region src/viewer/hooks/useSerialize.d.ts
 interface UseSerializeInput {
   slides: PptxSlide[];
   /** Separated master/layout (template) elements, merged back at save time. */
@@ -3240,8 +3118,6 @@ interface UseSerializeInput {
  */
 type SerializeSlides = (format?: PptxSaveFormat) => Promise<Uint8Array | null>;
 declare function useSerialize(input: UseSerializeInput): SerializeSlides;
-//#endregion
-//#region src/viewer/hooks/export-handler-types.d.ts
 interface UseExportHandlersInput {
   slides: PptxSlide[];
   /** Separated master/layout (template) elements, merged back at save time. */
@@ -3326,11 +3202,7 @@ interface ExportHandlersResult {
   exportProgress: number;
   exportStatusMessage: string;
 }
-//#endregion
-//#region src/viewer/hooks/useExportHandlers.d.ts
 declare function useExportHandlers(input: UseExportHandlersInput): ExportHandlersResult;
-//#endregion
-//#region src/viewer/hooks/usePrintHandlers.d.ts
 interface UsePrintHandlersInput {
   /** The editable slides (template elements partitioned out, as the viewer state holds them). */
   slides: PptxSlide[];
@@ -3357,8 +3229,6 @@ interface PrintHandlersResult {
   setIsPrintDialogOpen: React.Dispatch<React.SetStateAction<boolean>>;
 }
 declare function usePrintHandlers(input: UsePrintHandlersInput): PrintHandlersResult;
-//#endregion
-//#region src/viewer/hooks/useThemeHandlers.d.ts
 interface UseThemeHandlersInput {
   handlerRef: RefObject<PptxHandler | null>;
   setTheme: React.Dispatch<React.SetStateAction<Record<string, unknown> | null>>;
@@ -3408,8 +3278,6 @@ interface ThemeHandlersResult {
   handleSwitchTheme: (themePath: string) => Promise<void>;
 }
 declare function useThemeHandlers(input: UseThemeHandlersInput): ThemeHandlersResult;
-//#endregion
-//#region src/viewer/hooks/usePropertyHandlers.d.ts
 interface UsePropertyHandlersInput {
   slides: PptxSlide[];
   activeSlideIndex: number;
@@ -3450,8 +3318,6 @@ interface PropertyHandlersResult {
   usedFontFamilies: string[];
 }
 declare function usePropertyHandlers(input: UsePropertyHandlersInput): PropertyHandlersResult;
-//#endregion
-//#region src/viewer/hooks/useDerivedSlideState.d.ts
 interface UseDerivedSlideStateInput {
   slides: PptxSlide[];
   sections: Array<{
@@ -3499,8 +3365,6 @@ interface DerivedSlideState {
   authoredRange: AuthoredSlideRange | undefined;
 }
 declare function useDerivedSlideState(input: UseDerivedSlideStateInput): DerivedSlideState;
-//#endregion
-//#region src/viewer/hooks/useAnnotationHandlers.d.ts
 interface UseAnnotationHandlersInput {
   mode: ViewerMode;
   presentation: UsePresentationModeResult;
@@ -3524,8 +3388,6 @@ interface AnnotationHandlersResult {
   handleEnterRehearsalMode: () => void;
 }
 declare function useAnnotationHandlers(input: UseAnnotationHandlersInput): AnnotationHandlersResult;
-//#endregion
-//#region src/viewer/hooks/useRecoveryDetection.d.ts
 interface UseRecoveryDetectionInput {
   filePath: string | undefined;
   /** Public document name rendered in the recovery message. */
@@ -3559,8 +3421,6 @@ interface UseRecoveryDetectionResult {
   discarding: boolean;
 }
 declare function useRecoveryDetection(input: UseRecoveryDetectionInput): UseRecoveryDetectionResult;
-//#endregion
-//#region src/viewer/hooks/usePresentationSetup.d.ts
 interface UsePresentationSetupInput {
   mode: ViewerMode;
   slides: PptxSlide[];
@@ -3645,8 +3505,6 @@ interface PresentationSetupResult {
   setExitModeHandler: (handler: ((nextMode: ViewerMode) => void) | null) => void;
 }
 declare function usePresentationSetup(input: UsePresentationSetupInput): PresentationSetupResult;
-//#endregion
-//#region src/viewer/hooks/useIOHandlers.d.ts
 interface UseIOHandlersInput {
   state: ViewerState;
   slides: PptxSlide[];
@@ -3691,8 +3549,6 @@ interface IOHandlersResult {
   propertyHandlers: PropertyHandlersResult;
 }
 declare function useIOHandlers(input: UseIOHandlersInput): IOHandlersResult;
-//#endregion
-//#region src/viewer/hooks/useContentLifecycle.d.ts
 interface UseContentLifecycleInput {
   content: ArrayBuffer | Uint8Array | null;
   filePath: string | undefined;
@@ -3758,8 +3614,6 @@ interface ContentLifecycleResult {
   autosaveStatus: AutosaveStatus;
 }
 declare function useContentLifecycle(input: UseContentLifecycleInput): ContentLifecycleResult;
-//#endregion
-//#region src/viewer/hooks/useKeyboardShortcutWiring.d.ts
 interface UseKeyboardShortcutWiringInput {
   state: ViewerState;
   mode: ViewerMode;
@@ -3797,8 +3651,6 @@ interface UseKeyboardShortcutWiringInput {
   customization?: ResolvedCustomization;
 }
 declare function useKeyboardShortcutWiring(input: UseKeyboardShortcutWiringInput): void;
-//#endregion
-//#region src/viewer/hooks/useViewerIntegration.d.ts
 interface UseViewerIntegrationInput {
   transformCommittedText?: (text: string, previous?: string) => string;
   state: ViewerState;
@@ -3929,8 +3781,6 @@ interface ViewerIntegrationResult {
   loadVersion: number;
 }
 declare function useViewerIntegration(input: UseViewerIntegrationInput): ViewerIntegrationResult;
-//#endregion
-//#region src/viewer/hooks/useReducedMotion.d.ts
 interface UseReducedMotionResult {
   /** Whether the OS reports prefers-reduced-motion: reduce. */
   osReducedMotion: boolean;
@@ -3951,8 +3801,6 @@ interface UseReducedMotionResult {
  * @returns {@link UseReducedMotionResult}
  */
 declare function useReducedMotion(): UseReducedMotionResult;
-//#endregion
-//#region src/viewer/hooks/useViewerOptions.d.ts
 interface UseViewerOptionsResult {
   /** Imperative store: `setValue`, `setRibbonTabHidden`, `reset`, ... */
   optionsStore: ViewerOptionsStore;
@@ -3965,8 +3813,6 @@ interface UseViewerOptionsResult {
  * so choices survive reloads without any host wiring.
  */
 declare function useViewerOptions(): UseViewerOptionsResult;
-//#endregion
-//#region src/viewer/hooks/useToolbarVisibility.d.ts
 interface ToolbarVisibility {
   /** True when `id` is present in the host's `hiddenActions` list. */
   isHidden: (id: ToolbarActionId) => boolean;
@@ -3998,8 +3844,6 @@ declare function computeToolbarVisibility(hiddenActions: readonly ToolbarActionI
  * Recomputed only when the list reference or the hidden-tab set changes.
  */
 declare function useToolbarVisibility(hiddenActions: readonly ToolbarActionId[] | undefined): ToolbarVisibility;
-//#endregion
-//#region src/viewer/hooks/useLayoutSwitching.d.ts
 /**
  * Input for {@link useLayoutSwitching}.
  */
@@ -4062,8 +3906,6 @@ interface LayoutSwitchingResult {
  * ```
  */
 declare function useLayoutSwitching(input: UseLayoutSwitchingInput): LayoutSwitchingResult;
-//#endregion
-//#region src/viewer/hooks/useVirtualizedSlides.d.ts
 interface VirtualizedSlidesOptions {
   /** Total number of slide items. */
   totalItems: number;
@@ -4079,8 +3921,6 @@ interface VirtualizedSlidesResult extends VirtualizedRange {
   scrollToIndex: (index: number, behavior?: ScrollBehavior) => void;
 }
 declare function useVirtualizedSlides({ totalItems, itemHeight, overscan }: VirtualizedSlidesOptions): VirtualizedSlidesResult;
-//#endregion
-//#region src/viewer/hooks/useIsMobile.d.ts
 /**
  * Minimum touch target size (px) per WCAG accessibility guidelines. Re-exported
  * from `pptx-viewer-shared`'s `MIN_TOUCH_TARGET_PX` (the single source of truth
@@ -4107,8 +3947,6 @@ interface UseIsMobileResult {
   viewportHeight: number;
 }
 declare function useIsMobile(): UseIsMobileResult;
-//#endregion
-//#region src/viewer/hooks/useTouchGestures.d.ts
 interface UseTouchGesturesInput {
   /** The element to attach touch listeners to. */
   targetRef: React.RefObject<HTMLElement | null>;
@@ -4120,8 +3958,6 @@ interface UseTouchGesturesInput {
   enabled?: boolean;
 }
 declare function useTouchGestures(input: UseTouchGesturesInput): void;
-//#endregion
-//#region src/viewer/hooks/useKeyboardInsets.d.ts
 interface UseKeyboardInsetsResult {
   /** CSS pixels the on-screen keyboard currently covers (0 when closed). */
   keyboardInset: number;
@@ -4129,8 +3965,6 @@ interface UseKeyboardInsetsResult {
   isKeyboardOpen: boolean;
 }
 declare function useKeyboardInsets(enabled?: boolean): UseKeyboardInsetsResult;
-//#endregion
-//#region src/viewer/hooks/useClipboardHandlers.d.ts
 interface ClipboardInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
@@ -4151,8 +3985,6 @@ interface ClipboardInput {
   onPasted?: (element: PptxElement) => void;
 }
 declare function useClipboardHandlers(input: ClipboardInput): ClipboardHandlers;
-//#endregion
-//#region src/viewer/hooks/useDerivedElementState.d.ts
 interface UseDerivedElementStateInput {
   slides: PptxSlide[];
   activeSlideIndex: number;
@@ -4180,8 +4012,6 @@ interface DerivedElementState {
   handoutMasterElements: PptxElement[];
 }
 declare function useDerivedElementState(input: UseDerivedElementStateInput): DerivedElementState;
-//#endregion
-//#region src/viewer/hooks/useDialogCustomShows.d.ts
 interface UseDialogCustomShowsInput {
   activeSlide: PptxSlide | undefined;
   customShows: Array<{
@@ -4210,8 +4040,6 @@ interface UseDialogCustomShowsResult {
   isCurrentSlideInActiveShow: boolean;
 }
 declare function useDialogCustomShows(input: UseDialogCustomShowsInput): UseDialogCustomShowsResult;
-//#endregion
-//#region src/viewer/hooks/useExportSaveAs.d.ts
 /**
  * useExportSaveAs: Save-As format handlers and the deck-JSON export.
  *
@@ -4269,8 +4097,6 @@ interface ExportSaveAsResult {
   handleSaveAsPpt: () => void;
 }
 declare function useExportSaveAs(input: UseExportSaveAsInput): ExportSaveAsResult;
-//#endregion
-//#region src/viewer/hooks/useFontInjection.d.ts
 interface UseFontInjectionInput {
   embeddedFonts: PptxEmbeddedFont[];
   slides: PptxSlide[];
@@ -4278,8 +4104,6 @@ interface UseFontInjectionInput {
   googleFonts?: GoogleFontsOption;
 }
 declare function useFontInjection({ embeddedFonts, slides, googleFonts }: UseFontInjectionInput): void;
-//#endregion
-//#region src/viewer/hooks/useGroupAlignLayerHandlers.d.ts
 interface GroupAlignLayerInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
@@ -4298,8 +4122,6 @@ interface GroupAlignLayerInput {
   history: EditorHistoryResult;
 }
 declare function useGroupAlignLayerHandlers(input: GroupAlignLayerInput): GroupAlignLayerHandlers;
-//#endregion
-//#region src/viewer/hooks/useKeyboardShortcuts.d.ts
 interface UseKeyboardShortcutsInput {
   /** Container element ref, kept for API compatibility with the shell. */
   containerRef: React.RefObject<HTMLDivElement | null>;
@@ -4386,8 +4208,6 @@ interface UseKeyboardShortcutsInput {
   onPasteSpecial?: () => void;
 }
 declare function useKeyboardShortcuts(input: UseKeyboardShortcutsInput): void;
-//#endregion
-//#region src/viewer/hooks/useMergeShapesHandler.d.ts
 /** Input for the merge shapes handler. */
 interface MergeShapesHandlerInput {
   activeSlide: PptxSlide | undefined;
@@ -4405,8 +4225,6 @@ interface MergeShapesHandlers {
   canMergeShapes: boolean;
 }
 declare function useMergeShapesHandler(input: MergeShapesHandlerInput): MergeShapesHandlers;
-//#endregion
-//#region src/viewer/hooks/useResizablePanels.d.ts
 interface ResizablePanelSizes {
   leftWidth: number;
   rightWidth: number;
@@ -4418,8 +4236,6 @@ interface UseResizablePanelsResult extends ResizablePanelSizes {
   onResizeBottom: (delta: number) => void;
 }
 declare function useResizablePanels(): UseResizablePanelsResult;
-//#endregion
-//#region src/viewer/hooks/useSwipeNavigation.d.ts
 interface UseSwipeNavigationInput {
   /** Whether swipe navigation is active. */
   enabled: boolean;
@@ -4433,8 +4249,6 @@ interface UseSwipeNavigationResult {
   onTouchEnd: (e: React$1.TouchEvent) => void;
 }
 declare function useSwipeNavigation(input: UseSwipeNavigationInput): UseSwipeNavigationResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useAnimationPlayback.d.ts
 interface UseAnimationPlaybackInput {
   slides: PptxSlide[];
   onPlayActionSound?: (soundPath: string) => void;
@@ -4508,8 +4322,6 @@ interface UseAnimationPlaybackResult {
   presentationTimersRef: React.RefObject<number[]>;
 }
 declare function useAnimationPlayback(input: UseAnimationPlaybackInput): UseAnimationPlaybackResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useRehearsalTimings.d.ts
 interface UseRehearsalTimingsInput {
   containerRef: React.RefObject<HTMLElement | null>;
   onSetMode: (mode: ViewerMode) => void;
@@ -4532,8 +4344,6 @@ interface UseRehearsalTimingsResult {
   toggleRehearsalPause: () => void;
 }
 declare function useRehearsalTimings(input: UseRehearsalTimingsInput): UseRehearsalTimingsResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/usePresentationKeyboard.d.ts
 interface UsePresentationKeyboardInput {
   mode: ViewerMode;
   movePresentationSlide: (direction: 1 | -1) => void;
@@ -4575,8 +4385,6 @@ interface UsePresentationKeyboardInput {
  * resolves the same chords; this hook only performs the resulting actions.
  */
 declare function usePresentationKeyboard(input: UsePresentationKeyboardInput): void;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useSlideNavigation.d.ts
 interface UseSlideNavigationInput {
   slides: PptxSlide[];
   visibleSlideIndexes: number[];
@@ -4643,8 +4451,6 @@ interface UseSlideNavigationResult {
   scheduleAutoAdvanceForSlide: (slideIndex: number) => void;
 }
 declare function useSlideNavigation(input: UseSlideNavigationInput): UseSlideNavigationResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useZoomNavigation.d.ts
 /**
  * Input for the useZoomNavigation sub-hook.
  */
@@ -4683,8 +4489,6 @@ interface UseZoomNavigationResult {
  * `zoomExcursionRef` both hooks share.
  */
 declare function useZoomNavigation(input: UseZoomNavigationInput): UseZoomNavigationResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useAudienceMode.d.ts
 interface UseAudienceModeInput {
   mode: ViewerMode;
   onSetMode: (mode: ViewerMode) => void;
@@ -4705,8 +4509,6 @@ interface UseAudienceModeInput {
  * 3. Exits presentation mode when the presenter sends an exit signal
  */
 declare function useAudienceMode(input: UseAudienceModeInput): void;
-//#endregion
-//#region src/viewer/components/PresentationTransitionOverlay.d.ts
 interface PresentationTransitionOverlayProps {
   /** The outgoing (old) slide to render in the overlay layer. */
   outgoingSlide: PptxSlide;
@@ -4758,8 +4560,6 @@ interface PresentationTransitionOverlayProps {
   onComplete: () => void;
 }
 declare function PresentationTransitionOverlay({ outgoingSlide, templateElements, canvasSize, transition, durationMs, scale: stageScale, morphPlan, incomingSlide, incomingTemplateElements, onComplete }: PresentationTransitionOverlayProps): React$1.ReactElement | null;
-//#endregion
-//#region src/viewer/components/MorphTransitionOverlay.d.ts
 interface MorphTransitionOverlayProps {
   canvasSize: CanvasSize$1;
   scale: number;
@@ -4780,16 +4580,12 @@ interface MorphTransitionOverlayProps {
   containerRef?: React$1.RefObject<HTMLDivElement | null>;
 }
 declare function MorphTransitionOverlay({ canvasSize, scale, morphPlan, outgoingSlide, incomingSlide, containerRef }: MorphTransitionOverlayProps): React$1.ReactElement;
-//#endregion
-//#region src/viewer/components/SlideTransitionSlideLayer.d.ts
 interface SlideLayerProps {
   slide: PptxSlide;
   templateElements: PptxElement[];
   canvasSize: CanvasSize$1;
 }
 declare function SlideLayer({ slide, templateElements, canvasSize }: SlideLayerProps): React$1.ReactElement;
-//#endregion
-//#region src/viewer/components/FragmentedTransitionLayer.d.ts
 interface FragmentedTransitionLayerProps {
   layer: FragmentedLayer;
   slide: PptxSlide;