vtkviewer-vue 0.1.0

package/lib/types/components/PluginToolbar.vue.d.ts

@@ -0,0 +1,7 @@
+import { PluginToolbarProps } from '../types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, Ref, ComponentProvideOptions } from 'vue';
+declare const __VLS_export: DefineComponent<PluginToolbarProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<PluginToolbarProps> & Readonly<{}>, {
+    localeVersion: number | Ref<number>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/lib/types/components/ToolbarExtension.vue.d.ts

@@ -0,0 +1,9 @@
+import { ToolbarExtensionProps } from '../types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const __VLS_export: DefineComponent<ToolbarExtensionProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ToolbarExtensionProps> & Readonly<{}>, {
+    borderRadius: number;
+    padding: string;
+    gap: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/lib/types/components/ToolbarInfoPanel.vue.d.ts

@@ -0,0 +1,10 @@
+import { ToolbarInfoPanelProps } from '../types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const __VLS_export: DefineComponent<ToolbarInfoPanelProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ToolbarInfoPanelProps> & Readonly<{}>, {
+    borderRadius: number;
+    padding: string;
+    fontSize: number;
+    maxHeight: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/lib/types/components/VtkViewer.vue.d.ts

@@ -0,0 +1,32 @@
+import { ViewerContext, ThemeConfig } from '../core';
+import { InfoPanelConfig, ToolbarConfig, VtkViewerProps } from '../types';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare var __VLS_22: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_22) => any;
+};
+declare const __VLS_base: DefineComponent<VtkViewerProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:theme": (themeId: string) => any;
+    "update:locale": (locale: string) => any;
+    "update:ctx": (ctx: ViewerContext | null) => any;
+}, string, PublicProps, Readonly<VtkViewerProps> & Readonly<{
+    "onUpdate:theme"?: ((themeId: string) => any) | undefined;
+    "onUpdate:locale"?: ((locale: string) => any) | undefined;
+    "onUpdate:ctx"?: ((ctx: ViewerContext | null) => any) | undefined;
+}>, {
+    toolbar: ToolbarConfig | boolean;
+    infoPanel: InfoPanelConfig | boolean;
+    theme: string;
+    enableGesture: boolean;
+    enableKeyboard: boolean;
+    background: string;
+    customThemes: Record<string, ThemeConfig>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/lib/types/components/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 组件导出
+ */
+export { default as VtkViewer } from './VtkViewer.vue';

package/lib/types/composables/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 组合式函数导出
+ */
+export * from './useViewer';
+export * from './useFormatLoader';
+export * from './useUIPlugins';
+export * from './useResponsiveLayout';

package/lib/types/composables/useFormatLoader.d.ts

@@ -0,0 +1,33 @@
+import { Ref } from 'vue';
+import { FormatDetectionResult, ViewerContext } from '../core';
+/** 加载状态 */
+export interface LoadState {
+    isLoading: boolean;
+    progress: number;
+    stage: string;
+    error: string | null;
+    /** 正在解析的文件大小（字节），0 表示未知 */
+    fileSize?: number;
+}
+/** useFormatLoader 返回值 */
+export interface UseFormatLoaderReturn {
+    /** 加载状态 */
+    loadState: Ref<LoadState>;
+    /** 加载文件（自动清除旧场景） */
+    loadFile: (file: File) => Promise<void>;
+    /** 加载 ArrayBuffer（自动清除旧场景） */
+    loadBuffer: (buffer: ArrayBuffer, format: string, filename?: string) => Promise<void>;
+    /** 检测格式 */
+    detectFormat: (filename?: string, buffer?: ArrayBuffer) => FormatDetectionResult | null;
+    /** 支持的格式列表 */
+    supportedFormats: string[];
+    /** 清空场景（移除所有 Actor 和 Volume） */
+    clearScene: () => void;
+    /** 卸载模型（完整释放资源，复用卸载模型操作） */
+    unloadModels: () => void;
+}
+/**
+ * useFormatLoader 组合式函数
+ * 提供文件格式检测和加载能力
+ */
+export declare function useFormatLoader(ctx: ViewerContext): UseFormatLoaderReturn;

package/lib/types/composables/useResponsiveLayout.d.ts

@@ -0,0 +1,46 @@
+import { Ref, ComputedRef } from 'vue';
+export interface Breakpoint {
+    name: string;
+    minWidth: number;
+    maxWidth?: number;
+}
+export interface ResponsiveConfig {
+    /** 断点定义 */
+    breakpoints?: Breakpoint[];
+    /** 是否启用响应式 */
+    enabled?: boolean;
+    /** 工具栏折叠阈值 */
+    toolbarCollapseThreshold?: number;
+    /** 紧凑模式阈值 */
+    compactModeThreshold?: number;
+}
+/**
+ * useResponsiveLayout 组合式函数
+ * 提供响应式断点检测和布局适配
+ */
+export declare function useResponsiveLayout(containerRef: Ref<HTMLElement | null>, config?: ResponsiveConfig): {
+    windowWidth: Readonly<Ref<number, number>>;
+    windowHeight: Readonly<Ref<number, number>>;
+    containerWidth: Readonly<Ref<number, number>>;
+    containerHeight: Readonly<Ref<number, number>>;
+    currentBreakpoint: Readonly<Ref<string, string>>;
+    isCompactMode: Readonly<Ref<boolean, boolean>>;
+    isToolbarCollapsed: Readonly<Ref<boolean, boolean>>;
+    isMobile: ComputedRef<boolean>;
+    isTablet: ComputedRef<boolean>;
+    isDesktop: ComputedRef<boolean>;
+    orientation: ComputedRef<"landscape" | "portrait">;
+    aspectRatio: ComputedRef<number>;
+    updateBreakpoint: () => void;
+    updateContainerSize: () => void;
+    getResponsiveClasses: () => string[];
+    getResponsiveStyles: () => Record<string, string>;
+    getToolbarPosition: () => {
+        position: string;
+        alignment: string;
+    };
+    getPanelPosition: (panelType: string) => {
+        position: string;
+        size: string;
+    };
+};

package/lib/types/composables/useUIPlugins.d.ts

@@ -0,0 +1,57 @@
+import { ComputedRef, Ref, Component } from 'vue';
+import { ViewerContext } from '../core';
+import { IUIPlugin, UIPluginType } from '../plugins';
+/** UI插件渲染项 */
+export interface UIPluginRenderItem {
+    /** 插件ID */
+    id: string;
+    /** 渲染组件 */
+    component: Component;
+    /** UI类型 */
+    uiType: UIPluginType;
+    /** 渲染顺序 */
+    order: number;
+    /** 是否可见 */
+    visible: boolean;
+    /** 位置 */
+    position: string;
+}
+/** Portal 插件渲染项 */
+export interface UIPortalRenderItem {
+    /** 插件ID */
+    id: string;
+    /** 渲染组件 */
+    component: Component;
+    /** 渲染顺序 */
+    order: number;
+    /** 是否可见 */
+    visible: boolean;
+    /** Teleport 目标 */
+    portalTarget: string | Element;
+    /** Teleport 额外属性 */
+    portalProps: Record<string, any>;
+}
+/** useUIPlugins 返回值 */
+export interface UseUIPluginsReturn {
+    /** 所有UI插件 */
+    uiPlugins: ComputedRef<IUIPlugin[]>;
+    /** 覆盖层插件 */
+    overlayPlugins: ComputedRef<UIPluginRenderItem[]>;
+    /** 面板插件 */
+    panelPlugins: ComputedRef<UIPluginRenderItem[]>;
+    /** 通知插件 */
+    notificationPlugins: ComputedRef<UIPluginRenderItem[]>;
+    /** Portal 插件（挂载到外部 DOM） */
+    portalPlugins: ComputedRef<UIPortalRenderItem[]>;
+    /** 获取可见的UI插件 */
+    getVisiblePlugins: (type?: UIPluginType) => UIPluginRenderItem[];
+}
+/**
+ * useUIPlugins 组合式函数
+ * 管理UI插件的渲染和状态
+ * @param ctx ViewerContext 或 ComputedRef<ViewerContext | null>，支持响应式
+ */
+export declare function useUIPlugins(ctx: ViewerContext | Ref<ViewerContext | null> | null, options?: {
+    hideWhenNoModel?: boolean;
+    localeVersion?: Ref<number>;
+}): UseUIPluginsReturn;

package/lib/types/composables/useViewer.d.ts

@@ -0,0 +1,47 @@
+import { Ref } from 'vue';
+import { ThemeContextImpl, ViewerContext } from '../core';
+import { IViewerPlugin, PluginConfig, PluginsConfig } from '../plugins';
+/** useViewer 配置 */
+export interface UseViewerConfig {
+    /** 初始配置 */
+    config?: Record<string, any>;
+    /**
+     * 插件配置（默认列表，最低优先级）
+     * 采用分类配置格式。
+     *
+     * 当 VtkViewer 组件传入 plugins prop 时，
+     * 同分类配置将覆盖此处的配置。
+     */
+    plugins?: PluginsConfig;
+    /** 外部解码器路径配置 */
+    decoders?: Record<string, string>;
+    /** 容器元素引用 */
+    containerRef?: Ref<HTMLElement | null>;
+}
+/** useViewer 返回值 */
+export interface UseViewerReturn {
+    /** 查看器上下文 */
+    ctx: Ref<ViewerContext | null>;
+    /** 是否已初始化 */
+    isReady: Ref<boolean>;
+    /** 错误信息 */
+    error: Ref<string | null>;
+    /** 主题上下文（setup 阶段立即可用，不依赖 initialize） */
+    themeContext: ThemeContextImpl;
+    /**
+     * 初始化查看器
+     * @param pluginsOverride 插件覆盖配置（高优先级，同分类覆盖 useViewer 默认配置）
+     */
+    initialize: (pluginsOverride?: PluginsConfig) => Promise<void>;
+    /** 销毁查看器 */
+    destroy: () => void;
+    /** 注册插件 */
+    registerPlugin: (plugin: IViewerPlugin, config?: PluginConfig) => void;
+    /** 加载文件 */
+    loadFile: (file: File) => Promise<void>;
+}
+/**
+ * useViewer 组合式函数
+ * 创建和管理完整的 ViewerContext
+ */
+export declare function useViewer(config?: UseViewerConfig): UseViewerReturn;

package/lib/types/configs/index.d.ts

@@ -0,0 +1,76 @@
+import { ThemeConfig } from '../core';
+/**
+ * VtkViewer 内置语言包。
+ * 当外部未注入 t 函数时，PluginBase.t() 从此处按当前 locale 取值作为 fallback。
+ *
+ * 所有 value 均为纯静态字符串，不包含 {param} 插值占位符。
+ * 带参数的文本（如快捷键组合）由调用方手动拼接。
+ */
+export declare const BUILTIN_LANGS: Record<string, Record<string, string>>;
+/**
+ * 内置事件常量
+ */
+export declare const BuiltinEvents: {
+    readonly SCENE_LOADED: "scene:loaded";
+    readonly SCENE_CLEARED: "scene:cleared";
+    readonly RENDER_START: "render:start";
+    readonly RENDER_END: "render:end";
+    readonly RENDER_PIPELINE_READY: "render:pipelineReady";
+    readonly TOOL_CHANGED: "interaction:toolChanged";
+    readonly MEASUREMENT_START: "measurement:start";
+    readonly MEASUREMENT_COMPLETE: "measurement:complete";
+    readonly MEASUREMENT_CLEAR: "measurement:clear";
+    readonly COLORBY_PICKING_START: "colorBy:pickingStart";
+    readonly ANIMATION_PLAY: "animation:play";
+    readonly ANIMATION_PAUSE: "animation:pause";
+    readonly VOLUME_PRESET_CHANGED: "volume:presetChanged";
+    readonly COLOR_ARRAY_CHANGED: "colorBy:arrayChanged";
+    readonly PERFORMANCE_UPDATE: "performance:update";
+    readonly PLUGINS_INITIALIZED: "plugins:initialized";
+    readonly KEY_BINDING_REGISTRY_READY: "keyBinding:registry-ready";
+    readonly ERROR_OCCURRED: "error:occurred";
+    readonly ERROR_CLEARED: "error:cleared";
+    readonly WEBGL_CONTEXT_LOST: "webgl:contextLost";
+    readonly WEBGL_CONTEXT_RESTORED: "webgl:contextRestored";
+    readonly MEMORY_PRESSURE_CHANGED: "memory:pressureChanged";
+    readonly MEMORY_CLEANUP: "memory:cleanup";
+    readonly THEME_CHANGED: "theme:changed";
+    readonly LOCALE_CHANGED: "locale:changed";
+    readonly FILE_LOAD: "file:load";
+    readonly FILES_LOAD: "files:load";
+    readonly RESET_START: "reset:start";
+    readonly RESET_COMPLETE: "reset:complete";
+};
+export type BuiltinEventType = (typeof BuiltinEvents)[keyof typeof BuiltinEvents];
+/**
+ * 内置命令常量
+ * 命令ID命名规范：{pluginId}:{commandName}
+ */
+export declare const BuiltinCommands: {
+    readonly RENDER: "render";
+    readonly RESET_CAMERA: "resetCamera";
+    readonly RESET_TO_DEFAULT_VIEW: "resetToDefaultView";
+    readonly RESET_ALL: "resetAll";
+    readonly SET_CAMERA_VIEW: "setCameraView";
+    readonly RESTORE_CAMERA: "restoreCamera";
+    readonly TOGGLE_TOOL: "toggleTool";
+    readonly CAPTURE_SCREENSHOT: "captureScreenshot";
+    readonly TOGGLE_FULLSCREEN: "toggleFullscreen";
+    readonly TOGGLE_AXES: "toggleAxes";
+    readonly SET_BACKGROUND_COLOR: "setBackgroundColor";
+    readonly APPLY_VIEW_PRESET: "applyViewPreset";
+    readonly START_MEASUREMENT: "startMeasurement";
+    readonly CLEAR_MEASUREMENT: "clearMeasurement";
+    readonly PLAY_ANIMATION: "playAnimation";
+    readonly PAUSE_ANIMATION: "pauseAnimation";
+    readonly GO_TO_FRAME: "goToFrame";
+    readonly SET_VOLUME_PRESET: "setVolumePreset";
+    readonly SET_VOLUME_QUALITY: "setVolumeQuality";
+    readonly SET_COLOR_BY_ARRAY: "setColorByArray";
+    readonly GET_PERFORMANCE_DATA: "getPerformanceData";
+    readonly RETRY_LOAD: "retryLoad";
+    readonly DISMISS_ERROR: "dismissError";
+};
+export type BuiltinCommandType = (typeof BuiltinCommands)[keyof typeof BuiltinCommands];
+/** 内置主题预设（只用于 UI 显示，状态管理在 ctx.theme 中） */
+export declare const BUILTIN_THEMES: Record<string, ThemeConfig>;

package/lib/types/core/CommandRegistrar.d.ts

@@ -0,0 +1,12 @@
+import { CommandRegistry } from './CommandRegistry';
+import { RenderSubContext } from './RenderSubContext';
+import { SceneSubContext } from './SceneSubContext';
+import { InteractionSubContext } from './InteractionSubContext';
+import { UISubContext } from './UISubContext';
+import { IStateManager } from './StateManager';
+import { ResetManager } from './ResetManager';
+/**
+ * 注册内置核心命令
+ * 将 BuiltinCommands 中的命令委托给各子上下文
+ */
+export declare function registerCoreBuiltinCommands(commands: CommandRegistry, renderCtx: RenderSubContext, _sceneCtx: SceneSubContext, interactionCtx: InteractionSubContext, uiCtx: UISubContext, resetManager: ResetManager, stateManager?: IStateManager): void;

package/lib/types/core/CommandRegistry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 命令注册表
+ * 支持跨插件命令执行
+ * 命令ID命名规范：{pluginId}:{commandName}
+ */
+export interface CommandHandler<T = void> {
+    execute(...args: any[]): T;
+    canExecute?(): boolean;
+}
+/**
+ * 命令注册表接口
+ */
+export interface CommandRegistry {
+    /** 注册命令 */
+    register<T = void>(id: string, handler: CommandHandler<T>): void;
+    /** 注销命令 */
+    unregister(id: string): void;
+    /** 执行命令 */
+    execute<T = void>(id: string, ...args: any[]): T | undefined;
+    /** 命令是否已注册 */
+    has(id: string): boolean;
+}
+/**
+ * 命令注册表实现
+ */
+export declare class CommandRegistryImpl implements CommandRegistry {
+    private handlers;
+    register<T = void>(id: string, handler: CommandHandler<T>): void;
+    unregister(id: string): void;
+    execute<T = void>(id: string, ...args: any[]): T | undefined;
+    has(id: string): boolean;
+    /** 清除所有命令 */
+    clear(): void;
+}

package/lib/types/core/ConfigAccessor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 配置访问器
+ * 提供类型安全的配置访问能力
+ */
+/**
+ * 配置访问器接口
+ */
+export interface ConfigAccessor {
+    /** 获取配置值 */
+    get<T>(key: string): T | undefined;
+    /** 获取配置值（带默认值） */
+    get<T>(key: string, defaultValue: T): T;
+    /** 设置配置值 */
+    set<T>(key: string, value: T): void;
+    /** 检查配置是否存在 */
+    has(key: string): boolean;
+    /** 获取所有配置 */
+    getAll(): Record<string, any>;
+}
+/**
+ * 配置访问器实现
+ */
+export declare class ConfigAccessorImpl implements ConfigAccessor {
+    private config;
+    constructor(initialConfig?: Record<string, any>);
+    get<T>(key: string): T | undefined;
+    get<T>(key: string, defaultValue: T): T;
+    set<T>(key: string, value: T): void;
+    has(key: string): boolean;
+    getAll(): Record<string, any>;
+    /** 更新配置（合并） */
+    update(patch: Record<string, any>): void;
+}

package/lib/types/core/DisposalRegistry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 资源释放注册表
+ * 支持自动识别 VTK.js 对象并释放
+ */
+/** 可释放对象接口 */
+export interface Disposable {
+    delete?: () => void;
+    setRenderWindow?: (rw: any) => void;
+}
+/**
+ * 资源释放注册表接口
+ */
+export interface DisposalRegistry {
+    /** 注册释放函数（回调形式） */
+    register(releaseFn: () => void): void;
+    /** 注册 VTK.js 可释放对象（自动识别并调用 delete() 或 setRenderWindow(null) 等） */
+    registerDisposable(disposable: Disposable): void;
+    /** 释放所有已注册的资源 */
+    dispose(): void;
+}
+/**
+ * 资源释放注册表实现
+ */
+export declare class DisposalRegistryImpl implements DisposalRegistry {
+    private releaseFns;
+    private disposed;
+    register(releaseFn: () => void): void;
+    registerDisposable(disposable: Disposable): void;
+    dispose(): void;
+    /** 是否已释放 */
+    isDisposed(): boolean;
+}

package/lib/types/core/EventBus.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 事件总线
+ * 支持插件间事件通信
+ */
+export type EventCallback = (...args: any[]) => void;
+/**
+ * 查看器事件数据映射
+ * 为已知事件提供类型安全的数据约束
+ */
+export interface ViewerEventMap {
+    'scene:loaded': {
+        format: string;
+        filename?: string;
+        supportsColorBy?: boolean;
+    };
+    'scene:cleared': void;
+    'render:start': void;
+    'render:end': void;
+    'interaction:toolChanged': {
+        tool: string;
+        enabled: boolean;
+    };
+    'measurement:start': void;
+    'measurement:complete': void;
+    'measurement:clear': void;
+    'animation:play': void;
+    'animation:pause': void;
+    'volume:presetChanged': void;
+    'colorBy:arrayChanged': {
+        arrayName: string;
+    };
+    'performance:update': void;
+    'plugins:initialized': void;
+    'keyBinding:registry-ready': void;
+    'error:occurred': void;
+    'error:cleared': void;
+    'webgl:contextLost': void;
+    'webgl:contextRestored': void;
+    'memory:pressureChanged': void;
+    'memory:cleanup': void;
+    'file:load': File;
+    'files:load': File[];
+    'reset:start': any;
+    'reset:complete': any;
+    'camera:saved': void;
+    'camera:restored': void;
+    [key: string]: any;
+}
+/**
+ * 事件总线接口
+ * 提供事件的注册、注销、触发能力
+ * 已知事件自动获得类型约束，未知事件保持 any 兼容性
+ */
+export interface EventBus {
+    /** 监听事件 */
+    on<K extends keyof ViewerEventMap>(event: K, callback: (data: ViewerEventMap[K]) => void): void;
+    on(event: string, callback: EventCallback): void;
+    /** 取消监听 */
+    off<K extends keyof ViewerEventMap>(event: K, callback: (data: ViewerEventMap[K]) => void): void;
+    off(event: string, callback: EventCallback): void;
+    /** 触发事件 */
+    emit<K extends keyof ViewerEventMap>(event: K, data?: ViewerEventMap[K]): void;
+    emit(event: string, data?: any): void;
+    /** 监听一次 */
+    once<K extends keyof ViewerEventMap>(event: K, callback: (data: ViewerEventMap[K]) => void): void;
+    once(event: string, callback: EventCallback): void;
+}
+/**
+ * 事件总线实现
+ */
+export declare class EventBusImpl implements EventBus {
+    private listeners;
+    on(event: string, callback: EventCallback): void;
+    off(event: string, callback: EventCallback): void;
+    emit(event: string, data?: any): void;
+    once(event: string, callback: EventCallback): void;
+    /** 清除所有监听器 */
+    clear(): void;
+}

package/lib/types/core/FormatDetector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 格式检测器（迁移自FormatRegistry）
+ * 提供统一的格式检测接口，支持扩展名+魔数+内容分析
+ */
+export interface FormatDetectionResult {
+    format: string;
+    confidence: number;
+    method: 'extension' | 'magic' | 'content';
+}
+export declare class FormatDetector {
+    private static readonly MAGIC_NUMBERS;
+    /** VTK XML type 属性到格式的映射 */
+    private static readonly VTK_XML_TYPE_MAP;
+    private static readonly EXTENSION_MAP;
+    /**
+     * 根据文件扩展名检测格式
+     * @param filename 可选，文件名
+     */
+    static detectFormat(filename?: string): FormatDetectionResult | null;
+    /**
+     * 根据文件内容检测格式
+     */
+    static detectFormatFromBuffer(buffer: ArrayBuffer): FormatDetectionResult | null;
+    /**
+     * 检测 VTK XML 格式（通过解析 type 属性区分 VTP/VTU/VTI 等）
+     *
+     * VTK XML 文件都以 <VTKFile 开头，但 type 属性不同：
+     * - VTP: <VTKFile type="PolyData" ...
+     * - VTU: <?xml ...><VTKFile type="UnstructuredGrid" ...
+     * - VTI: <VTKFile type="ImageData" ...
+     */
+    private static detectVtkXmlFormat;
+    /**
+     * 综合检测格式（优先使用内容检测）
+     * @param filename 可选，文件名（用于扩展名检测）
+     * @param buffer 可选，文件内容（用于魔术数字和内容分析）
+     */
+    static detect(filename?: string, buffer?: ArrayBuffer): FormatDetectionResult | null;
+    /**
+     * 获取文件扩展名
+     */
+    private static getExtension;
+    /**
+     * 匹配魔术数字
+     */
+    private static matchMagic;
+    /**
+     * 分析内容特征
+     */
+    private static analyzeContent;
+    /**
+     * 根据格式ID列表构建 HTML input[accept] 属性字符串。
+     * 从 EXTENSION_MAP 动态查找对应扩展名，无硬编码。
+     *
+     * @param formats 格式ID数组（如 ['stl', 'obj', 'ply']）
+     * @returns HTML accept 属性值（如 ".stl,.stla,.stlb,.obj,.ply"）
+     */
+    static getAcceptedExtensions(formats: string[]): string;
+}