vtkviewer-vue 0.1.0

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

@@ -0,0 +1,113 @@
+import { Component, DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { IResettableActions, ResetAction } from '../../../core';
+import { ToolbarPluginConfig, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+/** 色条位置预设 */
+export type ScalarBarPosition = 'right' | 'left' | 'top' | 'bottom';
+/** 颜色映射插件配置 */
+export interface ColorByPluginConfig extends ToolbarPluginConfig {
+    /** 默认颜色预设名称（重置时恢复），默认 'erdc_rainbow_bright' */
+    defaultPreset?: string;
+    /** 色条是否显示刻度数值，默认 true */
+    showScalarBarTickLabels?: boolean;
+    /** 色条是否显示轴标题（数组名称），默认 true */
+    showScalarBarTitle?: boolean;
+    /** 色条轴标题自定义文本（为空时使用数组名称） */
+    scalarBarTitle?: string;
+    /** 色条位置，默认 'right' */
+    scalarBarPosition?: ScalarBarPosition;
+    /** 色条刻度数量，默认 'auto'（根据色条长度自动计算） */
+    scalarBarTickCount?: number | 'auto';
+    /** 色条刻度数值字号，默认 14 */
+    scalarBarTickFontSize?: number;
+    /** 色条轴标题字号，默认 18 */
+    scalarBarTitleFontSize?: number;
+    /** 色条轴标题与刻度的间距（像素），默认 48 */
+    scalarBarTitleOffset?: number;
+    /** 色条轴标题颜色，默认 '#000000'*/
+    scalarBarTitleColor?: string;
+    /** 点拾取最大保存数量，默认 5 */
+    maxPickPoints?: number;
+    /** 拾取点标记颜色，支持 '#rrggbb' 或 [r, g, b]（0~1），默认 '#00bcd4'（青色） */
+    pickPointColor?: [number, number, number][];
+    /** 拾取点标记半径占场景对角线比例，默认 0.003 */
+    pickPointRadiusRatio?: number;
+}
+export declare class ColorByPlugin extends PluginBase<ColorByPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 0;
+    readonly defaultConfig: ColorByPluginConfig;
+    private currentArray;
+    private currentPreset;
+    private colorOptions;
+    private arrayFeatures;
+    private scalarBarActor;
+    /** 模型加载时自动选择的第一个数据数组（用于 resetToDefault 恢复） */
+    private initialArrayValue;
+    /** 当前加载的格式是否支持颜色映射（由 scene:loaded 事件传入） */
+    private supportsColorBy;
+    /** 扩展区是否激活 */
+    private extensionActive;
+    /** 点拾取是否启用 */
+    private pickingEnabled;
+    /** 已拾取的点列表 */
+    private pickedPoints;
+    private pickedPointsCount;
+    /** 拾取点自动分配颜色调色板（与 erdc_rainbow_bright 彩虹色差异较大的深色调） */
+    private static readonly PICK_MARKER_PALETTE;
+    /** 拾取器 */
+    private cellPicker;
+    /** 左键点击事件订阅句柄 */
+    private clickSubscription;
+    protected onInit(): void;
+    protected onDispose(): void;
+    registerResetActions(): ResetAction[];
+    /** 重置颜色映射为默认状态 */
+    private resetToDefault;
+    private registerExtension;
+    /** 渲染扩展区内容（颜色映射数组选择 + 预设选择） */
+    renderExtension(): Component;
+    private onSceneCleared;
+    /** 隐藏色条并从渲染器移除 */
+    private hideScalarBar;
+    /** 应用色条配置（位置、标题、刻度等）
+     *  必须在 showScalarBar 中调用（此时 automated=false，手动控制生效） */
+    private applyScalarBarConfig;
+    /** 显示色条并添加到渲染器 */
+    private showScalarBar;
+    /** 切换点拾取开关 */
+    private togglePicking;
+    /** 启用点拾取 */
+    private enablePicking;
+    /** 禁用点拾取 */
+    private disablePicking;
+    /** 处理鼠标左键点击（拾取点并获取标量值） */
+    private handlePickClick;
+    /** 计算场景对角线长度 */
+    private getSceneDiagonal;
+    /** 创建拾取点标记（小球） */
+    private createPickMarker;
+    /** 移除单个拾取点标记 */
+    private removePickMarker;
+    /** 清理所有拾取点标记 */
+    private clearPickMarkers;
+    /** 注册点拾取信息面板 */
+    private registerPickInfoPanel;
+    private onSceneLoaded;
+    /** 获取所有可用的颜色映射数组名称（不含 Solid Color） */
+    get availableArrays(): string[];
+    private updateAvailableArrays;
+    /** 设置颜色映射数组（接受数组名称或 'location:arrayName' 格式） */
+    private setColorByArray;
+    /** 应用当前预设到所有 actor 的 lookupTable（与官网 applyPreset 一致） */
+    private applyPreset;
+    /** 对所有 actor 应用颜色映射（与官网 Geometry Viewer 一致） */
+    private applyColorBy;
+    render(): DefineComponent<{}, () => null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    isVisible(): boolean;
+}

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

@@ -0,0 +1,93 @@
+import { Component } from 'vue';
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+/** 加载模型插件配置 */
+export interface LoadModelPluginConfig extends ToolbarPluginConfig {
+}
+export declare class LoadModelPlugin extends PluginBase<LoadModelPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    /** 在核心组中靠前排列 */
+    readonly order = 0;
+    readonly defaultConfig: LoadModelPluginConfig;
+    /** 是否显示下拉弹窗 */
+    private isDropdownOpen;
+    /** 当前tab：'local'（本地文件）或 'remote'（远程URL） */
+    private tab;
+    /** URL输入框内容 */
+    private urlInput;
+    /** 是否正在加载 */
+    private isLoading;
+    /** 状态提示文本 */
+    private statusText;
+    /** 状态提示类型 */
+    private statusType;
+    /** 下拉弹窗对齐管理器（运行时自动根据按钮位置判断向左/向右展开） */
+    private dropdownAlignment;
+    /** 隐藏的文件选择input元素 */
+    private fileInput;
+    protected onInit(): void;
+    protected onDispose(): void;
+    /** 点击外部时关闭下拉 */
+    private handleOutsideClick;
+    /** 打开文件选择对话框 */
+    private openFileDialog;
+    /** 文件选择回调 */
+    private handleFileSelect;
+    /**
+     * 加载本地文件
+     * @param file 用户选择的File对象
+     */
+    private loadLocalFile;
+    /**
+     * 从远程URL加载模型
+     */
+    private loadFromUrl;
+    /**
+     * 核心加载流程：清场→解析→添加到场景→重置相机→发送事件
+     *
+     * @param buffer 文件二进制内容
+     * @param format 检测到的格式标识（如 'stl', 'obj'）
+     * @param filename 文件名（用于日志和事件）
+     * @param fileSize 文件大小（字节），用于LoadingPlugin显示
+     */
+    private loadBuffer;
+    /**
+     * 处理格式校验失败，设置错误并清除加载状态
+     */
+    private handleValidationError;
+    /**
+     * 处理加载异常
+     */
+    private handleLoadError;
+    /**
+     * 清空已有场景（复用UnloadModelPlugin的完备卸载逻辑）
+     */
+    private clearExistingScene;
+    /**
+     * 从已注册的格式插件中收集所有支持的格式
+     * @returns 去重排序后的格式列表
+     */
+    private getSupportedFormats;
+    /**
+     * 构建文件选择框的accept属性字符串。
+     * 直接从 FormatDetector.EXTENSION_MAP 动态查找，无硬编码扩展名映射。
+     *
+     * @param formats 支持的格式列表
+     * @returns HTML accept属性值（如 ".stl,.stla,.stlb,.obj,.ply"）
+     */
+    private buildAcceptString;
+    /**
+     * 根据格式名查找对应的格式插件（委托给 PluginRegistry 的索引）
+     * @param format 格式标识（如 'stl', 'obj'）
+     * @returns 匹配的格式插件，未找到则返回 undefined
+     */
+    private findFormatPlugin;
+    render(): Component;
+    isVisible(): boolean;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+}

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

@@ -0,0 +1,68 @@
+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 type PrecisionLevel = 'low' | 'medium' | 'high' | 'ultra';
+/** 渲染精度插件配置 */
+export interface RenderPrecisionPluginConfig extends ToolbarPluginConfig {
+    /** 默认精度级别 */
+    defaultLevel?: PrecisionLevel;
+    /** 是否默认在信息面板显示精度信息 */
+    defaultShowInfo?: boolean;
+}
+export declare class RenderPrecisionPlugin extends PluginBase<RenderPrecisionPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 6;
+    readonly defaultConfig: RenderPrecisionPluginConfig;
+    /** 当前精度级别 */
+    private currentLevel;
+    /** 是否展开面板 */
+    private panelOpen;
+    /** 下拉弹窗对齐管理器（运行时自动根据按钮位置判断向左/向右展开） */
+    private dropdownAlignment;
+    /** 自定义精度值（当使用自定义模式时） */
+    private customPolygonDivision;
+    private customEdgeAngle;
+    private customAntiAliasing;
+    /** 是否在信息面板显示精度信息 */
+    private showInPanel;
+    /** 是否使用自定义模式 */
+    private useCustom;
+    /** 当前实际应用的三角形数 */
+    private appliedTriangles;
+    /** 当前实际应用的顶点数 */
+    private appliedVertices;
+    private boundHandleClickOutside;
+    protected onInit(): void;
+    protected onDispose(): void;
+    registerResetActions(): ResetAction[];
+    private handleClickOutside;
+    /** 应用精度级别 */
+    private applyPrecision;
+    /** 应用自定义精度 */
+    private applyCustomPrecision;
+    /** 将精度配置应用到渲染器 */
+    private applyToRenderer;
+    /** 更新已应用的统计信息 */
+    private updateAppliedStats;
+    /** 重置精度 */
+    private resetPrecision;
+    /** 切换精度级别 */
+    private setLevel;
+    /** 切换信息面板显示状态 */
+    private toggleInfoPanel;
+    /** 注册信息面板 */
+    private registerInfoPanel;
+    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/model/RenderStylePlugin.d.ts

@@ -0,0 +1,88 @@
+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';
+/** 渲染模式 */
+type RepresentationMode = 'surface' | 'wireframe' | 'points' | 'surface-with-edges';
+/** 插值方式 */
+type InterpolationMode = 'flat' | 'gouraud' | 'phong';
+/** 渲染样式插件配置 */
+export interface RenderStylePluginConfig extends ToolbarPluginConfig {
+    /** 默认渲染模式 */
+    defaultRepresentation?: RepresentationMode;
+    /** 默认透明度 (0-1) */
+    defaultOpacity?: number;
+    /** 默认点大小 */
+    defaultPointSize?: number;
+    /** 默认线宽 */
+    defaultLineWidth?: number;
+    /** 是否显示边缘 */
+    showEdges?: boolean;
+    /** 边缘颜色 [r, g, b] (0-255) */
+    edgeColor?: [number, number, number];
+    /** 是否启用光照 */
+    enableLighting?: boolean;
+    /** 插值方式 */
+    interpolation?: InterpolationMode;
+}
+export declare class RenderStylePlugin extends PluginBase<RenderStylePluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 3;
+    readonly defaultConfig: RenderStylePluginConfig;
+    /** 当前渲染模式 */
+    private representation;
+    /** 当前透明度 */
+    private opacity;
+    /** 当前点大小 */
+    private pointSize;
+    /** 当前线宽 */
+    private lineWidth;
+    /** 是否显示边缘 */
+    private showEdges;
+    /** 边缘颜色 */
+    private edgeColor;
+    /** 是否启用光照 */
+    private enableLighting;
+    /** 当前插值方式 */
+    private interpolation;
+    /** 是否展开面板 */
+    private panelOpen;
+    protected onInit(): void;
+    /** 应用所有属性到场景中的 Actor */
+    private applyAllProperties;
+    /** 应用属性到单个 Actor */
+    private applyPropertiesToActor;
+    /** 设置渲染模式 */
+    private setRepresentation;
+    /** 设置透明度 */
+    private setOpacity;
+    /** 设置点大小 */
+    private setPointSize;
+    /** 设置线宽 */
+    private setLineWidth;
+    /** 切换边缘显示 */
+    private toggleEdges;
+    /** 设置光照 */
+    private setLighting;
+    /** 设置插值方式 */
+    private setInterpolation;
+    /** 获取当前图标配置（含多状态图标） */
+    private getIconConfig;
+    /** 重置所有设置到默认值 */
+    private resetToDefaults;
+    /** 切换面板展开状态 */
+    private togglePanel;
+    registerResetActions(): ResetAction[];
+    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 {};

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

@@ -0,0 +1,25 @@
+import { ToolbarPluginConfig, KeyboardShortcutConfigItem, KeyboardShortcutAction, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+import { DefineComponent, VNode, RendererNode, RendererElement, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** 卸载模型插件配置 */
+export interface UnloadModelPluginConfig extends ToolbarPluginConfig {
+}
+export declare class UnloadModelPlugin extends PluginBase<UnloadModelPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 100;
+    readonly defaultConfig: UnloadModelPluginConfig;
+    /**
+     * 卸载模型：清除场景、重置插件状态、恢复默认相机
+     */
+    private unload;
+    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/model/index.d.ts

@@ -0,0 +1,6 @@
+export * from './ClippingPlugin';
+export * from './ColorByPlugin';
+export * from './LoadModelPlugin';
+export * from './RenderPrecisionPlugin';
+export * from './RenderStylePlugin';
+export * from './UnloadModelPlugin';

package/lib/types/plugins/toolbar/scene/AxesPlugin.d.ts

@@ -0,0 +1,96 @@
+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';
+/** 坐标系模式 */
+type CoordinateMode = 'none' | 'world' | 'display' | 'both';
+/** 视口角落位置 */
+type ViewportCorner = 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT';
+/** RGB 颜色元组 [r, g, b]，值范围 0-255 */
+type RGBColor = [number, number, number];
+/** 坐标轴插件配置 */
+export interface AxesPluginConfig extends ToolbarPluginConfig {
+    /** 默认坐标系模式 */
+    defaultMode?: CoordinateMode;
+    /** 方向指示器位置，默认 BOTTOM_RIGHT */
+    viewportCorner?: ViewportCorner;
+    /** 视口大小比例 (0~1)，默认 0.15 */
+    viewportSize?: number;
+    /** 最小像素大小，默认 80 */
+    minPixelSize?: number;
+    /** 最大像素大小，默认 200 */
+    maxPixelSize?: number;
+    /** 箭头尖端分辨率（圆锥段数），默认 60 */
+    tipResolution?: number;
+    /** 箭头尖端半径，默认 0.05 */
+    tipRadius?: number;
+    /** 箭头尖端长度，默认 0.2 */
+    tipLength?: number;
+    /** 箭杆分辨率（圆柱段数），默认 60 */
+    shaftResolution?: number;
+    /** 箭杆半径，默认 0.01 */
+    shaftRadius?: number;
+    /** 方向指示器 X轴颜色 [r, g, b]，默认 [255, 150, 150] */
+    orientationXAxisColor?: RGBColor;
+    /** 方向指示器 Y轴颜色 [r, g, b]，默认 [150, 255, 150] */
+    orientationYAxisColor?: RGBColor;
+    /** 方向指示器 Z轴颜色 [r, g, b]，默认 [150, 150, 255] */
+    orientationZAxisColor?: RGBColor;
+    /** 原点坐标轴 X轴颜色 [r, g, b]，默认 [255, 0, 0] */
+    originXAxisColor?: RGBColor;
+    /** 原点坐标轴 Y轴颜色 [r, g, b]，默认 [0, 255, 0] */
+    originYAxisColor?: RGBColor;
+    /** 原点坐标轴 Z轴颜色 [r, g, b]，默认 [0, 0, 255] */
+    originZAxisColor?: RGBColor;
+    /** 原点坐标轴长度占场景对角线的比例 (0~1)，默认 0.2 */
+    originAxisScaleRatio?: number;
+}
+export declare class AxesPlugin extends PluginBase<AxesPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 2;
+    readonly defaultConfig: AxesPluginConfig;
+    /** 当前坐标系模式（响应式） */
+    private coordinateMode;
+    /** 是否显示坐标系（computed） */
+    private showAxes;
+    /** VTK.js OrientationMarkerWidget 实例（右下角方向指示器） */
+    private orientationWidget;
+    /** 原点坐标轴 Actor（世界坐标系） */
+    private originAxesActor;
+    protected onInit(): void;
+    /** 视口角落名称到 VTK.js Corners 枚举的映射 */
+    private static readonly CORNER_MAP;
+    /**
+     * 初始化坐标系系统
+     * 在渲染管线就绪后调用，确保 renderWindow/renderer 可用
+     */
+    private initCoordinateSystem;
+    /**
+     * 应用坐标系模式
+     */
+    private applyCoordinateMode;
+    /**
+     * 更新原点坐标轴缩放比例
+     * 根据场景边界自动计算合适的坐标轴大小
+     */
+    private updateOriginAxesScale;
+    /**
+     * 循环切换坐标系模式
+     */
+    private toggleAxes;
+    /** 释放 VTK.js 资源和事件监听器 */
+    protected onDispose(): void;
+    registerResetActions(): ResetAction[];
+    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 {};

package/lib/types/plugins/toolbar/scene/BackgroundColorPlugin.d.ts

@@ -0,0 +1,25 @@
+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 BackgroundColorPluginConfig extends ToolbarPluginConfig {
+}
+export declare class BackgroundColorPlugin extends PluginBase<BackgroundColorPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 3;
+    readonly defaultConfig: BackgroundColorPluginConfig;
+    /** 当前背景色（响应式） */
+    private currentColor;
+    protected onInit(): void;
+    registerResetActions(): ResetAction[];
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    isVisible(): boolean;
+}

package/lib/types/plugins/toolbar/scene/LanguageSwitchPlugin.d.ts

@@ -0,0 +1,45 @@
+import { Component } from 'vue';
+import { LanguageOption } from '../../../core';
+import { ToolbarPluginConfig, IToolbarPlugin } from '../../types';
+import { PluginBase } from '../../PluginBase';
+/** 语言切换插件配置 */
+export interface LanguageSwitchPluginConfig extends ToolbarPluginConfig {
+}
+/**
+ * 语言切换插件
+ * 在工具栏中提供语言切换下拉菜单
+ * 选择后通过 I18nManager + EventBus 同步状态
+ */
+export declare class LanguageSwitchPlugin extends PluginBase<LanguageSwitchPluginConfig> implements IToolbarPlugin {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 11;
+    readonly defaultConfig: LanguageSwitchPluginConfig;
+    /** 下拉菜单是否展开 */
+    private isDropdownOpen;
+    /** 下拉对齐管理器 */
+    private dropdownAlignment;
+    protected onInit(): void;
+    protected onDispose(): void;
+    /** 处理点击外部关闭下拉菜单 */
+    private handleOutsideClick;
+    /** 切换语言 */
+    switchLanguage(locale: string): void;
+    /** 设置当前语言（供 VtkViewer 外部同步使用，保持向后兼容） */
+    setCurrentLocale(locale: string): void;
+    /** 获取当前语言 */
+    getCurrentLocale(): string;
+    /**
+     * 设置可用语言列表（供 VtkViewer props.languages 传入，保持向后兼容）。
+     * 委托给 I18nManager。
+     */
+    setAvailableLanguages(opts?: LanguageOption[]): void;
+    /** 切换下拉菜单 */
+    private toggleDropdown;
+    render(): Component;
+    isVisible(): boolean;
+}

package/lib/types/plugins/toolbar/scene/LightIntensityPlugin.d.ts

@@ -0,0 +1,42 @@
+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 LightIntensityPluginConfig extends ToolbarPluginConfig {
+    /** 默认光照强度 (0-1, 默认 1.0) */
+    defaultIntensity?: number;
+    /** 强度步进值 (默认 0.1) */
+    step?: number;
+}
+export declare class LightIntensityPlugin extends PluginBase<LightIntensityPluginConfig> implements IToolbarPlugin, IResettableActions {
+    readonly metadata: {
+        id: string;
+        name: string;
+        type: "toolbar";
+        description: string;
+    };
+    readonly order = 7;
+    readonly defaultConfig: LightIntensityPluginConfig;
+    private intensity;
+    private panelOpen;
+    protected onInit(): void;
+    protected onDispose(): void;
+    registerResetActions(): ResetAction[];
+    /** 获取渲染器中的所有灯光 */
+    private getLights;
+    /** 应用光照强度到所有灯光 */
+    private applyIntensity;
+    /** 增加光照强度 */
+    increaseIntensity(): void;
+    /** 减少光照强度 */
+    decreaseIntensity(): void;
+    /** 重置光照强度 */
+    resetIntensity(): void;
+    render(): DefineComponent<{}, () => VNode<RendererNode, RendererElement, {
+        [key: string]: any;
+    }>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+    isVisible(): boolean;
+    getShortcutConfig(): KeyboardShortcutConfigItem[];
+    getKeyboardShortcutActions(): KeyboardShortcutAction[];
+}