@planara/core 2.7.1 → 3.0.0

package/dist/interfaces/api/renderer/renderable.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Интерфейс для объектов, которые могут быть отрисованы.
+ *
+ * @remarks
+ * Предназначен для модулей, которым требуется кастомный рендеринг
+ * поверх основной сцены (например, `GizmoModule`).
+ *
+ * **Отличие от `IUpdatableModule`:**
+ * - `render()` вызывается **после** основного рендера сцены
+ * - `render()` предназначен для отрисовки дополнительных элементов
+ *   (осей координат, отладочной информации, оверлеев)
+ *
+ * **Жизненный цикл:**
+ * 1. `init()` (из `IRuntimeModule`) — создание ресурсов
+ * 2. `render()` — отрисовка (вызывается каждый кадр)
+ * 3. `dispose()` (из `IRuntimeModule`) — освобождение ресурсов
+ *
+ * @public
+ * @interface
+ */
+export 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;
+}
+//# sourceMappingURL=renderable.d.ts.map

package/dist/interfaces/api/renderer/renderable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderable.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/api/renderer/renderable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB"}

package/dist/interfaces/api/renderer/renderer-access.d.ts

@@ -0,0 +1,34 @@
+import * as THREE from 'three';
+/**
+ * Низкоуровневый доступ к WebGLRenderer.
+ *
+ * @remarks
+ * Этот интерфейс **реализуется самим рендерером** (`Renderer`).
+ * Предоставляет прямой доступ к WebGLRenderer Three.js.
+ *
+ * Используется **только внутренними API-слоями** (например, `RendererApi`),
+ * но не модулями напрямую.
+ *
+ * @see {@link Renderer} - класс, реализующий этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export interface IRendererAccess {
+    /**
+     * Возвращает WebGLRenderer.
+     *
+     * @returns THREE.WebGLRenderer - рендерер Three.js
+     *
+     * @example
+     * ```typescript
+     * // Использование в RendererApi
+     * const renderer = this._rendererAccess.getRenderer();
+     * ```
+     *
+     * @public
+     * @method
+     */
+    getRenderer(): THREE.WebGLRenderer;
+}
+//# sourceMappingURL=renderer-access.d.ts.map

package/dist/interfaces/api/renderer/renderer-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-access.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/api/renderer/renderer-access.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;OAaG;IACH,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC;CACpC"}

package/dist/interfaces/api/renderer/renderer-camera-access.d.ts

@@ -0,0 +1,37 @@
+import * as THREE from 'three';
+/**
+ * Предоставляет низкоуровневый доступ к камере рендерера.
+ *
+ * Этот интерфейс используется внутренними модулями (например, `CameraApi`) для
+ * получения прямого доступа к камере `Three.js`. Он не содержит логики управления
+ * камерой — только доступ к объекту.
+ *
+ * @remarks
+ * В отличие от `ICameraApi`, который предоставляет высокоуровневые операции
+ * (включение слоёв, настройка параметров), этот интерфейс нужен только для
+ * чтения камеры.
+ *
+ * @see {@link Renderer} - класс, который реализует этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export 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;
+}
+//# sourceMappingURL=renderer-camera-access.d.ts.map

package/dist/interfaces/api/renderer/renderer-camera-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-camera-access.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/api/renderer/renderer-camera-access.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;OAcG;IACH,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;CAC3B"}

package/dist/interfaces/api/renderer/renderer-dom-access.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Низкоуровневый доступ к DOM-элементам рендерера.
+ *
+ * @remarks
+ * Этот интерфейс предоставляет доступ к canvas и DOM-элементу рендерера.
+ * Используется внутренними API-слоями (например, `DomApi`)
+ * для получения доступа к DOM без необходимости знать конкретную реализацию рендерера.
+ *
+ * @see {@link Renderer} - класс, реализующий этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export 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;
+}
+//# sourceMappingURL=renderer-dom-access.d.ts.map

package/dist/interfaces/api/renderer/renderer-dom-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-dom-access.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/api/renderer/renderer-dom-access.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;OAcG;IACH,SAAS,IAAI,iBAAiB,CAAC;IAE/B;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,IAAI,WAAW,CAAC;CAC9B"}

package/dist/interfaces/api/renderer/renderer-scene-access.d.ts

@@ -0,0 +1,45 @@
+import * as THREE from 'three';
+/**
+ * Низкоуровневый доступ к сцене рендерера.
+ *
+ * @remarks
+ * Этот интерфейс предоставляет доступ к сцене Three.js.
+ * Используется внутренними API-слоями (например, `SceneApi`)
+ * для получения доступа к сцене без необходимости знать конкретную
+ * реализацию рендерера.
+ *
+ * @see {@link Renderer} - класс, реализующий этот интерфейс
+ *
+ * @public
+ * @interface
+ */
+export 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;
+}
+//# sourceMappingURL=renderer-scene-access.d.ts.map

package/dist/interfaces/api/renderer/renderer-scene-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-scene-access.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/api/renderer/renderer-scene-access.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC;CACzB"}

package/dist/interfaces/api/renderer-api.d.ts

@@ -0,0 +1,35 @@
+import * as THREE from 'three';
+/**
+ * API для доступа к WebGLRenderer.
+ *
+ * @remarks
+ * Этот интерфейс **реализуется прослойкой** (`RendererApi`), а не самим рендерером.
+ * Предоставляет тот же функционал, но через верхнеуровневый API.
+ *
+ * Используется **модулями** (например, `GizmoModule`), которым нужен доступ
+ * к WebGLRenderer, но которые не должны знать о конкретной реализации рендерера.
+ *
+ * @see {@link RendererApi} - реализация этого интерфейса
+ * @see {@link IRendererAccess} - нижнеуровневый доступ (реализуется рендерером)
+ *
+ * @internal
+ * @interface
+ */
+export interface IRendererApi {
+    /**
+     * Возвращает WebGLRenderer.
+     *
+     * @returns THREE.WebGLRenderer - рендерер Three.js
+     *
+     * @example
+     * ```typescript
+     * const renderer = rendererApi.getRenderer();
+     * renderer.setSize(width, height);
+     * ```
+     *
+     * @internal
+     * @method
+     */
+    getRenderer(): THREE.WebGLRenderer;
+}
+//# sourceMappingURL=renderer-api.d.ts.map

package/dist/interfaces/api/renderer-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-api.d.ts","sourceRoot":"","sources":["../../../src/interfaces/api/renderer-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;OAaG;IACH,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC;CACpC"}

package/dist/interfaces/api/scene-api.d.ts

@@ -1,50 +1,90 @@
 import * as THREE from 'three';
 /**
- * Мини-API для взаимодействия со сценой и слоями камеры.
+ * Высокоуровневое API для управления сценой.
  *
  * @remarks
- * Абстрагирует прямой доступ к `THREE.Scene`/`THREE.Camera`, позволяя
- * хендлерам добавлять/удалять объекты и управлять видимостью слоёв.
- * Рекомендуется использовать совместно с константами слоёв
- * (например, `MESH_LAYER`, `LINE_LAYER`, `OVERLAY_LAYER`).
+ * Предоставляет базовые операции для работы со сценой Three.js:
+ * - получение сцены
+ * - добавление объектов на сцену
+ * - удаление объектов со сцены
  *
- * @example
- * // Добавить оверлей на слой подсветок и убедиться, что камера его видит:
- * sceneApi.add(overlayLine, OVERLAY_LAYER);
- * sceneApi.enableCameraLayer(OVERLAY_LAYER);
+ * Используется модулями и хендлерами, которым нужно управлять
+ * объектами на сцене (например, добавление мешей, света, вспомогательных элементов).
+ *
+ * @see {@link SceneApi} - реализация этого интерфейса
+ * @see {@link IRendererSceneAccess} - низкоуровневый доступ к сцене (internal)
+ *
+ * @internal
+ * @interface
  */
 export interface ISceneApi {
     /**
-     * Добавляет объект в сцену.
+     * Возвращает сцену рендерера.
      *
-     * @param obj - Объект для добавления (`THREE.Object3D`).
-     * @param layer - (Опц.) Слой, который следует выставить объекту перед добавлением.
+     * @returns THREE.Scene - сцена Three.js
+     *
+     * @example
+     * ```typescript
+     * const scene = sceneApi.getScene();
+     * ```
+     *
+     * @internal
+     * @method
+     */
+    getScene(): THREE.Scene;
+    /**
+     * Добавляет объект на сцену.
+     *
+     * @param object - объект Three.js для добавления (Mesh, Light, Group и т.д.)
      *
      * @remarks
-     * Если `layer` указан, реализация должна вызвать `obj.layers.set(layer)` или
-     * эквивалентную логику, прежде чем поместить объект в сцену.
+     * Объект будет виден на сцене после вызова этого метода.
+     * Если объект уже добавлен, он не будет продублирован.
+     *
+     * @example
+     * ```typescript
+     * const mesh = new THREE.Mesh(geometry, material);
+     * sceneApi.addToScene(mesh);
+     * ```
+     *
+     * @internal
+     * @method
      */
-    addObject(obj: THREE.Object3D, layer?: number): void;
+    addToScene(object: THREE.Object3D): void;
     /**
-     * Удаляет объект из сцены.
+     * Удаляет объект со сцены.
      *
-     * @param obj - Объект для удаления.
+     * @param object - объект Three.js для удаления
      *
      * @remarks
-     * Реализация может дополнительно освобождать ресурсы (материалы, геометрию)
-     * по соглашению, но это не обязательно для интерфейса.
+     * Объект перестаёт отображаться на сцене.
+     *
+     * @example
+     * ```typescript
+     * sceneApi.removeFromScene(mesh);
+     * ```
+     *
+     * @internal
+     * @method
      */
-    removeObject(obj: THREE.Object3D): void;
+    removeFromScene(object: THREE.Object3D): void;
     /**
-     * Включает указанный слой для активной камеры,
-     * чтобы объекты на этом слое были видимы.
+     * Добавляет объект в сцену и (опционально) выставляет ему слой.
+     *
+     * @param object - Объект, который нужно добавить в сцену.
+     * @param layer - (Опц.) Номер слоя, который следует установить объекту перед добавлением.
      *
-     * @param layer - Номер слоя, который требуется включить.
+     * @remarks
+     * Если рендерер уже диспоузнут (scene отсутствует), метод тихо завершится.
+     * Слой задаётся через `obj.layers.set(layer)`, после чего объект добавляется в `this.scene`.
      *
      * @example
-     * // Показать оверлеи подсветки:
-     * sceneApi.enableCameraLayer(OVERLAY_LAYER);
+     * // Добавить оверлей на слой подсветок:
+     * add(overlayLine, OVERLAY_LAYER);
+     *
+     * @internal
+     * @method
      */
-    enableCameraLayer(layer: number): void;
+    addObject(object: THREE.Object3D, layer?: number): void;
 }
 //# sourceMappingURL=scene-api.d.ts.map

package/dist/interfaces/api/scene-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-api.d.ts","sourceRoot":"","sources":["../../../src/interfaces/api/scene-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;OASG;IACH,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErD;;;;;;;;OAQG;IACH,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAExC;;;;;;;;;OASG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC"}
+{"version":3,"file":"scene-api.d.ts","sourceRoot":"","sources":["../../../src/interfaces/api/scene-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;OAYG;IACH,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC;IAExB;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAEzC;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE9C;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD"}

package/dist/interfaces/api/transform-api.d.ts

@@ -0,0 +1,120 @@
+import { ToolType } from '@planara/types';
+import { TransformListener } from '../../types/listener/transform-listener';
+import * as THREE from 'three';
+/**
+ * API для взаимодействия и настройки элементов управления сценой.
+ *
+ * @remarks
+ * Предоставляет методы для работы с TransformControls:
+ * - прикрепление/открепление контролов к объектам
+ * - смена режима трансформации (перемещение, вращение, масштабирование)
+ * - подписка на события изменения трансформации
+ *
+ * Используется хендлерами инструментов (Translate, Rotate, Scale)
+ * для управления гизмо и отслеживания изменений.
+ *
+ * @see {@link ControlsModule} - реализация этого интерфейса
+ * @see {@link TransformListener} - тип слушателя событий трансформации
+ *
+ * @internal
+ * @interface
+ */
+export interface ITransformApi {
+    /**
+     * Прикрепляет Transform Controls к объекту сцены.
+     *
+     * @param object - объект Three.js, к которому нужно прикрепить контролы
+     *
+     * @remarks
+     * После вызова этого метода на объекте появляется гизмо
+     * (стрелки, дуги, квадраты), с помощью которого можно
+     * перемещать, вращать или масштабировать объект.
+     *
+     * Если контролы уже прикреплены к другому объекту,
+     * они автоматически переключатся на новый.
+     *
+     * @example
+     * ```typescript
+     * const mesh = sceneApi.getSelectedMesh();
+     * controlsApi.attachTransform(mesh);
+     * ```
+     *
+     * @internal
+     * @method
+     */
+    attachTransform(object: THREE.Object3D): void;
+    /**
+     * Открепляет Transform Controls от текущего объекта.
+     *
+     * @remarks
+     * Гизмо исчезает, объект перестаёт быть доступным для
+     * интерактивной трансформации.
+     *
+     * Обычно вызывается при смене инструмента или при снятии выделения.
+     *
+     * @example
+     * ```typescript
+     * // При смене инструмента
+     * public rollback(): void {
+     *   this.controlsApi.detachTransform();
+     * }
+     * ```
+     *
+     * @internal
+     * @method
+     */
+    detachTransform(): void;
+    /**
+     * Изменяет режим трансформации гизмо.
+     *
+     * @param mode - режим трансформации (Translate, Rotate, Scale)
+     *
+     * @remarks
+     * В зависимости от режима, гизмо отображает разные контролы:
+     * - `Translate` - стрелки для перемещения
+     * - `Rotate` - дуги для вращения
+     * - `Scale` - квадраты для масштабирования
+     *
+     * @example
+     * ```typescript
+     * // Переключение на режим вращения
+     * controlsApi.setTransformMode(ToolType.Rotate);
+     * ```
+     *
+     * @internal
+     */
+    setTransformMode(mode: ToolType): void;
+    /**
+     * Подписывает слушателя на события изменения трансформации.
+     *
+     * @param callback - функция, которая будет вызвана при изменении
+     * @returns функция для отписки от события
+     *
+     * @remarks
+     * Событие генерируется в процессе взаимодействия пользователя с гизмо
+     * (перемещение, вращение, масштабирование).
+     *
+     * Возвращаемая функция позволяет отписаться от события:
+     * ```typescript
+     * const unsubscribe = controlsApi.onTransformChange(() => {
+     *   console.log('Object transformed');
+     * });
+     *
+     * // позже
+     * unsubscribe();
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Подписка на изменение трансформации
+     * this.unsubscribe = this.controlsApi.onTransformChange(() => {
+     *   this.store.notifySelectedTransformChange();
+     * });
+     * ```
+     *
+     * @internal
+     * @method
+     */
+    onTransformChange(callback: TransformListener): () => void;
+}
+//# sourceMappingURL=transform-api.d.ts.map

package/dist/interfaces/api/transform-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-api.d.ts","sourceRoot":"","sources":["../../../src/interfaces/api/transform-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE9C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,IAAI,IAAI,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAAC;CAC5D"}

package/dist/interfaces/command/index.d.ts

@@ -0,0 +1,9 @@
+import { FeatureType } from '../../types/feature/feature-type';
+/**
+ * @public
+ */
+export interface ICommand {
+    type: FeatureType;
+    payload: unknown[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/command/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/command/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB"}

package/dist/interfaces/controller/controller.d.ts

@@ -0,0 +1,38 @@
+import { Disposable } from 'tsyringe';
+/**
+ * Интерфейс для контроллера, управляющего жизненным циклом модулей.
+ *
+ * @remarks
+ * Контроллер отвечает за:
+ * - инициализацию модулей (`IRuntimeModule`)
+ * - запуск цикла рендеринга
+ * - обновление модулей каждый кадр (`IUpdatableModule`)
+ * - рендеринг модулей (`IRenderableModule`)
+ * - остановку и очистку ресурсов
+ *
+ * @public
+ * @interface
+ */
+export interface IController extends Disposable {
+    /**
+     * Запускает контроллер.
+     *
+     * @remarks
+     * Инициализирует все модули и запускает цикл рендеринга.
+     *
+     * @public
+     * @method
+     */
+    start(): void;
+    /**
+     * Останавливает контроллер.
+     *
+     * @remarks
+     * Останавливает цикл рендеринга и освобождает ресурсы.
+     *
+     * @public
+     * @method
+     */
+    stop(): void;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/interfaces/controller/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/interfaces/controller/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,CAAC;CACd"}

package/dist/interfaces/handler/display-handler.d.ts

@@ -4,11 +4,19 @@ import { DisplayMode } from '@planara/types';
  * Маркерный интерфейс для всех Display-хендлеров.
  * Используется только для DI.
  *
+ * @remarks
  * Расширяет {@link IHandler} и добавляет поле `mode`
+ *
  * @internal
+ * @interface
  */
 export interface IDisplayHandler extends IHandler {
-    /** Режим отображения, за который отвечает хендлер */
+    /**
+     * Режим отображения, за который отвечает хендлер.
+     *
+     * @internal
+     * @member
+     */
     mode: DisplayMode;
 }
 //# sourceMappingURL=display-handler.d.ts.map

package/dist/interfaces/handler/display-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/display-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,qDAAqD;IACrD,IAAI,EAAE,WAAW,CAAC;CACnB"}
+{"version":3,"file":"display-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/display-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C;;;;;OAKG;IACH,IAAI,EAAE,WAAW,CAAC;CACnB"}

package/dist/interfaces/handler/handler.d.ts

@@ -3,7 +3,9 @@ import { Disposable } from 'tsyringe';
  * Общий интерфейс для всех хендлеров.
  * Хендлеры выполняют действия по настройке рендерера,
  * управляют состоянием сцены или конкретных режимов отображения.
+ *
  * @internal
+ * @interface
  */
 export interface IHandler extends Disposable {
     /**

package/dist/interfaces/handler/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C;;;OAGG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAC;CAClB"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C;;;OAGG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAC;CAClB"}

package/dist/interfaces/handler/scene-handler.d.ts

@@ -6,6 +6,7 @@ import { SceneMode } from '@planara/types';
  *
  * Расширяет {@link IHandler} и добавляет поле `mode`
  * @internal
+ * @interface
  */
 export interface ISceneHandler extends IHandler {
     /** Режим редактирования сцены, за который отвечает хендлер */

package/dist/interfaces/handler/scene-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/scene-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,8DAA8D;IAC9D,IAAI,EAAE,SAAS,CAAC;CACjB"}
+{"version":3,"file":"scene-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/scene-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,8DAA8D;IAC9D,IAAI,EAAE,SAAS,CAAC;CACjB"}

package/dist/interfaces/handler/select-handler.d.ts

@@ -6,6 +6,7 @@ import { SelectMode } from '@planara/types';
  *
  * Расширяет {@link IHandler} и добавляет поле `mode`
  * @internal
+ * @interface
  */
 export interface ISelectHandler extends IHandler {
     /** Режим выборки, за который отвечает хендлер */