@planara/core 1.6.0 → 2.1.0

package/dist/index.full.d.ts

@@ -1,15 +1,8 @@
-import { Camera } from 'ogl';
 import { DisplayMode } from '@planara/types';
 import { Figure } from '@planara/types';
-import { Mesh } from 'ogl';
-import { MeshOptions } from 'ogl/types/core/Mesh';
-import { MeshRenderCallback } from 'ogl';
-import { OGLRenderingContext } from 'ogl/types/core/Renderer';
-import { OGLRenderingContext as OGLRenderingContext_2 } from 'ogl';
-import { Program } from 'ogl';
-import { Renderer as Renderer_2 } from 'ogl';
 import { SelectMode } from '@planara/types';
-import { Transform } from 'ogl';
+import * as THREE from 'three';
+import { ToolType } from '@planara/types';
 
 /**
  * Тип позиции камеры в мире.
@@ -35,12 +28,17 @@ export declare function createAppHub(canvas: HTMLCanvasElement): EditorHub;
 export declare type EditorEvents = {
     /** Событие наведения на объект (hover). Payload: объект с mesh или null */
     [EventTopics.SelectHover]: {
-        mesh: Mesh;
+        mesh: THREE.Object3D;
     } | null;
     /** Событие клика по объекту. Payload: объект с mesh или null */
     [EventTopics.SelectClick]: {
-        mesh: Mesh;
+        mesh: THREE.Object3D;
     } | null;
+    /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
+    [EventTopics.ToolSelect]: {
+        mode: SelectMode;
+        mesh: THREE.Object3D | null;
+    };
 };
 
 /**
@@ -50,25 +48,18 @@ export declare type EditorEvents = {
 export declare class EditorHub {
     private _displayManager;
     private _selectManager;
+    private _toolManager;
     private _renderer;
-    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _renderer: EditorRenderer);
+    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _toolManager: IToolManager, _renderer: EditorRenderer);
     setDisplayMode(mode: DisplayMode): void;
     setSelectMode(mode: SelectMode): void;
+    setToolMode(mode: ToolType): void;
     resizeRenderer(): void;
     updateRenderer(): void;
     addFigure(figure: Figure): void;
     destroy(): void;
 }
 
-/**
- * Расширение для Mesh с добавлением поля isHit, необходимого для raycast
- * @public
- */
-export declare class EditorMesh extends Mesh {
-    isHit: boolean;
-    constructor(gl: OGLRenderingContext, options?: Partial<MeshOptions>);
-}
-
 /**
  * Рендерер для редактора.
  * Добавляет сетку, оси координат и поддержку Orbit для управления камерой.
@@ -80,53 +71,52 @@ export declare class EditorRenderer extends Renderer {
     private _bus;
     /** Orbit-контроллер для управления камерой */
     private _orbit;
-    /** Raycast для подсветки моделей при наведении */
-    private _raycast;
-    /** Курсор мыши для остлеживания наведения на 3D-модель */
-    private _mouse;
-    /** Были ли зарегистрированы обработчики событий для мыши */
+    /** Transform-контроллер для редактирования */
+    private _transform;
+    private readonly _transformHelper;
+    /** Raycast для получения событий наведения/клика по модели*/
+    private _raycaster;
+    /** Курсор мыши */
+    private readonly _mouse;
+    /** Были ли инициализированы обработчики событий (hover/click) */
     private _isEventListenersAdded;
     /**
-     * Инициализация сцены редактора.
-     * Создает сетку, оси координат и orbit-контроллер.
+     * Последняя модель на которую наводились,
+     * необходима для отправки только уникальных событий в event bus
      */
+    private _lastHovered;
     constructor(_canvas: HTMLCanvasElement, _bus: EventBus);
     /**
      * Обновление состояния рендерера.
      */
     protected update(): void;
+    /** Добавление фигуры на сцену */
+    addFigure(figure: Figure): THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>;
     /**
-     * Метод для добавления фигуры.
-     * Настройка raycast.
-     * @param figure - Данные фигуры: position, normal, uv
-     */
-    addFigure(figure: Figure): EditorMesh;
-    /**
-     * Устанавливает callback, который будет вызываться перед рендером конкретного меша.
-     *
-     * @param mesh - Меш, для которого нужно задать callback.
-     * @param f - Функция обратного вызова, выполняемая перед рендером меша.
+     * Смена отображения `TransformControls` в зависимости от типа инструмента.
+     * @param mode - тип инструмента для отображения `TransformControls`.
      * @internal
      */
-    setMeshBeforeRender(mesh: Mesh, f: MeshRenderCallback): void;
+    setTransformControlsMode(mode: ToolType): void;
     /**
-     * Инициализация обработчиков мыши для raycast
+     * Добавление `TransformControls` к объекту.
+     * @param object - объект, к которому добавляются `TransformControls`.
+     * @internal
      */
-    private initMouseListeners;
+    attachTransformControls(object: THREE.Object3D): void;
     /**
-     * Обработчик движения мыши
+     * Удаление `TransformControls` с последнего выбранного объекта.
+     * @internal
      */
+    detachTransformControls(): void;
+    /** Инициализация обработчиков событий на hover/click */
+    private _initMouseListeners;
+    /** Обработчик события для hover */
     private _handleMouseMove;
-    /**
-     * Обработчик клика мыши
-     */
+    /** Обработчик события на click */
     private _handleMouseClick;
-    /**
-     * Универсальная логика raycast-события
-     */
+    /** Вспомогательный метод для получения модели, которую выбрали и отправки события в event bus */
     private _processRaycastEvent;
-    /** Деструктор */
-    destroy(): void;
 }
 
 /**
@@ -154,7 +144,9 @@ export declare enum EventTopics {
     /** Событие наведения на объект (hover). Payload: mesh: Mesh | null */
     SelectHover = "select.hover",
     /** Событие клика по объекту. Payload: mesh: Mesh | null */
-    SelectClick = "select.click"
+    SelectClick = "select.click",
+    /** Событие выбора объекта для редактирования. Payload: mode: SelectMode, object: THREE.Object3D | null */
+    ToolSelect = "tool.select"
 }
 
 /**
@@ -187,6 +179,13 @@ export declare interface IManager {
 export declare interface ISelectManager extends IManager {
 }
 
+/**
+ * Маркерный интерфейс для менеджеров инструментов.
+ * @public
+ */
+export declare interface IToolManager extends IManager {
+}
+
 /** @public */
 export declare class ObjLoader {
     /** Позиции вершин */
@@ -211,17 +210,12 @@ export declare class ObjLoader {
 
 /**
  * Рендерер для предпросмотра 3D-модели.
- * Настраивает сцену, камеру и орбитальную навигацию (по горизонтали).
- * Наследуется от базового Renderer.
+ * Настраивает сцену, камеру и орбитальную навигацию по горизонтали.
  * @alpha
  */
 export declare class PreviewRenderer extends Renderer {
     /** Orbit-контроллер для управления камерой */
     private _orbit;
-    /**
-     * Инициализация сцены предпросмотра.
-     * @param canvas - HTMLCanvasElement для рендеринга
-     */
     constructor(canvas: HTMLCanvasElement);
     /**
      * Обновление состояния рендерера.
@@ -235,18 +229,16 @@ export declare class PreviewRenderer extends Renderer {
  * @public
  */
 export declare abstract class Renderer {
-    /** Экземпляр рендерера OGL */
-    protected gl: Renderer_2;
     /** Корневой объект сцены */
-    protected scene: Transform;
+    protected scene: THREE.Scene;
     /** Камера для сцены */
-    protected camera: Camera;
+    protected camera: THREE.PerspectiveCamera;
+    /** Экземпляр рендерера Three.js */
+    protected renderer: THREE.WebGLRenderer;
     /** HTML-элемент canvas, на котором рендерится сцена */
     protected canvas: HTMLCanvasElement;
-    /** Program для настройки рендеринга моделей */
-    protected program: Program;
     /** Массив моделей на сцене */
-    protected meshes: Mesh[];
+    protected meshes: THREE.Mesh[];
     /**
      * Конструктор рендерера
      * @param canvas - HTMLCanvasElement для рендеринга
@@ -272,42 +264,28 @@ export declare abstract class Renderer {
      * Публичный метод для добавления фигуры.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): EditorMesh;
+    addFigure(figure: Figure): THREE.Mesh;
     /**
      * Добавляет фигуру в сцену и сохраняет его во внутреннем массиве.
      *
      * @param mesh - Фигура для добавления в сцену.
      * @internal
      */
-    addMesh(mesh: Mesh): void;
-    /**
-     * Возвращает WebGL контекст рендерера.
-     *
-     * @returns Контекст WebGL (OGLRenderingContext) текущей сцены.
-     * @internal
-     */
-    getContext(): OGLRenderingContext_2;
+    addMesh(mesh: THREE.Mesh): void;
     /**
      * Убирает фигуру со сцены
      *
      * @param mesh - Фигура для удаления со сцены.
      * @internal
      */
-    removeMesh(mesh: Mesh): void;
+    removeMesh(mesh: THREE.Mesh): void;
     /**
      * Возвращает список всех фигур, находящихся в сцене.
      *
      * @returns Массив текущих фигур.
      * @internal
      */
-    getMeshes(): Mesh[];
-    /**
-     * Возвращает настройку для рендеринга.
-     *
-     * @returns Program для настройки рендеринга моделей.
-     * @internal
-     */
-    getProgram(): Program;
+    getMeshes(): THREE.Mesh[];
     /** Деструктор */
     destroy(): void;
 }

package/dist/index.public.d.ts

@@ -1,15 +1,8 @@
-import { Camera } from 'ogl';
 import { DisplayMode } from '@planara/types';
 import { Figure } from '@planara/types';
-import { Mesh } from 'ogl';
-import { MeshOptions } from 'ogl/types/core/Mesh';
-import { MeshRenderCallback } from 'ogl';
-import { OGLRenderingContext } from 'ogl/types/core/Renderer';
-import { OGLRenderingContext as OGLRenderingContext_2 } from 'ogl';
-import { Program } from 'ogl';
-import { Renderer as Renderer_2 } from 'ogl';
 import { SelectMode } from '@planara/types';
-import { Transform } from 'ogl';
+import * as THREE from 'three';
+import { ToolType } from '@planara/types';
 
 /**
  * Тип позиции камеры в мире.
@@ -35,12 +28,17 @@ export declare function createAppHub(canvas: HTMLCanvasElement): EditorHub;
 export declare type EditorEvents = {
     /** Событие наведения на объект (hover). Payload: объект с mesh или null */
     [EventTopics.SelectHover]: {
-        mesh: Mesh;
+        mesh: THREE.Object3D;
     } | null;
     /** Событие клика по объекту. Payload: объект с mesh или null */
     [EventTopics.SelectClick]: {
-        mesh: Mesh;
+        mesh: THREE.Object3D;
     } | null;
+    /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
+    [EventTopics.ToolSelect]: {
+        mode: SelectMode;
+        mesh: THREE.Object3D | null;
+    };
 };
 
 /**
@@ -50,25 +48,18 @@ export declare type EditorEvents = {
 export declare class EditorHub {
     private _displayManager;
     private _selectManager;
+    private _toolManager;
     private _renderer;
-    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _renderer: EditorRenderer);
+    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _toolManager: IToolManager, _renderer: EditorRenderer);
     setDisplayMode(mode: DisplayMode): void;
     setSelectMode(mode: SelectMode): void;
+    setToolMode(mode: ToolType): void;
     resizeRenderer(): void;
     updateRenderer(): void;
     addFigure(figure: Figure): void;
     destroy(): void;
 }
 
-/**
- * Расширение для Mesh с добавлением поля isHit, необходимого для raycast
- * @public
- */
-export declare class EditorMesh extends Mesh {
-    isHit: boolean;
-    constructor(gl: OGLRenderingContext, options?: Partial<MeshOptions>);
-}
-
 /**
  * Рендерер для редактора.
  * Добавляет сетку, оси координат и поддержку Orbit для управления камерой.
@@ -80,46 +71,38 @@ export declare class EditorRenderer extends Renderer {
     private _bus;
     /** Orbit-контроллер для управления камерой */
     private _orbit;
-    /** Raycast для подсветки моделей при наведении */
-    private _raycast;
-    /** Курсор мыши для остлеживания наведения на 3D-модель */
-    private _mouse;
-    /** Были ли зарегистрированы обработчики событий для мыши */
+    /** Transform-контроллер для редактирования */
+    private _transform;
+    private readonly _transformHelper;
+    /** Raycast для получения событий наведения/клика по модели*/
+    private _raycaster;
+    /** Курсор мыши */
+    private readonly _mouse;
+    /** Были ли инициализированы обработчики событий (hover/click) */
     private _isEventListenersAdded;
     /**
-     * Инициализация сцены редактора.
-     * Создает сетку, оси координат и orbit-контроллер.
+     * Последняя модель на которую наводились,
+     * необходима для отправки только уникальных событий в event bus
      */
+    private _lastHovered;
     constructor(_canvas: HTMLCanvasElement, _bus: EventBus);
     /**
      * Обновление состояния рендерера.
      */
     protected update(): void;
-    /**
-     * Метод для добавления фигуры.
-     * Настройка raycast.
-     * @param figure - Данные фигуры: position, normal, uv
-     */
-    addFigure(figure: Figure): EditorMesh;
-    /* Excluded from this release type: setMeshBeforeRender */
-    /**
-     * Инициализация обработчиков мыши для raycast
-     */
-    private initMouseListeners;
-    /**
-     * Обработчик движения мыши
-     */
+    /** Добавление фигуры на сцену */
+    addFigure(figure: Figure): THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>;
+    /* Excluded from this release type: setTransformControlsMode */
+    /* Excluded from this release type: attachTransformControls */
+    /* Excluded from this release type: detachTransformControls */
+    /** Инициализация обработчиков событий на hover/click */
+    private _initMouseListeners;
+    /** Обработчик события для hover */
     private _handleMouseMove;
-    /**
-     * Обработчик клика мыши
-     */
+    /** Обработчик события на click */
     private _handleMouseClick;
-    /**
-     * Универсальная логика raycast-события
-     */
+    /** Вспомогательный метод для получения модели, которую выбрали и отправки события в event bus */
     private _processRaycastEvent;
-    /** Деструктор */
-    destroy(): void;
 }
 
 /**
@@ -147,7 +130,9 @@ export declare enum EventTopics {
     /** Событие наведения на объект (hover). Payload: mesh: Mesh | null */
     SelectHover = "select.hover",
     /** Событие клика по объекту. Payload: mesh: Mesh | null */
-    SelectClick = "select.click"
+    SelectClick = "select.click",
+    /** Событие выбора объекта для редактирования. Payload: mode: SelectMode, object: THREE.Object3D | null */
+    ToolSelect = "tool.select"
 }
 
 /**
@@ -180,6 +165,13 @@ export declare interface IManager {
 export declare interface ISelectManager extends IManager {
 }
 
+/**
+ * Маркерный интерфейс для менеджеров инструментов.
+ * @public
+ */
+export declare interface IToolManager extends IManager {
+}
+
 /** @public */
 export declare class ObjLoader {
     /** Позиции вершин */
@@ -210,18 +202,16 @@ export declare class ObjLoader {
  * @public
  */
 export declare abstract class Renderer {
-    /** Экземпляр рендерера OGL */
-    protected gl: Renderer_2;
     /** Корневой объект сцены */
-    protected scene: Transform;
+    protected scene: THREE.Scene;
     /** Камера для сцены */
-    protected camera: Camera;
+    protected camera: THREE.PerspectiveCamera;
+    /** Экземпляр рендерера Three.js */
+    protected renderer: THREE.WebGLRenderer;
     /** HTML-элемент canvas, на котором рендерится сцена */
     protected canvas: HTMLCanvasElement;
-    /** Program для настройки рендеринга моделей */
-    protected program: Program;
     /** Массив моделей на сцене */
-    protected meshes: Mesh[];
+    protected meshes: THREE.Mesh[];
     /**
      * Конструктор рендерера
      * @param canvas - HTMLCanvasElement для рендеринга
@@ -247,12 +237,10 @@ export declare abstract class Renderer {
      * Публичный метод для добавления фигуры.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): EditorMesh;
+    addFigure(figure: Figure): THREE.Mesh;
     /* Excluded from this release type: addMesh */
-    /* Excluded from this release type: getContext */
     /* Excluded from this release type: removeMesh */
     /* Excluded from this release type: getMeshes */
-    /* Excluded from this release type: getProgram */
     /** Деструктор */
     destroy(): void;
 }