vtkviewer-vue 0.1.0

package/lib/types/plugins/service/DragDropPlugin.d.ts

@@ -0,0 +1,94 @@
+import { PluginConfig, IServicePlugin } from '../types';
+import { PluginBase } from '../PluginBase';
+/** 拖拽加载插件配置 */
+export interface DragDropPluginConfig extends PluginConfig {
+    /** 是否允许多文件 */
+    multiple?: boolean;
+    /** 拖拽区域选择器 */
+    dropZoneSelector?: string;
+    /** 自定义验证函数 */
+    validateFile?: (file: File) => boolean | Promise<boolean>;
+}
+/**
+ * 拖拽加载插件
+ * 提供文件拖拽加载功能，包含文件验证和视觉反馈
+ */
+export declare class DragDropPlugin extends PluginBase<DragDropPluginConfig> implements IServicePlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "service";
+        description: string;
+    };
+    readonly defaultConfig: DragDropPluginConfig;
+    private dropZone;
+    private isDragging;
+    private dragCounter;
+    private _disposed;
+    /** 由已注册格式插件动态构建的支持扩展名列表 */
+    private supportedExtensions;
+    private boundHandleDragEnter;
+    private boundHandleDragOver;
+    private boundHandleDragLeave;
+    private boundHandleDrop;
+    private boundPreventDefault;
+    private setupTimer;
+    protected onInit(): void;
+    /**
+     * 遍历已注册的格式插件，收集所有支持的扩展名
+     */
+    private refreshSupportedExtensions;
+    /**
+     * 设置拖拽事件监听
+     */
+    private setupDragDrop;
+    /**
+     * 处理拖拽进入
+     */
+    private handleDragEnter;
+    /**
+     * 处理拖拽悬停
+     */
+    private handleDragOver;
+    /**
+     * 处理拖拽离开
+     */
+    private handleDragLeave;
+    /**
+     * 处理文件放置
+     */
+    private handleDrop;
+    /**
+     * 验证文件
+     */
+    private validateFiles;
+    /**
+     * 获取文件扩展名
+     */
+    private getExtension;
+    /**
+     * 显示拖拽覆盖层
+     */
+    private showDropOverlay;
+    /**
+     * 隐藏拖拽覆盖层
+     */
+    private hideDropOverlay;
+    /**
+     * 显示错误信息
+     */
+    private showError;
+    /**
+     * 启用拖拽
+     */
+    enable(): void;
+    /**
+     * 禁用拖拽
+     */
+    disable(): void;
+    /**
+     * 移除拖拽事件监听
+     */
+    private removeDragDrop;
+    protected onDispose(): void;
+}

package/lib/types/plugins/service/KeyBindingPlugin.d.ts

@@ -0,0 +1,83 @@
+import { KeyboardShortcutAction, PluginConfig, IServicePlugin } from '../types';
+import { PluginBase } from '../PluginBase';
+/** 快捷键注册项 */
+interface KeyBindingEntry {
+    id: string;
+    shortcut: KeyboardShortcutAction;
+    pluginId: string;
+}
+/**
+ * 快捷键注册表
+ * 管理所有键盘快捷键的注册、冲突检测和执行
+ */
+export declare class KeyBindingRegistry {
+    private bindings;
+    private keyMap;
+    /**
+     * 构建快捷键的完整按键字符串（包含修饰键）
+     * 字母键统一转为小写，避免 Caps Lock 导致不匹配
+     */
+    private buildShortcutKey;
+    /**
+     * 注册快捷键
+     */
+    register(pluginId: string, shortcut: KeyboardShortcutAction): void;
+    /**
+     * 注销插件的所有快捷键
+     */
+    unregisterPlugin(pluginId: string): void;
+    /**
+     * 处理键盘事件
+     */
+    handleKeydown(event: KeyboardEvent): void;
+    /**
+     * 构建按键字符串
+     * 字母键统一转为小写，避免 Caps Lock 导致不匹配
+     */
+    private buildKeyString;
+    /**
+     * 获取所有已注册的快捷键
+     */
+    getAll(): KeyBindingEntry[];
+    /**
+     * 检查快捷键是否已注册
+     */
+    has(key: string): boolean;
+    /**
+     * 检查快捷键是否已注册（使用完整按键字符串）
+     */
+    hasShortcut(shortcut: KeyboardShortcutAction): boolean;
+    /**
+     * 清除所有快捷键
+     */
+    clear(): void;
+}
+/** 键盘快捷键插件配置 */
+export interface KeyBindingPluginConfig extends PluginConfig {
+}
+/**
+ * 键盘快捷键管理插件
+ * 采用延迟收集模式，在所有插件初始化完成后统一收集快捷键
+ */
+export declare class KeyBindingPlugin extends PluginBase<KeyBindingPluginConfig> implements IServicePlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "service";
+        description: string;
+    };
+    private registry;
+    private keydownHandler;
+    protected onInit(): void;
+    /**
+     * 获取快捷键注册表（供外部调用）
+     */
+    getRegistry(): KeyBindingRegistry;
+    /**
+     * 延迟收集所有工具栏插件的快捷键
+     * 在所有插件初始化完成后执行
+     */
+    private collectShortcuts;
+    protected onDispose(): void;
+}
+export {};

package/lib/types/plugins/service/MemoryPressurePlugin.d.ts

@@ -0,0 +1,68 @@
+import { PluginConfig, IServicePlugin } from '../types';
+import { PluginBase } from '../PluginBase';
+/** 内存压力等级 */
+export type MemoryPressureLevel = 'normal' | 'warning' | 'danger';
+/** 内存压力配置 */
+export interface MemoryPressurePluginConfig extends PluginConfig {
+    /** 警告阈值（MB） */
+    warningThresholdMB?: number;
+    /** 危险阈值（MB） */
+    dangerThresholdMB?: number;
+    /** 监控间隔（ms） */
+    checkInterval?: number;
+}
+/** 内存统计信息 */
+export interface MemoryStats {
+    usedMB: number;
+    totalMB: number;
+    limitMB: number;
+    pressureLevel: MemoryPressureLevel;
+}
+/**
+ * 内存压力管理插件
+ * 使用 performance.memory API 监控JavaScript堆内存
+ * 提供三级压力评估：normal/warning/danger
+ */
+export declare class MemoryPressurePlugin extends PluginBase<MemoryPressurePluginConfig> implements IServicePlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "service";
+        description: string;
+    };
+    readonly defaultConfig: MemoryPressurePluginConfig;
+    private checkTimer;
+    private currentLevel;
+    protected onInit(): void;
+    /**
+     * 开始内存监控
+     */
+    private startMonitoring;
+    /**
+     * 检查内存使用情况
+     */
+    private checkMemory;
+    /**
+     * 计算压力等级
+     */
+    private calculatePressureLevel;
+    /**
+     * 保守清理策略
+     * 清理未使用纹理、不可见几何体
+     */
+    private performConservativeCleanup;
+    /**
+     * 激进清理策略
+     * 清理所有缓存、强制GC
+     */
+    private performAggressiveCleanup;
+    /**
+     * 获取当前内存统计
+     */
+    getStats(): MemoryStats | null;
+    /**
+     * 获取当前压力等级
+     */
+    getPressureLevel(): MemoryPressureLevel;
+    protected onDispose(): void;
+}

package/lib/types/plugins/service/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 服务插件导出
+ */
+export * from './DragDropPlugin';
+export * from './MemoryPressurePlugin';
+export * from './KeyBindingPlugin';

package/lib/types/plugins/toolbar/animation/AnimationPlugin.d.ts

@@ -0,0 +1,34 @@
+import { PluginIcon, ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 动画插件配置 */
+export interface AnimationPluginConfig extends ToolbarPluginConfig {
+    /** 播放状态图标 */
+    playIcon?: PluginIcon;
+    /** 暂停状态图标 */
+    pauseIcon?: PluginIcon;
+}
+export declare class AnimationPlugin extends PluginBase<AnimationPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 0;
+    readonly defaultConfig: AnimationPluginConfig;
+    private isPlaying;
+    private currentFrame;
+    private totalFrames;
+    protected onInit(): void;
+    protected onDispose(): void;
+    private play;
+    private pause;
+    private goToFrame;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    isVisible(): boolean;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/animation/index.d.ts

@@ -0,0 +1 @@
+export * from './AnimationPlugin';

package/lib/types/plugins/toolbar/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 工具栏插件导出
+ */
+export * from './interaction';
+export * from './model';
+export * from './tools';
+export * from './animation';
+export * from './scene';
+export * from './utils';

package/lib/types/plugins/toolbar/interaction/CenterModelPlugin.d.ts

@@ -0,0 +1,21 @@
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 居中模型插件配置 */
+export interface CenterModelPluginConfig extends ToolbarPluginConfig {
+}
+export declare class CenterModelPlugin extends PluginBase<CenterModelPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 3;
+    readonly defaultConfig: CenterModelPluginConfig;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/interaction/FullscreenPlugin.d.ts

@@ -0,0 +1,27 @@
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 全屏插件配置 */
+export interface FullscreenPluginConfig extends ToolbarPluginConfig {
+}
+export declare class FullscreenPlugin extends PluginBase<FullscreenPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 1;
+    readonly defaultConfig: FullscreenPluginConfig;
+    private isFullscreen;
+    private boundOnFullscreenChange;
+    protected onInit(): void;
+    protected onDispose(): void;
+    private onFullscreenChange;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    isVisible(): boolean;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/interaction/PanPlugin.d.ts

@@ -0,0 +1,24 @@
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 平移插件配置 */
+export interface PanPluginConfig extends ToolbarPluginConfig {
+}
+export declare class PanPlugin extends PluginBase<PanPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 2;
+    readonly defaultConfig: PanPluginConfig;
+    private active;
+    protected onInit(): void;
+    private onToolChanged;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/interaction/ResetAllPlugin.d.ts

@@ -0,0 +1,25 @@
+import { IResettableActions, ResetAction } from '../../../core';
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 重置所有插件配置 */
+export interface ResetAllPluginConfig extends ToolbarPluginConfig {
+}
+export declare class ResetAllPlugin extends PluginBase<ResetAllPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 4;
+    readonly defaultConfig: ResetAllPluginConfig;
+    registerResetActions(): ResetAction[];
+    /** 执行重置所有操作（仅重置相机和交互状态） */
+    private resetAll;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/interaction/RotatePlugin.d.ts

@@ -0,0 +1,24 @@
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 旋转插件配置 */
+export interface RotatePluginConfig extends ToolbarPluginConfig {
+}
+export declare class RotatePlugin extends PluginBase<RotatePluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 0;
+    readonly defaultConfig: RotatePluginConfig;
+    private active;
+    protected onInit(): void;
+    private onToolChanged;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/interaction/ViewSelectPlugin.d.ts

@@ -0,0 +1,26 @@
+import { IResettableActions, ResetAction } from '../../../core';
+import { ToolbarPluginConfig, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 视图选择插件配置 */
+export interface ViewSelectPluginConfig extends ToolbarPluginConfig {
+}
+export declare class ViewSelectPlugin extends PluginBase<ViewSelectPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 4;
+    readonly defaultConfig: ViewSelectPluginConfig;
+    /** 下拉框当前值（类级别状态） */
+    private currentValue;
+    protected onInit(): void;
+    /** 重置下拉框到默认状态 */
+    resetDropdown(): void;
+    registerResetActions(): ResetAction[];
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+}

package/lib/types/plugins/toolbar/interaction/ZoomPlugin.d.ts

@@ -0,0 +1,24 @@
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 缩放插件配置 */
+export interface ZoomPluginConfig extends ToolbarPluginConfig {
+}
+export declare class ZoomPlugin extends PluginBase<ZoomPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 1;
+    readonly defaultConfig: ZoomPluginConfig;
+    private active;
+    protected onInit(): void;
+    private onToolChanged;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}

package/lib/types/plugins/toolbar/interaction/index.d.ts

@@ -0,0 +1,7 @@
+export * from './CenterModelPlugin';
+export * from './FullscreenPlugin';
+export * from './PanPlugin';
+export * from './ResetAllPlugin';
+export * from './RotatePlugin';
+export * from './ViewSelectPlugin';
+export * from './ZoomPlugin';

package/lib/types/plugins/toolbar/model/ClippingPlugin.d.ts

@@ -0,0 +1,87 @@
+import { Component, DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { IResettableActions, ResetAction } from '../../../core';
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+type ClippingMode = 'clip' | 'cut' | 'section';
+type NormalPreset = 'X' | 'Y' | 'Z' | '-X' | '-Y' | '-Z';
+export interface ClippingPluginConfig extends ToolbarPluginConfig {
+    defaultMode?: ClippingMode;
+    defaultNormal?: NormalPreset;
+    insideOut?: boolean;
+    cutSectionColor?: [number, number, number];
+    enableWidget?: boolean;
+}
+export declare class ClippingPlugin extends PluginBase<ClippingPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 5;
+    readonly defaultConfig: ClippingPluginConfig;
+    private enabled;
+    private mode;
+    private planeOrigin;
+    private planeNormal;
+    private insideOut;
+    private panelOpen;
+    private modelShow;
+    private widgetShow;
+    private lastClipParams;
+    private getClipParamsKey;
+    private plane;
+    private clipper;
+    private cutter;
+    private cutActors;
+    private widgetManager;
+    private widget;
+    private actorBackups;
+    protected onInit(): void;
+    protected onDispose(): void;
+    registerResetActions(): ResetAction[];
+    private initVtkResources;
+    private initWidget;
+    private destroyVtkResources;
+    private toggleClipping;
+    private enableClipping;
+    private disableClipping;
+    /** 切换模型可见性（暂时隐藏/显示原始模型，便于查看剖切工具） */
+    private toggleModelVisibility;
+    /** 设置场景模型的可见性 */
+    private setModelVisibility;
+    /** 切换剖切工具可见性（暂时隐藏/显示 widget，便于观察剖切面） */
+    private toggleWidgetVisibility;
+    /** 设置剖切工具 widget 的可见性 */
+    private setWidgetVisibility;
+    private setMode;
+    private setNormalPreset;
+    private flipDirection;
+    private applyClipping;
+    private getSceneActors;
+    private backupActorInputs;
+    private restoreActorInputs;
+    private clearCutActors;
+    private centerPlaneOnModel;
+    private onSceneLoaded;
+    private syncPlaneToState;
+    private syncStateToWidget;
+    private syncWidgetToPlane;
+    private scheduleClipUpdate;
+    private resetToDefaults;
+    private registerInfoPanel;
+    /** 重置剖切参数到初始状态（保持剖切开启） */
+    private resetClippingParams;
+    private registerExtension;
+    /** 渲染扩展区内容 */
+    renderExtension(): Component;
+    /** 扩展区是否激活 */
+    isExtensionActive(): boolean;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    isVisible(): boolean;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}
+export {};