@vkontakte/videoplayer-interactive 1.0.39-dev.de950202.0 → 1.0.39-dev.f4da114d.0

package/types/modules/Interactives/Interactives.d.ts

@@ -95,12 +95,16 @@ export declare class Interactives {
      *
      * Контрол считается удалённым, если его флаг `isRemoved` установлен в `true`.
      * Однако, есть исключение для `openURI` — если с ним было взаимодействие, он
-     * получит `isRemoved = true`, но может оставаться в DOM до завершения эпизода (`endTime`).
+     * получит `isRemoved = true`, но может оставаться в DOM до завершения эпизода
+     * (`endTime`).
      *
-     * Из-за этого метод может вернуть `true` (что все контроллы "удалены"),
-     * хотя `openURI` всё ещё присутствует в DOM.
+     * Из-за этого метод может вернуть `true` (что все контроллы "удалены"), хотя
+     * `openURI` всё ещё присутствует в DOM.
+     *
+     * includeWillRemovedState - нужно ли считать состояние 'willRemoved' как
+     * 'removed'
      */
-    allControlsAreRemoved(): boolean;
+    allControlsAreRemoved(includeWillRemovedState?: boolean): boolean;
     isEndedExpectation(): boolean;
     playPrevChapter(): void;
     setDisabledControls(value: boolean): void;

package/types/modules/Interactives/containers/ChoiceContainer.d.ts

@@ -1,25 +1,28 @@
-import { Subject } from '@vkontakte/videoplayer-shared';
 import { Container } from './Container';
 import { ChapterContainer } from '../../../manifest';
 import type { ChoiceContainerOptions, ContainerCreateViewParams } from './types';
-import { CustomError } from '../../../utils/Error';
 import { Nullable } from '@vkontakte/videoplayer-shared';
 export declare const createChoiceContainer: (container: ChapterContainer, rootElement: HTMLElement, options?: ChoiceContainerOptions) => ChoiceContainer | undefined;
 export declare class ChoiceContainer extends Container {
     private rootElement;
     private containerElement;
     private layout;
-    private controlSubscriptions;
+    private subscriptions;
     isRemoved: boolean;
     isDisabled: boolean;
-    error$: Subject<CustomError>;
+    willRemoved: boolean;
     constructor(container: ChapterContainer, rootElement: HTMLElement, options?: ChoiceContainerOptions);
-    createView({ eventCallback }: ContainerCreateViewParams): HTMLElement;
+    createView({ eventCallback, videoDurationMs }: ContainerCreateViewParams): HTMLElement;
+    updateControlsFillAnimationDimensions(): void;
     hide(): void;
     show(): void;
     enable(): void;
     disable(): void;
-    removeView(): void;
+    removeView(withTransition?: boolean, useDelay?: boolean): void;
+    private onTransitionEnd;
+    removeAllControls(withTransition?: boolean): void;
+    removeNonInteractedControls(withTransition?: boolean): void;
+    isInteracted(): boolean;
     fakeRemove(): void;
     getElement(): Nullable<HTMLElement>;
     onProgress(currentTimeMs: number, isInteractiveTime: boolean): void;

package/types/modules/Interactives/containers/Container.d.ts

@@ -1,3 +1,5 @@
+import { Subject } from '@vkontakte/videoplayer-shared';
+import { CustomError } from '../../../utils/Error';
 import type { ChapterContainer } from '../../../manifest';
 import { type Control, type ControlCreator, type Options } from '../../../modules/Interactives/controls';
 import { type ChoiceContainerOptions } from './types';
@@ -6,8 +8,10 @@ export declare class Container {
     options?: Options;
     private factories;
     controls: Control[];
+    error$: Subject<CustomError>;
     constructor(container: ChapterContainer, options?: Options);
     featureIsEnabled(name: keyof ChoiceContainerOptions['features']): boolean | undefined;
+    onError(message: string | undefined, error: unknown): void;
     addControlFactory(type: string, factory: ControlCreator<any>): void;
     removeControlFactory(type: string): void;
     private setControls;

package/types/modules/Interactives/containers/types.d.ts

@@ -2,9 +2,10 @@ import { Options, ControlEventCallback } from '../controls';
 import { AnimationsFeatureToggles } from '../types';
 export type ChoiceContainerOptions = {
     isTouch: boolean;
-    features: Pick<AnimationsFeatureToggles, 'controlsExpectTimeBlinkAnimation' | 'controlsTapPlace'>;
+    features: Pick<AnimationsFeatureToggles, 'controlsExpectTimeBlinkAnimation' | 'controlsTapPlace' | 'controlsFillAnimation'>;
 };
 export declare function isChoiceContainerOptions(options: Options): options is ChoiceContainerOptions;
 export type ContainerCreateViewParams = {
     eventCallback: ControlEventCallback;
+    videoDurationMs: number;
 };

package/types/modules/Interactives/controls/AreaControl.d.ts

@@ -4,7 +4,7 @@ export declare const createAreaControl: ControlCreator<ControlOptions, AreaContr
 declare class AreaControl extends Control {
     constructor(control: TControl, options?: ControlOptions);
     createView({ parentElement, callbacks }: ControlCreateViewParams): void;
-    registerEvents(): void;
+    registerBlinkAnimationEvents(): void;
     disable(): void;
     enable(): void;
     getElement(): import("@vkontakte/videoplayer-shared").Nullable<HTMLElement>;
@@ -12,6 +12,8 @@ declare class AreaControl extends Control {
     toggleBlinkAnimation(enable?: boolean): void;
     syncBlinkAnimation(refAnim: HTMLElement): void;
     onBlinkHovering(): void;
+    setShowTimeRange(): void;
+    updateFillAnimationDimensions(): void;
     onProgress(): void;
     onResize(): void;
 }

package/types/modules/Interactives/controls/ButtonControl.d.ts

@@ -1,17 +1,23 @@
 import { Control } from './Control';
 import { type ControlCreator, type ControlCreateViewParams, type TControl, type ControlOptions } from './types';
+import { ControlFillAnimation } from '../utils/ControlFillAnimation';
 export declare const createButtonControl: ControlCreator<ControlOptions, ButtonControl>;
 declare class ButtonControl extends Control {
+    startTime?: number;
+    endTime?: number;
+    controlFillAnimation?: ControlFillAnimation;
     constructor(control: TControl, options?: ControlOptions);
     createView({ parentElement, callbacks }: ControlCreateViewParams): void;
-    registerEvents(): void;
+    registerBlinkAnimationEvents(): void;
     disable(): void;
     enable(): void;
     getElement(): import("@vkontakte/videoplayer-shared").Nullable<HTMLElement>;
     toggleBlinkAnimation(enable?: boolean): void;
     syncBlinkAnimation(refAnim: HTMLElement): void;
     onBlinkHovering(): void;
-    onProgress(): void;
+    updateFillAnimationDimensions(): void;
+    setShowTimeRange(startTime: number, endTime: number): void;
+    onProgress(currentTime: number): void;
     onResize(): void;
     updateShadowStyles(): void;
 }

package/types/modules/Interactives/controls/Control.d.ts

@@ -1,8 +1,7 @@
-import { Subject, Subscription, ValueSubject } from '@vkontakte/videoplayer-shared';
+import { Subject, Subscription, Nullable } from '@vkontakte/videoplayer-shared';
+import { CustomError } from '../../../utils/Error';
 import { ControlTap } from '../utils/ControlTap';
 import type { ControlEventCallback, ControlCreateViewParams, Dimensions, Callbacks, Options, TControl, ControlOptions } from './types';
-import { CustomError } from '../../../utils/Error';
-import { Nullable } from '@vkontakte/videoplayer-shared';
 type ControlContainer = {
     element: HTMLElement;
     dimensions: Dimensions;
@@ -16,8 +15,9 @@ export declare abstract class Control {
     controlElement: Nullable<HTMLElement>;
     subscriptions: Subscription;
     error$: Subject<CustomError>;
-    isInteracted$: ValueSubject<boolean>;
     controlTap?: ControlTap;
+    isInteracted: boolean;
+    isRemoved: boolean;
     constructor(control: TControl, options?: Options | undefined);
     abstract createView(params: ControlCreateViewParams): void;
     abstract getElement(): Nullable<HTMLElement>;
@@ -25,8 +25,13 @@ export declare abstract class Control {
     abstract enable(): void;
     abstract onProgress(currentTimeMs: number): void;
     abstract onResize(): void;
+    abstract setShowTimeRange(startTime: number, endTime: number): void;
+    abstract updateFillAnimationDimensions(): void;
     abstract updateShadowStyles(isDark?: boolean): void;
     abstract toggleBlinkAnimation(enable?: boolean): void;
+    onControlSelect: () => void;
+    removeView(withTransition?: boolean): void;
+    onTransitionEnd: (event: TransitionEvent) => void;
     onError(message: string | undefined, error: unknown): void;
     addControlTap(controlElement: HTMLElement): void;
     createContainerElement(callbacks: Callbacks): void;

package/types/modules/Interactives/controls/TextControl.d.ts

@@ -11,6 +11,7 @@ declare class TextControl extends Control {
     onResize(): void;
     updateShadowStyles(): void;
     toggleBlinkAnimation(): void;
-    onError(): void;
+    setShowTimeRange(): void;
+    updateFillAnimationDimensions(): void;
 }
 export {};

package/types/modules/Interactives/controls/types.d.ts

@@ -23,7 +23,7 @@ export type ControlCreateViewParams = {
 export type Options = Record<string, unknown>;
 export type ControlOptions = {
     isTouch: boolean;
-    features: Pick<AnimationsFeatureToggles, 'controlsExpectTimeBlinkAnimation' | 'controlsTapPlace'>;
+    features: Pick<AnimationsFeatureToggles, 'controlsExpectTimeBlinkAnimation' | 'controlsTapPlace' | 'controlsFillAnimation'>;
 };
 export declare function isControlOptions(options: Options): options is ControlOptions;
 type ControlEventCallbackParams = {

package/types/modules/Interactives/index.d.ts

@@ -9,7 +9,7 @@ export declare const utils: {
     createChoiceContainer: (container: import("@interactiveplatform/movika-manifest").ChapterContainer, rootElement: HTMLElement, options?: import("./containers/types").ChoiceContainerOptions) => import("./containers/ChoiceContainer").ChoiceContainer | undefined;
     createAreaControl: import("./controls").ControlCreator<import("./controls").ControlOptions, {
         createView({ parentElement, callbacks }: import("./controls").ControlCreateViewParams): void;
-        registerEvents(): void;
+        registerBlinkAnimationEvents(): void;
         disable(): void;
         enable(): void;
         getElement(): import("@vkontakte/videoplayer-shared").Nullable<HTMLElement>;
@@ -17,6 +17,8 @@ export declare const utils: {
         toggleBlinkAnimation(enable?: boolean): void;
         syncBlinkAnimation(refAnim: HTMLElement): void;
         onBlinkHovering(): void;
+        setShowTimeRange(): void;
+        updateFillAnimationDimensions(): void;
         onProgress(): void;
         onResize(): void;
         container: import("@vkontakte/videoplayer-shared").Nullable<{
@@ -27,10 +29,14 @@ export declare const utils: {
         controlElement: import("@vkontakte/videoplayer-shared").Nullable<HTMLElement>;
         subscriptions: import("@vkontakte/videoplayer-shared").Subscription;
         error$: import("@vkontakte/videoplayer-shared").Subject<import("../..").CustomError>;
-        isInteracted$: import("@vkontakte/videoplayer-shared").ValueSubject<boolean>;
         controlTap?: import("./utils/ControlTap").ControlTap;
+        isInteracted: boolean;
+        isRemoved: boolean;
         control: import("@interactiveplatform/movika-manifest/dist/chapter-DI_7rDZW").e;
         options?: import("./controls").Options | undefined;
+        onControlSelect: () => void;
+        removeView(withTransition?: boolean): void;
+        onTransitionEnd: (event: TransitionEvent) => void;
         onError(message: string | undefined, error: unknown): void;
         addControlTap(controlElement: HTMLElement): void;
         createContainerElement(callbacks: import("./controls").Callbacks): void;
@@ -41,15 +47,20 @@ export declare const utils: {
         removeListeners(): void;
     }>;
     createButtonControl: import("./controls").ControlCreator<import("./controls").ControlOptions, {
+        startTime?: number;
+        endTime?: number;
+        controlFillAnimation?: import("./utils/ControlFillAnimation").ControlFillAnimation;
         createView({ parentElement, callbacks }: import("./controls").ControlCreateViewParams): void;
-        registerEvents(): void;
+        registerBlinkAnimationEvents(): void;
         disable(): void;
         enable(): void;
         getElement(): import("@vkontakte/videoplayer-shared").Nullable<HTMLElement>;
         toggleBlinkAnimation(enable?: boolean): void;
         syncBlinkAnimation(refAnim: HTMLElement): void;
         onBlinkHovering(): void;
-        onProgress(): void;
+        updateFillAnimationDimensions(): void;
+        setShowTimeRange(startTime: number, endTime: number): void;
+        onProgress(currentTime: number): void;
         onResize(): void;
         updateShadowStyles(): void;
         container: import("@vkontakte/videoplayer-shared").Nullable<{
@@ -60,10 +71,14 @@ export declare const utils: {
         controlElement: import("@vkontakte/videoplayer-shared").Nullable<HTMLElement>;
         subscriptions: import("@vkontakte/videoplayer-shared").Subscription;
         error$: import("@vkontakte/videoplayer-shared").Subject<import("../..").CustomError>;
-        isInteracted$: import("@vkontakte/videoplayer-shared").ValueSubject<boolean>;
         controlTap?: import("./utils/ControlTap").ControlTap;
+        isInteracted: boolean;
+        isRemoved: boolean;
         control: import("@interactiveplatform/movika-manifest/dist/chapter-DI_7rDZW").e;
         options?: import("./controls").Options | undefined;
+        onControlSelect: () => void;
+        removeView(withTransition?: boolean): void;
+        onTransitionEnd: (event: TransitionEvent) => void;
         onError(message: string | undefined, error: unknown): void;
         addControlTap(controlElement: HTMLElement): void;
         createContainerElement(callbacks: import("./controls").Callbacks): void;

package/types/modules/Interactives/types.d.ts

@@ -19,6 +19,8 @@ export type AnimationsFeatureToggles = Partial<{
     areaControlShadow: boolean;
     controlsExpectTimeBlinkAnimation: boolean;
     controlsTapPlace: boolean;
+    controlsFillAnimation: boolean;
+    controlsHideAnimation: boolean;
 }>;
 export interface IInteractiveOptions {
     parentElement: HTMLElement;
@@ -45,6 +47,7 @@ export interface IInteractiveOptions {
      * @deprecated
      * */
     disableControlsOnPause?: boolean;
+    disableTextControlContainerVisibilityEvents?: boolean;
     isTouch?: boolean;
     animationsFeatureToggles?: AnimationsFeatureToggles;
 }

package/types/modules/Interactives/utils/ControlFillAnimation/ControlFillAnimation.d.ts

@@ -0,0 +1,34 @@
+export type Options = {
+    startTime: number;
+    endTime: number;
+    rotateAngle: number;
+    borderRadius: string;
+    debug?: boolean;
+};
+export declare class ControlFillAnimation {
+    fillAnimationElement: HTMLDivElement;
+    private fillAnimationFillerElement;
+    private fillAnimationFillerWrapperElement;
+    private startTime;
+    private endTime;
+    private shouldFillHeight;
+    private widthExpansionCoef;
+    private isDebug;
+    private fromLeft;
+    private useSkew;
+    private rotateAngle;
+    constructor(opts: Options);
+    updateDimension(opts: {
+        width: number;
+        height: number;
+        borderWidth: number;
+    }): void;
+    updateAnimation(currentTime: number): void;
+    /**
+     * Когда мы применяем scew для контрол, расстояние между крайними left & right
+     * точками становится больше. Это значит, что нужно увеличивать
+     * элемент-заполнитель, чтобы он заполнял контрол полностью. Этот метод
+     * возвращает коэффцицент увеличения для элемента-заполнителя.
+     */
+    private calcWidthExpansionCoef;
+}

package/types/modules/Interactives/utils/ControlFillAnimation/index.d.ts

@@ -0,0 +1 @@
+export * from './ControlFillAnimation';

package/types/modules/Interactives/utils/ControlFillAnimation/utils.d.ts

@@ -0,0 +1,12 @@
+export declare const CONTROL_FILL_ANIMATION_CLASSNAME_PREFIX = "interactive-control-fill-animation";
+export declare const controlFillAnimationClassNames: {
+    common: string;
+    fillerWrapper: string;
+    filler: string;
+    fillHeight: string;
+    fillWidth: string;
+    fromTop: string;
+    fromBottom: string;
+    fromLeft: string;
+    fromRight: string;
+};

package/types/modules/Interactives/utils/GameController.d.ts

@@ -5,10 +5,11 @@ import type { ChapterBranch } from '../../../manifest';
 import type { EventEmitter } from '../../../utils/EventEmitter';
 import { CustomError } from '../../../utils/Error';
 import type { SelectBranchesType } from './SelectBranches';
-import type { IgnoreExpectState } from '../../../modules/Interactives/types';
+import type { IgnoreExpectState, AnimationsFeatureToggles } from '../../../modules/Interactives/types';
 import type { ChoiceContainer } from '../../../modules/Interactives/containers';
 import { type GlobalEvents } from './events';
 import { GameStates } from './gameUtils';
+type Features = Pick<AnimationsFeatureToggles, 'controlsHideAnimation'>;
 type ConstructorArg = {
     player: IPlayer;
     container: ChoiceContainer;
@@ -23,6 +24,8 @@ type ConstructorArg = {
     disabledControls$: IValueSubject<boolean>;
     onRemove: () => void;
     onError: (error: CustomError) => void;
+    disableTextControlContainerVisibilityEvents?: boolean;
+    features: Features;
 };
 export declare class GameController {
     container: ChoiceContainer;
@@ -42,7 +45,9 @@ export declare class GameController {
     isSelectedContainerEvent: boolean;
     globalEvents: GlobalEvents;
     onError: ConstructorArg['onError'];
-    constructor({ player, container, branches, selectBranches, interactiveEvents, globalEvents, globalEventEmitter, getContainerEventState, permanentTextControls, interactiveTimeOpenUri, disabledControls$, onRemove, onError, }: ConstructorArg);
+    disableTextControlContainerVisibilityEvents: boolean;
+    features: Features;
+    constructor({ player, container, branches, selectBranches, interactiveEvents, globalEvents, globalEventEmitter, getContainerEventState, permanentTextControls, interactiveTimeOpenUri, disabledControls$, onRemove, onError, disableTextControlContainerVisibilityEvents, features, }: ConstructorArg);
     private emitContainerVisibilityEvent;
     registerEvents(): void;
     hide: () => void;
@@ -55,10 +60,12 @@ export declare class GameController {
     whilePlaying: () => void;
     onResize(isInteractiveTime: boolean): void;
     reset(): void;
-    removeView(): void;
+    removeView(withTransition?: boolean | undefined): void;
     fakeRemoveView(remove?: boolean): void;
     updateControlsShadowStyles(isDark?: boolean): void;
     toggleBlinkAnimation(value: boolean): void;
-    destroy(): void;
+    isInteracted(): boolean;
+    isRemovedOrDestroyed(includeWillRemovedState?: boolean): boolean;
+    destroy(withTransition?: boolean): void;
 }
 export {};

package/types/modules/Interactives/utils/angleUtils.d.ts

@@ -1,2 +1,25 @@
+/**
+ * use normalizeRadians before use
+ */
+export declare function isPositiveXAxis(angle: number): angle is 0;
+/**
+ * use normalizeRadians before use
+ */
+export declare function isPositiveYAxis(angle: number): boolean;
+/**
+ * use normalizeRadians before use
+ */
+export declare function isNegativeXAxis(angle: number): boolean;
+/**
+ * use normalizeRadians before use
+ */
+export declare function isNegativeYAxis(angle: number): boolean;
+/**
+ *  normalizes to [0, 2π)
+ */
 export declare function normalizeRadians(rad: number): number;
+/**
+ * use normalizeRadians before use
+ */
+export declare function getQuadrant(rad: number): number | null;
 export declare function radiansToDegrees(rad: number): number;

package/types/modules/Interactives/utils/emitOnError.d.ts

@@ -0,0 +1,13 @@
+import { ErrorCategoryEnum, ErrorSeverityEnum } from '../../../types';
+import { CustomError } from '../../../utils/Error';
+import { Subject } from '@vkontakte/videoplayer-shared';
+type EmitOnErrorArg = {
+    emitter$: Subject<CustomError>;
+    error?: unknown;
+    subjectId?: string;
+    message?: string;
+    severity?: ErrorSeverityEnum;
+    category?: ErrorCategoryEnum;
+};
+export declare function emitOnError({ emitter$, error, subjectId, message, severity, category, }: EmitOnErrorArg): void;
+export {};

package/types/modules/Interactives/utils/gameUtils.d.ts

@@ -36,5 +36,6 @@ type ExecForAllExpectContainersParamsType = {
     execFn: (gameController: GameController) => void;
 };
 export declare function execForAllExpectContainers({ gameControllers, subjectName, subjectId, execFn, }: ExecForAllExpectContainersParamsType): void;
+export declare function isControlHasOpenURIEvent(control: Control): boolean;
 export declare const evaluateContainerEventStatus: (container: ChapterContainer, gameControllers: GameController[]) => IgnoreExpectState;
 export {};