@planara/core 2.0.0 → 2.1.0

package/dist/index.full.d.ts

@@ -2,6 +2,7 @@ import { DisplayMode } from '@planara/types';
 import { Figure } from '@planara/types';
 import { SelectMode } from '@planara/types';
 import * as THREE from 'three';
+import { ToolType } from '@planara/types';
 
 /**
  * Тип позиции камеры в мире.
@@ -33,6 +34,11 @@ export declare type EditorEvents = {
     [EventTopics.SelectClick]: {
         mesh: THREE.Object3D;
     } | null;
+    /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
+    [EventTopics.ToolSelect]: {
+        mode: SelectMode;
+        mesh: THREE.Object3D | null;
+    };
 };
 
 /**
@@ -42,10 +48,12 @@ 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;
@@ -63,19 +71,51 @@ export declare class EditorRenderer extends Renderer {
     private _bus;
     /** Orbit-контроллер для управления камерой */
     private _orbit;
+    /** Transform-контроллер для редактирования */
+    private _transform;
+    private readonly _transformHelper;
+    /** Raycast для получения событий наведения/клика по модели*/
     private _raycaster;
+    /** Курсор мыши */
     private readonly _mouse;
+    /** Были ли инициализированы обработчики событий (hover/click) */
     private _isEventListenersAdded;
+    /**
+     * Последняя модель на которую наводились,
+     * необходима для отправки только уникальных событий в 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>;
-    private initMouseListeners;
+    /**
+     * Смена отображения `TransformControls` в зависимости от типа инструмента.
+     * @param mode - тип инструмента для отображения `TransformControls`.
+     * @internal
+     */
+    setTransformControlsMode(mode: ToolType): void;
+    /**
+     * Добавление `TransformControls` к объекту.
+     * @param object - объект, к которому добавляются `TransformControls`.
+     * @internal
+     */
+    attachTransformControls(object: THREE.Object3D): void;
+    /**
+     * Удаление `TransformControls` с последнего выбранного объекта.
+     * @internal
+     */
+    detachTransformControls(): void;
+    /** Инициализация обработчиков событий на hover/click */
+    private _initMouseListeners;
+    /** Обработчик события для hover */
     private _handleMouseMove;
+    /** Обработчик события на click */
     private _handleMouseClick;
+    /** Вспомогательный метод для получения модели, которую выбрали и отправки события в event bus */
     private _processRaycastEvent;
 }
 
@@ -104,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"
 }
 
 /**
@@ -137,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 {
     /** Позиции вершин */

package/dist/index.public.d.ts

@@ -2,6 +2,7 @@ import { DisplayMode } from '@planara/types';
 import { Figure } from '@planara/types';
 import { SelectMode } from '@planara/types';
 import * as THREE from 'three';
+import { ToolType } from '@planara/types';
 
 /**
  * Тип позиции камеры в мире.
@@ -33,6 +34,11 @@ export declare type EditorEvents = {
     [EventTopics.SelectClick]: {
         mesh: THREE.Object3D;
     } | null;
+    /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
+    [EventTopics.ToolSelect]: {
+        mode: SelectMode;
+        mesh: THREE.Object3D | null;
+    };
 };
 
 /**
@@ -42,10 +48,12 @@ 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;
@@ -63,19 +71,37 @@ export declare class EditorRenderer extends Renderer {
     private _bus;
     /** Orbit-контроллер для управления камерой */
     private _orbit;
+    /** Transform-контроллер для редактирования */
+    private _transform;
+    private readonly _transformHelper;
+    /** Raycast для получения событий наведения/клика по модели*/
     private _raycaster;
+    /** Курсор мыши */
     private readonly _mouse;
+    /** Были ли инициализированы обработчики событий (hover/click) */
     private _isEventListenersAdded;
+    /**
+     * Последняя модель на которую наводились,
+     * необходима для отправки только уникальных событий в 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>;
-    private initMouseListeners;
+    /* 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;
+    /** Вспомогательный метод для получения модели, которую выбрали и отправки события в event bus */
     private _processRaycastEvent;
 }
 
@@ -104,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"
 }
 
 /**
@@ -137,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 {
     /** Позиции вершин */