markdown-flow-ui 0.1.124 → 0.1.126

package/dist/components/Slide/Player.d.ts

@@ -2,10 +2,34 @@ import { default as React } from 'react';
 import { SlideAudioItem } from './useSlide';
 import { SlidePlayerCustomActionContext, SlidePlayerCustomActions } from './types';
 import { MobileViewMode } from './utils/mobileScreenMode';
+/**
+ * Labels and accessibility text used by the slide player controls.
+ *
+ * Missing fields fall back to `DEFAULT_SLIDE_PLAYER_TEXTS`; pass a `texts`
+ * object when a consumer needs localized control labels or tooltip text.
+ *
+ * @example
+ * ```tsx
+ * <Player texts={{ playLabel: "播放", nextLabel: "下一步" }} />
+ * ```
+ */
 export interface SlidePlayerTexts {
+    closeSettingsLabel?: string;
+    enterFullscreenLabel?: string;
+    exitFullscreenLabel?: string;
+    moreOptionsAriaLabel?: string;
+    nextLabel?: string;
+    notesLabel?: string;
+    pauseAutoplayLabel?: string;
+    pauseLabel?: string;
+    playAutoplayLabel?: string;
+    playLabel?: string;
+    previousLabel?: string;
+    screenModeLabel?: string;
     settingsTitle?: string;
     subtitleLabel?: string;
     subtitleToggleAriaLabel?: string;
+    volumeAriaLabel?: string;
     screenLabel?: string;
     nonFullscreenLabel?: string;
     fullscreenLabel?: string;
@@ -14,6 +38,8 @@ export interface SlidePlayerTexts {
 export type SlidePlayerLoadingReason = "loadingAudio" | "waitingForMoreAudio";
 export interface SlidePlayerNavigationContext {
     shouldContinuePlayback: boolean;
+    /** Set false when navigation should not reveal hidden player controls. */
+    shouldWakeControls?: boolean;
 }
 export type PlayerProps = Omit<React.ComponentProps<"div">, "onEnded"> & {
     audioList?: SlideAudioItem[];
@@ -46,9 +72,21 @@ export type PlayerProps = Omit<React.ComponentProps<"div">, "onEnded"> & {
     prevDisabled?: boolean;
     nextDisabled?: boolean;
     showControls?: boolean;
+    /**
+     * Enables document-level keyboard shortcuts for existing player actions.
+     *
+     * Defaults to `true`. Set to `false` when the page should not advertise or
+     * handle player shortcuts for this standalone player instance.
+     *
+     * @example
+     * ```tsx
+     * <Player enableKeyboardShortcuts={false} />
+     * ```
+     */
+    enableKeyboardShortcuts?: boolean;
     customActions?: SlidePlayerCustomActions;
     customActionContext?: SlidePlayerCustomActionContext;
     texts?: SlidePlayerTexts;
 };
-declare const MemoizedPlayer: React.MemoExoticComponent<({ audioList, className, currentAudioIndex, defaultPlaying, isPlaybackPaused, isAutoAdvanceEnabled, useAutoAdvanceToggle, onLoadingChange, onPlaybackPreferenceChange, onPlaybackStarted, onPlaybackTimeChange, onSubtitleToggle, onPrev, onNext, onFullscreen, isFullscreen, mobileViewMode, settingsPortalContainer, onMobileViewModeChange, onEnded, onAutoAdvanceToggle, onInteractionToggle, hasInteraction, isInteractionOpen, isSubtitleEnabled, prevDisabled, nextDisabled, showControls, customActions, customActionContext, texts, ...props }: PlayerProps) => React.JSX.Element>;
+declare const MemoizedPlayer: React.MemoExoticComponent<({ audioList, className, currentAudioIndex, defaultPlaying, isPlaybackPaused, isAutoAdvanceEnabled, useAutoAdvanceToggle, onLoadingChange, onPlaybackPreferenceChange, onPlaybackStarted, onPlaybackTimeChange, onSubtitleToggle, onPrev, onNext, onFullscreen, isFullscreen, mobileViewMode, settingsPortalContainer, onMobileViewModeChange, onEnded, onAutoAdvanceToggle, onInteractionToggle, hasInteraction, isInteractionOpen, isSubtitleEnabled, prevDisabled, nextDisabled, showControls, enableKeyboardShortcuts, customActions, customActionContext, texts, onFocusCapture, onPointerDown, ...props }: PlayerProps) => React.JSX.Element>;
 export default MemoizedPlayer;