@planara/core 3.1.0 → 3.2.0

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

@@ -55,6 +55,7 @@ export interface ISceneApi {
      * Удаляет объект со сцены.
      *
      * @param object - объект Three.js для удаления
+     * @param dispose - нужно ли освободить ресурсы объекта и его дочерних элементов
      *
      * @remarks
      * Объект перестаёт отображаться на сцене.
@@ -67,7 +68,7 @@ export interface ISceneApi {
      * @internal
      * @method
      */
-    removeFromScene(object: THREE.Object3D): void;
+    removeFromScene(object: THREE.Object3D, dispose?: boolean): void;
     /**
      * Добавляет объект в сцену и (опционально) выставляет ему слой.
      *

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;;;;;;;;;;;;;;;;;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"}
+{"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;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjE;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/handler/benchmark-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD;;;;;OAKG;IACH,IAAI,EAAE,iBAAiB,CAAC;CACzB"}

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

@@ -3,4 +3,5 @@ export * from './handler';
 export * from './scene-handler';
 export * from './select-handler';
 export * from './tool-handler';
+export * from './benchmark-handler';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC/B,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,10 @@
+import { IManager } from './manager';
+/**
+ * Маркерный интерфейс для менеджера бенчмарка.
+ *
+ * @internal
+ * @interface
+ */
+export interface IBenchmarkManager extends IManager {
+}
+//# sourceMappingURL=benchmark-manager.d.ts.map

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

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

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

@@ -3,4 +3,5 @@ export * from './manager';
 export * from './scene-manager';
 export * from './select-manager';
 export * from './tool-manager';
+export * from './benchmark-manager';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC/B,cAAc,qBAAqB,CAAC"}

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

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

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

@@ -1 +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"}
+{"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;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Модуль, поддерживающий временное включение и отключение пользовательского взаимодействия.
+ *
+ * @remarks
+ * Используется для модулей, которые обрабатывают ввод пользователя
+ * или реагируют на действия в сцене. Отключение не освобождает ресурсы
+ * и не удаляет обработчики событий, а только приостанавливает интерактивную логику.
+ *
+ * @internal
+ * @interface
+ */
+export interface IInteractiveModule {
+    /**
+     * Включает или отключает пользовательское взаимодействие модуля.
+     *
+     * @param enabled - `true`, если взаимодействие должно быть включено
+     *
+     * @internal
+     * @method
+     */
+    setInteractionEnabled(enabled: boolean): void;
+    /**
+     * Возвращает текущее состояние пользовательского взаимодействия модуля.
+     *
+     * @returns `true`, если взаимодействие включено
+     *
+     * @internal
+     * @method
+     */
+    isInteractionEnabled(): boolean;
+}
+//# sourceMappingURL=interactive-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-module.d.ts","sourceRoot":"","sources":["../../../src/interfaces/module/interactive-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAE9C;;;;;;;OAOG;IACH,oBAAoB,IAAI,OAAO,CAAC;CACjC"}

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

@@ -0,0 +1,27 @@
+import { IRuntimeModule } from '.';
+/**
+ * Модуль наблюдения за состоянием runtime.
+ *
+ * @remarks
+ * Используется для модулей, которым необходимо получать уведомление
+ * во время основного цикла приложения без изменения сцены и выполнения рендеринга.
+ *
+ * Такие модули могут собирать метрики, отслеживать состояние runtime
+ * или выполнять диагностические действия.
+ *
+ * @internal
+ * @interface
+ */
+export interface IObserverModule extends IRuntimeModule {
+    /**
+     * Выполняет наблюдение за текущим состоянием runtime.
+     *
+     * @remarks
+     * Метод вызывается внутри основного цикла приложения.
+     * Конкретная реализация сама определяет, какие данные необходимо обработать.
+     *
+     * @internal
+     */
+    observe(): void;
+}
+//# sourceMappingURL=observer-module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observer-module.d.ts","sourceRoot":"","sources":["../../../src/interfaces/module/observer-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;;;;;;;OAQG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

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

@@ -3,4 +3,5 @@ export * from './select-store';
 export * from './tool-store';
 export * from './transform-store';
 export * from './export-store';
+export * from './metrics-store';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/interfaces/store/metrics-store.d.ts

@@ -0,0 +1,60 @@
+import { BenchmarkMetrics, BenchmarkReport, BenchmarkTestType } from '@planara/types';
+import { MetricsListener } from '../../types/listener';
+/**
+ * Хранилище метрик benchmark-тестирования.
+ *
+ * @public
+ * @interface
+ */
+export interface IMetricsStore {
+    /**
+     * Очищает сохраненные метрики и текущие live-значения.
+     *
+     * @public
+     */
+    clear(): void;
+    /**
+     * Сохраняет метрики успешно выполненного benchmark-теста.
+     *
+     * @param type - тип benchmark-теста
+     * @param metrics - собранные метрики производительности
+     *
+     * @public
+     */
+    addMetrics(type: BenchmarkTestType, metrics: BenchmarkMetrics): void;
+    /**
+     * Обновляет текущие live-метрики.
+     *
+     * @param metrics - текущие метрики производительности
+     *
+     * @public
+     */
+    setCurrentMetrics(metrics: BenchmarkMetrics | null): void;
+    /**
+     * Возвращает текущие live-метрики.
+     *
+     * @returns Текущие метрики или `null`, если измерение не выполняется
+     *
+     * @public
+     */
+    getCurrentMetrics(): BenchmarkMetrics | null;
+    /**
+     * Регистрирует слушатель обновления live-метрик.
+     *
+     * @param listener - обработчик обновления метрик
+     *
+     * @returns Функция отписки
+     *
+     * @public
+     */
+    subscribe(listener: MetricsListener): () => void;
+    /**
+     * Возвращает отчет по успешно выполненным benchmark-тестам.
+     *
+     * @returns Отчет benchmark-тестирования
+     *
+     * @public
+     */
+    getReport(): BenchmarkReport;
+}
+//# sourceMappingURL=metrics-store.d.ts.map

package/dist/interfaces/store/metrics-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-store.d.ts","sourceRoot":"","sources":["../../../src/interfaces/store/metrics-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErE;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;IAE1D;;;;;;OAMG;IACH,iBAAiB,IAAI,gBAAgB,GAAG,IAAI,CAAC;IAE7C;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;IAEjD;;;;;;OAMG;IACH,SAAS,IAAI,eAAe,CAAC;CAC9B"}

package/dist/interfaces/{controller → worker}/index.d.ts

@@ -1,6 +1,6 @@
 import { Disposable } from 'tsyringe';
 /**
- * Интерфейс для контроллера, управляющего жизненным циклом модулей.
+ * Интерфейс для воркера, управляющего жизненным циклом модулей.
  *
  * @remarks
  * Контроллер отвечает за:
@@ -13,9 +13,9 @@ import { Disposable } from 'tsyringe';
  * @public
  * @interface
  */
-export interface IController extends Disposable {
+export interface IWorker extends Disposable {
     /**
-     * Запускает контроллер.
+     * Запускает воркер.
      *
      * @remarks
      * Инициализирует все модули и запускает цикл рендеринга.
@@ -25,7 +25,7 @@ export interface IController extends Disposable {
      */
     start(): void;
     /**
-     * Останавливает контроллер.
+     * Останавливает воркер.
      *
      * @remarks
      * Останавливает цикл рендеринга и освобождает ресурсы.

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

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

package/dist/managers/benchmark/benchmark-manager.d.ts

@@ -0,0 +1,27 @@
+import { FeatureType } from '../../types/feature';
+import { BenchmarkTestType } from '@planara/types';
+import { IBenchmarkManager } from '../../interfaces/manager';
+import { IBenchmarkHandler } from '../../interfaces/handler';
+/**
+ * Менеджер benchmark-тестирования.
+ *
+ * @remarks
+ * Отвечает за выбор и запуск хендлера benchmark-теста по указанному режиму.
+ * При смене режима выполняет откат предыдущего хендлера, сохраняет текущий
+ * режим тестирования и передает управление соответствующему хендлеру.
+ *
+ * @internal
+ * @class
+ */
+export declare class BenchmarkManager implements IBenchmarkManager {
+    /** Тип фичи, за которую отвечает менеджер. */
+    readonly type: FeatureType;
+    /** Текущий режим тестирования */
+    private _currentMode;
+    /** Хендлеры, которые управляют тестированием */
+    private readonly _handlers;
+    constructor(handlers: IBenchmarkHandler[]);
+    manage(mode: BenchmarkTestType, durationMs: number): void;
+    dispose(): Promise<void> | void;
+}
+//# sourceMappingURL=benchmark-manager.d.ts.map

package/dist/managers/benchmark/benchmark-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-manager.d.ts","sourceRoot":"","sources":["../../../src/managers/benchmark/benchmark-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,sBAAsB,CAAC;AAExE;;;;;;;;;;GAUG;AACH,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,8CAA8C;IAC9C,SAAgB,IAAI,EAAE,WAAW,CAAyB;IAE1D,iCAAiC;IACjC,OAAO,CAAC,YAAY,CAA8C;IAElE,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;gBAEV,QAAQ,EAAE,iBAAiB,EAAE;IAIzE,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAWzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CASvC"}

package/dist/managers/benchmark/index.d.ts

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

package/dist/managers/benchmark/index.d.ts.map

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

package/dist/managers/index.d.ts

@@ -2,4 +2,5 @@ export * from './display';
 export * from './scene';
 export * from './select';
 export * from './tool';
+export * from './benchmark';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

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

@@ -1,4 +1,4 @@
-import { EventBus } from '../../events';
+import { EventBus } from '../../shared/events';
 import { SelectMode } from '@planara/types';
 import { FeatureType } from '../../types/feature';
 import { ISelectHandler } from '../../interfaces/handler';

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

@@ -1 +1 @@
-{"version":3,"file":"select-manager.d.ts","sourceRoot":"","sources":["../../../src/managers/select/select-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAkC,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;GAIG;AACH,qBACa,aAAc,YAAW,cAAc;IAW5B,OAAO,CAAC,SAAS;IAEd,OAAO,CAAC,MAAM;IAZvC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAA+B;IAEnD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IAEtD,8CAA8C;IACvC,IAAI,EAAE,WAAW,CAAsB;gBAGhB,SAAS,EAAE,QAAQ,EAClB,QAAQ,EAAE,cAAc,EAAE,EACxB,MAAM,EAAE,YAAY;IAUrD,+BAA+B;IACxB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAYrC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAMd;IAEF,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAMd;IAEF,qCAAqC;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAWvC"}
+{"version":3,"file":"select-manager.d.ts","sourceRoot":"","sources":["../../../src/managers/select/select-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAkC,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;GAIG;AACH,qBACa,aAAc,YAAW,cAAc;IAW5B,OAAO,CAAC,SAAS;IAEd,OAAO,CAAC,MAAM;IAZvC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAA+B;IAEnD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IAEtD,8CAA8C;IACvC,IAAI,EAAE,WAAW,CAAsB;gBAGhB,SAAS,EAAE,QAAQ,EAClB,QAAQ,EAAE,cAAc,EAAE,EACxB,MAAM,EAAE,YAAY;IAUrD,+BAA+B;IACxB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAYrC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAMd;IAEF,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAMd;IAEF,qCAAqC;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAWvC"}

package/dist/modules/controls-module.d.ts

@@ -1,5 +1,5 @@
 import { ITransformApi, IControlsStateApi, ISceneApi, IDomApi, ICameraApi } from '../interfaces/api';
-import { IUpdatableModule } from '../interfaces/module';
+import { IUpdatableModule, IInteractiveModule } from '../interfaces/module';
 import { ToolType } from '@planara/types';
 import { TransformListener } from '../types/listener';
 import * as THREE from 'three';
@@ -13,6 +13,7 @@ import * as THREE from 'three';
  *
  * Модуль реализует:
  * - `IRuntimeModule` — жизненный цикл (init/dispose)
+ * - `IInteractiveModule` — управление пользовательским вводом
  * - `IUpdatableModule` — обновление состояния каждый кадр (update)
  * - `IControlsApi` — публичное API для управления контролами
  * - `IControlsStateApi` — публичное API для получения состояния контролов
@@ -25,18 +26,40 @@ import * as THREE from 'three';
  * @internal
  * @class
  */
-export declare class ControlsModule implements IUpdatableModule, ITransformApi, IControlsStateApi {
+export declare class ControlsModule implements IUpdatableModule, IInteractiveModule, ITransformApi, IControlsStateApi {
     private _cameraApi;
     private _domApi;
     private _sceneApi;
-    /** Orbit-контроллер для управления камерой */
+    /**
+     * Orbit-контроллер для управления камерой
+     *
+     * @private
+     * @member
+     */
     private _orbit;
-    /** Transform-контроллер для редактирования */
+    /**
+     * Transform-контроллер для редактирования
+     *
+     * @private
+     * @member
+     */
     private _transform;
     private _transformHelper;
     private _transformListeners;
-    /** Были ли инициализированы обработчики событий (hover/click) */
+    /**
+     * Были ли инициализированы обработчики событий (hover/click)
+     *
+     * @private
+     * @member
+     */
     private _isEventListenersAdded;
+    /**
+     * Доступно ли пользовательское взаимодействие с контроллерами
+     *
+     * @private
+     * @member
+     */
+    private _isInteractionEnabled;
     constructor(_cameraApi: ICameraApi, _domApi: IDomApi, _sceneApi: ISceneApi);
     init(): void;
     attachTransform(object: THREE.Object3D): void;
@@ -46,6 +69,8 @@ export declare class ControlsModule implements IUpdatableModule, ITransformApi,
     onTransformChange(callback: TransformListener): () => void;
     isOrbitInteracting(): boolean;
     isTransformDragging(): boolean;
+    setInteractionEnabled(enabled: boolean): void;
+    isInteractionEnabled(): boolean;
     private readonly _handlePointerDown;
     private readonly _handlePointerMove;
     private readonly _handlePointerUp;

package/dist/modules/controls-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controls-module.d.ts","sourceRoot":"","sources":["../../src/modules/controls-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,cAAe,YAAW,gBAAgB,EAAE,aAAa,EAAE,iBAAiB;IAa/D,OAAO,CAAC,UAAU;IACrB,OAAO,CAAC,OAAO;IACb,OAAO,CAAC,SAAS;IAdxC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAA+B;IAE7C,8CAA8C;IAC9C,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,mBAAmB,CAAgC;IAE3D,iEAAiE;IACjE,OAAO,CAAC,sBAAsB,CAAS;gBAGP,UAAU,EAAE,UAAU,EACzB,OAAO,EAAE,OAAO,EACd,SAAS,EAAE,SAAS;IAG5C,IAAI,IAAI,IAAI;IAkBZ,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAI7C,eAAe,IAAI,IAAI;IAIvB,MAAM,IAAI,IAAI;IAId,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAItC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAK1D,kBAAkB,IAAI,OAAO;IAI7B,mBAAmB,IAAI,OAAO;IAIrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEjC;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEjC;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAE/B;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAElC;IAEF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAMrC;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAEF,wDAAwD;IACxD,OAAO,CAAC,mBAAmB;IAiB3B,iCAAiC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAgCvC"}
+{"version":3,"file":"controls-module.d.ts","sourceRoot":"","sources":["../../src/modules/controls-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,cACX,YAAW,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB;IAqCzD,OAAO,CAAC,UAAU;IACrB,OAAO,CAAC,OAAO;IACb,OAAO,CAAC,SAAS;IArCxC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAA+B;IAE7C;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,mBAAmB,CAAgC;IAE3D;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB,CAAS;IAEvC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB,CAAQ;gBAGL,UAAU,EAAE,UAAU,EACzB,OAAO,EAAE,OAAO,EACd,SAAS,EAAE,SAAS;IAG5C,IAAI,IAAI,IAAI;IAkBZ,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI;IAI7C,eAAe,IAAI,IAAI;IAIvB,MAAM,IAAI,IAAI;IAId,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAItC,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAK1D,kBAAkB,IAAI,OAAO;IAI7B,mBAAmB,IAAI,OAAO;IAI9B,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAkB7C,oBAAoB,IAAI,OAAO;IAItC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI/B;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAEF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAMrC;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAEF,wDAAwD;IACxD,OAAO,CAAC,mBAAmB;IAiB3B,iCAAiC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAiCvC"}

package/dist/modules/gizmo-module.d.ts

@@ -1,4 +1,4 @@
-import { IRenderableModule } from '../interfaces/module';
+import { IInteractiveModule, IRenderableModule } from '../interfaces/module';
 import { ICameraApi, IDomApi, IRendererApi } from '../interfaces/api';
 /**
  * Модуль для отображения вспомогательных гизмо (осей, ориентации камеры и т.д.).
@@ -17,13 +17,27 @@ import { ICameraApi, IDomApi, IRendererApi } from '../interfaces/api';
  * @internal
  * @class
  */
-export declare class GizmoModule implements IRenderableModule {
+export declare class GizmoModule implements IRenderableModule, IInteractiveModule {
     private _cameraApi;
     private _domApi;
     private _rendererApi;
-    /** Gizmo для управления отображением perspective camera */
+    /**
+     * Gizmo для управления отображением perspective camera
+     *
+     * @private
+     * @member
+     */
     private _cameraGizmo;
+    /**
+     * Доступно ли пользовательское взаимодействие с контроллерами
+     *
+     * @private
+     * @member
+     */
+    private _isInteractionEnabled;
     constructor(_cameraApi: ICameraApi, _domApi: IDomApi, _rendererApi: IRendererApi);
+    setInteractionEnabled(enabled: boolean): void;
+    isInteractionEnabled(): boolean;
     init(): void;
     render(): void;
     /** Освобождение ресурсов модуля */

package/dist/modules/gizmo-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gizmo-module.d.ts","sourceRoot":"","sources":["../../src/modules/gizmo-module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI1E;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,WAAY,YAAW,iBAAiB;IAK3B,OAAO,CAAC,UAAU;IACrB,OAAO,CAAC,OAAO;IACP,OAAO,CAAC,YAAY;IANjD,2DAA2D;IAC3D,OAAO,CAAC,YAAY,CAAgC;gBAGpB,UAAU,EAAE,UAAU,EACzB,OAAO,EAAE,OAAO,EACR,YAAY,EAAE,YAAY;IAGxD,IAAI,IAAI,IAAI;IAaZ,MAAM,IAAI,IAAI;IAOrB,mCAAmC;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIvC"}
+{"version":3,"file":"gizmo-module.d.ts","sourceRoot":"","sources":["../../src/modules/gizmo-module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI1E;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,WAAY,YAAW,iBAAiB,EAAE,kBAAkB;IAkB/C,OAAO,CAAC,UAAU;IACrB,OAAO,CAAC,OAAO;IACP,OAAO,CAAC,YAAY;IAnBjD;;;;;OAKG;IACH,OAAO,CAAC,YAAY,CAAgC;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB,CAAQ;gBAGL,UAAU,EAAE,UAAU,EACzB,OAAO,EAAE,OAAO,EACR,YAAY,EAAE,YAAY;IAGxD,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK7C,oBAAoB,IAAI,OAAO;IAI/B,IAAI,IAAI,IAAI;IAaZ,MAAM,IAAI,IAAI;IASrB,mCAAmC;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAIvC"}

package/dist/modules/index.d.ts

@@ -3,4 +3,5 @@ export * from './gizmo-module';
 export * from './raycast-module';
 export * from './scene-module';
 export * from './scene-preview-module';
+export * from './metrics-module';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/modules/metrics-module.d.ts

@@ -0,0 +1,156 @@
+import { BenchmarkMetrics } from '@planara/types';
+import { MetricsListener } from '../types/listener';
+import { IObserverModule } from '../interfaces/module';
+import { IMetricsApi, IRendererInfoApi } from '../interfaces/api';
+/**
+ * Модуль сбора метрик производительности runtime.
+ *
+ * @remarks
+ * Модуль вызывается в фазе наблюдения основного цикла приложения.
+ * Он не изменяет сцену и не выполняет рендеринг, а только собирает
+ * показатели производительности текущего прогона.
+ *
+ * @internal
+ * @class
+ */
+export declare class MetricsModule implements IObserverModule, IMetricsApi {
+    private readonly _rendererInfoApi;
+    /** Выполняется ли сбор метрик */
+    private _isRunning;
+    /** Время запуска сбора метрик */
+    private _startedAt;
+    /** Время остановки сбора метрик */
+    private _stoppedAt;
+    /** Время предыдущего кадра */
+    private _lastFrameAt;
+    /** Количество обработанных кадров */
+    private _frames;
+    /** Суммарное время кадров */
+    private _frameTimeSum;
+    /** Максимальное время кадра */
+    private _maxFrameTime;
+    /** Количество объектов в тестовой сцене */
+    private _objectsCount;
+    /** Максимальное количество draw calls за время измерения */
+    private _drawCalls;
+    /** Максимальное количество треугольников за время измерения */
+    private _triangles;
+    /** Максимальное количество геометрий в памяти рендерера */
+    private _geometries;
+    /** Максимальное количество текстур в памяти рендерера */
+    private _textures;
+    /** Используемый объем памяти в мегабайтах */
+    private _memoryUsedMb;
+    /** Слушатели обновления метрик */
+    private readonly _listeners;
+    /** Время последнего уведомления слушателей */
+    private _lastNotifyAt;
+    /** Минимальный интервал уведомлений слушателей */
+    private readonly _notifyIntervalMs;
+    /**
+     * Конструктор модуля метрик.
+     *
+     * @param _rendererInfoApi - доступ к информации рендерера за кадр
+     *
+     * @internal
+     * @constructor
+     */
+    constructor(_rendererInfoApi: IRendererInfoApi);
+    /**
+     * Инициализирует модуль.
+     *
+     * @internal
+     * @method
+     */
+    init(): void;
+    /**
+     * Запускает сбор метрик.
+     *
+     * @param objectsCount - количество объектов, участвующих в текущем тесте
+     *
+     * @internal
+     * @method
+     */
+    start(objectsCount?: number): void;
+    /**
+     * Останавливает сбор метрик.
+     *
+     * @internal
+     * @method
+     */
+    stop(): void;
+    /**
+     * Сбрасывает накопленные метрики.
+     *
+     * @internal
+     * @method
+     */
+    reset(): void;
+    /**
+     * Выполняет наблюдение за текущим состоянием runtime.
+     *
+     * @remarks
+     * Метод вызывается каждый кадр в отдельной фазе render loop.
+     *
+     * @internal
+     * @method
+     */
+    observe(): void;
+    /**
+     * Возвращает текущие или последние собранные метрики.
+     *
+     * @returns Метрики производительности
+     *
+     * @internal
+     * @method
+     */
+    getMetrics(): BenchmarkMetrics;
+    /**
+     * Регистрирует слушатель изменения метрик.
+     *
+     * @param listener - обработчик обновления метрик
+     *
+     * @returns Функция отписки
+     *
+     * @internal
+     */
+    subscribe(listener: MetricsListener): () => void;
+    /**
+     * Освобождает ресурсы модуля.
+     *
+     * @internal
+     * @method
+     */
+    dispose(): Promise<void> | void;
+    /**
+     * Возвращает фактическую длительность сбора метрик.
+     *
+     * @returns Длительность измерения в миллисекундах
+     *
+     * @private
+     * @method
+     */
+    private _getDurationMs;
+    /**
+     * Сохраняет статистику WebGL-рендерера.
+     *
+     * @private
+     * @method
+     */
+    private _captureRendererInfo;
+    /**
+     * Сохраняет информацию об используемой памяти, если она доступна.
+     *
+     * @private
+     * @method
+     */
+    private _captureMemoryInfo;
+    /**
+     * Уведомляет слушателей об обновлении метрик.
+     *
+     * @private
+     * @method
+     */
+    private _notify;
+}
+//# sourceMappingURL=metrics-module.d.ts.map