@planara/core 2.8.0 → 3.1.0

package/dist/core/renderer.d.ts

@@ -1,120 +1,147 @@
-import { Figure } from '@planara/types';
 import { Disposable } from 'tsyringe';
+import { IRendererCameraAccess, IRendererAccess, IRendererDomAccess, IRendererSceneAccess, IRenderable } from '../interfaces/api/renderer';
+import { RendererConfig } from '@planara/types';
 import * as THREE from 'three';
 /**
- * Абстрактный базовый класс рендерера для работы с 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 {
-    /** Корневой объект сцены */
-    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);
+export declare class Renderer implements IRendererAccess, IRendererCameraAccess, IRendererDomAccess, IRendererSceneAccess, IRenderable, Disposable {
+    private readonly _config;
     /**
-     * Обновляет размер рендерера и камеры при изменении размеров canvas.
-     */
-    resize(): void;
-    /**
-     * Выполняет рендеринг сцены с текущей камерой.
+     * Корневой объект сцены Three.js.
+     *
+     * @protected
+     * @member
      */
-    protected render(): void;
+    protected scene: THREE.Scene;
     /**
-     * Метод для обновления логики рендерера.
+     * Камера для сцены Three.js.
+     *
+     * @protected
+     * @member
      */
-    protected update(): void;
+    protected camera: THREE.PerspectiveCamera;
     /**
-     * Запускает основной цикл рендеринга.
+     * Экземпляр Three.js WebGLRenderer.
+     *
+     * @protected
+     * @member
      */
-    loop(): void;
+    protected renderer: THREE.WebGLRenderer;
     /**
-     * Добавление фигуры на сцену.
-     * @param figure - Данные фигуры: position, normal, uv
+     * HTML-элемент canvas, на котором рендерится сцена.
+     *
+     * @protected
+     * @member
      */
-    addFigure(figure: Figure): THREE.Mesh;
+    protected canvas: HTMLCanvasElement;
     /**
-     * Добавляет фигуру в сцену и сохраняет его во внутреннем массиве.
+     * Конструктор рендерера.
+     *
+     * @param _canvas - HTMLCanvasElement для рендеринга
+     * @param _config - Конфиг для настройки рендерера
      *
-     * @param mesh - Фигура для добавления в сцену.
-     * @internal
+     * @remarks
+     * Инициализирует сцену, камеру, WebGLRenderer и базовое освещение
+     * на основе переданного `RendererConfig`.
+     *
+     * По умолчанию используется тёмный фон, перспективная камера
+     * и два источника света: AmbientLight и DirectionalLight.
+     *
+     * @public
+     * @constructor
      */
-    addMesh(mesh: THREE.Mesh): void;
+    constructor(_canvas: HTMLCanvasElement, _config: RendererConfig);
     /**
-     * Убирает фигуру со сцены
+     * Обновляет размер рендерера и пропорции камеры.
+     *
+     * @remarks
+     * Вызывается при изменении размеров canvas (например, при ресайзе окна браузера).
      *
-     * @param mesh - Фигура для удаления со сцены.
-     * @internal
+     * @example
+     * ```typescript
+     * window.addEventListener('resize', () => renderer.resize());
+     * ```
+     *
+     * @public
+     * @method
      */
-    removeMesh(mesh: THREE.Mesh): void;
+    resize(): void;
     /**
-     * Возвращает список всех фигур, находящихся в сцене.
+     * Выполняет рендеринг текущего кадра.
+     *
+     * @remarks
+     * Рендерит сцену с текущей камерой.
+     * Вызывается автоматически в цикле `loop()`.
      *
-     * @returns Массив текущих фигур.
-     * @internal
+     * @public
+     * @method
      */
-    getMeshes(): THREE.Mesh[];
+    render(): void;
     /**
-     * Добавляет объект в сцену и (опционально) выставляет ему слой.
-     *
-     * @param obj - Объект, который нужно добавить в сцену.
-     * @param layer - (Опц.) Номер слоя, который следует установить объекту перед добавлением.
+     * Обновляет состояние рендерера перед рендерингом.
      *
      * @remarks
-     * Если рендерер уже диспоузнут (scene отсутствует), метод тихо завершится.
-     * Слой задаётся через `obj.layers.set(layer)`, после чего объект добавляется в `this.scene`.
-     *
-     * @example
-     * // Добавить оверлей на слой подсветок:
-     * add(overlayLine, OVERLAY_LAYER);
+     * Пустой метод, предназначен для переопределения в наследниках
+     * (например, для обновления контролов камеры).
      *
-     * @internal
+     * @protected
+     * @method
+     * @virtual
      */
-    addObject(obj: THREE.Object3D, layer?: number): void;
+    protected update(): void;
     /**
-     * Удаляет объект из сцены (или из его родителя, если он есть).
-     *
-     * @param obj - Объект, который необходимо удалить.
+     * Запускает основной цикл рендеринга.
      *
      * @remarks
-     * Если у объекта есть `parent`, он будет удалён из родителя. Иначе — метод попытается
-     * удалить его напрямую из `this.scene`. В рамках данного API метод не отвечает за
-     * освобождение GPU-ресурсов; освобождайте геометрию/материалы отдельно при необходимости.
+     * Вызывает `update()` и `render()` каждый кадр с помощью `requestAnimationFrame`.
+     * **Важно:** вызывать метод только один раз.
      *
      * @example
-     * // Снять оверлей со сцены:
-     * removeObject(overlayLine);
+     * ```typescript
+     * renderer.loop();
+     * ```
      *
-     * @internal
+     * @public
+     * @method
      */
-    removeObject(obj: THREE.Object3D): void;
+    loop(): void;
+    getCamera(): THREE.Camera;
+    getRenderer(): THREE.WebGLRenderer;
+    getCanvas(): HTMLCanvasElement;
+    getDomElement(): HTMLElement;
+    getScene(): THREE.Scene;
     /**
-     * Включает указанный слой у активной камеры.
-     *
-     * @param layer - Номер слоя, который требуется сделать видимым для камеры.
+     * Освобождает ресурсы рендерера.
      *
      * @remarks
-     * Полезно для показа служебных оверлеев (например, подсветки) на отдельном слое.
-     * Метод не изменяет слои Raycaster — ими должен управлять другой слой API (например, IRaycastAPI).
-     *
-     * @example
-     * // Убедиться, что камера видит слой оверлеев:
-     * enableCameraLayer(OVERLAY_LAYER);
+     * Удаляет ссылки на сцену, камеру и canvas, вызывает `dispose()` у WebGLRenderer.
+     * Вызывается при уничтожении редактора IOC-контейнером.
      *
-     * @internal
+     * @public
+     * @method
      */
-    enableCameraLayer(layer: number): void;
-    /** Освобождает ресурсы рендерера, очищает внутренние данные. */
     dispose(): Promise<void> | void;
 }
 //# sourceMappingURL=renderer.d.ts.map

package/dist/core/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/core/renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C;;;;GAIG;AACH,8BAAsB,QAAS,YAAW,UAAU;IAClD,4BAA4B;IAC5B,SAAS,CAAC,KAAK,EAAG,KAAK,CAAC,KAAK,CAAC;IAE9B,uBAAuB;IACvB,SAAS,CAAC,MAAM,EAAG,KAAK,CAAC,iBAAiB,CAAC;IAE3C,mCAAmC;IACnC,SAAS,CAAC,QAAQ,EAAG,KAAK,CAAC,aAAa,CAAC;IAEzC,uDAAuD;IACvD,SAAS,CAAC,MAAM,EAAG,iBAAiB,CAAC;IAErC,8BAA8B;IAC9B,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAM;IAEpC;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,iBAAiB;IA+B/C;;OAEG;IACI,MAAM;IAMb;;OAEG;IACH,SAAS,CAAC,MAAM;IAIhB;;OAEG;IACH,SAAS,CAAC,MAAM,IAAI,IAAI;IAExB;;OAEG;IACI,IAAI;IAMX;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI;IAyB5C;;;;;OAKG;IACI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI;IAO/B;;;;;OAKG;IACI,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI;IAOlC;;;;;OAKG;IACI,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE;IAIhC;;;;;;;;;;;;;;;OAeG;IACI,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAS3D;;;;;;;;;;;;;;;OAeG;IACI,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAW9C;;;;;;;;;;;;;;OAcG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7C,gEAAgE;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAavC"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/core/renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,UAAU,CAAC;AAE/D,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,QACX,YACE,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,UAAU;IAoDgB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlDpD;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAG,KAAK,CAAC,KAAK,CAAC;IAE9B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAG,KAAK,CAAC,iBAAiB,CAAC;IAE3C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAG,KAAK,CAAC,aAAa,CAAC;IAEzC;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAG,iBAAiB,CAAC;IAErC;;;;;;;;;;;;;;;OAeG;gBAEiB,OAAO,EAAE,iBAAiB,EACD,OAAO,EAAE,cAAc;IAoEpE;;;;;;;;;;;;;OAaG;IACI,MAAM;IAMb;;;;;;;;;OASG;IACI,MAAM;IAIb;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,IAAI,IAAI;IAExB;;;;;;;;;;;;;;OAcG;IACI,IAAI;IAMJ,SAAS,IAAI,KAAK,CAAC,MAAM;IAIzB,WAAW,IAAI,KAAK,CAAC,aAAa;IAIlC,SAAS,IAAI,iBAAiB;IAI9B,aAAa,IAAI,WAAW;IAI5B,QAAQ,IAAI,KAAK,CAAC,KAAK;IAI9B;;;;;;;;;OASG;IACI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAQvC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-policy';
+export * from './use-validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/decorators/use-policy.d.ts

@@ -0,0 +1,5 @@
+import { IPolicy } from '../interfaces/policy';
+type PolicyAccessor<TThis> = (self: TThis) => IPolicy;
+export declare const usePolicy: <TThis extends object>(accessor: PolicyAccessor<TThis>) => <T extends (...args: any[]) => any>(_target: TThis, _propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+export {};
+//# sourceMappingURL=use-policy.d.ts.map

package/dist/decorators/use-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-policy.d.ts","sourceRoot":"","sources":["../../src/decorators/use-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,KAAK,cAAc,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;AAEtD,eAAO,MAAM,SAAS,GACnB,KAAK,SAAS,MAAM,EAAE,UAAU,cAAc,CAAC,KAAK,CAAC,MACrD,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChC,SAAS,KAAK,EACd,cAAc,MAAM,EACpB,YAAY,uBAAuB,CAAC,CAAC,CAAC,+BAiBvC,CAAC"}

package/dist/decorators/use-validator.d.ts

@@ -0,0 +1,5 @@
+import { IValidator } from '../interfaces/validator';
+type ValidatorAccessor<TThis> = (self: TThis) => IValidator;
+export declare const useValidator: <TThis extends object>(accessor: ValidatorAccessor<TThis>) => <T extends (...args: any[]) => any>(_target: TThis, _propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+export {};
+//# sourceMappingURL=use-validator.d.ts.map

package/dist/decorators/use-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-validator.d.ts","sourceRoot":"","sources":["../../src/decorators/use-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,KAAK,iBAAiB,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,UAAU,CAAC;AAE5D,eAAO,MAAM,YAAY,GACtB,KAAK,SAAS,MAAM,EAAE,UAAU,iBAAiB,CAAC,KAAK,CAAC,MACxD,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChC,SAAS,KAAK,EACd,cAAc,MAAM,EACpB,YAAY,uBAAuB,CAAC,CAAC,CAAC,+BAiBvC,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export * from './policy-error';
+export * from './validation-error';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/errors/policy-error.d.ts

@@ -0,0 +1,9 @@
+import { ResponseType } from '@planara/types';
+export declare class PolicyError extends Error {
+    readonly type: ResponseType;
+    readonly code?: string | undefined;
+    readonly meta?: unknown | undefined;
+    private readonly _name;
+    constructor(type: ResponseType, message: string, code?: string | undefined, meta?: unknown | undefined);
+}
+//# sourceMappingURL=policy-error.d.ts.map

package/dist/errors/policy-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-error.d.ts","sourceRoot":"","sources":["../../src/errors/policy-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,WAAY,SAAQ,KAAK;aAIlB,IAAI,EAAE,YAAY;aAElB,IAAI,CAAC,EAAE,MAAM;aACb,IAAI,CAAC,EAAE,OAAO;IANhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAGjC,IAAI,EAAE,YAAY,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC"}

package/dist/errors/validation-error.d.ts

@@ -0,0 +1,9 @@
+import { ResponseType } from '@planara/types';
+export declare class ValidationError extends Error {
+    readonly type: ResponseType;
+    readonly code?: string | undefined;
+    readonly meta?: unknown | undefined;
+    private readonly _name;
+    constructor(type: ResponseType, message: string, code?: string | undefined, meta?: unknown | undefined);
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/errors/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../src/errors/validation-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,eAAgB,SAAQ,KAAK;aAItB,IAAI,EAAE,YAAY;aAElB,IAAI,CAAC,EAAE,MAAM;aACb,IAAI,CAAC,EAAE,OAAO;IANhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;gBAGrC,IAAI,EAAE,YAAY,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC"}

package/dist/events/editor-events.d.ts

@@ -1,10 +1,11 @@
-import { EventTopics } from './event-topics';
-import { SelectMode } from '@planara/types';
+import { EventTopics } from '.';
 import * as THREE from 'three';
 /**
  * Типы событий редактора.
  * Используются в EventEmitter для типизированной публикации и подписки на события.
+ *
  * @public
+ * @type
  */
 export type EditorEvents = {
     /** Событие наведения на объект (hover). Payload: объект с пересечениями или null */
@@ -15,10 +16,5 @@ export type EditorEvents = {
     [EventTopics.SelectClick]: {
         intersection: THREE.Intersection;
     } | null;
-    /** Событие выбора объекта для редактирования. Payload: выбранный режим выборки */
-    [EventTopics.ToolSelect]: {
-        mode: SelectMode;
-        mesh: THREE.Object3D | null;
-    };
 };
 //# sourceMappingURL=editor-events.d.ts.map

package/dist/events/editor-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor-events.d.ts","sourceRoot":"","sources":["../../src/events/editor-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,oFAAoF;IACpF,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE;QAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvE,yEAAyE;IACzE,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE;QAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvE,kFAAkF;IAClF,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAA;KAAE,CAAC;CAC7E,CAAC"}
+{"version":3,"file":"editor-events.d.ts","sourceRoot":"","sources":["../../src/events/editor-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,oFAAoF;IACpF,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE;QAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;IAEvE,yEAAyE;IACzE,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE;QAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;CACxE,CAAC"}

package/dist/events/event-bus.d.ts

@@ -1,17 +1,114 @@
-import { EditorEvents } from './editor-events';
+import { EditorEvents } from '.';
 /**
- * Событийная шина редактора с топиками.
- * Используется для publish/subscribe без прямых зависимостей.
+ * Событийная шина редактора с типизированными топиками.
+ *
+ * @remarks
+ * Реализует паттерн Publish/Subscribe для слабой связи между компонентами.
+ *
+ * **Особенности:**
+ * - Полная типобезопасность через дженерики (`EditorEvents`)
+ * - Отсутствие прямых зависимостей между отправителем и получателем
+ * - Централизованное управление событиями
+ *
+ * **Где используется:**
+ * - `RaycasterModule` — публикует события выделения (`SelectHover`, `SelectClick`)
+ * - `SelectManager` — подписывается на события выделения
+ *
+ * @see {@link EditorEvents} - типы событий
+ * @see {@link EventTopics} - доступные топики
+ *
  * @public
+ * @class
  */
 export declare class EventBus {
+    /**
+     * Внутренний эмиттер событий Node.js.
+     *
+     * @private
+     * @member
+     */
     private _emitter;
+    /** @constructor */
     constructor();
-    /** Публикация события */
+    /**
+     * Публикует событие в шину.
+     *
+     * @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
+     */
     emit<K extends keyof EditorEvents>(event: K, payload: EditorEvents[K]): void;
-    /** Подписка на событие */
+    /**
+     * Подписывается на событие.
+     *
+     * @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
+     */
     on<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
-    /** Отписка от события */
+    /**
+     * Отписывается от события.
+     *
+     * @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
+     */
     off<K extends keyof EditorEvents>(event: K, listener: (payload: EditorEvents[K]) => void): void;
 }
 //# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,qBACa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAgB;;IAMhC,yBAAyB;IACzB,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5E,0BAA0B;IAC1B,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAI9F,yBAAyB;IACzB,GAAG,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;CAGhG"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,QAAQ;IACnB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAgB;IAEhC,mBAAmB;;IAKnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAInF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI;IAIP;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,YAAY,EACrC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI;CAGR"}

package/dist/events/event-topics.d.ts

@@ -1,14 +1,14 @@
 /**
  * Топики событий редактора.
  * Используются для подписки/публикации через 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"
 }
 //# sourceMappingURL=event-topics.d.ts.map

package/dist/events/event-topics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-topics.d.ts","sourceRoot":"","sources":["../../src/events/event-topics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,WAAW;IACrB,sFAAsF;IACtF,WAAW,iBAAiB;IAE5B,2EAA2E;IAC3E,WAAW,iBAAiB;IAE5B,0GAA0G;IAC1G,UAAU,gBAAgB;CAC3B"}
+{"version":3,"file":"event-topics.d.ts","sourceRoot":"","sources":["../../src/events/event-topics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,WAAW;IACrB,sFAAsF;IACtF,WAAW,iBAAiB;IAE5B,2EAA2E;IAC3E,WAAW,iBAAiB;CAC7B"}

package/dist/events/index.d.ts

@@ -0,0 +1,4 @@
+export * from './editor-events';
+export * from './event-bus';
+export * from './event-topics';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/handlers/display/index.d.ts

@@ -0,0 +1,2 @@
+export * from './wireframe-handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/display/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/display/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/handlers/display/wireframe-handler.d.ts

@@ -1,10 +1,12 @@
-import { IDisplayHandler } from '../../interfaces/handler/display-handler';
+import { IDisplayHandler } from '../../interfaces/handler';
+import { IMeshApi } from '../../interfaces/api';
 import { DisplayMode } from '@planara/types';
-import { IMeshApi } from '../../interfaces/api/mesh-api';
 /**
  * Хендлер для включения wireframe-режима.
  * Управляет сценой через RendererApi.
+ *
  * @internal
+ * @class
  */
 export declare class WireframeHandler implements IDisplayHandler {
     private _api;

package/dist/handlers/display/wireframe-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wireframe-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/display/wireframe-handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;;GAIG;AACH,qBACa,gBAAiB,YAAW,eAAe;IAcZ,OAAO,CAAC,IAAI;IAbtD,yBAAyB;IACzB,SAAgB,IAAI,EAAE,WAAW,CAAyB;IAE1D,0DAA0D;IAC1D,OAAO,CAAC,cAAc,CAAsC;IAE5D,qDAAqD;IACrD,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,eAAe,CAAmD;IAE1E,uCAAuC;IACvC,OAAO,CAAC,UAAU,CAA6B;gBAEG,IAAI,EAAE,QAAQ;IAEhE,yCAAyC;IAClC,MAAM,IAAI,IAAI;IAwBrB,gEAAgE;IACzD,QAAQ,IAAI,IAAI;IAuBvB,mFAAmF;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAItC,mEAAmE;IACnE,OAAO,CAAC,0BAA0B;CAgBnC"}
+{"version":3,"file":"wireframe-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/display/wireframe-handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;GAMG;AACH,qBACa,gBAAiB,YAAW,eAAe;IAcf,OAAO,CAAC,IAAI;IAbnD,yBAAyB;IACzB,SAAgB,IAAI,EAAE,WAAW,CAAyB;IAE1D,0DAA0D;IAC1D,OAAO,CAAC,cAAc,CAAsC;IAE5D,qDAAqD;IACrD,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,eAAe,CAAmD;IAE1E,uCAAuC;IACvC,OAAO,CAAC,UAAU,CAA6B;gBAEA,IAAI,EAAE,QAAQ;IAE7D,yCAAyC;IAClC,MAAM,IAAI,IAAI;IAwBrB,gEAAgE;IACzD,QAAQ,IAAI,IAAI;IAuBvB,mFAAmF;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAItC,mEAAmE;IACnE,OAAO,CAAC,0BAA0B;CAgBnC"}

package/dist/handlers/scene/add-figure-scene-handler.d.ts

@@ -1,10 +1,12 @@
-import { ISceneHandler } from '../../interfaces/handler/scene-handler';
-import { IMeshApi } from '../../interfaces/api/mesh-api';
+import { ISceneHandler } from '../../interfaces/handler';
+import { IMeshApi } from '../../interfaces/api';
 import { FigureType, SceneMode } from '@planara/types';
 /**
  * Хендлер для добавления базовых фигур на сцену.
  * Управляет сценой через RendererApi.
+ *
  * @internal
+ * @class
  */
 export declare class AddFigureSceneHandler implements ISceneHandler {
     private _api;

package/dist/handlers/scene/add-figure-scene-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-figure-scene-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/scene/add-figure-scene-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS5D;;;;GAIG;AACH,qBACa,qBAAsB,YAAW,aAAa;IAOf,OAAO,CAAC,IAAI;IANtD,iCAAiC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAuB;IAEtD,uEAAuE;IACvE,OAAO,CAAC,cAAc,CAA2B;gBAEC,IAAI,EAAE,QAAQ;IAEhE,2EAA2E;IACpE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAyBvC,wCAAwC;IACjC,QAAQ,IAAI,IAAI;IASvB,oCAAoC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIvC"}
+{"version":3,"file":"add-figure-scene-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/scene/add-figure-scene-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQ5D;;;;;;GAMG;AACH,qBACa,qBAAsB,YAAW,aAAa;IAOlB,OAAO,CAAC,IAAI;IANnD,iCAAiC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAuB;IAEtD,uEAAuE;IACvE,OAAO,CAAC,cAAc,CAA2B;gBAEF,IAAI,EAAE,QAAQ;IAE7D,2EAA2E;IACpE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IA8BvC,wCAAwC;IACjC,QAAQ,IAAI,IAAI;IASvB,oCAAoC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIvC"}

package/dist/handlers/scene/delete-figure-scene-handler.d.ts

@@ -1,7 +1,7 @@
-import { ISceneHandler } from '../../interfaces/handler/scene-handler';
-import { IMeshApi } from '../../interfaces/api/mesh-api';
+import { ISceneHandler } from '../../interfaces/handler';
+import { IMeshApi } from '../../interfaces/api';
+import { ISelectStore } from '../../interfaces/store';
 import { SceneMode } from '@planara/types';
-import { IEditorStore } from '../../interfaces/store/editor-store';
 /**
  * Хендлер для удаления фигур со сцены.
  * Управляет сценой через RendererApi.
@@ -14,7 +14,7 @@ export declare class DeleteFigureSceneHandler implements ISceneHandler {
     readonly mode: SceneMode;
     /** Последняя удаленная фигура, сохраняем для отката через `ctrl + z` */
     private _lastDeletedMesh;
-    constructor(_api: IMeshApi, _store: IEditorStore);
+    constructor(_api: IMeshApi, _store: ISelectStore);
     handle(): void;
     /** Срабатывает только на `ctrl + z`. */
     rollback(): void;

package/dist/handlers/scene/delete-figure-scene-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-figure-scene-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/scene/delete-figure-scene-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAIxE;;;;GAIG;AACH,qBACa,wBAAyB,YAAW,aAAa;IAQnC,OAAO,CAAC,IAAI;IACX,OAAO,CAAC,MAAM;IARxC,iCAAiC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAA0B;IAEzD,wEAAwE;IACxE,OAAO,CAAC,gBAAgB,CAA2B;gBAGlB,IAAI,EAAE,QAAQ,EACb,MAAM,EAAE,YAAY;IAG/C,MAAM,IAAI,IAAI;IAerB,wCAAwC;IACjC,QAAQ,IAAI,IAAI;IASvB,oCAAoC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIvC"}
+{"version":3,"file":"delete-figure-scene-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/scene/delete-figure-scene-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C;;;;GAIG;AACH,qBACa,wBAAyB,YAAW,aAAa;IAQtC,OAAO,CAAC,IAAI;IACT,OAAO,CAAC,MAAM;IARvC,iCAAiC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAA0B;IAEzD,wEAAwE;IACxE,OAAO,CAAC,gBAAgB,CAA2B;gBAGrB,IAAI,EAAE,QAAQ,EACX,MAAM,EAAE,YAAY;IAG9C,MAAM,IAAI,IAAI;IAerB,wCAAwC;IACjC,QAAQ,IAAI,IAAI;IASvB,oCAAoC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIvC"}

package/dist/handlers/scene/export-scene-handler.d.ts

@@ -0,0 +1,23 @@
+import { ISceneHandler } from '../../interfaces/handler';
+import { ISceneApi } from '../../interfaces/api';
+import { IExportStore } from '../../interfaces/store';
+import { SceneMode } from '@planara/types';
+/**
+ * Хендлер для экспорта сцены в виде файла.
+ *
+ * @internal
+ * @class
+ */
+export declare class ExportSceneHandler implements ISceneHandler {
+    private _api;
+    private readonly _exportStore;
+    /** Режим редактирования сцены */
+    readonly mode: SceneMode;
+    constructor(_api: ISceneApi, _exportStore: IExportStore);
+    /** Экспорт всей сцены в ExportStore для последующей загрузки в виде файла. */
+    handle(): void;
+    rollback(): void;
+    /** Освобождает ресурсы хендлера. */
+    dispose(): Promise<void> | void;
+}
+//# sourceMappingURL=export-scene-handler.d.ts.map

package/dist/handlers/scene/export-scene-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-scene-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/scene/export-scene-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C;;;;;GAKG;AACH,qBACa,kBAAmB,YAAW,aAAa;IAK/B,OAAO,CAAC,IAAI;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IALtD,iCAAiC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAoB;gBAGpB,IAAI,EAAE,SAAS,EACJ,YAAY,EAAE,YAAY;IAGpE,8EAA8E;IACvE,MAAM,IAAI,IAAI;IAmBd,QAAQ,IAAI,IAAI;IAEvB,oCAAoC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGvC"}

package/dist/handlers/scene/index.d.ts

@@ -0,0 +1,6 @@
+export * from './add-figure-scene-handler';
+export * from './delete-figure-scene-handler';
+export * from './export-scene-handler';
+export * from './load-scene-handler';
+export * from './load-figure-scene-handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/scene/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC"}