@vkontakte/videoplayer 1.0.9 → 1.0.95-dev.e4134bc49.0

package/types/utils/CaptionsPrepared.d.ts

@@ -0,0 +1,17 @@
+import { type IValueSubject } from "@vkontakte/videoplayer-shared";
+import type { Caption, VideoSubtitleParsed } from "../types";
+export declare class CaptionsPrepared {
+	private readonly flickeringTimeout;
+	private readonly subscriptions;
+	private isAuto;
+	private isLive;
+	private readonly captions$;
+	readonly captionsPrepared$: IValueSubject<Caption[][]>;
+	subscribe(): this;
+	setIsAuto(value: boolean): void;
+	setIsLive(value: boolean): void;
+	setCaptions(value: VideoSubtitleParsed["texts"]): void;
+	destroy(): void;
+	private isEnabled;
+	private processCaptions;
+}

package/types/utils/WebVttParser.d.ts

@@ -0,0 +1,19 @@
+type ITextCueWebVttParser = ({
+	type: "text";
+	value: string;
+} | {
+	type: "timestamp";
+	value: number;
+})[];
+interface ICueWebVttParser {
+	startTime: number;
+	endTime: number;
+	lang: string;
+	texts: ITextCueWebVttParser;
+}
+declare class WebVttParser {
+	private readonly oneLineRegExp;
+	private readonly twoLinesRegExp;
+	parse(vtt: string, lang: string): ICueWebVttParser[];
+}
+export default WebVttParser;

package/types/utils/attachments/defferedDisableByCondition.d.ts

@@ -0,0 +1,4 @@
+import type { Attachment } from "svelte/attachments";
+import type { Writable } from "svelte/store";
+import type { Milliseconds } from "@vkontakte/videoplayer-shared";
+export declare const deferredDisableByCondition: (condition: boolean, disable: Writable<boolean>, disableTimeout: Milliseconds) => Attachment;

package/types/utils/changeVolume.d.ts

@@ -0,0 +1,9 @@
+type Params = {
+	isAudioDisabled: boolean;
+	isAudioAvailable: boolean;
+	isAds: boolean;
+	audioDisabledHintCallback?: () => void;
+	audioIsNotExistHintCallback?: () => void;
+};
+export declare const isAvailableVolumeChange: ({ isAudioDisabled, isAudioAvailable, isAds, audioDisabledHintCallback, audioIsNotExistHintCallback }: Params) => boolean;
+export {};

package/{utils → types/utils}/clipboard.d.ts

@@ -1 +1 @@
-export declare const copyToClipboard: (text: string) => void;
+export declare const copyToClipboard: (text: string) => void;

package/{utils → types/utils}/dom.d.ts

@@ -1,2 +1,3 @@
-export declare function matchesSelector(el: HTMLElement, selector: string): boolean;
-export declare function isHover(el: HTMLElement): boolean;
+export declare function matchesSelector(el: HTMLElement, selector: string): boolean;
+export declare function isHover(el: HTMLElement): boolean;
+export declare function getShadowActiveElement(): Element | null;

package/types/utils/elementHelpers.d.ts

@@ -0,0 +1,4 @@
+import type { IRectangle } from "@vkontakte/videoplayer-shared";
+import type { Position } from "../types";
+export declare const calcPosition: (childElement?: HTMLElement, parentElement?: HTMLElement) => Required<Position>;
+export declare const getSize: (element?: HTMLElement) => IRectangle;

package/types/utils/fetchFile.d.ts

@@ -0,0 +1 @@
+export declare const fetchFile: (url: string, filename: string, fileExtension: string) => void;

package/types/utils/findCurrentSubtltlePhrase.d.ts

@@ -0,0 +1,2 @@
+import type { VideoSubtitle, VideoSubtitleParsed, VideoSubtitlesParsed } from "../types";
+export declare const findCurrentSubtitlePhrase: (position: number, currentSubtitle: Omit<VideoSubtitle, "selected">, availableSubtitlesParsed: VideoSubtitlesParsed, isLive?: boolean) => VideoSubtitleParsed | undefined;

package/{utils → types/utils}/formatSeconds.d.ts

@@ -1 +1 @@
-export declare const formatSeconds: (inputSeconds: number) => string;
+export declare const formatSeconds: (inputSeconds: number) => string;

package/types/utils/fullscreen.d.ts

@@ -0,0 +1,29 @@
+interface DocumentWithFullscreen extends HTMLDocument {
+	msFullscreenElement?: Element;
+	msFullscreenEnabled?: boolean;
+	msExitFullscreen?: () => Promise<void>;
+	mozFullScreenElement?: Element;
+	mozFullscreenEnabled?: boolean;
+	mozCancelFullScreen?: () => Promise<void>;
+	webkitFullscreenElement?: Element;
+	webkitFullscreenEnabled?: boolean;
+	webkitExitFullscreen?: () => Promise<void>;
+}
+interface DocumentElementWithFullscreen extends HTMLElement {
+	msRequestFullscreen?: () => Promise<void>;
+	mozRequestFullScreen?: () => Promise<void>;
+	webkitRequestFullscreen?: () => Promise<void>;
+}
+export declare const requestFullscreen: (element: DocumentElementWithFullscreen) => Promise<void>;
+export declare const exitFullscreen: (doc: DocumentWithFullscreen) => Promise<void>;
+export declare const isSupported: (doc: DocumentWithFullscreen, isIOS?: boolean) => boolean;
+export declare const exitIosSafariVideoElementFullscreen: (videoElement: HTMLVideoElement) => void;
+export declare const getDocumentFullscreenElement: () => Element | undefined;
+export declare const checkIsFullscreen: () => boolean;
+export declare const registerFullscreenChangeEvent: (callback: () => void) => void;
+export declare const removeFullscreenChangeEvent: (callback: () => void) => void;
+export declare const requestLockScreenOrientation: (videoSize?: {
+	width: number;
+	height: number;
+}) => Promise<void>;
+export {};

package/types/utils/getActualEpisode.d.ts

@@ -0,0 +1,10 @@
+import type { IVideoEpisode } from "../types";
+/**
+* Функция для получения актуального (текущего) воспроизводимого эпизода
+
+* @param progress - вещественное число от 0 до 1. Отображает процент прогрессии видео
+* @param duration - общая продолжительность видеоролика
+* @param videoEpisodes - массив размеченных эпизодов с временными метками
+* @return {IVideoEpisode|undefined} - актуальный эпизод, если он есть, или undefined
+*/
+export declare const getActualEpisode: (progress: number, duration: number, videoEpisodes: IVideoEpisode[]) => IVideoEpisode | undefined;

package/types/utils/getControlInfo.d.ts

@@ -0,0 +1,5 @@
+import type { IControlInfo } from "../types";
+export declare function getControlInfo<
+	TRefKey extends string,
+	Refs extends Record<TRefKey, HTMLElement | undefined>
+>(parentElement: HTMLElement | null, refs: Refs, key: TRefKey, show: boolean): IControlInfo;

package/types/utils/getHotKeyMapData.d.ts

@@ -0,0 +1,2 @@
+import type { HotKeyMapData } from "../types";
+export declare const getHotKeyMapData: () => HotKeyMapData;

package/types/utils/grid.d.ts

@@ -0,0 +1,6 @@
+import { GridTypes } from "../constans";
+export declare const isHigher: (a: GridTypes, b: GridTypes) => boolean;
+export declare const isHigherOrEqual: (a: GridTypes, b: GridTypes) => boolean;
+export declare const isLower: (a: GridTypes, b: GridTypes) => boolean;
+export declare const isLowerOrEqual: (a: GridTypes, b: GridTypes) => boolean;
+export declare const getGridTypeByWidth: (width: number) => GridTypes;

package/types/utils/hooks/useIosSafariFullscreen.d.ts

@@ -0,0 +1,6 @@
+interface Params {
+	getFullscreenTarget: () => HTMLElement;
+	fullScreenChangeHandler: (forced?: boolean) => void;
+}
+export declare const useIosSafariFullscreen: ({ getFullscreenTarget, fullScreenChangeHandler }: Params) => void;
+export {};

package/types/utils/hooks/useIosSafariFullscreenSubtitles.d.ts

@@ -0,0 +1,7 @@
+import type { IStore } from "../../store";
+interface Params {
+	store: IStore;
+	getFullscreenTarget: () => HTMLElement;
+}
+export declare const useIosSafariFullscreenSubtitles: ({ store, getFullscreenTarget }: Params) => void;
+export {};

package/types/utils/keyboardHandleCases.d.ts

@@ -0,0 +1,2 @@
+import type { Writable } from "svelte/store";
+export declare const handleStartedByKeyboard: (startedByKeyboard$: Writable<boolean>, startedByKeyboard: boolean, btnRef: HTMLElement | undefined) => Promise<void>;

package/types/utils/landscapeUtils.d.ts

@@ -0,0 +1 @@
+export declare const isVertical: (angle: number) => boolean;

package/types/utils/notificationShowManager.d.ts

@@ -0,0 +1,10 @@
+type Check = {
+	notificationShowed: (notificationId: string) => void;
+	canShowNotification: (notificationId: string) => boolean;
+};
+type Settings = {
+	timeout: number;
+	maxShowCount: number;
+};
+export declare const getNotificationManager: ({ maxShowCount, timeout }: Settings) => Check;
+export {};

package/types/utils/roundFps.d.ts

@@ -0,0 +1 @@
+export declare const roundFps: (fps: number) => number | "";

package/types/utils/sanitizeHtml.d.ts

@@ -0,0 +1,5 @@
+/**
+* Помогает защитится от XSS атак
+* @param html string
+*/
+export declare const sanitizeHtml: (html: string) => string;

package/types/utils/sorts.d.ts

@@ -0,0 +1,5 @@
+export declare const sortByWeightAsc: (a: {
+	weight: number;
+}, b: {
+	weight: number;
+}) => number;

package/types/utils/stack/index.d.ts

@@ -0,0 +1,9 @@
+export declare class StackFixedSize {
+	private top;
+	private bottom;
+	private size;
+	private readonly maxSize;
+	constructor(maxSize: number);
+	push(value: number): void;
+	getValuesFromBottom(): number[];
+}

package/types/utils/stack/node.d.ts

@@ -0,0 +1,5 @@
+export declare class StackNode {
+	value: number;
+	next: StackNode | null;
+	constructor(value: number);
+}

package/types/utils/subtitleLanguages.d.ts

@@ -0,0 +1,3 @@
+export declare const subtitleLanguages: Record<string, string>;
+export declare const iso3LettersTo2: Record<string, keyof typeof subtitleLanguages>;
+export declare const getLanguageName: (code: string) => string | undefined;

package/types/utils/subtitles.d.ts

@@ -0,0 +1,10 @@
+import type { ITextTrack } from "@vkontakte/videoplayer-core";
+export declare class NativeSubtitles {
+	private readonly video;
+	constructor(video: HTMLVideoElement);
+	private getTracksArray;
+	attach(track: ITextTrack, showing?: boolean): void;
+	detachAll(): void;
+	updateSrc(track: ITextTrack): void;
+	getCurrentShowingId(): string | null;
+}

package/types/utils/timeout.d.ts

@@ -0,0 +1,4 @@
+export declare const createTimeout: (delayMs?: number) => {
+	add: (fn: VoidFunction) => void;
+	clear: () => void;
+};

package/types/utils/updatePlayerControlBlocks.d.ts

@@ -0,0 +1,3 @@
+import type { ControlBlocksRefs } from "../types";
+import { type IUIState } from "../store";
+export declare const updateControlBlocks: (videoElement: HTMLVideoElement | null, controlBlocks: IUIState["controlBlocks"], controlBlocskRef: ControlBlocksRefs, showControlBlock: boolean) => void;

package/types/utils/updatePlayerControlsInfo.d.ts

@@ -0,0 +1,3 @@
+import type { IPlayerControlsRef } from "../types";
+import { type IUIState } from "../store";
+export declare const updatePlayerControlsInfo: (videoElement: HTMLVideoElement | null, controls: IUIState["controls"], controlsRef: IPlayerControlsRef, showControls: boolean) => void;

package/types/utils/userSettings.d.ts

@@ -0,0 +1,58 @@
+import type { VideoQuality } from "@vkontakte/videoplayer-shared";
+import { type PlaybackRate } from "@vkontakte/videoplayer-core";
+export declare const savePreferredVolume: (volume: number) => void;
+export declare const getPreferredVolume: () => number | undefined;
+export declare const savePreferredQuality: (videoId: number | undefined, value: VideoQuality) => void;
+export declare const deletePreferredQuality: () => void;
+export declare const getPreferredQuality: (currentVideoId: number | undefined) => VideoQuality | undefined;
+export declare const savePreferMute: (preferMute: boolean) => void;
+export declare const getPreferMute: () => boolean;
+export declare const savePreferTrafficSavingEnabled: (trafficSavingEnabled: boolean) => void;
+export declare const getPreferTrafficSavingEnabled: () => boolean;
+export declare const getPreferredStreamLanguage: () => string | null;
+export declare const savePreferredStreamLanguage: (language: string) => void;
+export declare const getPreferredSubtitlesLanguage: () => string | null;
+export declare const savePreferredSubtitlesLanguage: (language?: string) => void;
+export declare const savePreferredRate: (rate: PlaybackRate) => void;
+export declare const getPreferredRate: () => PlaybackRate | undefined;
+export declare const savePreferredAutoplayNext: (autoplayNext: boolean) => void;
+export declare const getPreferredAutoplayNext: () => boolean;
+export type PreferredQualitySettingsType = "traffic_saving" | "high_quality" | "auto_quality" | "exact_video";
+export type PreferredQualitySettingsValue = {
+	type: Exclude<PreferredQualitySettingsType, "exact_video">;
+	videoId?: number;
+} | {
+	type: "exact_quality";
+	quality: VideoQuality;
+	videoId?: number;
+};
+export type DefaultPreferredQualitySettingsValue = Exclude<PreferredQualitySettingsValue, {
+	type: "exact_quality";
+}>;
+export type QualitySettingsAppliesTo = "as-default" | "to-video";
+export declare const getPreferredQualitySettings: (videoId: number | undefined) => (PreferredQualitySettingsValue & {
+	appliesTo: QualitySettingsAppliesTo;
+}) | null;
+export declare const migrateSettingsToLegacyWay: (videoId?: number) => void;
+export declare const savePreferredQualitySettings: (value: PreferredQualitySettingsValue, appliesTo?: QualitySettingsAppliesTo) => void;
+export declare const savePreferredDefaultQualitySettings: (value: DefaultPreferredQualitySettingsValue) => void;
+export declare const removePreferredQualitySettingsByVideo: () => void;
+export declare const getPreferredDefaultQualitySettings: () => DefaultPreferredQualitySettingsValue | null;
+type IUserSalt = string & {};
+type IVideoId = string & {};
+export interface IVideoPrefs {
+	[userSalt: IUserSalt]: IVideoPrefsUser;
+}
+export interface IVideoPrefsUser {
+	[videoId: IVideoId]: IVideoPrefsUserVideo;
+}
+export interface IVideoPrefsUserVideo {
+	updatedTs: number;
+	subtitleTrackId?: string;
+	audioTrackId?: string;
+}
+export declare const getUserVideoPrefs: (userSalt: IUserSalt, videoId: IVideoId) => IVideoPrefsUserVideo | null;
+export declare const saveUserVideoPrefs: (userSalt: IUserSalt, videoId: IVideoId, settings: Omit<IVideoPrefsUserVideo, "updatedTs">) => void;
+export declare function markPreviewTrackCloseTooltipAsShown(): void;
+export declare function previewTrackCloseTooltipShown(): boolean;
+export {};

package/types/utils/videoConfig.d.ts

@@ -0,0 +1,6 @@
+import type { IVKVideoPlayerConfig } from "../types";
+export declare function overrideVideoConfig<
+	Base extends Partial<IVKVideoPlayerConfig>,
+	Override extends Partial<IVKVideoPlayerConfig>,
+	Key extends keyof Partial<IVKVideoPlayerConfig>
+>(base: Base, override: Override): Base & Override;

package/types/utils/volumeChange.d.ts

@@ -0,0 +1,5 @@
+import type { IStore } from "../store";
+export declare const getNextVolumeUp: (currentVolume: number, step: number) => number;
+export declare const getNextVolumeDown: (currentVolume: number, step: number) => number;
+export declare const volumeDiscreteChangeUp: (store: IStore, currentVolume: number, step: number) => void;
+export declare const volumeDiscreteChangeDown: (store: IStore, currentVolume: number, step: number) => void;

package/types/utils/webAPI/annotationsApi/annotationsApi.d.ts

@@ -0,0 +1,34 @@
+import type { IAnnotationsApi } from "../../../types";
+/**
+* @deprecated Использовать slotsApi.
+*/
+export declare class AnnotationsApi implements IAnnotationsApi {
+	private annotationsInside;
+	private rootAnnotationsContainer;
+	private annotations;
+	private subscriptions;
+	private mutationObserver;
+	private playerSize;
+	constructor(annotationsInside: boolean);
+	init(container: HTMLElement): void;
+	add(annotationName: string, annotation: HTMLElement): void | never;
+	get(annotationName: string): HTMLElement | never;
+	remove(annotationName: string): void | never;
+	clear(): void;
+	destroy(): void;
+	private isElementExceedsBoundaries;
+	/** @deprecated Больше не используется. Контейнер теперь определяется самостоятельно */
+	registryRootContainer(container: HTMLElement): void;
+	/** @deprecated Логики со слоями больше нет. Теперь все аннотации добавляются на единый общий слой */
+	addLayer(layerName: string): HTMLElement | never;
+	/** @deprecated Логики со слоями больше нет. Теперь все аннотации добавляются на единый общий слой */
+	getLayer(layerName: string): HTMLElement | undefined;
+	/** @deprecated Логики со слоями больше нет. Теперь все аннотации добавляются на единый общий слой */
+	removeLayer(layerName: string): void;
+	/** @deprecated Логики со слоями больше нет. Теперь все аннотации добавляются на единый общий слой */
+	clearLayer(layerName: string): void;
+	/** @deprecated Метод больше не является публичным */
+	detach(): void;
+	/** @deprecated Больше нет необходимости переназначать контейнер для аннотаций в ходе работы плеера */
+	reattach(): void;
+}

package/types/utils/webAPI/annotationsApi/errors.d.ts

@@ -0,0 +1,7 @@
+export declare const ANNOTATION_EMPTY_ROOT_CONTAINER_ERROR = "Inner error. Unexpectedly root annotation container null reference exception";
+export declare const ANNOTATION_ALREADY_EXIST_ERROR = "Annotation with such name already exists";
+export declare const ANNOTATION_DOESNT_EXIST_ERROR = "Annotation with such name does not exist";
+export declare const ANNOTATION_EXCEED_PLAYER_LIMITS_ERROR = "Annotation exceed player boundaries";
+export declare class AnnotationsError extends Error {
+	constructor(message: string);
+}

package/types/utils/webAPI/focusLock.d.ts

@@ -0,0 +1,34 @@
+export interface FocusableElement extends HTMLElement {
+	disabled?: boolean;
+	href?: string;
+	tabIndex: number;
+}
+export declare class FocusLock {
+	private getActiveElement;
+	private focusableElements;
+	private isActive;
+	private container;
+	constructor(getActiveElement: () => HTMLElement | null);
+	/**
+	* Активирует захват фокуса
+	*/
+	activate(): void;
+	/**
+	* Деактивирует захват фокуса
+	*/
+	deactivate(): void;
+	/**
+	* Обновляет список фокусируемых элементов
+	*/
+	updateFocusableElements(): void;
+	/**
+	* Получает все фокусируемые элементы внутри контейнера
+	*/
+	private getFocusableElements;
+	/**
+	* Обработчик клавиши Tab
+	*/
+	private handleTabKey;
+	destroy(): void;
+	setContainer(container: HTMLElement): void;
+}

package/types/utils/webAPI/focusManager.d.ts

@@ -0,0 +1,17 @@
+export declare class FocusManager {
+	private shadowRoot;
+	private lastFocusedNode;
+	private focusLock;
+	constructor(shadowRoot: ShadowRoot);
+	private init;
+	private handleFocusChange;
+	/**
+	* Восстанавливает фокус на последнем сфокусированном элементе в плеере.
+	*/
+	restoreFocus: () => void;
+	destroy(): void;
+	getLastFocusedNode(): HTMLElement | null;
+	activateLock(): void;
+	deactivateLock(): void;
+	setContainerForFocusLock(container: HTMLElement): void;
+}

package/types/utils/webAPI/language.d.ts

@@ -0,0 +1,2 @@
+import type { InterfaceLanguage } from "@vkontakte/videoplayer-shared";
+export declare const selectNavigatorLanguage: (available: InterfaceLanguage[]) => InterfaceLanguage | undefined;

package/types/utils/webAPI/mediaSessionApi.d.ts

@@ -0,0 +1,16 @@
+import type { MediaSessionApiActionHandler, MediaSessionApiMetadata } from "../../types";
+import type { IStore } from "../../store";
+export declare class MediaSessionApi {
+	private subscription;
+	private readonly logger;
+	private readonly log;
+	constructor();
+	isSupported(): boolean;
+	setMetaData({ title, artist, thumbUrl }: MediaSessionApiMetadata): void;
+	updateActionHandlers(actionHandlers: MediaSessionApiActionHandler[]): void;
+	private resetActionHandlers;
+	private setActionHandlers;
+	attachToStore(store?: IStore): void;
+	clearSubscriptions(): void;
+	destroy(): void;
+}

package/types/utils/webAPI/pictureInPictureApi/documentPictureInPictureApi.svelte.d.ts

@@ -0,0 +1,47 @@
+import { ValueSubject } from "@vkontakte/videoplayer-shared";
+import type { IDpipConfig } from "../../../config";
+import type { ExternalPictureInPictureEventHandlers, IPictureInPictureApi, PictureInPictureSettings } from "../../../types";
+import { PictureInPictureType } from "../../../types";
+export declare class DocumentPictureInPictureApiSvelte implements IPictureInPictureApi {
+	readonly settings: PictureInPictureSettings;
+	private playerDomElement;
+	private playerParentShadowRoot;
+	private playerDummyElement;
+	private svelteContext;
+	private pipWindow;
+	info: {
+		isActive$: ValueSubject<boolean>;
+		isEnabled$: ValueSubject<boolean>;
+		type: PictureInPictureType;
+	};
+	/**
+	* Обычный pip может быть открыт браузером через медиа-сессию
+	*/
+	private pipActive;
+	private readonly pipApi;
+	constructor(settings: PictureInPictureSettings);
+	get dpipConfig(): IDpipConfig;
+	/**
+	* Флаг показывает, есть ли в целом возможность использовать dpip в данном браузере, поддерживается ли это.
+	*/
+	isSupported(): boolean;
+	/**
+	* Флаг показывает, находится ли пользователь в режиме dpip.
+	*/
+	isActive(): boolean;
+	setPlayerDomElement(playerDomElement: HTMLElement, playerParentShadowRoot: ShadowRoot): void;
+	setContext(svelteContext: Map<unknown, unknown>): void;
+	request(): Promise<void>;
+	exit(): Promise<void>;
+	dispose(): Promise<void>;
+	/**
+	* Флаг определяет может ли пользователь переходить в dpip на уровне бизнес логике.
+	*/
+	setEnabled(enabled: boolean): void;
+	assignPlayerContainer(playerContainer: HTMLElement): void;
+	updateVideoElement(): void;
+	setExternalEventHandlers(externalEventHandlers: ExternalPictureInPictureEventHandlers): void;
+	private get initialSize();
+	private createStretchedContainer;
+}
+export declare function isInstanceOfDocumentPictureInPictureApi(pictureInPictureApi?: IPictureInPictureApi): pictureInPictureApi is DocumentPictureInPictureApiSvelte;

package/types/utils/webAPI/pictureInPictureApi/factory.d.ts

@@ -0,0 +1,3 @@
+import type { IDpipConfig } from "../../../config";
+import type { IPictureInPictureApi } from "../../../types";
+export declare const createPiPApi: (initiallyEnabled: boolean, dpipConfig?: IDpipConfig | boolean) => IPictureInPictureApi | undefined;

package/types/utils/webAPI/pictureInPictureApi/index.d.ts

@@ -0,0 +1,4 @@
+export { isInstanceOfDocumentPictureInPictureApi } from "./documentPictureInPictureApi.svelte";
+export { isInstanceOfPictureInPictureApi } from "./pictureInPictureApi";
+export { createPiPApi } from "./factory";
+export { isPiPSupported, isDpipSupported } from "./utils";

package/types/utils/webAPI/pictureInPictureApi/pictureInPictureApi.d.ts

@@ -0,0 +1,49 @@
+import { ValueSubject } from "@vkontakte/videoplayer-shared";
+import type { ExternalPictureInPictureEventHandlers, IPictureInPictureApi, PictureInPictureSettings } from "../../../types";
+import { PictureInPictureType } from "../../../types";
+export declare class PictureInPictureApi implements IPictureInPictureApi {
+	private isRequested;
+	private videoElement;
+	private playerContainer;
+	private svelteContext;
+	private externalEventHandlers;
+	private readonly eventHandlers;
+	info: {
+		isActive$: ValueSubject<boolean>;
+		isEnabled$: ValueSubject<boolean>;
+		type: PictureInPictureType;
+	};
+	constructor({ enabled }: PictureInPictureSettings);
+	/**
+	* Флаг показывает, есть ли в целом возможность использовать pip в данном браузере, поддерживается ли это.
+	*/
+	isSupported(): boolean;
+	/**
+	* Флаг показывает, находится ли пользователь в режиме pip.
+	*/
+	isActive(): boolean;
+	setContext(svelteContext: Map<unknown, unknown>): void;
+	revealPictureInPicture(): Promise<void>;
+	request(): Promise<void>;
+	exit(): Promise<void>;
+	assignPlayerContainer(playerContainer: HTMLElement): void;
+	updateVideoElement(): void;
+	private addEventHandlers;
+	setExternalEventHandlers(externalEventHandlers: ExternalPictureInPictureEventHandlers): void;
+	private removeEventHandlers;
+	dispose(): Promise<void>;
+	private onEnterPictureInPicture;
+	private onLeavePictureInPicture;
+	private onResize;
+	/**
+	* Флаг определяет может ли пользователь переходить в pip на уровне бизнес логике.
+	*/
+	setEnabled(enabled: boolean): void;
+	/**
+	* для сафари нужно корректно обновить состояние пипа, потому что если мы попали сюда
+	* из за креша провайдера + клика на выход из пип-а, то сафари может не успеть прислать
+	* leavepictureinpicture на старый элемент из за чего UI застрянет в неправильном состоянии
+	*/
+	private waitForSafariLeavePictureInPicture;
+}
+export declare function isInstanceOfPictureInPictureApi(pictureInPictureApi?: IPictureInPictureApi): pictureInPictureApi is PictureInPictureApi;

package/types/utils/webAPI/pictureInPictureApi/types.d.ts

@@ -0,0 +1,6 @@
+import type { DebouncedFn } from "@vkontakte/videoplayer-shared";
+export interface PictureInPictureEventHandlers {
+	enterpictureinpicture: (event: Event) => void;
+	leavepictureinpicture: (event?: Event) => void;
+	resize: DebouncedFn<(event: Event) => void>;
+}

package/types/utils/webAPI/pictureInPictureApi/utils.d.ts

@@ -0,0 +1,10 @@
+import { type SafeAny } from "@vkontakte/videoplayer-shared";
+import type { PictureInPictureResizeEvent } from "../../../types";
+import type { IDpipConfig } from "../../../config";
+export declare const isPiPSupported: () => boolean;
+export declare const isDpipSupported: () => boolean;
+export declare const isPiPEvent: (e: SafeAny) => e is PictureInPictureEvent;
+export declare const isPiPResizeEvent: (e: Event) => e is PictureInPictureResizeEvent;
+export declare const isDpipEnabledByConfig: (value?: IDpipConfig | boolean) => boolean;
+export declare const styleSheetToString: (styleSheet: CSSStyleSheet) => string;
+export declare const createStyleNode: (textContent: string, id: string) => Node;

package/types/utils/webAPI/slotsApi.d.ts

@@ -0,0 +1,53 @@
+import type { IStore } from "../../store";
+import type { IPlayerControlsRef } from "../../types";
+/**
+* Если смотреть по порядку расположения типов, то чем дальше тип, тем выше у него zIndex.
+*
+* over_video - слот будет находиться над видео;
+* over_controls - слот будет находиться над контролами, но под меню настроек.
+*/
+export type SlotOverlay = "over_video" | "over_controls";
+export declare const SLOT_NAME = "annotation";
+export type HideControlsWhenIntersectedOptions = {
+	observedSlotElementId: string;
+	controlsToObserve: (keyof IPlayerControlsRef)[];
+};
+type AddOptions = {
+	id: string;
+	overlay: SlotOverlay;
+	hideAllControls?: boolean;
+	controlsBehaviour?: HideControlsWhenIntersectedOptions;
+};
+type AddReturnType = {
+	success: true;
+} | {
+	success: false;
+	message: string;
+};
+export declare class SlotsApi {
+	private shadowRootContainer;
+	private slots;
+	private store;
+	private disabledIds;
+	constructor(disabledIds: string[]);
+	init(shadowRootContainer: HTMLElement, store: IStore | undefined): void;
+	add(elementParam: HTMLElement | (() => HTMLElement), options: AddOptions): AddReturnType;
+	private setupSlotStyles;
+	/**
+	* Запускаем отслеживание пересечения между переданным элементом внутри слота и контролами.
+	*/
+	private runHidingControlsWhenIntersected;
+	/**
+	* Ищем внутри рутового элемента слота элемент, с которым хотим отслеживать пересечение контролов.
+	* Приходится делать через mutationObserver, так как данный элемент в силу асинхронной работы внешнего
+	* фреймворка может появиться позже.
+	* @param slotRootElement Рутовый элемент слота.
+	* @param slotElementId Идентификатор элемента внутри слота, с которым хотим отслеживать пересечение контролов.
+	* @param slotId Идентификатор слота.
+	*/
+	private findSlotElement;
+	remove(id: string): void;
+	destroy(): void;
+	haveSlots(): boolean;
+}
+export {};