@planara/core 3.0.0 → 3.1.0

package/dist/index.full.d.ts

@@ -1,9 +1,13 @@
 import { DisplayMode } from '@planara/types';
 import { Disposable as Disposable_2 } from 'tsyringe';
+import { ExportResult } from '@planara/types';
+import { ExportSceneResult } from '@planara/types';
 import { Figure } from '@planara/types';
 import { FigureTransform } from '@planara/types';
 import { FigureType } from '@planara/types';
-import { SceneMode } from '@planara/types';
+import { IResponse } from '@planara/types';
+import { RendererConfig } from '@planara/types';
+import { RendererConfigInput } from '@planara/types';
 import { SelectMode } from '@planara/types';
 import * as THREE from 'three';
 import { ToolType } from '@planara/types';
@@ -23,7 +27,14 @@ export declare type CameraPosition = {
  * Вызывать один раз при старте (когда есть canvas).
  * @public
  */
-export declare const createAppHub: (canvas: HTMLCanvasElement) => EditorHub;
+export declare const createEditorHub: (canvas: HTMLCanvasElement, rendererConfig?: RendererConfigInput) => EditorHub;
+
+/**
+ * Инициализирует вьювер и возвращает хаб.
+ * Вызывать один раз при старте (когда есть canvas).
+ * @public
+ */
+export declare const createViewerHub: (canvas: HTMLCanvasElement, rendererConfig?: RendererConfigInput) => ViewerHub;
 
 /**
  * Типы событий редактора.
@@ -51,13 +62,17 @@ export declare class EditorHub implements Disposable_2 {
     private _renderer;
     private _mediator;
     private _store;
+    private _exportStore;
     private _controller;
-    constructor(_renderer: Renderer, _mediator: IMediator, _store: ITransformStore, _controller: IController);
+    constructor(_renderer: Renderer, _mediator: IMediator, _store: ITransformStore, _exportStore: IExportStore, _controller: IController);
     setDisplayMode(mode: DisplayMode): IResponse | null;
-    setSceneMode(mode: SceneMode): IResponse | null;
     setSelectMode(mode: SelectMode): IResponse | null;
     setToolMode(mode: ToolType): IResponse | null;
-    addFigure(mode: SceneMode, figure: FigureType): IResponse | null;
+    addFigure(figure: FigureType): IResponse | null;
+    deleteFigure(): IResponse | null;
+    loadFigure(content: string): IResponse | null;
+    loadScene(content: string): IResponse | null;
+    exportScene(): ExportSceneResult;
     resizeRenderer(): void;
     /**
      * Запускает редактор.
@@ -220,7 +235,13 @@ export declare enum FeatureType {
  * Возвращает уже созданный хаб, если редактор инициализирован.
  * @public
  */
-export declare const getAppHub: () => EditorHub;
+export declare const getEditorHub: () => EditorHub;
+
+/**
+ * Возвращает уже созданный хаб, если редактор инициализирован.
+ * @public
+ */
+export declare const getViewerHub: () => ViewerHub;
 
 /**
  * @public
@@ -287,6 +308,13 @@ export declare interface IDisplayStore {
     setDisplayMode(mode: DisplayMode): void;
 }
 
+/** @public */
+export declare interface IExportStore {
+    setResult(result: ExportResult): void;
+    getResult(): ExportResult | null;
+    clearResult(): void;
+}
+
 /**
  * Интерфейс медиатора команд редактора.
  *
@@ -544,27 +572,6 @@ export declare interface IRendererSceneAccess {
     getScene(): THREE.Scene;
 }
 
-/**
- * Тип ответа от менеджеров или политик редактора.
- *
- * @remarks
- * Используется для единого API на уровне Hub.
- * Все менеджеры возвращают `Response`, чтобы клиент знал статус вызова.
- *
- * @public
- * @interface
- */
-export declare interface IResponse {
-    /** Тип ответа (enum ResponseType) */
-    type: ResponseType_2;
-    /** Читаемое сообщение для отображения или логирования */
-    message: string;
-    /** Строковый код для логов или интеграций (опционально) */
-    code?: string;
-    /** Флаг блокировки действия (true, если вызов запрещён) */
-    blocked?: boolean;
-}
-
 /**
  * Интерфейс store для менеджеров и хендлеров, которые позволяют работать с Select фичей,
  * необходим для корректного взаимодействия между группами фичей.
@@ -687,6 +694,7 @@ export declare class ObjLoader {
  * @class
  */
 export declare class Renderer implements IRendererAccess, IRendererCameraAccess, IRendererDomAccess, IRendererSceneAccess, IRenderable, Disposable_2 {
+    private readonly _config;
     /**
      * Корневой объект сцены Three.js.
      *
@@ -719,22 +727,19 @@ export declare class Renderer implements IRendererAccess, IRendererCameraAccess,
      * Конструктор рендерера.
      *
      * @param _canvas - HTMLCanvasElement для рендеринга
+     * @param _config - Конфиг для настройки рендерера
      *
      * @remarks
-     * Инициализирует сцену с тёмным фоном, перспективную камеру
-     * (45° FOV, near 0.1, far 1000) и базовое освещение:
-     * - `AmbientLight` (0xffffff, 0.5) — общий свет
-     * - `DirectionalLight` (0xffffff, 1) — направленный свет
+     * Инициализирует сцену, камеру, WebGLRenderer и базовое освещение
+     * на основе переданного `RendererConfig`.
      *
-     * @example
-     * ```typescript
-     * const renderer = new Renderer(canvas);
-     * ```
+     * По умолчанию используется тёмный фон, перспективная камера
+     * и два источника света: AmbientLight и DirectionalLight.
      *
      * @public
      * @constructor
      */
-    constructor(_canvas: HTMLCanvasElement);
+    constructor(_canvas: HTMLCanvasElement, _config: RendererConfig);
     /**
      * Обновляет размер рендерера и пропорции камеры.
      *
@@ -746,7 +751,7 @@ export declare class Renderer implements IRendererAccess, IRendererCameraAccess,
      * window.addEventListener('resize', () => renderer.resize());
      * ```
      *
-     * @oublic
+     * @public
      * @method
      */
     resize(): void;
@@ -807,30 +812,35 @@ export declare class Renderer implements IRendererAccess, IRendererCameraAccess,
     dispose(): Promise<void> | void;
 }
 
-/**
- * Enum типов ответа от менеджеров и политик.
- *
- * @remarks
- * Используется в `IResponse.type`.
- *
- * @public
- * @enum
- */
-declare enum ResponseType_2 {
-    /** Действие заблокировано, инструмент недоступен */
-    ToolNotAllowed = "TOOL_NOT_ALLOWED",
-    /** Действие выполнено успешно */
-    Success = "SUCCESS",
-    /** Действие не выполнено, потому что нет изменений */
-    NoChange = "NO_CHANGE",
-    Error = "ERROR"
-}
-export { ResponseType_2 as ResponseType }
-
 /** @public */
 export declare type SelectedListener = (obj: THREE.Object3D | null) => void;
 
 /** @public */
 export declare type TransformListener = () => void;
 
+/**
+ * Хаб для управления вьювером
+ * @public
+ */
+export declare class ViewerHub implements Disposable_2 {
+    private _renderer;
+    private _mediator;
+    private _controller;
+    constructor(_renderer: Renderer, _mediator: IMediator, _controller: IController);
+    addFigure(figure: FigureType): IResponse | null;
+    loadFigure(content: string): IResponse | null;
+    loadScene(content: string): IResponse | null;
+    resizeRenderer(): void;
+    /**
+     * Запускает вьювер.
+     * Вызывается после создания хаба.
+     */
+    start(): void;
+    /**
+     * Останавливает вьювер.
+     */
+    stop(): void;
+    dispose(): Promise<void> | void;
+}
+
 export { }

package/dist/index.public.d.ts

@@ -1,9 +1,13 @@
 import { DisplayMode } from '@planara/types';
 import { Disposable as Disposable_2 } from 'tsyringe';
+import { ExportResult } from '@planara/types';
+import { ExportSceneResult } from '@planara/types';
 import { Figure } from '@planara/types';
 import { FigureTransform } from '@planara/types';
 import { FigureType } from '@planara/types';
-import { SceneMode } from '@planara/types';
+import { IResponse } from '@planara/types';
+import { RendererConfig } from '@planara/types';
+import { RendererConfigInput } from '@planara/types';
 import { SelectMode } from '@planara/types';
 import * as THREE from 'three';
 import { ToolType } from '@planara/types';
@@ -23,7 +27,14 @@ export declare type CameraPosition = {
  * Вызывать один раз при старте (когда есть canvas).
  * @public
  */
-export declare const createAppHub: (canvas: HTMLCanvasElement) => EditorHub;
+export declare const createEditorHub: (canvas: HTMLCanvasElement, rendererConfig?: RendererConfigInput) => EditorHub;
+
+/**
+ * Инициализирует вьювер и возвращает хаб.
+ * Вызывать один раз при старте (когда есть canvas).
+ * @public
+ */
+export declare const createViewerHub: (canvas: HTMLCanvasElement, rendererConfig?: RendererConfigInput) => ViewerHub;
 
 /**
  * Типы событий редактора.
@@ -51,13 +62,17 @@ export declare class EditorHub implements Disposable_2 {
     private _renderer;
     private _mediator;
     private _store;
+    private _exportStore;
     private _controller;
-    constructor(_renderer: Renderer, _mediator: IMediator, _store: ITransformStore, _controller: IController);
+    constructor(_renderer: Renderer, _mediator: IMediator, _store: ITransformStore, _exportStore: IExportStore, _controller: IController);
     setDisplayMode(mode: DisplayMode): IResponse | null;
-    setSceneMode(mode: SceneMode): IResponse | null;
     setSelectMode(mode: SelectMode): IResponse | null;
     setToolMode(mode: ToolType): IResponse | null;
-    addFigure(mode: SceneMode, figure: FigureType): IResponse | null;
+    addFigure(figure: FigureType): IResponse | null;
+    deleteFigure(): IResponse | null;
+    loadFigure(content: string): IResponse | null;
+    loadScene(content: string): IResponse | null;
+    exportScene(): ExportSceneResult;
     resizeRenderer(): void;
     /**
      * Запускает редактор.
@@ -220,7 +235,13 @@ export declare enum FeatureType {
  * Возвращает уже созданный хаб, если редактор инициализирован.
  * @public
  */
-export declare const getAppHub: () => EditorHub;
+export declare const getEditorHub: () => EditorHub;
+
+/**
+ * Возвращает уже созданный хаб, если редактор инициализирован.
+ * @public
+ */
+export declare const getViewerHub: () => ViewerHub;
 
 /**
  * @public
@@ -287,6 +308,13 @@ export declare interface IDisplayStore {
     setDisplayMode(mode: DisplayMode): void;
 }
 
+/** @public */
+export declare interface IExportStore {
+    setResult(result: ExportResult): void;
+    getResult(): ExportResult | null;
+    clearResult(): void;
+}
+
 /**
  * Интерфейс медиатора команд редактора.
  *
@@ -544,27 +572,6 @@ export declare interface IRendererSceneAccess {
     getScene(): THREE.Scene;
 }
 
-/**
- * Тип ответа от менеджеров или политик редактора.
- *
- * @remarks
- * Используется для единого API на уровне Hub.
- * Все менеджеры возвращают `Response`, чтобы клиент знал статус вызова.
- *
- * @public
- * @interface
- */
-export declare interface IResponse {
-    /** Тип ответа (enum ResponseType) */
-    type: ResponseType_2;
-    /** Читаемое сообщение для отображения или логирования */
-    message: string;
-    /** Строковый код для логов или интеграций (опционально) */
-    code?: string;
-    /** Флаг блокировки действия (true, если вызов запрещён) */
-    blocked?: boolean;
-}
-
 /**
  * Интерфейс store для менеджеров и хендлеров, которые позволяют работать с Select фичей,
  * необходим для корректного взаимодействия между группами фичей.
@@ -687,6 +694,7 @@ export declare class ObjLoader {
  * @class
  */
 export declare class Renderer implements IRendererAccess, IRendererCameraAccess, IRendererDomAccess, IRendererSceneAccess, IRenderable, Disposable_2 {
+    private readonly _config;
     /**
      * Корневой объект сцены Three.js.
      *
@@ -719,22 +727,19 @@ export declare class Renderer implements IRendererAccess, IRendererCameraAccess,
      * Конструктор рендерера.
      *
      * @param _canvas - HTMLCanvasElement для рендеринга
+     * @param _config - Конфиг для настройки рендерера
      *
      * @remarks
-     * Инициализирует сцену с тёмным фоном, перспективную камеру
-     * (45° FOV, near 0.1, far 1000) и базовое освещение:
-     * - `AmbientLight` (0xffffff, 0.5) — общий свет
-     * - `DirectionalLight` (0xffffff, 1) — направленный свет
+     * Инициализирует сцену, камеру, WebGLRenderer и базовое освещение
+     * на основе переданного `RendererConfig`.
      *
-     * @example
-     * ```typescript
-     * const renderer = new Renderer(canvas);
-     * ```
+     * По умолчанию используется тёмный фон, перспективная камера
+     * и два источника света: AmbientLight и DirectionalLight.
      *
      * @public
      * @constructor
      */
-    constructor(_canvas: HTMLCanvasElement);
+    constructor(_canvas: HTMLCanvasElement, _config: RendererConfig);
     /**
      * Обновляет размер рендерера и пропорции камеры.
      *
@@ -746,7 +751,7 @@ export declare class Renderer implements IRendererAccess, IRendererCameraAccess,
      * window.addEventListener('resize', () => renderer.resize());
      * ```
      *
-     * @oublic
+     * @public
      * @method
      */
     resize(): void;
@@ -807,30 +812,35 @@ export declare class Renderer implements IRendererAccess, IRendererCameraAccess,
     dispose(): Promise<void> | void;
 }
 
-/**
- * Enum типов ответа от менеджеров и политик.
- *
- * @remarks
- * Используется в `IResponse.type`.
- *
- * @public
- * @enum
- */
-declare enum ResponseType_2 {
-    /** Действие заблокировано, инструмент недоступен */
-    ToolNotAllowed = "TOOL_NOT_ALLOWED",
-    /** Действие выполнено успешно */
-    Success = "SUCCESS",
-    /** Действие не выполнено, потому что нет изменений */
-    NoChange = "NO_CHANGE",
-    Error = "ERROR"
-}
-export { ResponseType_2 as ResponseType }
-
 /** @public */
 export declare type SelectedListener = (obj: THREE.Object3D | null) => void;
 
 /** @public */
 export declare type TransformListener = () => void;
 
+/**
+ * Хаб для управления вьювером
+ * @public
+ */
+export declare class ViewerHub implements Disposable_2 {
+    private _renderer;
+    private _mediator;
+    private _controller;
+    constructor(_renderer: Renderer, _mediator: IMediator, _controller: IController);
+    addFigure(figure: FigureType): IResponse | null;
+    loadFigure(content: string): IResponse | null;
+    loadScene(content: string): IResponse | null;
+    resizeRenderer(): void;
+    /**
+     * Запускает вьювер.
+     * Вызывается после создания хаба.
+     */
+    start(): void;
+    /**
+     * Останавливает вьювер.
+     */
+    stop(): void;
+    dispose(): Promise<void> | void;
+}
+
 export { }