@planara/core 2.7.1 → 3.0.0

package/README.md

@@ -1,5 +1,10 @@
 ![build](https://github.com/planara/planara-core/actions/workflows/build.yml/badge.svg)
 ![deploy](https://github.com/planara/planara-core/actions/workflows/deploy.yml/badge.svg)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
+
+[![npm downloads](https://img.shields.io/npm/dm/@planara/core.svg)](https://www.npmjs.com/package/@planara/core)
+[![npm total downloads](https://img.shields.io/npm/dt/@planara/core.svg)](https://www.npmjs.com/package/@planara/core)
 
 ## Planara Core
 

package/dist/api/modules/controls-state-api.d.ts

@@ -0,0 +1,23 @@
+import { IControlsStateApi } from '../../interfaces/api/controls-state-api';
+/**
+ * API для получения состояния элементов управления сценой.
+ *
+ * **Назначение:**
+ * - Предоставляет хендлерам и менеджерам унифицированный интерфейс для получения состояния контролов
+ * - Скрывает конкретную реализацию {@link ControlsModule}
+ *
+ * **Используется:**
+ * - `RaycasterModule` для проверки, нужно ли обрабатывать события ввода
+ * - Другими модулями, которым важно знать состояние контролов
+ *
+ * @internal
+ * @class
+ */
+export declare class ControlsStateApi implements IControlsStateApi {
+    private readonly _controlsModule;
+    /** @constructor */
+    constructor(_controlsModule: IControlsStateApi);
+    isOrbitInteracting(): boolean;
+    isTransformDragging(): boolean;
+}
+//# sourceMappingURL=controls-state-api.d.ts.map

package/dist/api/modules/controls-state-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls-state-api.d.ts","sourceRoot":"","sources":["../../../src/api/modules/controls-state-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,qBACa,gBAAiB,YAAW,iBAAiB;IAG5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAF5D,mBAAmB;gBAE0B,eAAe,EAAE,iBAAiB;IAGxE,kBAAkB,IAAI,OAAO;IAI7B,mBAAmB,IAAI,OAAO;CAGtC"}

package/dist/api/modules/mesh-api.d.ts

@@ -0,0 +1,30 @@
+import { IMeshApi } from '../../interfaces/api/mesh-api';
+import * as THREE from 'three';
+/**
+ * API для управления мешами (фигурами) на сцене.
+ *
+ * **Назначение:**
+ * - Предоставляет хендлерам и менеджерам унифицированный интерфейс для работы с мешами
+ * - Скрывает конкретную реализацию {@link `SceneModule`}
+ *
+ * **Используется:**
+ * - Хендлерами инструментов ({@link `TranslateToolHandler`}, {@link `RotateToolHandler`} и др.)
+ * - Хэндлерами сцены при необходимости получить список мешей
+ *
+ * @see {@link IMeshApi} - интерфейс, который реализует этот класс
+ * @see {@link SceneModule} - реальная реализация операций с мешами
+ *
+ * @internal
+ * @class
+ */
+export declare class MeshApi implements IMeshApi {
+    private readonly _sceneModule;
+    /** @constructor */
+    constructor(_sceneModule: IMeshApi);
+    addMesh(mesh: THREE.Mesh): void;
+    addMeshes(meshes: THREE.Mesh[]): void;
+    removeMesh(mesh: THREE.Mesh): void;
+    removeMeshes(meshes: THREE.Mesh[]): void;
+    getMeshes(): THREE.Mesh[];
+}
+//# sourceMappingURL=mesh-api.d.ts.map

package/dist/api/modules/mesh-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-api.d.ts","sourceRoot":"","sources":["../../../src/api/modules/mesh-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,OAAQ,YAAW,QAAQ;IAEI,OAAO,CAAC,QAAQ,CAAC,YAAY;IADvE,mBAAmB;gBACwC,YAAY,EAAE,QAAQ;IAE1E,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI;IAI/B,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI;IAIrC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI;IAIlC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI;IAIxC,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE;CAGjC"}

package/dist/api/modules/raycast-api.d.ts

@@ -0,0 +1,28 @@
+import { SelectMode } from '@planara/types';
+import { IRaycastApi } from '../../interfaces/api/raycast-api';
+/**
+ * API для управления raycast (выделением геометрии).
+ *
+ * **Назначение:**
+ * - Предоставляет менеджерам и хендлерам унифицированный интерфейс для настройки raycast
+ * - Скрывает конкретную реализацию ({@link `RaycastModule`})
+ * - Позволяет легко подменить реализацию (например, для тестирования)
+ *
+ * **Используется:**
+ * - {@link `SelectManager`} — для переключения режима выделения при смене инструмента
+ * - {@link `MeshSelectHandler`}, {@link `EdgeSelectHandler`}, {@link `VertexSelectHandler`}  — для установки режима перед обработкой
+ *
+ * @see {@link IRaycastApi} - интерфейс, который реализует этот класс
+ * @see {@link RaycastModule} - реальная реализация raycast
+ * @see {@link SelectManager} - менеджер, использующий этот API
+ *
+ * @internal
+ * @class
+ */
+export declare class RaycastApi implements IRaycastApi {
+    private readonly _raycastModule;
+    /** @constructor */
+    constructor(_raycastModule: IRaycastApi);
+    setRaycastMode(mode: SelectMode): void;
+}
+//# sourceMappingURL=raycast-api.d.ts.map

package/dist/api/modules/raycast-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raycast-api.d.ts","sourceRoot":"","sources":["../../../src/api/modules/raycast-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,UAAW,YAAW,WAAW;IAEA,OAAO,CAAC,QAAQ,CAAC,cAAc;IAD3E,mBAAmB;gBAC0C,cAAc,EAAE,WAAW;IAEjF,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;CAG9C"}

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

@@ -0,0 +1,33 @@
+import { ToolType } from '@planara/types';
+import { TransformListener } from '../../types/listener/transform-listener';
+import { ITransformApi } from '../../interfaces/api/transform-api';
+import * as THREE from 'three';
+/**
+ * API для управления трансформацией объектов (гизмо).
+ *
+ * **Назначение:**
+ * - Предоставляет хендлерам инструментов унифицированный интерфейс для работы с гизмо
+ * - Скрывает конкретную реализацию {@link `ControlsModule`}
+ *
+ * **Используется:**
+ * - Хендлерами инструментов:
+ *   - {@link `TranslateToolHandler`} — перемещение
+ *   - {@link `RotateToolHandler`} — вращение
+ *   - {@link `ScaleToolHandler`} — масштабирование
+ *
+ * @see {@link ITransformApi} - интерфейс, который реализует этот класс
+ * @see {@link ControlsModule} - реальная реализация операций трансформации
+ *
+ * @internal
+ * @class
+ */
+export declare class TransformApi implements ITransformApi {
+    private readonly _controlsModule;
+    /** @constructor */
+    constructor(_controlsModule: ITransformApi);
+    attachTransform(object: THREE.Object3D): void;
+    detachTransform(): void;
+    setTransformMode(mode: ToolType): void;
+    onTransformChange(callback: TransformListener): () => void;
+}
+//# sourceMappingURL=transform-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform-api.d.ts","sourceRoot":"","sources":["../../../src/api/modules/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;AAIjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,YAAa,YAAW,aAAa;IAEH,OAAO,CAAC,QAAQ,CAAC,eAAe;IAD7E,mBAAmB;gBAC2C,eAAe,EAAE,aAAa;IAErF,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAI7C,eAAe,IAAI,IAAI;IAIvB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAItC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;CAGlE"}

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

@@ -0,0 +1,26 @@
+import { ICameraApi } from '../../interfaces/api/camera-api';
+import { IRendererCameraAccess } from '../../interfaces/api/renderer/renderer-camera-access';
+import * as THREE from 'three';
+/**
+ * Реализация API для управления камерой.
+ *
+ * @remarks
+ * Предоставляет высокоуровневые методы для работы с камерой:
+ * - получение экземпляра камеры
+ * - включение/выключение слоёв отображения
+ *
+ * @see {@link ICameraApi} - интерфейс, который реализует этот класс
+ * @see {@link IRendererCameraAccess} - низкоуровневый доступ к камере
+ * @see {@link Renderer} - рендерер, предоставляющий доступ к камере
+ *
+ * @internal
+ * @class
+ */
+export declare class CameraApi implements ICameraApi {
+    private _cameraAccessApi;
+    constructor(_cameraAccessApi: IRendererCameraAccess);
+    getCamera(): THREE.Camera;
+    enableCameraLayer(layer: number): void;
+    disableCameraLayer(layer: number): void;
+}
+//# sourceMappingURL=camera-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera-api.d.ts","sourceRoot":"","sources":["../../../src/api/renderer/camera-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAElG;;;;;;;;;;;;;;GAcG;AACH,qBACa,SAAU,YAAW,UAAU;IAEP,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,qBAAqB;IAG3E,SAAS,IAAI,KAAK,CAAC,MAAM;IAIzB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG/C"}

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

@@ -0,0 +1,24 @@
+import { IDomApi } from '../../interfaces/api/dom-api';
+import { IRendererDomAccess } from '../../interfaces/api/renderer/renderer-dom-access';
+/**
+ * Реализация API для доступа к DOM-элементам рендерера.
+ *
+ * @remarks
+ * Предоставляет доступ к canvas и DOM-элементу рендерера.
+ * Используется модулями, которым нужно взаимодействовать с DOM
+ * (например, для подписки на события мыши).
+ *
+ * @see {@link IDomApi} - интерфейс, который реализует этот класс
+ * @see {@link IRendererDomAccess} - низкоуровневый доступ к DOM
+ * @see {@link Renderer} - рендерер, предоставляющий доступ
+ *
+ * @internal
+ * @class
+ */
+export declare class DomApi implements IDomApi {
+    private _domAccessApi;
+    constructor(_domAccessApi: IRendererDomAccess);
+    getCanvas(): HTMLCanvasElement;
+    getDomElement(): HTMLElement;
+}
+//# sourceMappingURL=dom-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom-api.d.ts","sourceRoot":"","sources":["../../../src/api/renderer/dom-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,qBACa,MAAO,YAAW,OAAO;IACa,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,kBAAkB;IAEnF,SAAS,IAAI,iBAAiB;IAI9B,aAAa,IAAI,WAAW;CAGpC"}

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

@@ -0,0 +1,26 @@
+import { ISceneApi } from '../../interfaces/api/scene-api';
+import { IRendererSceneAccess } from '../../interfaces/api/renderer/renderer-scene-access';
+import * as THREE from 'three';
+/**
+ * Реализация API для управления сценой.
+ *
+ * @remarks
+ * Делегирует вызовы к {@link IRendererSceneAccess},
+ * что позволяет изолировать логику управления сценой от конкретной реализации рендерера.
+ *
+ * @see {@link ISceneApi} - интерфейс, который реализует этот класс
+ * @see {@link IRendererSceneAccess} - низкоуровневый доступ к сцене
+ * @see {@link Renderer} - рендерер, предоставляющий доступ к сцене
+ *
+ * @internal
+ * @class
+ */
+export declare class SceneApi implements ISceneApi {
+    private _sceneAccessApi;
+    constructor(_sceneAccessApi: IRendererSceneAccess);
+    getScene(): THREE.Scene;
+    addToScene(object: THREE.Object3D): void;
+    removeFromScene(object: THREE.Object3D): void;
+    addObject(object: THREE.Object3D, layer?: number): void;
+}
+//# sourceMappingURL=scene-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-api.d.ts","sourceRoot":"","sources":["../../../src/api/renderer/scene-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAEhG;;;;;;;;;;;;;GAaG;AACH,qBACa,QAAS,YAAW,SAAS;IAEN,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,oBAAoB;IAGxE,QAAQ,IAAI,KAAK,CAAC,KAAK;IAIvB,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAIxC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAI7C,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM;CAWxD"}

package/dist/constants/colors.d.ts

@@ -8,6 +8,9 @@
  *
  * @example
  * (line.material as THREE.LineBasicMaterial).color.setHex(HOVER_COLOR);
+ *
+ * @internal
+ * @const
  */
 export declare const HOVER_COLOR = 16776960;
 /**
@@ -19,6 +22,9 @@ export declare const HOVER_COLOR = 16776960;
  *
  * @example
  * (line.material as THREE.LineBasicMaterial).color.setHex(SELECT_COLOR);
+ *
+ * @internal
+ * @const
  */
 export declare const SELECT_COLOR = 16755200;
 /**
@@ -30,6 +36,9 @@ export declare const SELECT_COLOR = 16755200;
  *
  * @example
  * (line.material as THREE.LineBasicMaterial).color.setHex(EDGES_DEFAULT_COLOR);
+ *
+ * @internal
+ * @const
  */
 export declare const EDGES_DEFAULT_COLOR = 2236962;
 /**
@@ -38,6 +47,9 @@ export declare const EDGES_DEFAULT_COLOR = 2236962;
  * @remarks
  * Применяется при выключении постоянной подсветки выбранной вершины.
  * Должен визуально отличаться от {@link HOVER_COLOR} и {@link SELECT_COLOR}, чтобы не путать состояния.
+ *
+ * @internal
+ * @const
  */
 export declare const VERTEX_DEFAULT_COLOR = 2236962;
 //# sourceMappingURL=colors.d.ts.map

package/dist/constants/colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/constants/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,UAAW,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,UAAW,CAAC"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/constants/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,UAAW,CAAC;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,UAAW,CAAC"}

package/dist/constants/figure-geometries.d.ts

@@ -1,12 +1,63 @@
 import { FigureType } from '@planara/types';
 import * as THREE from 'three';
 /**
- * Базовые фабрики геометрий по типу фигуры.
- * Всегда создают новый экземпляр — безопасно для редактирования вершин.
+ * Фабрики геометрий для стандартных типов фигур.
+ *
+ * @remarks
+ * Каждая фабрика создаёт **новый экземпляр** геометрии при вызове.
+ * Это важно для редактирования вершин — изменения в одной геометрии
+ * не влияют на другие экземпляры того же типа.
+ *
+ * Все геометрии создаются с единичными размерами (ширина/высота/глубина = 1
+ * или радиус = 0.5).
+ *
+ * @example
+ * ```typescript
+ * // Создание куба
+ * const geometry = BASE_GEOMETRIES[FigureType.Cube]();
+ * const mesh = new THREE.Mesh(geometry, BASE_MATERIAL);
+ * ```
+ *
+ * @see {@link FigureType} - типы доступных фигур
+ *
+ * @internal
+ * @const
  */
 export declare const BASE_GEOMETRIES: Record<FigureType, () => THREE.BufferGeometry>;
-/** Базовый материал для фигур */
+/**
+ * Базовый материал для фигур.
+ *
+ * @remarks
+ * Используется для всех стандартных фигур, создаваемых через `addFigure`.
+ * Материал переиспользуется между фигурами, так как геометрия и так
+ * создаётся заново для каждой фигуры.
+ *
+ * @example
+ * ```typescript
+ * // Использование с кастомной геометрией
+ * const geometry = new THREE.BoxGeometry(2, 2, 2);
+ * const mesh = new THREE.Mesh(geometry, BASE_MATERIAL);
+ * ```
+ *
+ * @internal
+ * @const
+ */
 export declare const BASE_MATERIAL: THREE.MeshStandardMaterial;
-/** Базовый размер вершины. */
+/**
+ * Базовый размер точек для вершин.
+ *
+ * @remarks
+ * Используется при создании точек вершин для визуализации.
+ * Размер задаётся в пикселях.
+ *
+ * @example
+ * ```typescript
+ * const points = makeVertexPoints(geometry);
+ * points.material.size = BASE_POINT_SIZE;
+ * ```
+ *
+ * @internal
+ * @const
+ */
 export declare const BASE_POINT_SIZE = 8;
 //# sourceMappingURL=figure-geometries.d.ts.map

package/dist/constants/figure-geometries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-geometries.d.ts","sourceRoot":"","sources":["../../src/constants/figure-geometries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,KAAK,CAAC,cAAc,CAa1E,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,aAAa,4BAIxB,CAAC;AAEH,8BAA8B;AAC9B,eAAO,MAAM,eAAe,IAAI,CAAC"}
+{"version":3,"file":"figure-geometries.d.ts","sourceRoot":"","sources":["../../src/constants/figure-geometries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,KAAK,CAAC,cAAc,CA8D1E,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,4BAIxB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC"}

package/dist/constants/layers.d.ts

@@ -8,6 +8,9 @@
  * @example
  * camera.layers.enable(MESH_LAYER);
  * raycaster.layers.set(MESH_LAYER);
+ *
+ * @internal
+ * @const
  */
 export declare const MESH_LAYER = 0;
 /**
@@ -21,6 +24,9 @@ export declare const MESH_LAYER = 0;
  * camera.layers.enable(LINE_LAYER);
  * raycaster.layers.set(LINE_LAYER);
  * raycaster.params.Line.threshold = 0.03;
+ *
+ * @internal
+ * @const
  */
 export declare const LINE_LAYER = 1;
 /**
@@ -34,6 +40,9 @@ export declare const LINE_LAYER = 1;
  * camera.layers.enable(POINT_LAYER);
  * raycaster.layers.set(POINT_LAYER);
  * raycaster.params.Points.threshold = 0.03;
+ *
+ * @internal
+ * @const
  */
 export declare const POINT_LAYER = 2;
 /**
@@ -47,6 +56,9 @@ export declare const POINT_LAYER = 2;
  * camera.layers.enable(OVERLAY_LAYER); // камера видит подсветку
  * // Raycaster НЕ видит подсветку:
  * // raycaster.layers.set(...) — без OVERLAY_LAYER
+ *
+ * @internal
+ * @const
  */
 export declare const OVERLAY_LAYER = 31;
 //# sourceMappingURL=layers.d.ts.map

package/dist/constants/layers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/constants/layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC"}
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/constants/layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC"}

package/dist/constants/messages.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Константы сообщений для политик инструментов.
+ *
+ * @remarks
+ * Используются в `ToolPolicy` и `ToolManager` для унификации сообщений.
+ *
+ * @public
+ * @constant
+ */
+export declare const TOOL_MESSAGES: {
+    /** Сообщение, когда инструмент недоступен в текущем режиме выбора */
+    readonly ToolNotAllowed: "This tool cannot be used with current select mode";
+    /** Сообщение об успешном выполнении действия */
+    readonly Success: "Action executed successfully";
+    /** Сообщение, когда инструмент уже выбран */
+    readonly NoChange: "Tool already selected";
+};
+//# sourceMappingURL=messages.d.ts.map

package/dist/constants/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/constants/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;IACxB,qEAAqE;;IAGrE,gDAAgD;;IAGhD,6CAA6C;;CAErC,CAAC"}

package/dist/constants/threshold.d.ts

@@ -1,5 +1,45 @@
-/** мировые координаты */
+/**
+ * Порог выделения рёбер (линий) в мировых координатах.
+ *
+ * @remarks
+ * Определяет, на каком расстоянии (в единицах Three.js) луч может пройти мимо ребра,
+ * чтобы оно всё равно считалось выделенным.
+ *
+ * Значение `0.03` означает, что луч может пройти в 3 сантиметрах от ребра
+ * (при единичном масштабе модели) и ребро всё равно будет выделено.
+ *
+ * Чем больше значение, тем легче выделить ребро, но выше вероятность ложных срабатываний.
+ *
+ * @example
+ * ```typescript
+ * // Установка порога для raycast
+ * raycaster.params.Line.threshold = LINE_THRESHOLD;
+ * ```
+ *
+ * @internal
+ * @const
+ */
 export declare const LINE_THRESHOLD = 0.03;
-/** пиксели */
+/**
+ * Порог выделения вершин (точек) в пикселях.
+ *
+ * @remarks
+ * Определяет, на каком расстоянии (в пикселях) курсор мыши может находиться от точки,
+ * чтобы она считалась выделенной.
+ *
+ * Значение `0.05` означает, что курсор может отстоять от точки на 0.05 пикселя.
+ * Фактически это минимальный порог — выделение происходит только при точном попадании.
+ *
+ * Чем больше значение, тем легче выделить вершину, но выше риск ложных срабатываний.
+ *
+ * @example
+ * ```typescript
+ * // Установка порога для raycast
+ * raycaster.params.Points.threshold = POINTS_THRESHOLD;
+ * ```
+ *
+ * @internal
+ * @const
+ */
 export declare const POINTS_THRESHOLD = 0.05;
 //# sourceMappingURL=threshold.d.ts.map

package/dist/constants/threshold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threshold.d.ts","sourceRoot":"","sources":["../../src/constants/threshold.ts"],"names":[],"mappings":"AACA,yBAAyB;AACzB,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,cAAc;AACd,eAAO,MAAM,gBAAgB,OAAO,CAAC"}
+{"version":3,"file":"threshold.d.ts","sourceRoot":"","sources":["../../src/constants/threshold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC"}

package/dist/controllers/renderer-controller.d.ts

@@ -0,0 +1,74 @@
+import { IController } from '../interfaces/controller/controller';
+import { IRenderable } from '../interfaces/api/renderer/renderable';
+import { IRuntimeModule } from '../interfaces/module/runtime-module';
+import { IRenderableModule } from '../interfaces/module/renderable-module';
+import { IUpdatableModule } from '../interfaces/module/updatable-module';
+/**
+ * Контроллер для оркестрации жизненного цикла модулей и цикла рендеринга.
+ *
+ * @remarks
+ * Отвечает за:
+ * - инициализацию всех модулей ({@link `IRuntimeModule`}, {@link `IUpdatableModule`}, {@link `IRenderableModule`})
+ * - запуск анимационного цикла (`requestAnimationFrame`)
+ * - вызов `update()` у модулей перед рендерингом
+ * - вызов `render()` у рендерера
+ * - вызов `render()` у модулей после рендеринга
+ * - остановку цикла и очистку ресурсов
+ *
+ * @see {@link IController} - интерфейс контроллера
+ * @see {@link IRuntimeModule} - модули с инициализацией
+ * @see {@link IUpdatableModule} - модули с обновлением каждый кадр
+ * @see {@link IRenderableModule} - модули с кастомным рендерингом
+ * @see {@link IRenderable} - рендерер
+ *
+ * @internal
+ * @class
+ */
+export declare class RendererController implements IController {
+    private _updatable;
+    private _renderable;
+    private _runtime;
+    private _renderer;
+    /**
+     * ID анимационного цикла (для остановки)
+     *
+     * @private
+     * @member
+     */
+    private _animationId;
+    /**
+     * Конструктор контроллера.
+     *
+     * @param _updatable - модули, требующие обновления каждый кадр
+     * @param _renderable - модули, требующие кастомного рендеринга
+     * @param _runtime - модули, требующие инициализации
+     * @param _renderer - рендерер (должен реализовывать `IRenderable`)
+     *
+     * @internal
+     * @constructor
+     */
+    constructor(_updatable: IUpdatableModule[], _renderable: IRenderableModule[], _runtime: IRuntimeModule[], _renderer: IRenderable);
+    start(): void;
+    /**
+     * Внутренний анимационный цикл.
+     *
+     * @remarks
+     * Каждый кадр:
+     * 1. Обновляет модули (`update()`)
+     * 2. Рендерит сцену
+     * 3. Рендерит дополнительные модули (`render()`)
+     *
+     * @private
+     * @method
+     */
+    private _loop;
+    stop(): void;
+    /**
+     * Освобождает ресурсы контроллера.
+     *
+     * @public
+     * @method
+     */
+    dispose(): Promise<void> | void;
+}
+//# sourceMappingURL=renderer-controller.d.ts.map

package/dist/controllers/renderer-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-controller.d.ts","sourceRoot":"","sources":["../../src/controllers/renderer-controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,kBAAmB,YAAW,WAAW;IAqBnB,OAAO,CAAC,UAAU;IACjB,OAAO,CAAC,WAAW;IACtB,OAAO,CAAC,QAAQ;IACtB,OAAO,CAAC,SAAS;IAvB1C;;;;;OAKG;IACH,OAAO,CAAC,YAAY,CAAuB;IAE3C;;;;;;;;;;OAUG;gBAEsC,UAAU,EAAE,gBAAgB,EAAE,EAC7B,WAAW,EAAE,iBAAiB,EAAE,EACnC,QAAQ,EAAE,cAAc,EAAE,EAChC,SAAS,EAAE,WAAW;IAGhD,KAAK,IAAI,IAAI;IAOpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,KAAK;IAON,IAAI,IAAI,IAAI;IAOnB;;;;;OAKG;IACI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGvC"}