@planara/core 2.8.0 → 3.1.0

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

@@ -0,0 +1,120 @@
+import { ToolType } from '@planara/types';
+import { TransformListener } from '../../types/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,kBAAkB,CAAC;AAE1D;;;;;;;;;;;;;;;;;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';
+/**
+ * @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,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB"}

package/dist/interfaces/controller/index.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=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/controller/index.ts"],"names":[],"mappings":"AACA,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/index.d.ts

@@ -0,0 +1,6 @@
+export * from './display-handler';
+export * from './handler';
+export * from './scene-handler';
+export * from './select-handler';
+export * from './tool-handler';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

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 {
     /** Режим выборки, за который отвечает хендлер */

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

@@ -1 +1 @@
-{"version":3,"file":"select-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/select-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,iDAAiD;IACjD,IAAI,EAAE,UAAU,CAAC;CAClB"}
+{"version":3,"file":"select-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/select-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,iDAAiD;IACjD,IAAI,EAAE,UAAU,CAAC;CAClB"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"tool-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/tool-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,8CAA8C;IAC9C,IAAI,EAAE,QAAQ,CAAC;CAChB"}
+{"version":3,"file":"tool-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/tool-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,8CAA8C;IAC9C,IAAI,EAAE,QAAQ,CAAC;CAChB"}

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

@@ -1,7 +1,9 @@
 import { IManager } from './manager';
 /**
  * Маркерный интерфейс для менеджера отображения.
- * @public
+ *
+ * @internal
+ * @interface
  */
 export interface IDisplayManager extends IManager {
 }

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

@@ -1 +1 @@
-{"version":3,"file":"display-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/display-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ;CAAG"}
+{"version":3,"file":"display-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/display-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,QAAQ;CAAG"}

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

@@ -0,0 +1,6 @@
+export * from './display-manager';
+export * from './manager';
+export * from './scene-manager';
+export * from './select-manager';
+export * from './tool-manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/interfaces/manager/manager.d.ts

@@ -1,12 +1,23 @@
 import { Disposable } from 'tsyringe';
+import { FeatureType } from '../../types/feature';
 /**
  * Общий интерфейс для всех менеджеров в хабе.
  * Каждый менеджер отвечает за одну фичу.
- * @public
+ *
+ * @internal
+ * @interface
  */
 export interface IManager extends Disposable {
+    /**
+     * Тип фичи, за которую отвечает менеджер.
+     *
+     * @member
+     */
+    type: FeatureType;
     /**
      * Выполняет основное действие менеджера.
+     *
+     * @method
      */
     manage(...args: unknown[]): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClC"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C;;;;OAIG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClC"}

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

@@ -1,7 +1,9 @@
 import { IManager } from './manager';
 /**
  * Маркерный интерфейс для менеджера сцены.
- * @public
+ *
+ * @internal
+ * @interface
  */
 export interface ISceneManager extends IManager {
 }

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

@@ -1 +1 @@
-{"version":3,"file":"scene-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/scene-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ;CAAG"}
+{"version":3,"file":"scene-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/scene-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ;CAAG"}

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

@@ -1,7 +1,9 @@
 import { IManager } from './manager';
 /**
  * Маркерный интерфейс для менеджера выборки.
- * @public
+ *
+ * @internal
+ * @interface
  */
 export interface ISelectManager extends IManager {
 }

package/dist/interfaces/manager/select-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/select-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;CAAG"}
+{"version":3,"file":"select-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/select-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;CAAG"}

package/dist/interfaces/manager/tool-manager.d.ts

@@ -1,7 +1,9 @@
 import { IManager } from './manager';
 /**
  * Маркерный интерфейс для менеджера инструментов.
- * @public
+ *
+ * @internal
+ * @interface
  */
 export interface IToolManager extends IManager {
 }

package/dist/interfaces/manager/tool-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/tool-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;CAAG"}
+{"version":3,"file":"tool-manager.d.ts","sourceRoot":"","sources":["../../../src/interfaces/manager/tool-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ;CAAG"}

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

@@ -0,0 +1,51 @@
+import { ICommand } from '../command';
+import { IResponse } from '@planara/types';
+import { Disposable } from 'tsyringe';
+/**
+ * Интерфейс медиатора команд редактора.
+ *
+ * @remarks
+ * Медиатор выступает промежуточным слоем между публичным API хаба
+ * и менеджерами конкретных функциональных областей редактора.
+ *
+ * Основные задачи медиатора:
+ * - принять команду от верхнего уровня
+ * - определить менеджер, отвечающий за указанную фичу
+ * - передать вызов в pipeline middleware
+ * - вернуть итоговый ответ выполнения команды
+ *
+ * В штатном сценарии успешное выполнение команды может не формировать явный ответ и возвращать `null`.
+ * Если в процессе обработки возникает исключение, например ошибка политики,
+ * оно может быть преобразовано middleware в объект `IResponse`.
+ *
+ * @public
+ * @interface
+ */
+export interface IMediator extends Disposable {
+    /**
+     * Отправляет команду на выполнение через 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;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/mediator/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;CAC3C"}

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

@@ -0,0 +1,50 @@
+import { IResponse } from '@planara/types';
+/**
+ * Интерфейс middleware в pipeline обработки команд редактора.
+ *
+ * @remarks
+ * Middleware позволяет внедрять сквозную логику поверх вызова менеджера,
+ * не изменяя реализацию самих менеджеров.
+ *
+ * Middleware образуют цепочку вызовов, в которой каждый элемент
+ * получает функцию `next` для передачи управления следующему шагу pipeline.
+ *
+ * Возвращаемое значение:
+ * - `null`, если выполнение завершилось без необходимости формировать ответ
+ * - `IResponse`, если middleware сформировал ответ самостоятельно, например при перехвате исключения
+ *
+ * @internal
+ * @interface
+ */
+export interface IMiddleware {
+    /**
+     * Выполняет шаг middleware и передаёт управление следующему
+     * обработчику в pipeline.
+     *
+     * @param next - функция вызова следующего шага pipeline
+     *
+     * @returns результат выполнения текущего шага pipeline:
+     * - `null`, если явный ответ не был сформирован
+     * - `IResponse`, если middleware сформировал ответ самостоятельно
+     *
+     * @example
+     * ```typescript
+     * public async handle(next: () => Promise<IResponse | null>): Promise<IResponse | null> {
+     *   try {
+     *     return await next();
+     *   } catch {
+     *     return {
+     *       type: ResponseType.Error,
+     *       message: 'Unexpected error',
+     *       blocked: true,
+     *     };
+     *   }
+     * }
+     * ```
+     *
+     * @public
+     * @method
+     */
+    handle(next: () => IResponse | null): IResponse | null;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/middleware/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;CACxD"}

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

@@ -0,0 +1,4 @@
+export * from './renderable-module';
+export * from './runtime-module';
+export * from './updatable-module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/module/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/interfaces/module/renderable-module.d.ts

@@ -0,0 +1,27 @@
+import { IRuntimeModule } from './runtime-module';
+import { IRenderable } from '../api/renderer';
+/**
+ * Интерфейс для модулей, требующих кастомного рендеринга.
+ *
+ * @remarks
+ * Некоторые модули должны рендерить дополнительную графику поверх основной сцены:
+ * - `GizmoModule` — отображение осей координат (CameraAxesGizmo)
+ * - оверлеи, подсказки, вспомогательные элементы
+ *
+ * В отличие от {@link IUpdatableModule}, который обновляет состояние,
+ * `IRenderableModule` отвечает именно за отрисовку дополнительных элементов
+ * **после** основного рендера сцены.
+ *
+ * Оркестрацией вызовов `render()` занимается `EditorRenderer`,
+ * который получает все модули через `@injectAll('IRenderableModule')`.
+ *
+ * @see {@link IRuntimeModule} - для одноразовой инициализации
+ * @see {@link IUpdatableModule} - для модулей с периодическим обновлением
+ * @see {@link GizmoModule} - пример реализации
+ *
+ * @internal
+ * @interface
+ */
+export interface IRenderableModule extends IRuntimeModule, IRenderable {
+}
+//# sourceMappingURL=renderable-module.d.ts.map

package/dist/interfaces/module/renderable-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderable-module.d.ts","sourceRoot":"","sources":["../../../src/interfaces/module/renderable-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc,EAAE,WAAW;CAAG"}

package/dist/interfaces/module/runtime-module.d.ts

@@ -0,0 +1,54 @@
+import { Disposable } from 'tsyringe';
+/**
+ * Базовый интерфейс для всех runtime-модулей редактора.
+ *
+ * @remarks
+ * Модули — это независимые компоненты, которые управляют определёнными аспектами редактора:
+ * - управление камерой и контролами (`ControlsModule`)
+ * - управление сценой и объектами (`SceneModule`)
+ * - обработка выделения (`RaycasterModule`)
+ * - отображение вспомогательных элементов (`GizmoModule`)
+ *
+ * Все модули проходят единый жизненный цикл:
+ * 1. `init()` — инициализация модуля (подписки, создание объектов)
+ * 2. `dispose()` — освобождение ресурсов (отписки, очистка)
+ *
+ * Оркестрацией модулей занимается {@link EditorHub}.
+ *
+ * @see {@link ControlsModule} - пример реализации
+ * @see {@link SceneModule} - пример реализации
+ * @see {@link RaycastModule} - пример реализации
+ *
+ * @internal
+ * @interface
+ */
+export interface IRuntimeModule extends Disposable {
+    /**
+     * Инициализирует модуль.
+     *
+     * @remarks
+     * Вызывается один раз при старте редактора.
+     * Здесь модуль должен:
+     * - создавать необходимые объекты
+     * - подписываться на события
+     * - регистрировать обработчики
+     *
+     * Порядок инициализации модулей не важен, так как модули
+     * не должны зависеть друг от друга на этапе `init()`.
+     * Взаимодействие происходит через API и EventBus после инициализации.
+     *
+     * @example
+     * ```typescript
+     * public init(): void {
+     *   // Создание контролов
+     *   this._orbit = new OrbitControls(...);
+     *   // Подписка на события
+     *   this._eventBus.on(EventTopics.SelectClick, this._onClick);
+     * }
+     * ```
+     *
+     * @internal
+     */
+    init(): void;
+}
+//# sourceMappingURL=runtime-module.d.ts.map

package/dist/interfaces/module/runtime-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-module.d.ts","sourceRoot":"","sources":["../../../src/interfaces/module/runtime-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,IAAI,IAAI,CAAC;CACd"}