@planara/core 1.5.0 → 2.0.0

package/dist/index.full.d.ts

@@ -1,27 +1,54 @@
-import { Camera } from 'ogl';
 import { DisplayMode } from '@planara/types';
 import { Figure } from '@planara/types';
-import { Geometry } from 'ogl';
-import { Mesh } from 'ogl';
-import { OGLRenderingContext } from 'ogl';
-import { Program } from 'ogl';
-import { Renderer as Renderer_2 } from 'ogl';
-import { Transform } from 'ogl';
+import { SelectMode } from '@planara/types';
+import * as THREE from 'three';
+
+/**
+ * Тип позиции камеры в мире.
+ * @public
+ */
+export declare type CameraPosition = {
+    x: number;
+    y: number;
+    z: number;
+};
 
 /**
  * Создаёт или возвращает готовый экземпляр хаба.
  * @public
  */
-export declare function createAppHub(renderer: Renderer): EditorHub;
+export declare function createAppHub(canvas: HTMLCanvasElement): EditorHub;
+
+/**
+ * Типы событий редактора.
+ * Используются в EventEmitter для типизированной публикации и подписки на события.
+ * @public
+ */
+export declare type EditorEvents = {
+    /** Событие наведения на объект (hover). Payload: объект с mesh или null */
+    [EventTopics.SelectHover]: {
+        mesh: THREE.Object3D;
+    } | null;
+    /** Событие клика по объекту. Payload: объект с mesh или null */
+    [EventTopics.SelectClick]: {
+        mesh: THREE.Object3D;
+    } | null;
+};
 
 /**
  * Хаб для управления редактированием
  * @public
  */
 export declare class EditorHub {
-    private displayManager;
-    constructor(displayManager: IDisplayManager);
+    private _displayManager;
+    private _selectManager;
+    private _renderer;
+    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _renderer: EditorRenderer);
     setDisplayMode(mode: DisplayMode): void;
+    setSelectMode(mode: SelectMode): void;
+    resizeRenderer(): void;
+    updateRenderer(): void;
+    addFigure(figure: Figure): void;
     destroy(): void;
 }
 
@@ -32,72 +59,52 @@ export declare class EditorHub {
  * @public
  */
 export declare class EditorRenderer extends Renderer {
+    private _canvas;
+    private _bus;
     /** Orbit-контроллер для управления камерой */
-    private orbit;
-    /** Raycast для подсветки моделей при наведении */
-    private raycast;
-    /** Курсор мыши для остлеживания наведения на 3D-модель */
-    private mouse;
-    /** Были ли зарегистрированы обработчики событий для мыши */
-    private isEventListenersAdded;
-    /**
-     * Инициализация сцены редактора.
-     * Создает сетку, оси координат и orbit-контроллер.
-     * @param canvas - HTMLCanvasElement для рендеринга
-     */
-    constructor(canvas: HTMLCanvasElement);
-    /**
-     * Добавляет фигуру в сцену и сохраняет его во внутреннем массиве.
-     *
-     * @param mesh - Фигура для добавления в сцену.
-     * @internal
-     */
-    addMesh(mesh: Mesh): void;
-    /**
-     * Возвращает WebGL контекст рендерера.
-     *
-     * @returns Контекст WebGL (OGLRenderingContext) текущей сцены.
-     * @internal
-     */
-    getContext(): OGLRenderingContext;
-    /**
-     * Убирает фигуру со сцены
-     *
-     * @param mesh - Фигура для удаления со сцены.
-     * @internal
-     */
-    removeMesh(mesh: Mesh): void;
-    /**
-     * Возвращает список всех фигур, находящихся в сцене.
-     *
-     * @returns Массив текущих фигур.
-     * @internal
-     */
-    getMeshes(): Mesh[];
+    private _orbit;
+    private _raycaster;
+    private readonly _mouse;
+    private _isEventListenersAdded;
+    private _lastHovered;
+    constructor(_canvas: HTMLCanvasElement, _bus: EventBus);
     /**
      * Обновление состояния рендерера.
      */
     protected update(): void;
-    /**
-     * Метод для добавления фигуры.
-     * Настройка raycast.
-     * @param figure - Данные фигуры: position, normal, uv
-     */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
-    /**
-     * Обновление uniform uHit для конкретной 3D-модели
-     */
-    protected updateHitUniform(mesh: Mesh): void;
-    /**
-     * Инициализация обработчиков мыши для raycast
-     */
+    addFigure(figure: Figure): THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>;
     private initMouseListeners;
-    /**
-     * Обработчик движения мыши
-     */
-    private handleMouseMove;
-    /** Деструктор */
-    destroy(): void;
+    private _handleMouseMove;
+    private _handleMouseClick;
+    private _processRaycastEvent;
+}
+
+/**
+ * Событийная шина редактора с топиками.
+ * Используется для publish/subscribe без прямых зависимостей.
+ * @public
+ */
+export declare class EventBus {
+    private _emitter;
+    constructor();
+    /** Публикация события */
+    emit<K extends keyof EditorEvents>(event: K, payload: EditorEvents[K]): void;
+    /** Подписка на событие */
+    on<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
+    /** Отписка от события */
+    off<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
+}
+
+/**
+ * Топики событий редактора.
+ * Используются для подписки/публикации через EventEmitter.
+ * @public
+ */
+export declare enum EventTopics {
+    /** Событие наведения на объект (hover). Payload: mesh: Mesh | null */
+    SelectHover = "select.hover",
+    /** Событие клика по объекту. Payload: mesh: Mesh | null */
+    SelectClick = "select.click"
 }
 
 /**
@@ -123,17 +130,24 @@ export declare interface IManager {
     destroy(): void;
 }
 
+/**
+ * Маркерный интерфейс для менеджеров выборки.
+ * @public
+ */
+export declare interface ISelectManager extends IManager {
+}
+
 /** @public */
 export declare class ObjLoader {
     /** Позиции вершин */
-    private positions;
+    private _positions;
     /** Нормали вершин */
-    private normals;
+    private _normals;
     /** UV-координаты (опционально) */
-    private uvs;
-    private tmpPositions;
-    private tmpNormals;
-    private tmpUVs;
+    private _uvs;
+    private _tmpPositions;
+    private _tmpNormals;
+    private _tmpUVs;
     /**
      * Загружает OBJ-модель в Figure
      * @param objContent - Строка содержимого .obj файла
@@ -147,17 +161,12 @@ export declare class ObjLoader {
 
 /**
  * Рендерер для предпросмотра 3D-модели.
- * Настраивает сцену, камеру и орбитальную навигацию (по горизонтали).
- * Наследуется от базового Renderer.
+ * Настраивает сцену, камеру и орбитальную навигацию по горизонтали.
  * @alpha
  */
 export declare class PreviewRenderer extends Renderer {
     /** Orbit-контроллер для управления камерой */
-    private orbit;
-    /**
-     * Инициализация сцены предпросмотра.
-     * @param canvas - HTMLCanvasElement для рендеринга
-     */
+    private _orbit;
     constructor(canvas: HTMLCanvasElement);
     /**
      * Обновление состояния рендерера.
@@ -171,18 +180,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 для рендеринга
@@ -208,7 +215,28 @@ export declare abstract class Renderer {
      * Публичный метод для добавления фигуры.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
+    addFigure(figure: Figure): THREE.Mesh;
+    /**
+     * Добавляет фигуру в сцену и сохраняет его во внутреннем массиве.
+     *
+     * @param mesh - Фигура для добавления в сцену.
+     * @internal
+     */
+    addMesh(mesh: THREE.Mesh): void;
+    /**
+     * Убирает фигуру со сцены
+     *
+     * @param mesh - Фигура для удаления со сцены.
+     * @internal
+     */
+    removeMesh(mesh: THREE.Mesh): void;
+    /**
+     * Возвращает список всех фигур, находящихся в сцене.
+     *
+     * @returns Массив текущих фигур.
+     * @internal
+     */
+    getMeshes(): THREE.Mesh[];
     /** Деструктор */
     destroy(): void;
 }

package/dist/index.public.d.ts

@@ -1,27 +1,54 @@
-import { Camera } from 'ogl';
 import { DisplayMode } from '@planara/types';
 import { Figure } from '@planara/types';
-import { Geometry } from 'ogl';
-import { Mesh } from 'ogl';
-import { OGLRenderingContext } from 'ogl';
-import { Program } from 'ogl';
-import { Renderer as Renderer_2 } from 'ogl';
-import { Transform } from 'ogl';
+import { SelectMode } from '@planara/types';
+import * as THREE from 'three';
+
+/**
+ * Тип позиции камеры в мире.
+ * @public
+ */
+export declare type CameraPosition = {
+    x: number;
+    y: number;
+    z: number;
+};
 
 /**
  * Создаёт или возвращает готовый экземпляр хаба.
  * @public
  */
-export declare function createAppHub(renderer: Renderer): EditorHub;
+export declare function createAppHub(canvas: HTMLCanvasElement): EditorHub;
+
+/**
+ * Типы событий редактора.
+ * Используются в EventEmitter для типизированной публикации и подписки на события.
+ * @public
+ */
+export declare type EditorEvents = {
+    /** Событие наведения на объект (hover). Payload: объект с mesh или null */
+    [EventTopics.SelectHover]: {
+        mesh: THREE.Object3D;
+    } | null;
+    /** Событие клика по объекту. Payload: объект с mesh или null */
+    [EventTopics.SelectClick]: {
+        mesh: THREE.Object3D;
+    } | null;
+};
 
 /**
  * Хаб для управления редактированием
  * @public
  */
 export declare class EditorHub {
-    private displayManager;
-    constructor(displayManager: IDisplayManager);
+    private _displayManager;
+    private _selectManager;
+    private _renderer;
+    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _renderer: EditorRenderer);
     setDisplayMode(mode: DisplayMode): void;
+    setSelectMode(mode: SelectMode): void;
+    resizeRenderer(): void;
+    updateRenderer(): void;
+    addFigure(figure: Figure): void;
     destroy(): void;
 }
 
@@ -32,48 +59,52 @@ export declare class EditorHub {
  * @public
  */
 export declare class EditorRenderer extends Renderer {
+    private _canvas;
+    private _bus;
     /** Orbit-контроллер для управления камерой */
-    private orbit;
-    /** Raycast для подсветки моделей при наведении */
-    private raycast;
-    /** Курсор мыши для остлеживания наведения на 3D-модель */
-    private mouse;
-    /** Были ли зарегистрированы обработчики событий для мыши */
-    private isEventListenersAdded;
-    /**
-     * Инициализация сцены редактора.
-     * Создает сетку, оси координат и orbit-контроллер.
-     * @param canvas - HTMLCanvasElement для рендеринга
-     */
-    constructor(canvas: HTMLCanvasElement);
-    /* Excluded from this release type: addMesh */
-    /* Excluded from this release type: getContext */
-    /* Excluded from this release type: removeMesh */
-    /* Excluded from this release type: getMeshes */
+    private _orbit;
+    private _raycaster;
+    private readonly _mouse;
+    private _isEventListenersAdded;
+    private _lastHovered;
+    constructor(_canvas: HTMLCanvasElement, _bus: EventBus);
     /**
      * Обновление состояния рендерера.
      */
     protected update(): void;
-    /**
-     * Метод для добавления фигуры.
-     * Настройка raycast.
-     * @param figure - Данные фигуры: position, normal, uv
-     */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
-    /**
-     * Обновление uniform uHit для конкретной 3D-модели
-     */
-    protected updateHitUniform(mesh: Mesh): void;
-    /**
-     * Инициализация обработчиков мыши для raycast
-     */
+    addFigure(figure: Figure): THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>;
     private initMouseListeners;
-    /**
-     * Обработчик движения мыши
-     */
-    private handleMouseMove;
-    /** Деструктор */
-    destroy(): void;
+    private _handleMouseMove;
+    private _handleMouseClick;
+    private _processRaycastEvent;
+}
+
+/**
+ * Событийная шина редактора с топиками.
+ * Используется для publish/subscribe без прямых зависимостей.
+ * @public
+ */
+export declare class EventBus {
+    private _emitter;
+    constructor();
+    /** Публикация события */
+    emit<K extends keyof EditorEvents>(event: K, payload: EditorEvents[K]): void;
+    /** Подписка на событие */
+    on<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
+    /** Отписка от события */
+    off<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
+}
+
+/**
+ * Топики событий редактора.
+ * Используются для подписки/публикации через EventEmitter.
+ * @public
+ */
+export declare enum EventTopics {
+    /** Событие наведения на объект (hover). Payload: mesh: Mesh | null */
+    SelectHover = "select.hover",
+    /** Событие клика по объекту. Payload: mesh: Mesh | null */
+    SelectClick = "select.click"
 }
 
 /**
@@ -99,17 +130,24 @@ export declare interface IManager {
     destroy(): void;
 }
 
+/**
+ * Маркерный интерфейс для менеджеров выборки.
+ * @public
+ */
+export declare interface ISelectManager extends IManager {
+}
+
 /** @public */
 export declare class ObjLoader {
     /** Позиции вершин */
-    private positions;
+    private _positions;
     /** Нормали вершин */
-    private normals;
+    private _normals;
     /** UV-координаты (опционально) */
-    private uvs;
-    private tmpPositions;
-    private tmpNormals;
-    private tmpUVs;
+    private _uvs;
+    private _tmpPositions;
+    private _tmpNormals;
+    private _tmpUVs;
     /**
      * Загружает OBJ-модель в Figure
      * @param objContent - Строка содержимого .obj файла
@@ -129,18 +167,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 для рендеринга
@@ -166,7 +202,10 @@ export declare abstract class Renderer {
      * Публичный метод для добавления фигуры.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
+    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;
 }