@planara/core 2.7.1 → 3.0.0

package/dist/index.full.d.ts

@@ -28,7 +28,9 @@ export declare const createAppHub: (canvas: HTMLCanvasElement) => EditorHub;
 /**
  * Типы событий редактора.
  * Используются в EventEmitter для типизированной публикации и подписки на события.
+ *
  * @public
+ * @type
  */
 export declare type EditorEvents = {
     /** Событие наведения на объект (hover). Payload: объект с пересечениями или null */
@@ -39,11 +41,6 @@ export declare type EditorEvents = {
     [EventTopics.SelectClick]: {
         intersection: THREE.Intersection;
     } | null;
-    /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
-    [EventTopics.ToolSelect]: {
-        mode: SelectMode;
-        mesh: THREE.Object3D | null;
-    };
 };
 
 /**
@@ -51,169 +48,548 @@ export declare type EditorEvents = {
  * @public
  */
 export declare class EditorHub implements Disposable_2 {
-    private _displayManager;
-    private _selectManager;
-    private _toolManager;
-    private _sceneManager;
     private _renderer;
+    private _mediator;
     private _store;
-    constructor(_displayManager: IDisplayManager, _selectManager: ISelectManager, _toolManager: IToolManager, _sceneManager: ISceneManager, _renderer: EditorRenderer, _store: IEditorStore);
-    setDisplayMode(mode: DisplayMode): void;
-    setSceneMode(sceneMode: SceneMode): void;
-    setSelectMode(mode: SelectMode): void;
-    setToolMode(mode: ToolType): void;
+    private _controller;
+    constructor(_renderer: Renderer, _mediator: IMediator, _store: ITransformStore, _controller: IController);
+    setDisplayMode(mode: DisplayMode): IResponse | null;
+    setSceneMode(mode: SceneMode): IResponse | null;
+    setSelectMode(mode: SelectMode): IResponse | null;
+    setToolMode(mode: ToolType): IResponse | null;
+    addFigure(mode: SceneMode, figure: FigureType): IResponse | null;
     resizeRenderer(): void;
-    updateRenderer(): void;
-    addFigure(mode: SceneMode, figure: FigureType): void;
+    /**
+     * Запускает редактор.
+     * Вызывается после создания хаба.
+     */
+    start(): void;
+    /**
+     * Останавливает редактор.
+     */
+    stop(): void;
     getSelectionStats(): FigureTransform | null;
     onSelectionStatsChange(listener: () => void): () => void;
     dispose(): Promise<void> | void;
 }
 
 /**
- * Рендерер для редактора.
- * Добавляет сетку, оси координат и поддержку Orbit для управления камерой.
- * Наследуется от базового Renderer.
+ * Событийная шина редактора с типизированными топиками.
+ *
+ * @remarks
+ * Реализует паттерн Publish/Subscribe для слабой связи между компонентами.
+ *
+ * **Особенности:**
+ * - Полная типобезопасность через дженерики (`EditorEvents`)
+ * - Отсутствие прямых зависимостей между отправителем и получателем
+ * - Централизованное управление событиями
+ *
+ * **Где используется:**
+ * - `RaycasterModule` — публикует события выделения (`SelectHover`, `SelectClick`)
+ * - `SelectManager` — подписывается на события выделения
+ *
+ * @see {@link EditorEvents} - типы событий
+ * @see {@link EventTopics} - доступные топики
+ *
  * @public
+ * @class
  */
-export declare class EditorRenderer extends Renderer {
-    private _canvas;
-    private _bus;
-    /** Orbit-контроллер для управления камерой */
-    private _orbit;
-    /** Transform-контроллер для редактирования */
-    private _transform;
-    private readonly _transformHelper;
-    /** Raycast для получения событий наведения/клика по модели*/
-    private readonly _raycaster;
-    /** Курсор мыши */
-    private readonly _mouse;
-    /** Были ли инициализированы обработчики событий (hover/click) */
-    private _isEventListenersAdded;
-    /**
-     * Последняя модель на которую наводились,
-     * необходима для отправки только уникальных событий в event bus
-     */
-    private _lastHovered;
-    /** Gizmo для управления отображением perspective camera */
-    private _cameraGizmo;
-    private _transformListeners;
-    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>;
-    /**
-     * Смена отображения `TransformControls` в зависимости от типа инструмента.
-     * @param mode - тип инструмента для отображения `TransformControls`.
-     * @internal
-     */
-    setTransformControlsMode(mode: ToolType): void;
+export declare class EventBus {
     /**
-     * Добавление `TransformControls` к объекту.
-     * @param object - объект, к которому добавляются `TransformControls`.
-     * @internal
+     * Внутренний эмиттер событий Node.js.
+     *
+     * @private
+     * @member
      */
-    attachTransformControls(object: THREE.Object3D): void;
+    private _emitter;
+    /** @constructor */
+    constructor();
     /**
-     * Удаление `TransformControls` с последнего выбранного объекта.
-     * @internal
+     * Публикует событие в шину.
+     *
+     * @param event - название события (из `EventTopics`)
+     * @param payload - данные события (тип зависит от события)
+     *
+     * @typeParam K - ключ события из `EditorEvents`
+     *
+     * @remarks
+     * Все подписчики, зарегистрированные на это событие, получат payload.
+     *
+     * @example
+     * ```typescript
+     * // Публикация события клика
+     * eventBus.emit(EventTopics.SelectClick, { intersection: hit });
+     *
+     * // Публикация события сброса выделения
+     * eventBus.emit(EventTopics.SelectClick, null);
+     * ```
+     *
+     * @public
+     * @method
      */
-    detachTransformControls(): void;
+    emit<K extends keyof EditorEvents>(event: K, payload: EditorEvents[K]): void;
     /**
-     * Подписывает слушателя на изменения трансформации текущего объекта.
-     * @internal
+     * Подписывается на событие.
+     *
+     * @param event - название события (из `EventTopics`)
+     * @param listener - функция-обработчик, получающая payload
+     *
+     * @typeParam K - ключ события из `EditorEvents`
+     *
+     * @remarks
+     * **Важно:** для предотвращения утечек памяти необходимо отписываться от событий
+     * в `dispose()` методах компонентов.
+     *
+     * @example
+     * ```typescript
+     * // Подписка на событие hover
+     * this._eventBus.on(EventTopics.SelectHover, (payload) => {
+     *   if (payload) {
+     *     this._handleHover(payload.intersection);
+     *   } else {
+     *     this._clearHover();
+     *   }
+     * });
+     * ```
+     *
+     * @public
+     * @method
      */
-    onTransformChange(cb: TransformListener): () => void;
+    on<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
     /**
-     * Настройка режимов для `Raycaster`.
-     * @internal
+     * Отписывается от события.
+     *
+     * @param event - название события (из `EventTopics`)
+     * @param listener - функция-обработчик, которую нужно отписать
+     *
+     * @typeParam K - ключ события из `EditorEvents`
+     *
+     * @remarks
+     * Для корректной отписки необходимо передать ту же самую функцию,
+     * которая использовалась при подписке.
+     *
+     * @example
+     * ```typescript
+     * // Сохранение ссылки на обработчик
+     * private _handleClick = (payload) => { ... };
+     *
+     * // Подписка
+     * eventBus.on(EventTopics.SelectClick, this._handleClick);
+     *
+     * // Отписка (в dispose)
+     * eventBus.off(EventTopics.SelectClick, this._handleClick);
+     * ```
+     *
+     * @public
+     * @method
      */
-    setRaycastMode(mode: SelectMode): void;
-    dispose(): void;
-    protected render(): void;
-    /** Инициализация обработчиков событий на hover/click */
-    private _initMouseListeners;
-    /** Обработчик события для hover */
-    private _handleMouseMove;
-    /** Обработчик события на click */
-    private _handleMouseClick;
-    /** Вспомогательный метод для получения модели, которую выбрали и отправки события в event bus */
-    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
+ * @enum
  */
 export declare enum EventTopics {
     /** Событие наведения на объект (hover). Payload: intersection: Intersection | null */
     SelectHover = "select.hover",
     /** Событие клика по объекту. Payload: intersection: Intersection | null */
-    SelectClick = "select.click",
-    /** Событие выбора объекта для редактирования. Payload: mode: SelectMode, object: THREE.Object3D | null */
-    ToolSelect = "tool.select"
+    SelectClick = "select.click"
+}
+
+/**
+ * Тип фичи, совпадает с менеджерами
+ *
+ * @public
+ */
+export declare enum FeatureType {
+    /** Отображение */
+    Display = 0,
+    /** Управление сценой */
+    Scene = 1,
+    /** Выборка */
+    Select = 2,
+    /** Инструменты */
+    Tool = 3
 }
 
 /**
  * Возвращает уже созданный хаб, если редактор инициализирован.
+ * @public
  */
 export declare const getAppHub: () => EditorHub;
 
 /**
- * Маркерный интерфейс для менеджера отображения.
  * @public
  */
-export declare interface IDisplayManager extends IManager {
+export declare interface ICommand {
+    type: FeatureType;
+    payload: unknown[];
 }
 
-/** @public */
-export declare interface IEditorStore {
-    /** Возвращает текущий режим выбора. */
-    getSelectMode(): SelectMode;
-    /** Возвращает текущий активный инструмент. */
-    getToolType(): ToolType;
-    /** Возвращает текущий режим отображения. */
-    getDisplayMode(): DisplayMode;
+/**
+ * Интерфейс для контроллера, управляющего жизненным циклом модулей.
+ *
+ * @remarks
+ * Контроллер отвечает за:
+ * - инициализацию модулей (`IRuntimeModule`)
+ * - запуск цикла рендеринга
+ * - обновление модулей каждый кадр (`IUpdatableModule`)
+ * - рендеринг модулей (`IRenderableModule`)
+ * - остановку и очистку ресурсов
+ *
+ * @public
+ * @interface
+ */
+export declare interface IController extends Disposable_2 {
     /**
-     * Устанавливает режим выбора.
-     * @param mode - Режим выбора (Mesh/Face/Edge/Vertex и т.п.).
+     * Запускает контроллер.
+     *
+     * @remarks
+     * Инициализирует все модули и запускает цикл рендеринга.
+     *
+     * @public
+     * @method
      */
-    setSelectMode(mode: SelectMode): void;
+    start(): void;
     /**
-     * Устанавливает активный инструмент.
-     * @param toolType - Тип инструмента (Translate/Rotate/Scale и т.п.).
+     * Останавливает контроллер.
+     *
+     * @remarks
+     * Останавливает цикл рендеринга и освобождает ресурсы.
+     *
+     * @public
+     * @method
      */
-    setToolType(toolType: ToolType): void;
+    stop(): void;
+}
+
+/**
+ * Интерфейс store для менеджеров и хендлеров, которые позволяют работать с Display фичей,
+ * необходим для корректного взаимодействия между группами фичей.
+ *
+ * Можно получить:
+ * - текущий режим отображения
+ *
+ * @public
+ * @interface
+ */
+export declare interface IDisplayStore {
+    /** Возвращает текущий режим отображения. */
+    getDisplayMode(): DisplayMode;
     /**
      * Устанавливает режим отображения.
      * @param mode - Режим отображения (зависит от твоего домена).
      */
     setDisplayMode(mode: DisplayMode): void;
+}
+
+/**
+ * Интерфейс медиатора команд редактора.
+ *
+ * @remarks
+ * Медиатор выступает промежуточным слоем между публичным API хаба
+ * и менеджерами конкретных функциональных областей редактора.
+ *
+ * Основные задачи медиатора:
+ * - принять команду от верхнего уровня
+ * - определить менеджер, отвечающий за указанную фичу
+ * - передать вызов в pipeline middleware
+ * - вернуть итоговый ответ выполнения команды
+ *
+ * В штатном сценарии успешное выполнение команды может не формировать явный ответ и возвращать `null`.
+ * Если в процессе обработки возникает исключение, например ошибка политики,
+ * оно может быть преобразовано middleware в объект `IResponse`.
+ *
+ * @public
+ * @interface
+ */
+export declare interface IMediator extends Disposable_2 {
+    /**
+     * Отправляет команду на выполнение через middleware pipeline в соответствующий менеджер редактора.
+     *
+     * @param command - команда, содержащая тип фичи и аргументы вызова
+     *
+     * @returns результат выполнения команды:
+     * - `null`, если команда выполнена успешно и не требует явного ответа
+     * - `IResponse`, если в ходе обработки был сформирован ответ, например при ошибке или блокировке действия
+     *
+     * @example
+     * ```typescript
+     * const response = mediator.send({
+     *   type: FeatureType.Tool,
+     *   payload: [ToolType.Rotate],
+     * });
+     *
+     * if (response?.blocked) {
+     *   console.warn(response.message);
+     * }
+     * ```
+     *
+     * @public
+     * @method
+     */
+    send(command: ICommand): IResponse | null;
+}
+
+/**
+ * Интерфейс для объектов, которые могут быть отрисованы.
+ *
+ * @remarks
+ * Предназначен для модулей, которым требуется кастомный рендеринг
+ * поверх основной сцены (например, `GizmoModule`).
+ *
+ * **Отличие от `IUpdatableModule`:**
+ * - `render()` вызывается **после** основного рендера сцены
+ * - `render()` предназначен для отрисовки дополнительных элементов
+ *   (осей координат, отладочной информации, оверлеев)
+ *
+ * **Жизненный цикл:**
+ * 1. `init()` (из `IRuntimeModule`) — создание ресурсов
+ * 2. `render()` — отрисовка (вызывается каждый кадр)
+ * 3. `dispose()` (из `IRuntimeModule`) — освобождение ресурсов
+ *
+ * @public
+ * @interface
+ */
+export declare interface IRenderable {
+    /**
+     * Выполняет кастомный рендеринг объекта.
+     *
+     * @remarks
+     * Вызывается каждый кадр **после** основного рендера сцены.
+     *
+     * **Важно:** метод не должен выполнять тяжёлые операции,
+     * чтобы не снижать производительность.
+     *
+     * @example
+     * ```typescript
+     * public render(): void {
+     *   const canvas = this._domApi.getCanvas();
+     *   this._gizmo?.render(canvas.width, canvas.height);
+     *   this._drawFPS();
+     * }
+     * ```
+     *
+     * @public
+     * @method
+     */
+    render(): void;
+}
+
+/**
+ * Низкоуровневый доступ к WebGLRenderer.
+ *
+ * @remarks
+ * Этот интерфейс **реализуется самим рендерером** (`Renderer`).
+ * Предоставляет прямой доступ к WebGLRenderer Three.js.
+ *
+ * Используется **только внутренними API-слоями** (например, `RendererApi`),
+ * но не модулями напрямую.
+ *
+ * @see {@link Renderer} - класс, реализующий этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export declare interface IRendererAccess {
+    /**
+     * Возвращает WebGLRenderer.
+     *
+     * @returns THREE.WebGLRenderer - рендерер Three.js
+     *
+     * @example
+     * ```typescript
+     * // Использование в RendererApi
+     * const renderer = this._rendererAccess.getRenderer();
+     * ```
+     *
+     * @public
+     * @method
+     */
+    getRenderer(): THREE.WebGLRenderer;
+}
+
+/**
+ * Предоставляет низкоуровневый доступ к камере рендерера.
+ *
+ * Этот интерфейс используется внутренними модулями (например, `CameraApi`) для
+ * получения прямого доступа к камере `Three.js`. Он не содержит логики управления
+ * камерой — только доступ к объекту.
+ *
+ * @remarks
+ * В отличие от `ICameraApi`, который предоставляет высокоуровневые операции
+ * (включение слоёв, настройка параметров), этот интерфейс нужен только для
+ * чтения камеры.
+ *
+ * @see {@link Renderer} - класс, который реализует этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export declare interface IRendererCameraAccess {
+    /**
+     * Возвращает камеру рендерера.
+     *
+     * @returns Камера Three.js.
+     *
+     * @example
+     * ```typescript
+     * const camera = cameraAccess.getCamera();
+     * camera.position.set(5, 5, 5);
+     * camera.lookAt(0, 0, 0);
+     * ```
+     *
+     * @public
+     * @method
+     */
+    getCamera(): THREE.Camera;
+}
+
+/**
+ * Низкоуровневый доступ к DOM-элементам рендерера.
+ *
+ * @remarks
+ * Этот интерфейс предоставляет доступ к canvas и DOM-элементу рендерера.
+ * Используется внутренними API-слоями (например, `DomApi`)
+ * для получения доступа к DOM без необходимости знать конкретную реализацию рендерера.
+ *
+ * @see {@link Renderer} - класс, реализующий этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export declare interface IRendererDomAccess {
+    /**
+     * Возвращает canvas-элемент редактора.
+     *
+     * @remarks
+     * Canvas используется для рендеринга 3D-сцены.
+     *
+     * @returns HTMLCanvasElement - canvas элемент
+     *
+     * @example
+     * ```typescript
+     * const canvas = domAccess.getCanvas();
+     * ```
+     *
+     * @public
+     */
+    getCanvas(): HTMLCanvasElement;
+    /**
+     * Возвращает DOM-элемент рендерера.
+     *
+     * @remarks
+     * Обычно это тот же canvas, но в некоторых случаях может быть
+     * другим элементом (например, div-обёрткой). Используется для
+     * подписки на события ввода (mousemove, click, dblclick и т.д.).
+     *
+     * @returns HTMLElement - DOM-элемент для подписки на события
+     *
+     * @example
+     * ```typescript
+     * const domElement = domAccess.getDomElement();
+     * ```
+     *
+     * @public
+     * @method
+     */
+    getDomElement(): HTMLElement;
+}
+
+/**
+ * Низкоуровневый доступ к сцене рендерера.
+ *
+ * @remarks
+ * Этот интерфейс предоставляет доступ к сцене Three.js.
+ * Используется внутренними API-слоями (например, `SceneApi`)
+ * для получения доступа к сцене без необходимости знать конкретную
+ * реализацию рендерера.
+ *
+ * @see {@link Renderer} - класс, реализующий этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export declare interface IRendererSceneAccess {
+    /**
+     * Возвращает сцену рендерера.
+     *
+     * @returns THREE.Scene - сцена Three.js
+     *
+     * @remarks
+     * Сцена содержит все объекты, которые рендерятся на экране.
+     * Через неё можно добавлять, удалять и модифицировать объекты.
+     *
+     * @example
+     * ```typescript
+     * const scene = sceneAccess.getScene();
+     *
+     * // Добавление объекта
+     * scene.add(myMesh);
+     *
+     * // Поиск объекта по имени
+     * const obj = scene.getObjectByName('myObject');
+     *
+     * // Удаление объекта
+     * scene.remove(obj);
+     * ```
+     *
+     * @public
+     * @method
+     */
+    getScene(): THREE.Scene;
+}
+
+/**
+ * Тип ответа от менеджеров или политик редактора.
+ *
+ * @remarks
+ * Используется для единого API на уровне Hub.
+ * Все менеджеры возвращают `Response`, чтобы клиент знал статус вызова.
+ *
+ * @public
+ * @interface
+ */
+export declare interface IResponse {
+    /** Тип ответа (enum ResponseType) */
+    type: ResponseType_2;
+    /** Читаемое сообщение для отображения или логирования */
+    message: string;
+    /** Строковый код для логов или интеграций (опционально) */
+    code?: string;
+    /** Флаг блокировки действия (true, если вызов запрещён) */
+    blocked?: boolean;
+}
+
+/**
+ * Интерфейс store для менеджеров и хендлеров, которые позволяют работать с Select фичей,
+ * необходим для корректного взаимодействия между группами фичей.
+ *
+ * Можно получить:
+ * - режим выборки
+ * - выбранный объект
+ * - подписаться на изменение объекта
+ *
+ * @public
+ * @interface
+ */
+export declare interface ISelectStore {
+    /** Возвращает текущий режим выбора. */
+    getSelectMode(): SelectMode;
+    /**
+     * Устанавливает режим выбора.
+     * @param mode - Режим выбора (Mesh/Face/Edge/Vertex и т.п.).
+     */
+    setSelectMode(mode: SelectMode): void;
     /**
      * Возвращает текущий выбранный объект сцены.
      * @remarks
      * Предполагается, что до вызова этого метода уже был
-     * вызван {@link IEditorStore.setSelectedObject}. Иначе результат не определён.
+     * вызван {@link ISelectStore.setSelectedObject}. Иначе результат не определён.
      */
     getSelectedObject(): THREE.Object3D | null;
     /** Возвращает актуальную статистику по трансформации выбранного объекта. */
@@ -228,43 +604,40 @@ export declare interface IEditorStore {
      * @param cb - Callback, получающий текущий выбранный объект (`THREE.Object3D | null`).
      */
     onSelectedObjectChange(cb: SelectedListener): () => void;
-    /** Подписывает слушателя на изменения трансформации выбранного объекта. */
-    onSelectedTransformChange(cb: TransformListener): () => void;
-    /** Уведомляет всех подписчиков о том, что трансформация выбранного объекта изменилась. */
-    notifySelectedTransformChange(): void;
 }
 
 /**
- * Общий интерфейс для всех менеджеров в хабе.
- * Каждый менеджер отвечает за одну фичу.
+ * Интерфейс store для менеджеров и хендлеров, которые позволяют работать с Tool фичей,
+ * необходим для корректного взаимодействия между группами фичей.
+ *
+ * Можно получить:
+ * - выбранный инструмент
+ * - подписаться на изменение трансформации объекта
+ *
  * @public
+ * @interface
  */
-export declare interface IManager extends Disposable_2 {
+export declare interface IToolStore {
+    /** Возвращает текущий активный инструмент. */
+    getToolType(): ToolType;
     /**
-     * Выполняет основное действие менеджера.
+     * Устанавливает активный инструмент.
+     * @param toolType - Тип инструмента (Translate/Rotate/Scale и т.п.).
      */
-    manage(...args: unknown[]): void;
-}
-
-/**
- * Маркерный интерфейс для менеджера сцены.
- * @public
- */
-export declare interface ISceneManager extends IManager {
-}
-
-/**
- * Маркерный интерфейс для менеджера выборки.
- * @public
- */
-export declare interface ISelectManager extends IManager {
+    setToolType(toolType: ToolType): void;
+    /** Подписывает слушателя на изменения трансформации выбранного объекта. */
+    onSelectedTransformChange(cb: TransformListener): () => void;
+    /** Уведомляет всех подписчиков о том, что трансформация выбранного объекта изменилась. */
+    notifySelectedTransformChange(): void;
 }
 
 /**
- * Маркерный интерфейс для менеджера инструментов.
+ * Обобщенный интерфейс для хендлеров инструментов (`IToolHandler`).
+ *
  * @public
+ * @interface
  */
-export declare interface IToolManager extends IManager {
+export declare interface ITransformStore extends ISelectStore, IToolStore {
 }
 
 /** @public */
@@ -290,137 +663,170 @@ export declare class ObjLoader {
 }
 
 /**
- * Рендерер для предпросмотра 3D-модели.
- * Настраивает сцену, камеру и орбитальную навигацию по горизонтали.
- * @alpha
- */
-export declare class PreviewRenderer extends Renderer {
-    /** Orbit-контроллер для управления камерой */
-    private _orbit;
-    constructor(canvas: HTMLCanvasElement);
-    /**
-     * Обновление состояния рендерера.
-     */
-    protected update(): void;
-}
-
-/**
- * Абстрактный базовый класс рендерера для работы с WebGL через OGL.
- * Отвечает за инициализацию сцены, камеры и цикла рендеринга.
+ * Базовый класс рендерера для работы с WebGL через Three.js.
+ *
+ * @remarks
+ * Отвечает за инициализацию сцены, камеры, освещения и цикла рендеринга.
+ * Предоставляет низкоуровневый API для доступа к основным компонентам Three.js.
+ *
+ * **Не содержит логики управления камерой или выделения объектов** —
+ * это ответственность модулей (например, `ControlsModule`, `RaycasterModule`).
+ *
+ * Рендерер реализует интерфейсы нижнего API:
+ * - `IRendererAccess` — доступ к WebGLRenderer
+ * - `IRendererCameraAccess` — доступ к камере
+ * - `IRendererDomAccess` — доступ к DOM-элементам
+ * - `IRendererSceneAccess` — доступ к сцене
+ *
+ * @see {@link IRendererAccess} - доступ к WebGLRenderer
+ * @see {@link IRendererCameraAccess} - доступ к камере
+ * @see {@link IRendererDomAccess} - доступ к DOM
+ * @see {@link IRendererSceneAccess} - доступ к сцене
+ *
  * @public
+ * @class
  */
-export declare abstract class Renderer implements Disposable_2 {
-    /** Корневой объект сцены */
-    protected scene: THREE.Scene;
-    /** Камера для сцены */
-    protected camera: THREE.PerspectiveCamera;
-    /** Экземпляр рендерера Three.js */
-    protected renderer: THREE.WebGLRenderer;
-    /** HTML-элемент canvas, на котором рендерится сцена */
-    protected canvas: HTMLCanvasElement;
-    /** Массив моделей на сцене */
-    protected meshes: THREE.Mesh[];
-    /**
-     * Конструктор рендерера
-     * @param canvas - HTMLCanvasElement для рендеринга
-     */
-    protected constructor(canvas: HTMLCanvasElement);
-    /**
-     * Обновляет размер рендерера и камеры при изменении размеров canvas.
-     */
-    resize(): void;
-    /**
-     * Выполняет рендеринг сцены с текущей камерой.
-     */
-    protected render(): void;
-    /**
-     * Метод для обновления логики рендерера.
-     */
-    protected update(): void;
+export declare class Renderer implements IRendererAccess, IRendererCameraAccess, IRendererDomAccess, IRendererSceneAccess, IRenderable, Disposable_2 {
     /**
-     * Запускает основной цикл рендеринга.
-     */
-    loop(): void;
-    /**
-     * Добавление фигуры на сцену.
-     * @param figure - Данные фигуры: position, normal, uv
+     * Корневой объект сцены Three.js.
+     *
+     * @protected
+     * @member
      */
-    addFigure(figure: Figure): THREE.Mesh;
+    protected scene: THREE.Scene;
     /**
-     * Добавляет фигуру в сцену и сохраняет его во внутреннем массиве.
+     * Камера для сцены Three.js.
      *
-     * @param mesh - Фигура для добавления в сцену.
-     * @internal
+     * @protected
+     * @member
      */
-    addMesh(mesh: THREE.Mesh): void;
+    protected camera: THREE.PerspectiveCamera;
     /**
-     * Убирает фигуру со сцены
+     * Экземпляр Three.js WebGLRenderer.
      *
-     * @param mesh - Фигура для удаления со сцены.
-     * @internal
+     * @protected
+     * @member
      */
-    removeMesh(mesh: THREE.Mesh): void;
+    protected renderer: THREE.WebGLRenderer;
     /**
-     * Возвращает список всех фигур, находящихся в сцене.
+     * HTML-элемент canvas, на котором рендерится сцена.
      *
-     * @returns Массив текущих фигур.
-     * @internal
+     * @protected
+     * @member
      */
-    getMeshes(): THREE.Mesh[];
+    protected canvas: HTMLCanvasElement;
     /**
-     * Добавляет объект в сцену и (опционально) выставляет ему слой.
+     * Конструктор рендерера.
      *
-     * @param obj - Объект, который нужно добавить в сцену.
-     * @param layer - (Опц.) Номер слоя, который следует установить объекту перед добавлением.
+     * @param _canvas - HTMLCanvasElement для рендеринга
      *
      * @remarks
-     * Если рендерер уже диспоузнут (scene отсутствует), метод тихо завершится.
-     * Слой задаётся через `obj.layers.set(layer)`, после чего объект добавляется в `this.scene`.
+     * Инициализирует сцену с тёмным фоном, перспективную камеру
+     * (45° FOV, near 0.1, far 1000) и базовое освещение:
+     * - `AmbientLight` (0xffffff, 0.5) — общий свет
+     * - `DirectionalLight` (0xffffff, 1) — направленный свет
      *
      * @example
-     * // Добавить оверлей на слой подсветок:
-     * add(overlayLine, OVERLAY_LAYER);
+     * ```typescript
+     * const renderer = new Renderer(canvas);
+     * ```
      *
-     * @internal
+     * @public
+     * @constructor
      */
-    addObject(obj: THREE.Object3D, layer?: number): void;
+    constructor(_canvas: HTMLCanvasElement);
     /**
-     * Удаляет объект из сцены (или из его родителя, если он есть).
-     *
-     * @param obj - Объект, который необходимо удалить.
+     * Обновляет размер рендерера и пропорции камеры.
      *
      * @remarks
-     * Если у объекта есть `parent`, он будет удалён из родителя. Иначе — метод попытается
-     * удалить его напрямую из `this.scene`. В рамках данного API метод не отвечает за
-     * освобождение GPU-ресурсов; освобождайте геометрию/материалы отдельно при необходимости.
+     * Вызывается при изменении размеров canvas (например, при ресайзе окна браузера).
      *
      * @example
-     * // Снять оверлей со сцены:
-     * removeObject(overlayLine);
+     * ```typescript
+     * window.addEventListener('resize', () => renderer.resize());
+     * ```
      *
-     * @internal
+     * @oublic
+     * @method
      */
-    removeObject(obj: THREE.Object3D): void;
+    resize(): void;
     /**
-     * Включает указанный слой у активной камеры.
+     * Выполняет рендеринг текущего кадра.
+     *
+     * @remarks
+     * Рендерит сцену с текущей камерой.
+     * Вызывается автоматически в цикле `loop()`.
      *
-     * @param layer - Номер слоя, который требуется сделать видимым для камеры.
+     * @public
+     * @method
+     */
+    render(): void;
+    /**
+     * Обновляет состояние рендерера перед рендерингом.
      *
      * @remarks
-     * Полезно для показа служебных оверлеев (например, подсветки) на отдельном слое.
-     * Метод не изменяет слои Raycaster — ими должен управлять другой слой API (например, IRaycastAPI).
+     * Пустой метод, предназначен для переопределения в наследниках
+     * (например, для обновления контролов камеры).
+     *
+     * @protected
+     * @method
+     * @virtual
+     */
+    protected update(): void;
+    /**
+     * Запускает основной цикл рендеринга.
+     *
+     * @remarks
+     * Вызывает `update()` и `render()` каждый кадр с помощью `requestAnimationFrame`.
+     * **Важно:** вызывать метод только один раз.
      *
      * @example
-     * // Убедиться, что камера видит слой оверлеев:
-     * enableCameraLayer(OVERLAY_LAYER);
+     * ```typescript
+     * renderer.loop();
+     * ```
+     *
+     * @public
+     * @method
+     */
+    loop(): void;
+    getCamera(): THREE.Camera;
+    getRenderer(): THREE.WebGLRenderer;
+    getCanvas(): HTMLCanvasElement;
+    getDomElement(): HTMLElement;
+    getScene(): THREE.Scene;
+    /**
+     * Освобождает ресурсы рендерера.
+     *
+     * @remarks
+     * Удаляет ссылки на сцену, камеру и canvas, вызывает `dispose()` у WebGLRenderer.
+     * Вызывается при уничтожении редактора IOC-контейнером.
      *
-     * @internal
+     * @public
+     * @method
      */
-    enableCameraLayer(layer: number): void;
-    /** Освобождает ресурсы рендерера, очищает внутренние данные. */
     dispose(): Promise<void> | void;
 }
 
+/**
+ * Enum типов ответа от менеджеров и политик.
+ *
+ * @remarks
+ * Используется в `IResponse.type`.
+ *
+ * @public
+ * @enum
+ */
+declare enum ResponseType_2 {
+    /** Действие заблокировано, инструмент недоступен */
+    ToolNotAllowed = "TOOL_NOT_ALLOWED",
+    /** Действие выполнено успешно */
+    Success = "SUCCESS",
+    /** Действие не выполнено, потому что нет изменений */
+    NoChange = "NO_CHANGE",
+    Error = "ERROR"
+}
+export { ResponseType_2 as ResponseType }
+
 /** @public */
 export declare type SelectedListener = (obj: THREE.Object3D | null) => void;