@planara/core 1.5.0 → 1.6.0

package/dist/index.full.d.ts

@@ -1,30 +1,74 @@
 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 { 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';
 
+/**
+ * Тип позиции камеры в мире.
+ * @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: Mesh;
+    } | null;
+    /** Событие клика по объекту. Payload: объект с mesh или null */
+    [EventTopics.SelectClick]: {
+        mesh: Mesh;
+    } | 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;
 }
 
+/**
+ * Расширение для Mesh с добавлением поля isHit, необходимого для raycast
+ * @public
+ */
+export declare class EditorMesh extends Mesh {
+    isHit: boolean;
+    constructor(gl: OGLRenderingContext, options?: Partial<MeshOptions>);
+}
+
 /**
  * Рендерер для редактора.
  * Добавляет сетку, оси координат и поддержку Orbit для управления камерой.
@@ -32,48 +76,21 @@ export declare class EditorHub {
  * @public
  */
 export declare class EditorRenderer extends Renderer {
+    private _canvas;
+    private _bus;
     /** Orbit-контроллер для управления камерой */
-    private orbit;
+    private _orbit;
     /** Raycast для подсветки моделей при наведении */
-    private raycast;
+    private _raycast;
     /** Курсор мыши для остлеживания наведения на 3D-модель */
-    private mouse;
+    private _mouse;
     /** Были ли зарегистрированы обработчики событий для мыши */
-    private isEventListenersAdded;
+    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[];
+    constructor(_canvas: HTMLCanvasElement, _bus: EventBus);
     /**
      * Обновление состояния рендерера.
      */
@@ -83,11 +100,15 @@ export declare class EditorRenderer extends Renderer {
      * Настройка raycast.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
+    addFigure(figure: Figure): EditorMesh;
     /**
-     * Обновление uniform uHit для конкретной 3D-модели
+     * Устанавливает callback, который будет вызываться перед рендером конкретного меша.
+     *
+     * @param mesh - Меш, для которого нужно задать callback.
+     * @param f - Функция обратного вызова, выполняемая перед рендером меша.
+     * @internal
      */
-    protected updateHitUniform(mesh: Mesh): void;
+    setMeshBeforeRender(mesh: Mesh, f: MeshRenderCallback): void;
     /**
      * Инициализация обработчиков мыши для raycast
      */
@@ -95,11 +116,47 @@ export declare class EditorRenderer extends Renderer {
     /**
      * Обработчик движения мыши
      */
-    private handleMouseMove;
+    private _handleMouseMove;
+    /**
+     * Обработчик клика мыши
+     */
+    private _handleMouseClick;
+    /**
+     * Универсальная логика raycast-события
+     */
+    private _processRaycastEvent;
     /** Деструктор */
     destroy(): void;
 }
 
+/**
+ * Событийная шина редактора с топиками.
+ * Используется для 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"
+}
+
 /**
  * Маркерный интерфейс для менеджеров отображения.
  * @public
@@ -123,17 +180,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 файла
@@ -153,7 +217,7 @@ export declare class ObjLoader {
  */
 export declare class PreviewRenderer extends Renderer {
     /** Orbit-контроллер для управления камерой */
-    private orbit;
+    private _orbit;
     /**
      * Инициализация сцены предпросмотра.
      * @param canvas - HTMLCanvasElement для рендеринга
@@ -208,7 +272,42 @@ export declare abstract class Renderer {
      * Публичный метод для добавления фигуры.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
+    addFigure(figure: Figure): EditorMesh;
+    /**
+     * Добавляет фигуру в сцену и сохраняет его во внутреннем массиве.
+     *
+     * @param mesh - Фигура для добавления в сцену.
+     * @internal
+     */
+    addMesh(mesh: Mesh): void;
+    /**
+     * Возвращает WebGL контекст рендерера.
+     *
+     * @returns Контекст WebGL (OGLRenderingContext) текущей сцены.
+     * @internal
+     */
+    getContext(): OGLRenderingContext_2;
+    /**
+     * Убирает фигуру со сцены
+     *
+     * @param mesh - Фигура для удаления со сцены.
+     * @internal
+     */
+    removeMesh(mesh: Mesh): void;
+    /**
+     * Возвращает список всех фигур, находящихся в сцене.
+     *
+     * @returns Массив текущих фигур.
+     * @internal
+     */
+    getMeshes(): Mesh[];
+    /**
+     * Возвращает настройку для рендеринга.
+     *
+     * @returns Program для настройки рендеринга моделей.
+     * @internal
+     */
+    getProgram(): Program;
     /** Деструктор */
     destroy(): void;
 }

package/dist/index.public.d.ts

@@ -1,30 +1,74 @@
 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 { 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';
 
+/**
+ * Тип позиции камеры в мире.
+ * @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: Mesh;
+    } | null;
+    /** Событие клика по объекту. Payload: объект с mesh или null */
+    [EventTopics.SelectClick]: {
+        mesh: Mesh;
+    } | 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;
 }
 
+/**
+ * Расширение для Mesh с добавлением поля isHit, необходимого для raycast
+ * @public
+ */
+export declare class EditorMesh extends Mesh {
+    isHit: boolean;
+    constructor(gl: OGLRenderingContext, options?: Partial<MeshOptions>);
+}
+
 /**
  * Рендерер для редактора.
  * Добавляет сетку, оси координат и поддержку Orbit для управления камерой.
@@ -32,24 +76,21 @@ export declare class EditorHub {
  * @public
  */
 export declare class EditorRenderer extends Renderer {
+    private _canvas;
+    private _bus;
     /** Orbit-контроллер для управления камерой */
-    private orbit;
+    private _orbit;
     /** Raycast для подсветки моделей при наведении */
-    private raycast;
+    private _raycast;
     /** Курсор мыши для остлеживания наведения на 3D-модель */
-    private mouse;
+    private _mouse;
     /** Были ли зарегистрированы обработчики событий для мыши */
-    private isEventListenersAdded;
+    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 */
+    constructor(_canvas: HTMLCanvasElement, _bus: EventBus);
     /**
      * Обновление состояния рендерера.
      */
@@ -59,11 +100,8 @@ export declare class EditorRenderer extends Renderer {
      * Настройка raycast.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
-    /**
-     * Обновление uniform uHit для конкретной 3D-модели
-     */
-    protected updateHitUniform(mesh: Mesh): void;
+    addFigure(figure: Figure): EditorMesh;
+    /* Excluded from this release type: setMeshBeforeRender */
     /**
      * Инициализация обработчиков мыши для raycast
      */
@@ -71,11 +109,47 @@ export declare class EditorRenderer extends Renderer {
     /**
      * Обработчик движения мыши
      */
-    private handleMouseMove;
+    private _handleMouseMove;
+    /**
+     * Обработчик клика мыши
+     */
+    private _handleMouseClick;
+    /**
+     * Универсальная логика raycast-события
+     */
+    private _processRaycastEvent;
     /** Деструктор */
     destroy(): void;
 }
 
+/**
+ * Событийная шина редактора с топиками.
+ * Используется для 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"
+}
+
 /**
  * Маркерный интерфейс для менеджеров отображения.
  * @public
@@ -99,17 +173,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 файла
@@ -166,7 +247,12 @@ export declare abstract class Renderer {
      * Публичный метод для добавления фигуры.
      * @param figure - Данные фигуры: position, normal, uv
      */
-    addFigure(figure: Figure): Mesh<Geometry, Program>;
+    addFigure(figure: Figure): EditorMesh;
+    /* 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;
 }