@truelab/truengine 0.0.1-0

package/dist/types/src/plugins/gsap/custom.ease.plugin.d.ts

@@ -0,0 +1,2 @@
+import { CustomEase } from 'gsap/CustomEase';
+export { CustomEase };

package/dist/types/src/plugins/gsap/motion.path.plugin.d.ts

@@ -0,0 +1,2 @@
+import { MotionPathPlugin } from 'gsap/all';
+export { MotionPathPlugin };

package/dist/types/src/plugins/modernizr/modernizr-custom.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/references.d.ts

@@ -0,0 +1,4 @@
+import { TGenericObject } from './extends/short.types';
+type TClass = new (...args: unknown[]) => unknown;
+export declare const Core: TGenericObject<TClass>;
+export {};

package/dist/types/src/scenes/abstract.scene.d.ts

@@ -0,0 +1,73 @@
+import { DI } from '../classes/di.class';
+import { IProducer } from '../classes/producer.class';
+import { IContainer, IScene } from '../extends/interfaces';
+import { TMixedObject } from '../extends/short.types';
+/**
+ * Абстрактная сцена
+ *
+ * @rules
+ * В сцене должны находиться:
+ * - все игровые объекты этой сцены (компоненты, dragonbones, простые объекты)
+ * - вызовы методов анимации этих объектов (движения, механика, последовательности)
+ * - обработчики событий от своих дочерних объектов
+ * - все механики должны быть разделены между собой (методами)
+ * - для последовательности анимации создайте отдельный метод с вызовом анимаций
+ * - ссылки на управление свойствами внутреннего контейнера (link)
+ * - обработка адаптивки
+ * - обратиться к компонентам верхнего уровня можно через this.producer.component<?>('bigwin')
+ * - обращаться к другим сценам и панелям можно только чтобы переключить их состояния (компоненты внутри них будут недоступны)
+ *
+ * @methods
+ * constructor() - конструктор сцены, а не объектов на ней (здесь делаем только то что касается свойств сцены)
+ * create() - метод сборки объектов сцены
+ * destroy() - метод уничтожения объектов сцены из памяти (используем реестр)
+ * processing() - метод вызова механик по входным данным от сервера
+ *
+ * @examples
+ * this.producer.component <TextComponent> ('text').setText('123')
+ */
+export declare abstract class AbstractScene extends DI implements IScene {
+    name: string;
+    instance: IContainer;
+    producer: IProducer;
+    width: number;
+    height: number;
+    alpha: number;
+    destroyed: boolean;
+    hidden: boolean;
+    /**
+     * Конструктор сцены (но не объектов на ней)
+     * @param name
+     */
+    constructor(name?: string);
+    /**
+     * Метод создания сцены.
+     * Создает все объекты сцены (слот, персонаж), вешает слушатели на события.
+     */
+    abstract create(): Promise<boolean>;
+    /**
+     * Метод разрушения сцены.
+     * Все, что было создано в create должно быть уничтожено здесь.
+     * Слушатели событий должны быть удалены.
+     */
+    abstract destroy(): Promise<boolean>;
+    /**
+     * Метод отрисовки сцены по сценарию на основе ответа от сервера.
+     * Например, передать пришедший ответ в слот, запустить анимации персонажей.
+     */
+    abstract processing?(playground: unknown, isLast: boolean): Promise<TMixedObject>;
+    /**
+     * Метод адаптивки элементов на сцене.
+     */
+    abstract adaptive?(modeChanged?: boolean): Promise<void>;
+    /**
+     * Метод перехода на сцену
+     * (метод вызывает продюсер)
+     */
+    show(): Promise<void>;
+    /**
+     * Метод перехода из сцены
+     * (метод вызывает продюсер)
+     */
+    hide(): Promise<void>;
+}

package/dist/types/src/scenes/background.scene.d.ts

@@ -0,0 +1,35 @@
+import { TMixedObject, TPixiSprite, TPixiTexture } from '../extends/short.types';
+import { AbstractScene } from './abstract.scene';
+export type TBackground = {
+    landscape: string;
+    portrait: string;
+};
+export type TBackgroundTextures = {
+    landscape: TPixiTexture;
+    portrait: TPixiTexture;
+};
+/**
+ * Background scene
+ */
+export declare class BackgroundScene extends AbstractScene {
+    protected _backgrounds: Map<string, TBackground>;
+    protected _background: TPixiSprite;
+    protected _textures: Map<string, TBackgroundTextures>;
+    protected _mode: string;
+    /** get current background mode */
+    get mode(): string;
+    /** set new background mode */
+    set mode(value: string);
+    /** @constructor */
+    constructor(name?: string);
+    /** @inheritdoc */
+    create(): Promise<boolean>;
+    /** @inheritdoc */
+    destroy(): Promise<boolean>;
+    /** Smoothly change mode */
+    crossfadeMode(mode: string, durationMs?: number): Promise<void>;
+    /** @inheritdoc */
+    processing(): Promise<TMixedObject>;
+    /** @inheritdoc */
+    adaptive(): Promise<void>;
+}

package/dist/types/src/scenes/masked.scene.d.ts

@@ -0,0 +1,15 @@
+import { AbstractScene } from './abstract.scene';
+import * as PIXI from 'pixi.js';
+/**
+ * Добавляет функционал маски на сцену
+ */
+export declare abstract class MaskedScene extends AbstractScene {
+    protected _maskGraphics: PIXI.Graphics;
+    /**
+     * Включить на сцене маске.
+     * По умолчанию маска по размеру сцены как в конфиге, но можно ее расширить, задав поля.
+     * @param padX поля маски по горизонтали
+     * @param padY поля маски по вертикали
+     */
+    sceneMask(padX?: number, padY?: number): PIXI.Graphics;
+}

package/dist/types/src/services/focus.services.d.ts

@@ -0,0 +1,17 @@
+import { Emitter } from '../classes/emitter.class';
+import { IService } from '../extends/interfaces';
+import { TCallbackVoid, TTimeout } from '../extends/short.types';
+/** */
+export declare class FocusServise extends Emitter implements IService {
+    onFocus: TCallbackVoid;
+    onBlur: TCallbackVoid;
+    protected _tickerInterval: number;
+    protected _windowFocusTimeout: TTimeout;
+    /**
+     * @constructor
+     * @param engine TEngine
+     */
+    constructor();
+    /** */
+    protected _onChange(): void;
+}

package/dist/types/src/services/iframe.service.d.ts

@@ -0,0 +1,27 @@
+import { Emitter } from '../classes/emitter.class';
+import { IService } from '../extends/interfaces';
+export declare enum ECasinoEvent {
+    gameStarted = "gameStarted",// Начали спин
+    gameComplete = "gameComplete",// Завершили спин
+    fullscreenOn = "fullscreen-on",// Включили режим фулскрина
+    fullscreenOff = "fullscreen-off",// Выключили режим фулскрина
+    modalRefill = "modalRefill",// Показать модалку пополнения баланса
+    changeBalance = "changeBalance",// Баланс изменился
+    leaveTheGame = "leaveTheGame"
+}
+/**
+ * @deprecated
+ * Use IntegrationService instead
+ * Сервис для кастомной обработки событий типа
+ */
+export declare class IFrameService extends Emitter implements IService {
+    protected _casinoUrl: string;
+    protected _returnUrl: string;
+    available: boolean;
+    /** @constructor */
+    constructor();
+    /** */
+    leaveTheGameEvent(): void;
+    /** */
+    eventEmit(event: ECasinoEvent): void;
+}

package/dist/types/src/services/langs.service.d.ts

@@ -0,0 +1,31 @@
+import { TGenericObject, TLangsReplace } from '../extends/short.types';
+/**
+ * Сервис языков
+ */
+export declare class LangsService {
+    protected collection: Map<string, string>;
+    /**
+     * Добавление перевода в коллекцию
+     * @param slug слаг перевода
+     * @param text перевод
+     */
+    set(slug: string, text?: string): LangsService;
+    /**
+     * Установить множество переводов за раз
+     * @param {TGenericObject <string>} langs
+     */
+    setMany(langs: TGenericObject<string>): LangsService;
+    /**
+     * Получение текста метки с подстановками если они заданы
+     * @param slug текстовая метка
+     * @param def значение по умолчанию если метка отсутствует в коллекции
+     * @param replaces объект подстановок в шаблон строки
+     */
+    get(slug: string, def?: string, replaces?: TLangsReplace): string;
+    /**
+     * Метод замены подстрок в текстовой метке
+     * @param text входной текст
+     * @param replaces объект подстановок
+     */
+    replace(text: string, replaces?: TLangsReplace): string;
+}

package/dist/types/src/services/registry.service.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Сервис реестра данных в приложении.
+ */
+export declare class RegistryService {
+    protected _collection: Map<string, unknown>;
+    /**
+     * Регистрация объекта в реестре
+     * @param name идентификатор
+     * @param compiled собранный объект
+     */
+    set<T = unknown>(name: string, compiled: T): T;
+    /**
+     * Получить объект из реестра
+     * @param name
+     */
+    get<T>(name: string): T;
+    /**
+     * Узнать есть ли объект в реестре
+     * @param name
+     */
+    exists(name: string): boolean;
+    /**
+     * Удалить объект/объекты из реестра
+     * registry().remove(['one'])
+     * registry().remove(['one', 'two', 'three'])
+     * @param names
+     */
+    remove(names: string[]): RegistryService;
+}

package/dist/types/src/services/settings.service.d.ts

@@ -0,0 +1,51 @@
+import { Emitter } from '../classes/emitter.class';
+import { TMixedObject } from '../extends/short.types';
+import { TEngineSettings } from '../extends/struct.types';
+/**
+ * Сервис настроек
+ *
+ * @rules
+ * - названия настроек именовать camelCase.
+ */
+export declare class SettingsService extends Emitter {
+    protected defaults: Map<string, unknown>;
+    protected currents: Map<string, unknown>;
+    /**
+     * Установить значение настройки
+     * Выбрасывается событие settings.{name}:set
+     * @param {string} name param name
+     * @param {mixed} value param value
+     * @param autoemit флаг выбрасывания событий settings.set - заглушить чтобы избежать циклического вызова
+     */
+    set(name: string, value?: unknown, autoemit?: boolean): SettingsService;
+    /**
+     * Установить множество настроек за раз
+     * @param {TEngineSettings} settings
+     */
+    setMany(settings: TEngineSettings): SettingsService;
+    /**
+     * Получить значение настройки
+     * @param {string} name
+     * @param {any} def
+     */
+    get<T = string>(name: string, def?: T): T;
+    /**
+     * Узнать есть ли такая настройка
+     * @param {string} name
+     */
+    has(name: string): boolean;
+    /**
+     * Получить настройки по переданным ключам
+     * @param names
+     */
+    pull(names: string[]): TMixedObject;
+    /**
+     * Сбросить все настройки до дефолтных (если есть)
+     */
+    reset(): SettingsService;
+    /**
+     * Метод сохраняет все текущие настройки как default
+     * - в дальнейшем при сбросе будут использоваться они
+     */
+    asDefault(): SettingsService;
+}

package/dist/types/src/services/skip.service.d.ts

@@ -0,0 +1,51 @@
+import { Emitter } from '../classes/emitter.class';
+import { IService } from '../extends/interfaces';
+/**
+ *  Сервис скипов
+ *  Дока по механике https://www.notion.so/truelab/Fast-play-778d052d65e246e596b2e05b1389d918
+ */
+export declare class SkipService extends Emitter implements IService {
+    private name;
+    protected _isActive: boolean;
+    protected _isEnabled: boolean;
+    protected _isInitialized: boolean;
+    protected _tags: Set<string>;
+    /** Активирован ли скип */
+    get isActive(): boolean;
+    /** Разрешен ли скип в данный момент */
+    get isEnabled(): boolean;
+    /**
+     *  Инициализировать сервис
+     */
+    init(): SkipService;
+    /**
+     *  Активировать скип
+     * - Функция должна вызываться во время нажатия кнопки скипа, или кликов по экрану.
+     * - Бросит событие о активации режима скипа - 'skip:active'.
+     * - Бросит события о кастомных скипах, если такие указаны - 'skip.[tag]:active', затем очистит их.
+     */
+    start(): void;
+    /**
+     *  Разрешить скип
+     * - Должен вызываться в начале каждого спина.
+     * - Может вызываться внутри спина, если передан кастомный тэг.
+     * - При переданном тэге запишет для него слушатель и бросит событие вида 'skip.[tag]:active' с ним при скипе.
+     */
+    enable(tag?: string): boolean;
+    /**
+     *  Отключить возможность скипа.
+     * @rules
+     * - Должен вызываться в конце каждого спина.
+     * - Переключит режим скипа в неактивный.
+     * - При вызове без тэга запретит дальнейшую возможность скипа.
+     * - При вызове с тэгом удалит тэг из ожидания скипа без запрета.
+     * @param tag - удалить кастомный тэг из ожидания скипа
+     */
+    disable(tag?: string): void;
+    /** Переключить возможность скипа */
+    protected _toggleEnabled(enabled: boolean): void;
+    /** Переключить состояние скипа */
+    protected _toggleActive(isActive: boolean): void;
+    /** Включить слушателей */
+    protected _startListeners(): void;
+}

package/dist/types/src/services/sounds/sounds.service.d.ts

@@ -0,0 +1,111 @@
+import { IMediaInstance, Sound, SoundSprite } from '@pixi/sound';
+import { Emitter } from '../../classes/emitter.class';
+import { IService } from '../../extends/interfaces';
+import { TGsapTimeline } from '../../extends/short.types';
+export type TSoundType = 'ambience' | 'effects' | 'dealer';
+export type TSample = {
+    name: string;
+    type: TSoundType;
+    sprite?: string;
+};
+export type TSounds = Record<string, TSample>;
+type TLoopTracks = {
+    sound: SoundSprite;
+    sample: TSample;
+    crossfade: number;
+    timeline: TGsapTimeline;
+};
+type TSingleTracks = {
+    sample: TSample;
+    instance: IMediaInstance;
+};
+/**
+ * Сервис управления звуками.
+ * По умолчанию все звуки включены и громкость 1,
+ * поэтому при старте игры надо задать эти параметры из настроек
+ *
+ * @rules
+ * - звуки должны быть заранее правильно подобраны, по тональности, по громкости, по длине
+ * - допускается программное управление громкостью звуков принадлежащих одному типу, а не отдельных звуков
+ * - регулярно повторяющиеся звуки должны иметь несколько вариантов звучания
+ * - не объединять звуки разных событий в один джингл (мешает управлять таймингами)
+ * - если анимация не имеет конкретной длины то звук должен формироваться программно (набиваясь, повторяясь и тп)
+ */
+export declare class SoundsService extends Emitter implements IService {
+    getSoundsCustom: (sample: TSample) => Sound;
+    protected _soundsSprites: Map<string, Sound>;
+    protected _loopTracks: Map<string, TLoopTracks>;
+    protected _singleTracks: Map<string, TSingleTracks>;
+    protected _values: {
+        [key in TSoundType]: number;
+    };
+    /** Глобальная громкость */
+    set sounds(value: number);
+    /** Глобальная громкость */
+    get sounds(): number;
+    /** Включена ли музыка */
+    get ambience(): number;
+    /** Глобально включить или отключить музыку */
+    set ambience(value: number);
+    /** Включены ли эффекты */
+    get effects(): number;
+    /** Глобально включить или отключить эффекты */
+    set effects(value: number);
+    /** Глобально включить или отключить дилера */
+    set dealer(value: number);
+    /** Включен ли дилер */
+    get dealer(): number;
+    /**
+     * Запуск проигрывания звукового спрайта
+     * - сэмплы, которые уже проигрываются, не будут запущены повторно
+     * - если нужно запустить один сэмпл несколько раз одновременно - передаем tag
+     * @param sound
+     * @param tag
+     */
+    play(sample: TSample, tag?: string): TSample;
+    /**
+     * Остановить проигрывание звукового спрайта
+     * @param sound
+     * @param tag
+     */
+    stop(sample: TSample, tag?: string): TSample;
+    /**
+     * Запуск лупа на таймлайне
+     * @param track имя трека для сведения с другими лупами
+     * @param sample семпл для петли
+     * @param crossfade время плавного перехода из текущего в переданный семпл (включает fadein начального)
+     */
+    loop(track: string, sample: TSample, crossfade?: number, volume?: number): TGsapTimeline;
+    /**
+     * Все текущие треки в состоянии loop запустить заново,
+     * т.к. их звуковые спрайты могли изменится
+     */
+    refreshLoops(): void;
+    /**
+     * Очистка и остановка трека
+     */
+    delete(track: string, crossfade?: number): Promise<void>;
+    /** */
+    current(track: string): TLoopTracks;
+    /** */
+    somePlaying(someof: TSample[], tag?: string): boolean;
+    /**
+     * Получить sound из альтернативных возможных источников
+     */
+    protected _getSound(sample: TSample): Sound;
+    /**
+     * получить sound из предзагруженных ассетов
+     */
+    protected _getSoundDefault({ sprite }: TSample): Sound;
+    /**
+     * Получить строку-ключ, по которой звук будет сохранен в проигрываемых сейчас звуках
+     * @param sample
+     * @param tag
+     */
+    protected _getKey(sample: TSample, tag?: string): string;
+    /**
+     * Установить значение соответствующему типу
+     */
+    protected _setValue(value: number, type: TSoundType): void;
+}
+export {};

package/dist/types/src/services/storage.service.d.ts

@@ -0,0 +1,38 @@
+import { IService } from '../extends/interfaces';
+import { TGenericObject, TMixedObject } from '../extends/short.types';
+export type TSupportStorage = boolean | number | string | TMixedObject | number[] | string[];
+/**
+ * Сервис для работы с localStorage.
+ * Хранит в себе копию объекта из localStorage
+ * и при записи нового значения переводит этот объект в строку JSON
+ * и сохраняет в localStorage
+ */
+export declare class StorageService implements IService {
+    protected _key: string;
+    protected _cached: TGenericObject<TSupportStorage>;
+    protected _isAvailable: boolean;
+    /**
+     * Установить ключ, по которому хранить объект с настройками в localStorage.
+     * Важно вызвать этот метод до использования других методов сервиса.
+     * @param key
+     */
+    setKey(key: string): void;
+    /**
+     * Получить значение.
+     *
+     * Если такое значение есть и оно валидно, то возвращаем его,
+     * Иначе возвращаем дефолтное значение.
+     *
+     * @param {*} name
+     * @param {*} value
+     * @param {*} validator
+     */
+    get(name: string, def: TSupportStorage, validator: (value: TSupportStorage) => boolean): TSupportStorage;
+    /**
+     * Установить новое значение настройки.
+     *
+     * @param {*} name
+     * @param {*} value
+     */
+    set(name: string, value: TSupportStorage): TSupportStorage;
+}

package/dist/types/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;

package/package.json

@@ -0,0 +1,33 @@
+{
+    "name": "@truelab/truengine",
+    "version": "0.0.1-0",
+    "main": "dist/truengine.umd.js",
+    "module": "dist/truengine.esm.js",
+    "types": "dist/types/index.d.ts",
+    "files": [
+        "dist/"
+    ],
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview",
+        "build:watch": "vite build --watch"
+    },
+    "dependencies": {
+        "@pixi-spine/loader-4.1": "^3.1.0",
+        "@pixi/particle-emitter": "5.0.7",
+        "@pixi/sound": "^4.0.4",
+        "@truelab/truelogic": "^3.2.2",
+        "@types/gsap": "^1.20.2",
+        "@types/modernizr": "^3.5.3",
+        "@types/webfontloader": "^1.6.29",
+        "decimal.js-light": "^2.5.1",
+        "gsap": "^3.12.7",
+        "lil-gui": "^0.17.0",
+        "pixi-particles": "^4.3.0",
+        "pixi-spine": "^3.1.0",
+        "pixi.js": "^6.5.10",
+        "webfontloader": "^1.6.28"
+    }
+}