@planara/core 2.1.1 → 2.2.0

package/dist/index.full.d.ts

@@ -1,4 +1,5 @@
 import { DisplayMode } from '@planara/types';
+import { Disposable as Disposable_2 } from 'tsyringe';
 import { Figure } from '@planara/types';
 import { SelectMode } from '@planara/types';
 import * as THREE from 'three';
@@ -26,13 +27,13 @@ export declare function createAppHub(canvas: HTMLCanvasElement): EditorHub;
  * @public
  */
 export declare type EditorEvents = {
-    /** Событие наведения на объект (hover). Payload: объект с mesh или null */
+    /** Событие наведения на объект (hover). Payload: объект с пересечениями или null */
     [EventTopics.SelectHover]: {
-        mesh: THREE.Object3D;
+        intersection: THREE.Intersection;
     } | null;
-    /** Событие клика по объекту. Payload: объект с mesh или null */
+    /** Событие клика по объекту. Payload: объект с пересечениями или null */
     [EventTopics.SelectClick]: {
-        mesh: THREE.Object3D;
+        intersection: THREE.Intersection;
     } | null;
     /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
     [EventTopics.ToolSelect]: {
@@ -45,7 +46,7 @@ export declare type EditorEvents = {
  * Хаб для управления редактированием
  * @public
  */
-export declare class EditorHub {
+export declare class EditorHub implements Disposable_2 {
     private _displayManager;
     private _selectManager;
     private _toolManager;
@@ -57,7 +58,7 @@ export declare class EditorHub {
     resizeRenderer(): void;
     updateRenderer(): void;
     addFigure(figure: Figure): void;
-    destroy(): void;
+    dispose(): Promise<void> | void;
 }
 
 /**
@@ -75,7 +76,7 @@ export declare class EditorRenderer extends Renderer {
     private _transform;
     private readonly _transformHelper;
     /** Raycast для получения событий наведения/клика по модели*/
-    private _raycaster;
+    private readonly _raycaster;
     /** Курсор мыши */
     private readonly _mouse;
     /** Были ли инициализированы обработчики событий (hover/click) */
@@ -109,6 +110,12 @@ export declare class EditorRenderer extends Renderer {
      * @internal
      */
     detachTransformControls(): void;
+    /**
+     * Настройка режимов для `Raycaster`.
+     * @internal
+     */
+    setRaycastMode(mode: SelectMode): void;
+    dispose(): void;
     /** Инициализация обработчиков событий на hover/click */
     private _initMouseListeners;
     /** Обработчик события для hover */
@@ -141,9 +148,9 @@ export declare class EventBus {
  * @public
  */
 export declare enum EventTopics {
-    /** Событие наведения на объект (hover). Payload: mesh: Mesh | null */
+    /** Событие наведения на объект (hover). Payload: intersection: Intersection | null */
     SelectHover = "select.hover",
-    /** Событие клика по объекту. Payload: mesh: Mesh | null */
+    /** Событие клика по объекту. Payload: intersection: Intersection | null */
     SelectClick = "select.click",
     /** Событие выбора объекта для редактирования. Payload: mode: SelectMode, object: THREE.Object3D | null */
     ToolSelect = "tool.select"
@@ -161,15 +168,11 @@ export declare interface IDisplayManager extends IManager {
  * Каждый менеджер отвечает за одну фичу.
  * @public
  */
-export declare interface IManager {
+export declare interface IManager extends Disposable_2 {
     /**
      * Выполняет основное действие менеджера.
      */
     manage(...args: unknown[]): void;
-    /**
-     * Освобождает ресурсы менеджера.
-     */
-    destroy(): void;
 }
 
 /**
@@ -228,7 +231,7 @@ export declare class PreviewRenderer extends Renderer {
  * Отвечает за инициализацию сцены, камеры и цикла рендеринга.
  * @public
  */
-export declare abstract class Renderer {
+export declare abstract class Renderer implements Disposable_2 {
     /** Корневой объект сцены */
     protected scene: THREE.Scene;
     /** Камера для сцены */
@@ -261,7 +264,7 @@ export declare abstract class Renderer {
      */
     loop(): void;
     /**
-     * Публичный метод для добавления фигуры.
+     * Добавление фигуры на сцену.
      * @param figure - Данные фигуры: position, normal, uv
      */
     addFigure(figure: Figure): THREE.Mesh;
@@ -286,8 +289,58 @@ export declare abstract class Renderer {
      * @internal
      */
     getMeshes(): THREE.Mesh[];
-    /** Деструктор */
-    destroy(): void;
+    /**
+     * Добавляет объект в сцену и (опционально) выставляет ему слой.
+     *
+     * @param obj - Объект, который нужно добавить в сцену.
+     * @param layer - (Опц.) Номер слоя, который следует установить объекту перед добавлением.
+     *
+     * @remarks
+     * Если рендерер уже диспоузнут (scene отсутствует), метод тихо завершится.
+     * Слой задаётся через `obj.layers.set(layer)`, после чего объект добавляется в `this.scene`.
+     *
+     * @example
+     * // Добавить оверлей на слой подсветок:
+     * add(overlayLine, OVERLAY_LAYER);
+     *
+     * @internal
+     */
+    addObject(obj: THREE.Object3D, layer?: number): void;
+    /**
+     * Удаляет объект из сцены (или из его родителя, если он есть).
+     *
+     * @param obj - Объект, который необходимо удалить.
+     *
+     * @remarks
+     * Если у объекта есть `parent`, он будет удалён из родителя. Иначе — метод попытается
+     * удалить его напрямую из `this.scene`. В рамках данного API метод не отвечает за
+     * освобождение GPU-ресурсов; освобождайте геометрию/материалы отдельно при необходимости.
+     *
+     * @example
+     * // Снять оверлей со сцены:
+     * removeObject(overlayLine);
+     *
+     * @internal
+     */
+    removeObject(obj: THREE.Object3D): void;
+    /**
+     * Включает указанный слой у активной камеры.
+     *
+     * @param layer - Номер слоя, который требуется сделать видимым для камеры.
+     *
+     * @remarks
+     * Полезно для показа служебных оверлеев (например, подсветки) на отдельном слое.
+     * Метод не изменяет слои Raycaster — ими должен управлять другой слой API (например, IRaycastAPI).
+     *
+     * @example
+     * // Убедиться, что камера видит слой оверлеев:
+     * enableCameraLayer(OVERLAY_LAYER);
+     *
+     * @internal
+     */
+    enableCameraLayer(layer: number): void;
+    /** Освобождает ресурсы рендерера, очищает внутренние данные. */
+    dispose(): Promise<void> | void;
 }
 
 export { }

package/dist/index.public.d.ts

@@ -1,4 +1,5 @@
 import { DisplayMode } from '@planara/types';
+import { Disposable as Disposable_2 } from 'tsyringe';
 import { Figure } from '@planara/types';
 import { SelectMode } from '@planara/types';
 import * as THREE from 'three';
@@ -26,13 +27,13 @@ export declare function createAppHub(canvas: HTMLCanvasElement): EditorHub;
  * @public
  */
 export declare type EditorEvents = {
-    /** Событие наведения на объект (hover). Payload: объект с mesh или null */
+    /** Событие наведения на объект (hover). Payload: объект с пересечениями или null */
     [EventTopics.SelectHover]: {
-        mesh: THREE.Object3D;
+        intersection: THREE.Intersection;
     } | null;
-    /** Событие клика по объекту. Payload: объект с mesh или null */
+    /** Событие клика по объекту. Payload: объект с пересечениями или null */
     [EventTopics.SelectClick]: {
-        mesh: THREE.Object3D;
+        intersection: THREE.Intersection;
     } | null;
     /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
     [EventTopics.ToolSelect]: {
@@ -45,7 +46,7 @@ export declare type EditorEvents = {
  * Хаб для управления редактированием
  * @public
  */
-export declare class EditorHub {
+export declare class EditorHub implements Disposable_2 {
     private _displayManager;
     private _selectManager;
     private _toolManager;
@@ -57,7 +58,7 @@ export declare class EditorHub {
     resizeRenderer(): void;
     updateRenderer(): void;
     addFigure(figure: Figure): void;
-    destroy(): void;
+    dispose(): Promise<void> | void;
 }
 
 /**
@@ -75,7 +76,7 @@ export declare class EditorRenderer extends Renderer {
     private _transform;
     private readonly _transformHelper;
     /** Raycast для получения событий наведения/клика по модели*/
-    private _raycaster;
+    private readonly _raycaster;
     /** Курсор мыши */
     private readonly _mouse;
     /** Были ли инициализированы обработчики событий (hover/click) */
@@ -95,6 +96,8 @@ export declare class EditorRenderer extends Renderer {
     /* Excluded from this release type: setTransformControlsMode */
     /* Excluded from this release type: attachTransformControls */
     /* Excluded from this release type: detachTransformControls */
+    /* Excluded from this release type: setRaycastMode */
+    dispose(): void;
     /** Инициализация обработчиков событий на hover/click */
     private _initMouseListeners;
     /** Обработчик события для hover */
@@ -127,9 +130,9 @@ export declare class EventBus {
  * @public
  */
 export declare enum EventTopics {
-    /** Событие наведения на объект (hover). Payload: mesh: Mesh | null */
+    /** Событие наведения на объект (hover). Payload: intersection: Intersection | null */
     SelectHover = "select.hover",
-    /** Событие клика по объекту. Payload: mesh: Mesh | null */
+    /** Событие клика по объекту. Payload: intersection: Intersection | null */
     SelectClick = "select.click",
     /** Событие выбора объекта для редактирования. Payload: mode: SelectMode, object: THREE.Object3D | null */
     ToolSelect = "tool.select"
@@ -147,15 +150,11 @@ export declare interface IDisplayManager extends IManager {
  * Каждый менеджер отвечает за одну фичу.
  * @public
  */
-export declare interface IManager {
+export declare interface IManager extends Disposable_2 {
     /**
      * Выполняет основное действие менеджера.
      */
     manage(...args: unknown[]): void;
-    /**
-     * Освобождает ресурсы менеджера.
-     */
-    destroy(): void;
 }
 
 /**
@@ -201,7 +200,7 @@ export declare class ObjLoader {
  * Отвечает за инициализацию сцены, камеры и цикла рендеринга.
  * @public
  */
-export declare abstract class Renderer {
+export declare abstract class Renderer implements Disposable_2 {
     /** Корневой объект сцены */
     protected scene: THREE.Scene;
     /** Камера для сцены */
@@ -234,15 +233,18 @@ export declare abstract class Renderer {
      */
     loop(): void;
     /**
-     * Публичный метод для добавления фигуры.
+     * Добавление фигуры на сцену.
      * @param figure - Данные фигуры: position, normal, uv
      */
     addFigure(figure: Figure): THREE.Mesh;
     /* Excluded from this release type: addMesh */
     /* Excluded from this release type: removeMesh */
     /* Excluded from this release type: getMeshes */
-    /** Деструктор */
-    destroy(): void;
+    /* Excluded from this release type: addObject */
+    /* Excluded from this release type: removeObject */
+    /* Excluded from this release type: enableCameraLayer */
+    /** Освобождает ресурсы рендерера, очищает внутренние данные. */
+    dispose(): Promise<void> | void;
 }
 
 export { }