@fengyizhi/scene-lib 0.0.0-stage → 1.0.0

package/index.d.ts

@@ -0,0 +1,1535 @@
+import * as THREE from 'three';
+import * as i0 from '@angular/core';
+import { AfterViewInit, OnChanges, OnDestroy, ElementRef, EventEmitter, NgZone } from '@angular/core';
+import { TransformControls } from 'three/examples/jsm/controls/TransformControls.js';
+import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+
+/** 看板数据点（value widget 用） */
+interface DashboardDataPoint {
+    /** 标签 */
+    label: string;
+    /** 显示绑定点 ID */
+    bindingId: string;
+    /** 动画绑定点 ID */
+    animationBindingId?: string;
+    /** 单位 */
+    unit?: string;
+    /** 数据源（可选，如果不用绑定点） */
+    dataSource?: {
+        mode: 'static' | 'simulated' | 'api';
+        staticValue?: number | string;
+        simulated?: {
+            type: 'sine' | 'random';
+            min: number;
+            max: number;
+            interval: number;
+        };
+        api?: {
+            url: string;
+            field: string;
+            pollInterval: number;
+        };
+    };
+}
+/** 看板 Widget */
+interface DashboardWidget {
+    id: string;
+    type: 'value' | 'gauge' | 'progress' | 'status' | 'chart' | 'text';
+    /** 布局模式：screen=屏幕固定，world=绑定3D位置 */
+    mode: 'screen' | 'world';
+    /** screen 模式：百分比坐标 0-1 */
+    screen?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** world 模式：3D 坐标 */
+    world?: {
+        position: Vec3;
+    };
+    /** 数据源（非 value 类型用） */
+    dataSource?: {
+        mode: 'static' | 'simulated' | 'api';
+        staticValue?: number | string;
+        simulated?: {
+            type: 'sine' | 'random';
+            min: number;
+            max: number;
+            interval: number;
+        };
+        api?: {
+            url: string;
+            field: string;
+            pollInterval: number;
+        };
+    };
+    /** 数据点列表（value 类型用，多值显示） */
+    dataPoints?: DashboardDataPoint[];
+    /** 显示标签 */
+    label?: string;
+    /** 单位 */
+    unit?: string;
+    /** 最小值（仪表/进度条用） */
+    min?: number;
+    /** 最大值（仪表/进度条用） */
+    max?: number;
+    /** 阈值变色 */
+    thresholds?: {
+        value: number;
+        color: string;
+    }[];
+    /** 小数位数 */
+    decimals?: number;
+}
+/** 看板配置 */
+interface DashboardConfig {
+    /** 是否显示 */
+    visible: boolean;
+    /** Widget 列表 */
+    widgets: DashboardWidget[];
+}
+/** 告警配置 */
+interface AlarmConfig {
+    /** 查询告警详情的 API URL */
+    apiUrl: string;
+    /** 弹框显示时长（毫秒） */
+    displayDuration: number;
+}
+/** 场景文档模型（scene.json v3）——纯数据，不依赖 three / Angular */
+type Vec3 = [number, number, number];
+type PrimitiveKind = 'box' | 'sphere' | 'cylinder' | 'group' | 'asset' | 'light' | 'label';
+interface TransformState {
+    position: Vec3;
+    /** 欧拉角，单位：度（对 UI 友好） */
+    rotation: Vec3;
+    scale: Vec3;
+}
+interface NodeDoc extends TransformState {
+    id: string;
+    name: string;
+    primitive: PrimitiveKind;
+    visible: boolean;
+    children: string[];
+    /** 标签文字内容（仅 label 节点） */
+    text?: string;
+    /** 资产 ID（服务器分配的 assetId） */
+    assetId?: string;
+    /** 资产库 ID（如 '021000'） */
+    assetLibraryId?: string;
+    /** 资产文件 URL（运行时生成，不持久化也可） */
+    assetUrl?: string;
+    /** 资产显示名称 */
+    assetName?: string;
+    /** 资产文件格式（如 'glb', 'gltf', 'obj'） */
+    assetFormat?: string;
+    /** MTL 文件路径（仅 OBJ 格式时使用） */
+    assetMtlUrl?: string;
+    materialOverrides?: Record<string, MaterialOverride>;
+    animations?: AnimationRule[];
+    effects?: VisualEffect[];
+    lightType?: 'ambient' | 'directional' | 'point' | 'spot';
+    lightColor?: string;
+    lightIntensity?: number;
+    lightCastShadow?: boolean;
+    lightTarget?: Vec3;
+    /** 点光源/聚光灯照射距离（0 = 无限） */
+    lightDistance?: number;
+    /** 光照衰减率 */
+    lightDecay?: number;
+    /** 聚光灯锥角（弧度） */
+    lightAngle?: number;
+    /** 聚光灯边缘柔和度（0-1） */
+    lightPenumbra?: number;
+}
+/** 材质覆盖：场景级别，不修改资产本身 */
+interface MaterialOverride {
+    color?: string;
+    opacity?: number;
+    roughness?: number;
+    metalness?: number;
+    emissive?: string;
+    visible?: boolean;
+    map?: string;
+    normalMap?: string;
+    roughnessMap?: string;
+    metalnessMap?: string;
+    emissiveMap?: string;
+    /** 基础色是否与贴图叠加（默认 true；关闭后基础色强制 #ffffff，贴图原样显示） */
+    useBaseColor?: boolean;
+}
+/** 动画/绑定规则 */
+interface AnimationRule {
+    id: string;
+    targetMeshName: string;
+    property: string;
+    type: 'continuous' | 'oscillate' | 'data-driven' | 'trigger' | 'emissive' | 'emissive-constant' | 'emissive-temperature';
+    speed?: number;
+    from?: number;
+    to?: number;
+    duration?: number;
+    easing?: string;
+    triggerBy?: 'click' | 'manual';
+    dataSource?: string;
+    dataMin?: number;
+    dataMax?: number;
+    valueMin?: number;
+    valueMax?: number;
+    /** 告警颜色（emissive 类型用，如 '#ff0000'） */
+    alarmColor?: string;
+    /** 高亮颜色（emissive-constant 用，如 '#00aaff'） */
+    highlightColor?: string;
+    /** 点位注释（自动生成，人能看懂的描述，如"空调1号温度传感器"） */
+    pointComment?: string;
+    /** 温度梯度颜色（emissive-temperature 用，如 ['#00ff00', '#ffff00', '#ff0000']） */
+    tempColors?: string[];
+    /** 唯一绑定 ID，用于关联实时数据点位（对应 point 表的 ElementIDName3d） */
+    bindingId?: string;
+    /** 预设动画名称（如'旋转风扇'，由编辑器自动生成） */
+    presetName?: string;
+}
+type VisualEffectKind = 'particle' | 'uv-animation' | 'path-particle' | 'screen-content';
+interface VisualEffectBase {
+    id: string;
+    kind: VisualEffectKind;
+    enabled: boolean;
+    /** 目标子网格名（可选） */
+    targetMeshName?: string;
+}
+/** UV 动画（管道液体流动、电缆电流） */
+interface UvAnimationEffect extends VisualEffectBase {
+    kind: 'uv-animation';
+    /** U 方向滚动速度（UV 坐标/秒） */
+    speedU: number;
+    /** V 方向滚动速度 */
+    speedV: number;
+}
+/** 粒子效果（蒸汽、烟雾） */
+interface ParticleEffect extends VisualEffectBase {
+    kind: 'particle';
+    /** 发射速率（粒子/秒） */
+    emissionRate: number;
+    /** 粒子最大数量 */
+    maxParticles: number;
+    /** 粒子生命周期（秒） */
+    lifetime: number;
+    /** 发射方向 */
+    direction: Vec3;
+    /** 发射锥角（弧度） */
+    spreadAngle: number;
+    /** 初速度 */
+    speed: number;
+    /** 速度衰减 */
+    damping: number;
+    /** 粒子大小 */
+    size: number;
+    /** 大小随机范围 */
+    sizeRandom: number;
+    startColor: string;
+    endColor: string;
+    startOpacity: number;
+    endOpacity: number;
+    /** 重力（0=无） */
+    gravity: number;
+    blendMode: 'normal' | 'additive';
+}
+/** 路径粒子效果（管道水流、光纤） */
+interface PathParticleEffect extends VisualEffectBase {
+    kind: 'path-particle';
+    /** 路径点数组（世界坐标） */
+    pathPoints: Vec3[];
+    /** 段类型数组，长度 = pathPoints.length - 1
+     * - 'linear': 直线段
+     * - 'smooth': 平滑曲线段（CatmullRom）
+     */
+    segmentTypes: ('linear' | 'smooth')[];
+    /** 粒子数量 */
+    particleCount: number;
+    /** 粒子大小 */
+    size: number;
+    /** 流动速度（路径进度/秒，0-1） */
+    speed: number;
+    /** 粒子颜色 */
+    color: string;
+    /** 粒子透明度 */
+    opacity: number;
+    /** 混合模式 */
+    blendMode: 'normal' | 'additive';
+    /** 是否循环 */
+    loop: boolean;
+    /** 粒子外观类型 */
+    textureType: 'dot' | 'arrow' | 'wave';
+    /** 拖尾效果 */
+    trail: boolean;
+    /** 发光效果 */
+    glow: boolean;
+    /** 管道透明度（0=完全透明 1=不透明，1 表示不隐藏管道） */
+    pipeOpacity: number;
+    /** 粒子分布半径（管道截面内随机偏移范围） */
+    pipeRadius?: number;
+}
+/** 屏幕内容切换效果（大屏贴图轮播） */
+interface ScreenContentEffect extends VisualEffectBase {
+    kind: 'screen-content';
+    /** 图片 URL 数组（base64 或 http） */
+    images: string[];
+    /** 轮播间隔（毫秒） */
+    interval: number;
+    /** 是否自动播放 */
+    autoPlay: boolean;
+    /** 目标网格名称（为空则应用到所有网格） */
+    targetMeshName?: string;
+    /** 当前图片索引（运行时使用，不持久化） */
+    currentIndex?: number;
+}
+type VisualEffect = UvAnimationEffect | ParticleEffect | PathParticleEffect | ScreenContentEffect;
+/** 飞行路线关键帧 */
+interface CameraKeyframe {
+    /** 相机位置 */
+    position: Vec3;
+    /** 相机目标点 */
+    target: Vec3;
+    /** 到达此关键帧的时间（秒，相对于路径起点） */
+    time: number;
+}
+/** 飞行路线 */
+interface FlyPath {
+    id: string;
+    name: string;
+    keyframes: CameraKeyframe[];
+    /** 是否循环播放 */
+    loop: boolean;
+    /** 总时长（秒，若未指定则从关键帧计算） */
+    duration?: number;
+    /** 关键帧默认间隔（秒），默认 2 */
+    interval?: number;
+}
+interface CameraDoc {
+    position: Vec3;
+    target: Vec3;
+}
+/** 环境配置（场景级） */
+interface EnvironmentConfig {
+    /** 背景色 */
+    background?: string;
+    /** 半球光 */
+    hemisphere?: {
+        /** 是否启用（默认 true） */
+        enabled?: boolean;
+        skyColor?: string;
+        groundColor?: string;
+        intensity?: number;
+    };
+    /** 默认平行光 */
+    directional?: {
+        /** 是否启用（默认 true） */
+        enabled?: boolean;
+        color?: string;
+        intensity?: number;
+        position?: Vec3;
+    };
+    /** HDRI 环境贴图（base64 data URL），优先于 background 纯色背景 */
+    hdriDataUrl?: string;
+    /** 阴影配置 */
+    shadow?: {
+        /** 是否启用阴影（默认 true） */
+        enabled?: boolean;
+        /** 阴影贴图分辨率（默认 2048） */
+        mapSize?: number;
+        /** 阴影相机范围（默认 15，对应 -range ~ +range） */
+        cameraRange?: number;
+    };
+    /** 场景空间配置 */
+    room?: {
+        /** 是否启用 */
+        enabled?: boolean;
+        /** 宽度（X 轴），默认 30 */
+        width?: number;
+        /** 深度（Z 轴），默认 30 */
+        depth?: number;
+        /** 高度（Y 轴），默认 10 */
+        height?: number;
+        /** 地板颜色 */
+        floorColor?: string;
+        /** 墙壁颜色 */
+        wallColor?: string;
+        /** 天花板颜色 */
+        ceilingColor?: string;
+        /** 地板漫反射贴图（base64 data URL） */
+        floorTexture?: string;
+        /** 地板法线贴图 */
+        floorNormalTexture?: string;
+        /** 地板粗糙度贴图 */
+        floorRoughnessTexture?: string;
+        /** 墙壁漫反射贴图 */
+        wallTexture?: string;
+        /** 墙壁法线贴图 */
+        wallNormalTexture?: string;
+        /** 墙壁粗糙度贴图 */
+        wallRoughnessTexture?: string;
+        /** 天花板漫反射贴图 */
+        ceilingTexture?: string;
+        /** 天花板法线贴图 */
+        ceilingNormalTexture?: string;
+        /** 天花板粗糙度贴图 */
+        ceilingRoughnessTexture?: string;
+        /** 基础色是否与贴图叠加（默认 true；关闭后基础色强制 #ffffff，贴图原样显示） */
+        floorUseBaseColor?: boolean;
+        wallUseBaseColor?: boolean;
+        ceilingUseBaseColor?: boolean;
+    };
+}
+interface SceneDoc {
+    schemaVersion: 3;
+    /** 场景 ID（服务器分配） */
+    id?: string;
+    /** 场景名称 */
+    name?: string;
+    nodes: NodeDoc[];
+    /** 相机位置 */
+    camera?: CameraDoc;
+    /** 环境配置 */
+    environment?: EnvironmentConfig;
+    /** 飞行路线 */
+    flyPaths?: FlyPath[];
+    /** 大屏看板 */
+    dashboard?: DashboardConfig;
+    /** 告警配置 */
+    alarm?: AlarmConfig;
+}
+/** 场景元数据（列表用，不包含完整 SceneDoc） */
+interface SceneMeta {
+    id: string;
+    name: string;
+    createdAt: number;
+    updatedAt: number;
+}
+declare function nextId(prefix?: string): string;
+declare function createNode(primitive: PrimitiveKind, name: string): NodeDoc;
+declare function createSceneDoc(): SceneDoc;
+declare function clone<T>(value: T): T;
+/** 告警弹窗数据 */
+interface AlarmPopupData {
+    deviceName: string;
+    alarmType: string;
+    currentValue: number;
+    threshold: number;
+    priority: 'high' | 'medium' | 'low';
+    suggestion: string;
+    timestamp: number;
+}
+
+/** 命令：一切场景修改的唯一入口，天然可撤销 */
+interface Command {
+    label: string;
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+declare class History {
+    private readonly store;
+    private undoStack;
+    private redoStack;
+    constructor(store: SceneStore);
+    execute(cmd: Command): void;
+    undo(): void;
+    redo(): void;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    /** 清空所有历史记录 */
+    clear(): void;
+    /** 检查撤销栈中是否有指定节点/mesh 的材质命令 */
+    hasMaterialCmdFor(nodeId: string, meshName: string): boolean;
+    /** 更新栈顶最后一个指定节点/mesh 的材质命令的 after 状态（用于贴图上传完成后替换临时 URL）
+     *  返回 true 表示找到并更新了，false 表示栈中没有匹配的命令 */
+    updateLastMaterialAfter(nodeId: string, meshName: string, newAfter: MaterialOverride): boolean;
+    /** 直接推入命令（用于已手动应用变更的场景，不再执行 do） */
+    pushCommand(cmd: Command): void;
+}
+
+type Listener = () => void;
+/** 单一数据源：场景文档 + 选择 + 历史。不依赖 Angular / three */
+declare class SceneStore {
+    readonly doc: SceneDoc;
+    readonly history: History;
+    private docListeners;
+    private selectionListeners;
+    private _selection;
+    get selection(): readonly string[];
+    node(id: string): NodeDoc | undefined;
+    parentOf(id: string): NodeDoc | undefined;
+    /** 收集节点自身及全部后代 */
+    subtree(id: string): NodeDoc[];
+    roots(): NodeDoc[];
+    setSelection(ids: string[]): void;
+    onDocChange(l: Listener): () => void;
+    onSelectionChange(l: Listener): () => void;
+    /** History 与直接修改（如选择无关的文档变更）后调用 */
+    notifyChanged(): void;
+    /** 从 JSON 加载场景文档（替换当前文档，兼容 v2 和 v3） */
+    loadDoc(doc: SceneDoc): void;
+}
+
+declare class AddNodeCommand implements Command {
+    private readonly node;
+    private readonly parentId;
+    readonly label: string;
+    constructor(node: NodeDoc, parentId?: string | null);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+declare class RemoveNodeCommand implements Command {
+    private readonly id;
+    readonly label = "\u5220\u9664\u8282\u70B9";
+    private removed;
+    private parentId;
+    constructor(id: string);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+declare class TransformCommand implements Command {
+    private readonly id;
+    private readonly before;
+    private readonly after;
+    readonly label = "\u53D8\u6362";
+    constructor(id: string, before: TransformState, after: TransformState);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 合并选中节点为一个 group */
+declare class GroupCommand implements Command {
+    private readonly selectedIds;
+    readonly label = "\u5408\u5E76\u4E3A\u7EC4";
+    private groupId;
+    private originalParents;
+    private originalPositions;
+    private removedEmptyGroups;
+    constructor(selectedIds: string[]);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 解除合并：将 group 的子节点提升到 group 的父节点下，删除 group */
+declare class UngroupCommand implements Command {
+    readonly label = "\u89E3\u9664\u5408\u5E76";
+    private groupId;
+    private children;
+    private groupParentId;
+    private groupName;
+    constructor(groupId: string);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 材质覆盖命令：记录 before/after，支持 undo/redo */
+declare class MaterialOverrideCommand implements Command {
+    private readonly nodeId;
+    private readonly meshName;
+    private readonly before;
+    private readonly after;
+    readonly label = "\u4FEE\u6539\u6750\u8D28";
+    constructor(nodeId: string, meshName: string, before: MaterialOverride | undefined, after: MaterialOverride);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 同步材质到同资产实例命令（批量） */
+declare class SyncMaterialCommand implements Command {
+    private readonly sourceNodeId;
+    private readonly targetNodeIds;
+    private readonly beforeMap;
+    private readonly after;
+    readonly label = "\u540C\u6B65\u6750\u8D28\u5230\u540C\u8D44\u4EA7\u5B9E\u4F8B";
+    constructor(sourceNodeId: string, targetNodeIds: string[], beforeMap: Map<string, Record<string, MaterialOverride> | undefined>, after: Record<string, MaterialOverride> | undefined);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 看板配置命令 */
+declare class SetDashboardCommand implements Command {
+    private readonly before;
+    private readonly after;
+    readonly label = "\u4FEE\u6539\u770B\u677F";
+    constructor(before: DashboardConfig | undefined, after: DashboardConfig);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 告警配置命令 */
+declare class SetAlarmCommand implements Command {
+    private readonly before;
+    private readonly after;
+    readonly label = "\u4FEE\u6539\u544A\u8B66";
+    constructor(before: AlarmConfig | undefined, after: AlarmConfig);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 拖动节点改变父节点 */
+declare class ReparentCommand implements Command {
+    private readonly nodeId;
+    private readonly newParentId;
+    readonly label = "\u79FB\u52A8\u8282\u70B9";
+    private oldParentId;
+    private oldIndex;
+    constructor(nodeId: string, newParentId: string | null);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 环境配置命令：背景色、半球光、平行光、HDRI、场景空间 */
+declare class SetEnvironmentCommand implements Command {
+    private readonly before;
+    private readonly after;
+    readonly label = "\u4FEE\u6539\u73AF\u5883";
+    constructor(before: EnvironmentConfig | undefined, after: EnvironmentConfig);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 灯光属性修改命令 */
+declare class SetLightPropertyCommand implements Command {
+    private readonly nodeId;
+    private readonly prop;
+    private readonly newValue;
+    readonly label = "\u4FEE\u6539\u706F\u5149";
+    private oldValue;
+    constructor(nodeId: string, prop: string, newValue: unknown);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+    /** 执行前保存旧值（必须在 do 之前调用） */
+    captureOldValue(store: SceneStore): void;
+}
+/** 节点重命名命令 */
+declare class SetNodeNameCommand implements Command {
+    private readonly nodeId;
+    private readonly newName;
+    readonly label = "\u91CD\u547D\u540D";
+    private oldName;
+    constructor(nodeId: string, newName: string);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+declare class SetNodeTextCommand implements Command {
+    private readonly nodeId;
+    private readonly newText;
+    readonly label = "\u6807\u7B7E\u6587\u5B57";
+    private oldText;
+    constructor(nodeId: string, newText: string);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 批量删除命令（多选删除合并为单个撤销步骤） */
+declare class BatchRemoveCommand implements Command {
+    private readonly ids;
+    readonly label = "\u5220\u9664\u8282\u70B9";
+    private removedGroups;
+    constructor(ids: string[]);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 动画添加命令 */
+declare class AddAnimationCommand implements Command {
+    private readonly nodeId;
+    private readonly rule;
+    readonly label = "\u6DFB\u52A0\u52A8\u753B";
+    constructor(nodeId: string, rule: AnimationRule);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 动画更新命令 */
+declare class UpdateAnimationCommand implements Command {
+    private readonly nodeId;
+    private readonly index;
+    private readonly newRule;
+    readonly label = "\u4FEE\u6539\u52A8\u753B";
+    private oldRule;
+    constructor(nodeId: string, index: number, newRule: AnimationRule);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 动画删除命令 */
+declare class RemoveAnimationCommand implements Command {
+    private readonly nodeId;
+    private readonly index;
+    readonly label = "\u5220\u9664\u52A8\u753B";
+    private oldRule;
+    private oldIndex;
+    constructor(nodeId: string, index: number);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 飞行路线操作命令（创建/更新/删除合并为一个命令类） */
+declare class FlyPathCommand implements Command {
+    private readonly action;
+    private readonly pathId;
+    private readonly pathData?;
+    private readonly updates?;
+    readonly label: string;
+    private beforePaths;
+    constructor(action: 'create' | 'update' | 'delete', pathId: string, pathData?: FlyPath | undefined, updates?: Partial<FlyPath> | undefined);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 关键帧操作命令（添加/更新/删除/插入/覆盖合并为一个命令类） */
+declare class KeyframeCommand implements Command {
+    private readonly action;
+    private readonly pathId;
+    private readonly index?;
+    private readonly keyframe?;
+    readonly label: string;
+    private beforePaths;
+    constructor(action: 'add' | 'update' | 'delete' | 'insert' | 'overwrite', pathId: string, index?: number | undefined, keyframe?: CameraKeyframe | undefined);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 添加视觉效果 */
+declare class AddEffectCommand implements Command {
+    private readonly nodeId;
+    private readonly effect;
+    readonly label = "\u6DFB\u52A0\u7279\u6548";
+    constructor(nodeId: string, effect: VisualEffect);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 更新视觉效果 */
+declare class UpdateEffectCommand implements Command {
+    private readonly nodeId;
+    private readonly index;
+    private readonly newEffect;
+    readonly label = "\u4FEE\u6539\u7279\u6548";
+    private oldEffect;
+    constructor(nodeId: string, index: number, newEffect: VisualEffect);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 删除视觉效果 */
+declare class RemoveEffectCommand implements Command {
+    private readonly nodeId;
+    private readonly index;
+    readonly label = "\u5220\u9664\u7279\u6548";
+    private oldEffect;
+    private oldIndex;
+    constructor(nodeId: string, index: number);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 更新路径点位置 */
+declare class UpdatePathPointsCommand implements Command {
+    private readonly nodeId;
+    private readonly effectIndex;
+    private readonly newPoints;
+    readonly label = "\u4FEE\u6539\u8DEF\u5F84\u70B9";
+    private oldPoints;
+    constructor(nodeId: string, effectIndex: number, newPoints: Vec3[]);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+declare class InsertPathPointCommand implements Command {
+    private readonly nodeId;
+    private readonly effectIndex;
+    private readonly insertAfter;
+    private readonly position;
+    readonly label = "\u6DFB\u52A0\u8DEF\u5F84\u70B9";
+    private oldPoints;
+    private oldSegmentTypes;
+    constructor(nodeId: string, effectIndex: number, insertAfter: number, position: Vec3);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 删除路径点（最少保留 2 个） */
+declare class RemovePathPointCommand implements Command {
+    private readonly nodeId;
+    private readonly effectIndex;
+    private readonly pointIndex;
+    readonly label = "\u5220\u9664\u8DEF\u5F84\u70B9";
+    private oldPoints;
+    private oldSegmentTypes;
+    constructor(nodeId: string, effectIndex: number, pointIndex: number);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 切换段类型（直线/曲线） */
+declare class ToggleSegmentTypeCommand implements Command {
+    private readonly nodeId;
+    private readonly effectIndex;
+    private readonly segmentIndex;
+    readonly label = "\u5207\u6362\u6BB5\u7C7B\u578B";
+    private oldType;
+    constructor(nodeId: string, effectIndex: number, segmentIndex: number);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+/** 移动控制点到数组开头或结尾 */
+declare class MovePathPointToEndCommand implements Command {
+    private readonly nodeId;
+    private readonly effectIndex;
+    private readonly pointIndex;
+    private readonly toStart;
+    readonly label = "\u79FB\u52A8\u63A7\u5236\u70B9";
+    private oldPoints;
+    private oldSegmentTypes;
+    constructor(nodeId: string, effectIndex: number, pointIndex: number, toStart: boolean);
+    do(store: SceneStore): void;
+    undo(store: SceneStore): void;
+}
+
+type TransformMode = 'translate' | 'rotate' | 'scale';
+interface PickEvent {
+    id: string | null;
+    /** 是否按住 Ctrl/Cmd 追加（true = 切换；false = 排他选中） */
+    additive: boolean;
+}
+interface ViewerCallbacks {
+    onSelect(ev: PickEvent): void;
+    onTransformEnd(id: string, before: TransformState, after: TransformState): void;
+    /** 资产加载完成后生成缩略图 */
+    onThumbnailGenerated?(assetId: string, dataUrl: string): void;
+    /** 路径点移动 */
+    onPathPointMoved?(nodeId: string, effectIndex: number, pointIndex: number, newPosition: Vec3): void;
+    /** 添加路径点 */
+    onAddPathPoint?(nodeId: string, effectIndex: number, insertAfter: number, position: Vec3): void;
+    /** 删除路径点 */
+    onDeletePathPoint?(nodeId: string, effectIndex: number, pointIndex: number): void;
+    /** 路径编辑模式变化 */
+    onPathEditingChanged?(isEditing: boolean): void;
+    /** 控制点右键点击 */
+    onPathPointRightClick?(nodeId: string, effectIndex: number, pointIndex: number, position: Vec3, event: MouseEvent): void;
+    /** 线段右键点击 */
+    onSegmentRightClick?(nodeId: string, effectIndex: number, segmentIndex: number, position: Vec3, event: MouseEvent): void;
+    /** 模型表面点击（左键） */
+    onModelSurfaceClick?(nodeId: string, effectIndex: number, position: Vec3, event: PointerEvent): void;
+    /** 移动控制点到数组开头/结尾 */
+    onMovePathPointToEnd?(nodeId: string, effectIndex: number, pointIndex: number, toStart: boolean): void;
+}
+/** three.js 视口：只认 SceneStore 这份单一数据源，sync() 是唯一写 three 对象的入口 */
+declare class SceneViewer {
+    private host;
+    private store;
+    private cb;
+    private renderer;
+    /** 后处理合成器 */
+    private composer;
+    private scene;
+    private camera;
+    private orbit;
+    private gizmo;
+    private hemiLight;
+    private dirLight;
+    private objects;
+    private helpers;
+    private lightTargets;
+    private lightHelpers;
+    private lightPickers;
+    private assetCache;
+    /** 正在等待加载的节点（URL → 等待中的 nodeId 集合），处理 undo→redo 竞态 */
+    private pendingAssetNodes;
+    /** 动画基础变换（nodeId → 数据模型原始变换） */
+    private animBases;
+    /** 缩略图渲染器（离屏） */
+    private thumbRenderer?;
+    private thumbScene;
+    private thumbCamera;
+    /** 动画时间 */
+    private animTime;
+    /** 上一帧时间戳 */
+    private lastFrameTime;
+    /** 拖拽中冻结动画 */
+    private animationFrozen;
+    /** 相机是否已从文档恢复（只在首次 sync 时恢复一次） */
+    private cameraRestored;
+    /** 保存原始材质参数（覆盖前），用于撤销覆盖时恢复 */
+    private originalMaterials;
+    /** undo/redo 期间为 true，sync() 中据此传 isUndoRedoing 给 applyMaterialOverrides */
+    private _isUndoRedoing;
+    /** 贴图缓存（dataURL → THREE.Texture） */
+    private textureCache;
+    /** 标签对象缓存（nodeId → label mesh） */
+    private labelObjects;
+    private textureLoader;
+    /** HDRI 环境贴图缓存 */
+    private hdriTexture;
+    /** 当前 HDRI data URL（用于判断是否需要重新加载） */
+    private hdriCurrentUrl;
+    /** 网格辅助线 */
+    private gridHelper;
+    /** 场景空间网格 */
+    private roomMesh;
+    /** 缓存上次的房间配置，避免每次 state 变化都重建 */
+    private lastRoomKey;
+    private gltfLoader;
+    /** 正在加载中的资产 URL（防止重复加载） */
+    private loadingAssetUrls;
+    private dragBefore;
+    private downPos;
+    private ro;
+    private raycaster;
+    private unsubDoc;
+    private unsubSel;
+    /** 看板 overlay 元素 */
+    private dashboardOverlayEl?;
+    /** 看板 widget DOM 元素缓存 (widgetId → HTMLDivElement) */
+    private dashboardElements;
+    /** 看板数据源定时器 */
+    private dashboardIntervals;
+    /** 看板当前数据值 (widgetId → value) */
+    private dashboardValues;
+    /** 当前播放的飞行路线 */
+    private flyPathPlaying;
+    /** 播放开始的真实时间戳 */
+    private flyPathStartTime;
+    /** 告警弹窗 (nodeId → mesh) */
+    private alarmPopups;
+    /** 告警弹窗创建时间 (nodeId → timestamp) */
+    private alarmCreationTime;
+    /** 暂停时已经过的时间（秒） */
+    private flyPathPausedElapsed;
+    /** 是否暂停 */
+    private flyPathPaused;
+    /** 是否刚从暂停恢复（需要在下一帧重算 startTime） */
+    private flyPathResuming;
+    /** 飞行路线回调 */
+    private flyPathCallbacks;
+    private boxSelecting;
+    private boxStart;
+    private boxEl;
+    private keysPressed;
+    private moveSpeed;
+    /** 复用的临时向量，避免每帧 GC */
+    private _tmpVec;
+    private _tmpVec2;
+    private _tmpVec3;
+    private _upVector;
+    private onKeyDown;
+    private onKeyUp;
+    /** nodeId → effectId → THREE.Object3D（粒子系统等） */
+    private effectObjects;
+    /** `${nodeId}:${effectId}` → ParticleRuntime */
+    private particleSystems;
+    /** `${nodeId}:${effectId}` → PathParticleRuntime */
+    private pathParticleSystems;
+    /** UV 动画状态：`${nodeId}:${effectId}` → { offsetU, offsetV } */
+    private uvAnimStates;
+    /** 屏幕内容切换状态：`${nodeId}:${effectId}` → { intervalId, currentIndex, targetMeshName } */
+    private screenContentStates;
+    /** 管道水流效果导致的材质半透明：nodeId → [{ mesh, material, originalOpacity, originalDepthWrite }] */
+    private pipeTransparencyBackup;
+    private pathEditor;
+    /** 是否为编辑器模式（编辑器模式下动画默认播放，不依赖数据） */
+    private isEditorMode;
+    constructor(host: HTMLElement, store: SceneStore, cb: ViewerCallbacks, dashboardOverlayEl?: HTMLDivElement, isEditorMode?: boolean);
+    setMode(mode: TransformMode): void;
+    /** 设置路径编辑的活动效果 */
+    setPathEditingEffect(effectKey: string | null): void;
+    /** 是否正在编辑路径 */
+    isPathEditing(): boolean;
+    /** 设置路径编辑控制点大小 */
+    setPathHandleSize(size: number): void;
+    /** 将当前相机状态写入 SceneDoc（保存前调用） */
+    saveCamera(): void;
+    /** 从 SceneDoc 恢复相机位置 */
+    private restoreCamera;
+    /** 导出场景为 GLB 文件 */
+    exportScene(): void;
+    /** 按文档重建/更新/删除 three 对象 */
+    sync(): void;
+    /** 强制恢复相机（草稿恢复后调用） */
+    forceRestoreCamera(): void;
+    /** 创建标签 mesh */
+    private createLabel;
+    /** 应用场景环境配置（背景色、半球光、平行光、HDRI） */
+    private applyEnvironment;
+    /** 确保半球光存在并加入场景 */
+    private ensureHemiLight;
+    /** 移除半球光 */
+    private removeHemiLight;
+    /** 确保平行光存在并加入场景 */
+    private ensureDirLight;
+    /** 移除平行光 */
+    private removeDirLight;
+    /** 应用场景空间配置 */
+    private applyRoom;
+    /** 构建房间 6 面材质 */
+    private buildRoomMaterials;
+    /**
+     * 修正 BoxGeometry + BackSide 的 UV 镜像问题
+     * BackSide 从内部看盒子时，+X、+Z 面 U 反向，+Y 天花板 UV 全反，-Y 地板 V 反向
+     */
+    private fixBoxBackSideUV;
+    /** 销毁房间网格和材质 */
+    private disposeRoom;
+    /** 处理键盘移动（WASD + Q/E）—— 仅当场景空间启用时生效 */
+    private processKeyboardMovement;
+    /** 场景空间开启时，限制 orbit 目标和相机在房间内部 */
+    private constrainCameraToRoom;
+    /** 清除 HDRI 环境贴图 */
+    private clearHdri;
+    /** 初始化后处理效果链：SSAO + Bloom + 色调映射输出 */
+    private initPostProcessing;
+    /** 播放飞行路线 */
+    playFlyPath(path: FlyPath, callbacks?: {
+        onComplete?: () => void;
+    }): void;
+    /** 停止飞行路线 */
+    stopFlyPath(): void;
+    /** 暂停飞行路线 */
+    pauseFlyPath(): void;
+    /** 恢复播放（从暂停处继续） */
+    resumeFlyPath(): void;
+    /** 是否正在播放飞行路线 */
+    isFlyPathPlaying(): boolean;
+    /** 更新飞行路线相机（在渲染循环中调用） */
+    private updateFlyPath;
+    /** 从关键帧设置相机 */
+    private setCameraFromKeyframe;
+    /** 保存节点的基础变换（数据模型值） */
+    private saveBaseTransforms;
+    /** 每帧更新所有动画 */
+    private updateAnimations;
+    /** 将动画值应用到对象的指定属性 */
+    private applyAnimValue;
+    /** 应用发射光动画规则 */
+    private applyEmissiveRule;
+    /** 多色梯度插值 */
+    private interpolateColorGradient;
+    /** 计算单条动画规则的当前值 */
+    private evaluateAnimation;
+    /** 全局模拟数据（0-100），可由外部设置 */
+    dataSignal: number;
+    /** 每节点实时数据：nodeId → { dataKey: value } */
+    private nodeDataMap;
+    /** 按 bindingId 存储实时数据：bindingId → value */
+    private bindingDataMap;
+    /** 设置模拟数据值（用于数据驱动动画测试） */
+    setDataSignal(value: number): void;
+    /** 设置节点实时数据（用于 per-node 数据驱动动画） */
+    setData(nodeId: string, data: Record<string, number>): void;
+    /** 获取节点实时数据值 */
+    getNodeData(nodeId: string, key: string): number | undefined;
+    /** 按 bindingId 设置实时数据（用于点位绑定） */
+    setBindingData(bindingId: string, value: number): void;
+    /** 获取 bindingId 对应的数据值 */
+    getBindingData(bindingId: string): number | undefined;
+    /** 为资产生成缩略图（离屏渲染 512×384） */
+    generateThumbnail(assetId: string, model: THREE.Object3D): void;
+    /** 标记正在 undo/redo，sync() 中据此传 isUndoRedoing 给 applyMaterialOverrides */
+    setUndoRedoing(value: boolean): void;
+    /** 显示告警弹窗 */
+    showAlarm(nodeId: string, data: AlarmPopupData): void;
+    /** 隐藏告警弹窗 */
+    hideAlarm(nodeId: string): void;
+    /** 每帧更新告警弹窗（自动消失 + billboard 朝向） */
+    private updateAlarmSprites;
+    /** 同步看板 widget DOM 与数据模型 */
+    private syncDashboard;
+    /** 创建单个看板 widget */
+    private createDashboardWidget;
+    /** 应用 widget 样式 */
+    private applyWidgetStyle;
+    /** 更新 widget 内容 */
+    private updateWidgetContent;
+    /** 初始化 widget 数据源 */
+    private initWidgetDataSource;
+    /** 格式化显示值 */
+    private formatValue;
+    /** 获取状态灯颜色 */
+    private getStatusColor;
+    /** 计算进度百分比 */
+    private calcProgress;
+    /** 每帧更新看板 widget 位置（world 模式） */
+    private updateDashboard;
+    /** 同步视觉效果：创建/更新/销毁 effect 对应的 three.js 对象 */
+    private syncEffects;
+    /** 清理节点的所有效果 */
+    private clearNodeEffects;
+    /** 设置管道半透明（水流效果激活时调用） */
+    private setPipeTransparency;
+    /** 恢复管道原始不透明度 */
+    private restorePipeTransparency;
+    /** 确保目标 mesh 有流动贴图（程序化生成） */
+    private ensureFlowTexture;
+    /** 更新屏幕内容贴图 */
+    private updateScreenContent;
+    /** 每帧更新所有视觉效果 */
+    private updateEffects;
+    dispose(): void;
+    private createMesh;
+    /** 判断对象是否为灯光 */
+    private isLight;
+    /** 根据节点数据创建灯光对象 */
+    private createLight;
+    /** 更新灯光属性（不改变位置） */
+    private updateLightProperties;
+    /** 异步加载资产（从 URL，包括 blob URL） */
+    private loadAsset;
+    /** 创建红色占位线框 */
+    private createPlaceholder;
+    /** 创建带 Draco 解码器的 GLTFLoader */
+    private createGltfLoader;
+    /** 加载 GLTF/GLB */
+    private loadGltf;
+    /** 加载 OBJ + 可选 MTL */
+    private loadObj;
+    /** 解码文本，自动检测 UTF-8 或 GBK 编码（处理中文 mesh 名称乱码） */
+    private decodeText;
+    /** 将加载的资产模型应用到节点 */
+    private applyAssetToNode;
+    /** 确保所有 mesh 都有 name（供其他方法调用） */
+    private ensureMeshNames;
+    /** 获取资产节点的 mesh 名称列表 */
+    getMeshNames(nodeId: string): string[];
+    /** 获取节点的包围盒信息（世界坐标） */
+    getNodeBounds(nodeId: string): {
+        center: [number, number, number];
+        size: [number, number, number];
+    } | null;
+    /** 应用材质覆盖到指定节点（含处理覆盖移除 — 恢复原始材质） */
+    applyMaterialOverrides(nodeId: string, isUndoRedoing?: boolean): void;
+    /** 加载或获取缓存的贴图，应用到材质 */
+    private applyTexture;
+    /** 保存 mesh 的原始材质（仅首次保存，后续调用不覆盖） */
+    private saveOriginalMaterials;
+    /** 隔离显示子部件：其他部件隐藏 */
+    isolateSubMesh(nodeId: string, meshName: string): void;
+    /** 退出隔离显示：恢复所有部件到正常状态 */
+    exitIsolation(nodeId: string): void;
+    /** 保存节点所有 mesh 的原始材质（模型加载后调用） */
+    private saveAllOriginalMaterials;
+    /** 恢复 mesh 到原始材质 */
+    private resetMaterialToOriginal;
+    /** 获取 mesh 的原始材质（未覆盖前的值） */
+    getOriginalMaterial(nodeId: string, meshName: string): {
+        color: string;
+        opacity: number;
+        roughness: number;
+        metalness: number;
+        emissive: string;
+        visible: boolean;
+        map: THREE.Texture | null;
+    } | undefined;
+    private refreshSelection;
+    /** 根据 Box3 创建包围盒的几何体 */
+    private createBoxGeometry;
+    /** 计算 group 的所有后代的包围盒（本地空间，相对于组的 Object3D） */
+    private computeGroupLocalBounds;
+    /** 计算 group 的所有后代的包围盒（世界空间） */
+    private computeGroupBounds;
+    private snapshot;
+    private pick;
+    private createBoxEl;
+    private updateBoxEl;
+    private finishBoxSelect;
+    /** 双击拉近视角：将相机平滑移动到目标对象前方 */
+    private onDblClick;
+    /** 平滑聚焦到指定节点：将相机移动到对象前方 */
+    focusOnNode(nodeId: string): void;
+    private resize;
+    /** 屏幕坐标 → 地面（y=0）世界坐标 */
+    screenToGround(viewportX: number, viewportY: number): Vec3 | null;
+}
+
+/**
+ * 场景视口组件：three.js 全部跑在 NgZone 之外，
+ * 只有对外事件才回到 zone 内触发变更检测。
+ */
+declare class SceneViewComponent implements AfterViewInit, OnChanges, OnDestroy {
+    private zone;
+    host: ElementRef<HTMLDivElement>;
+    dashboardOverlay: ElementRef<HTMLDivElement>;
+    store: SceneStore;
+    mode: TransformMode;
+    isEditorMode: boolean;
+    select: EventEmitter<PickEvent>;
+    transformEnd: EventEmitter<{
+        id: string;
+        before: TransformState;
+        after: TransformState;
+    }>;
+    dropAsset: EventEmitter<{
+        x: number;
+        y: number;
+        assetId: string;
+        assetName: string;
+        assetFormat: string;
+        assetLibraryId: string;
+    }>;
+    thumbnailGenerated: EventEmitter<{
+        assetId: string;
+        dataUrl: string;
+    }>;
+    pathPointMoved: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        pointIndex: number;
+        position: Vec3;
+    }>;
+    addPathPoint: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        insertAfter: number;
+        position: Vec3;
+    }>;
+    deletePathPoint: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        pointIndex: number;
+    }>;
+    pathEditingChanged: EventEmitter<boolean>;
+    pathPointRightClick: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        pointIndex: number;
+        position: Vec3;
+        event: MouseEvent;
+    }>;
+    segmentRightClick: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        segmentIndex: number;
+        position: Vec3;
+        event: MouseEvent;
+    }>;
+    modelSurfaceClick: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        position: Vec3;
+        event: PointerEvent;
+    }>;
+    movePathPointToEnd: EventEmitter<{
+        nodeId: string;
+        effectIndex: number;
+        pointIndex: number;
+        toStart: boolean;
+    }>;
+    private viewer;
+    constructor(zone: NgZone);
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: {
+        [key: string]: any;
+    }): void;
+    ngOnDestroy(): void;
+    /** 导出场景为 GLB */
+    exportScene(): void;
+    /** 屏幕坐标 → 地面世界坐标 */
+    screenToGround(screenX: number, screenY: number): [number, number, number] | null;
+    /** 获取资产节点的 mesh 名称列表 */
+    getMeshNames(nodeId: string): string[];
+    /** 获取节点的包围盒信息（世界坐标） */
+    getNodeBounds(nodeId: string): {
+        center: [number, number, number];
+        size: [number, number, number];
+    } | null;
+    /** 重新应用材质覆盖（材质参数变化后调用） */
+    applyMaterialOverrides(nodeId: string): void;
+    /** 获取 mesh 的原始材质（未覆盖前的值） */
+    getOriginalMaterial(nodeId: string, meshName: string): {
+        color: string;
+        opacity: number;
+        roughness: number;
+        metalness: number;
+        emissive: string;
+        visible: boolean;
+    } | undefined;
+    /** 隔离显示子部件：其他部件变为半透明 */
+    isolateSubMesh(nodeId: string, meshName: string): void;
+    /** 退出隔离显示：恢复所有部件到原始状态 */
+    exitIsolation(nodeId: string): void;
+    /** 保存当前相机状态到 SceneDoc */
+    saveCamera(): void;
+    /** 强制恢复相机（草稿恢复后调用） */
+    forceRestoreCamera(): void;
+    /** 设置模拟数据信号（用于数据驱动动画测试） */
+    setDataSignal(value: number): void;
+    /** 设置节点实时数据（用于 per-node 数据驱动动画） */
+    setData(nodeId: string, data: Record<string, number>): void;
+    /** 按 bindingId 设置实时数据（用于点位绑定） */
+    setBindingData(bindingId: string, value: number): void;
+    /** 标记正在 undo/redo */
+    setUndoRedoing(value: boolean): void;
+    /** 播放飞行路线 */
+    playFlyPath(path: FlyPath, callbacks?: {
+        onComplete?: () => void;
+    }): void;
+    /** 停止飞行路线 */
+    stopFlyPath(): void;
+    /** 暂停飞行路线 */
+    pauseFlyPath(): void;
+    /** 恢复播放 */
+    resumeFlyPath(): void;
+    /** 是否正在播放飞行路线 */
+    isFlyPathPlaying(): boolean;
+    /** 获取当前相机位置（用于添加关键帧） */
+    getCameraState(): {
+        position: [number, number, number];
+        target: [number, number, number];
+    } | null;
+    /** 设置相机位置（跳转到指定视角） */
+    setCameraState(state: {
+        position: [number, number, number];
+        target: [number, number, number];
+    }): void;
+    /** 平滑聚焦到指定节点 */
+    focusOnNode(nodeId: string): void;
+    /** 设置路径编辑的活动效果 */
+    setPathEditingEffect(effectKey: string | null): void;
+    /** 是否正在编辑路径 */
+    isPathEditing(): boolean;
+    /** 设置路径编辑控制点大小 */
+    setPathHandleSize(size: number): void;
+    /** 显示告警弹框 */
+    showAlarm(nodeId: string, data: any): void;
+    /** 隐藏告警弹框 */
+    hideAlarm(nodeId: string): void;
+    /** 拖拽悬停：允许放置 */
+    onDragOver(e: DragEvent): void;
+    /** 拖拽放置：解析资产信息并发射事件 */
+    onDrop(e: DragEvent): void;
+    /** 获取 viewer 实例（供外部调用高级功能如告警弹窗） */
+    getViewer(): SceneViewer | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SceneViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SceneViewComponent, "twin-scene-view", never, { "store": { "alias": "store"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "isEditorMode": { "alias": "isEditorMode"; "required": false; }; }, { "select": "select"; "transformEnd": "transformEnd"; "dropAsset": "dropAsset"; "thumbnailGenerated": "thumbnailGenerated"; "pathPointMoved": "pathPointMoved"; "addPathPoint": "addPathPoint"; "deletePathPoint": "deletePathPoint"; "pathEditingChanged": "pathEditingChanged"; "pathPointRightClick": "pathPointRightClick"; "segmentRightClick": "segmentRightClick"; "modelSurfaceClick": "modelSurfaceClick"; "movePathPointToEnd": "movePathPointToEnd"; }, never, never, true, never>;
+}
+
+/**
+ * 路径编辑器 — 可视化编辑路径粒子的路径点
+ * 控制点球体 + 路径线，支持拖拽/添加/删除
+ * 复用 viewer 的 TransformControls，不创建独立实例
+ */
+
+interface PathEditorCallbacks {
+    onPathPointMoved(nodeId: string, effectIndex: number, pointIndex: number, newPosition: Vec3): void;
+    onPathPointDrag?(nodeId: string, effectIndex: number, newPoints: Vec3[]): void;
+    onAddPathPoint(nodeId: string, effectIndex: number, insertAfter: number, position: Vec3): void;
+    onDeletePathPoint(nodeId: string, effectIndex: number, pointIndex: number): void;
+    onActiveEffectChanged?(effectKey: string | null): void;
+    /** 控制点右键点击 */
+    onPathPointRightClick?(nodeId: string, effectIndex: number, pointIndex: number, position: Vec3, event: MouseEvent): void;
+    /** 线段右键点击 */
+    onSegmentRightClick?(nodeId: string, effectIndex: number, segmentIndex: number, position: Vec3, event: MouseEvent): void;
+    /** 模型表面点击（左键） */
+    onModelSurfaceClick?(nodeId: string, effectIndex: number, position: Vec3, event: PointerEvent): void;
+    /** 移动控制点到数组开头/结尾 */
+    onMovePathPointToEnd?(nodeId: string, effectIndex: number, pointIndex: number, toStart: boolean): void;
+    /** 获取模型节点对象（用于添加子级） */
+    getNodeObject?(nodeId: string): THREE.Object3D | null;
+}
+interface PathVis {
+    handles: THREE.Mesh[];
+    curveLine: THREE.Line;
+    segmentLines: THREE.Line[];
+    effectKey: string;
+    nodeId: string;
+    effectIndex: number;
+    pathPoints: Vec3[];
+    segmentTypes: ('linear' | 'smooth')[];
+}
+declare class PathEditor {
+    private scene;
+    private camera;
+    private renderer;
+    private store;
+    private orbit;
+    private cb;
+    private visuals;
+    private activeEffectKey;
+    private dragging;
+    private handleSize;
+    private pendingAttachIndex;
+    /** 复用 viewer 的 gizmo，不创建独立实例 */
+    private gizmo;
+    private raycaster;
+    private pointer;
+    onActiveEffectChanged?: (effectKey: string | null) => void;
+    /** 设置 viewer 的 gizmo（由 viewer 初始化时调用） */
+    setGizmo(gizmo: TransformControls): void;
+    constructor(scene: THREE.Scene, camera: THREE.Camera, renderer: THREE.WebGLRenderer, store: SceneStore, orbit: OrbitControls, cb: PathEditorCallbacks);
+    /** 绑定 gizmo 事件（由 viewer 初始化时调用一次） */
+    bindGizmoEvents(): void;
+    /** 同步 store 数据到可视化 */
+    sync(): void;
+    /** 设置活动编辑效果 */
+    setActiveEffect(effectKey: string | null): void;
+    /** 是否正在编辑 */
+    isActive(): boolean;
+    /** 获取所有绿球 mesh（用于射线检测） */
+    getHandles(): THREE.Mesh[];
+    /** 获取活动效果 key */
+    getActiveEffectKey(): string | null;
+    /** 根据世界坐标位置找到插入位置 */
+    getInsertPosition(worldPoint: THREE.Vector3): {
+        insertAfter: number;
+        position: Vec3;
+    } | null;
+    /** 设置控制点球体大小 */
+    setHandleSize(size: number): void;
+    /** 设置待绑定的控制点索引（sync 后绑定到该点） */
+    setPendingAttachIndex(index: number): void;
+    private recreateHandles;
+    /** 尝试拾取控制点，返回是否拾取到 */
+    pickHandle(event: PointerEvent): boolean;
+    /** 尝试拾取路径线，返回插入位置 */
+    pickCurve(event: PointerEvent, groundY?: number): {
+        insertAfter: number;
+        position: Vec3;
+    } | null;
+    /** 拾取线段，返回段索引 */
+    pickSegment(event: PointerEvent): {
+        segmentIndex: number;
+        position: Vec3;
+    } | null;
+    /** 处理右键点击 */
+    handleRightClick(event: MouseEvent): boolean;
+    /** 根据点击位置找到插入位置（开头/结尾） */
+    findInsertPosition(vis: PathVis, point: THREE.Vector3): {
+        insertAfter: number;
+        position: Vec3;
+    };
+    /** 释放资源 */
+    dispose(): void;
+    private updatePointer;
+    private createVisual;
+    private updateVisual;
+    private removeVisual;
+    private setVisVisible;
+    private buildCurvePoints;
+    /** 为单个段构建曲线点，包含上下文点以便 smooth 段能正确弯曲 */
+    private buildSegmentCurvePoints;
+    private attachGizmo;
+    private startDrag;
+    private updateDrag;
+    private finishDrag;
+}
+
+/**
+ * 粒子系统运行时
+ * 使用 BufferGeometry + Points + ShaderMaterial 实现 GPU 加速的粒子效果
+ */
+
+/** 粒子运行时状态 */
+declare class ParticleRuntime {
+    geometry: THREE.BufferGeometry;
+    material: THREE.ShaderMaterial;
+    points: THREE.Points;
+    private positions;
+    private velocities;
+    private ages;
+    private lifetimes;
+    private sizes;
+    private alive;
+    private emitAccumulator;
+    private config;
+    private origin;
+    /** 水平漂移累积（每个粒子独立的随机相位） */
+    private driftPhases;
+    private posAttr;
+    private ageAttr;
+    private lifetimeAttr;
+    private sizeAttr;
+    constructor(config: ParticleEffect, origin: THREE.Vector3);
+    /** 更新配置参数（不重建 geometry） */
+    updateConfig(config: ParticleEffect): void;
+    /** 发射粒子 */
+    private emit;
+    private findDeadSlot;
+    /** 每帧更新 */
+    update(dt: number): void;
+    /** 更新粒子系统的原点位置（跟随父节点） */
+    setOrigin(position: THREE.Vector3): void;
+    dispose(): void;
+}
+
+/**
+ * 路径粒子系统运行时
+ * 粒子沿指定路径（曲线）运动，模拟管道水流/光纤效果
+ */
+
+/** 路径粒子运行时状态 */
+declare class PathParticleRuntime {
+    geometry: THREE.BufferGeometry;
+    material: THREE.ShaderMaterial;
+    points: THREE.Points;
+    private positions;
+    private progresses;
+    private sizes;
+    /** 每个粒子的固定 3D 偏移（管道截面内随机分布） */
+    private offsets;
+    private opacities;
+    private trailProgresses;
+    private config;
+    private curve;
+    private time;
+    private posAttr;
+    private progressAttr;
+    private sizeAttr;
+    private opacityAttr;
+    private trailAttr;
+    constructor(config: PathParticleEffect);
+    /** 获取当前路径点（用于比较是否变化） */
+    getPathPoints(): Vec3[];
+    /** 更新配置参数 */
+    updateConfig(config: PathParticleEffect): void;
+    private segmentTypesChanged;
+    private pathChanged;
+    private rebuildBuffers;
+    /** 每帧更新 */
+    update(dt: number): void;
+    /** 更新路径点（仅更新曲线和粒子位置，不更新 config.pathPoints） */
+    setPathPoints(points: Vec3[], segmentTypes?: ('linear' | 'smooth')[]): void;
+    /** 根据切线方向，在垂直平面内计算圆盘偏移的 3D 向量 */
+    private static _tmpN;
+    private static _tmpB;
+    private static _tmpT;
+    static offsetOnPlane(angle: number, radius: number, tangent: THREE.Vector3): THREE.Vector3;
+    dispose(): void;
+}
+
+/**
+ * 分段路径 — 根据 segmentTypes 逐段生成曲线
+ * - 'linear': 直线段（线性插值）
+ * - 'smooth': 平滑曲线段（CatmullRom，前后各借一个控制点）
+ *
+ * 注意：CatmullRomCurve3([p0,p1,p2,p3]) 的参数范围是 p0→p3 (t=0→1)
+ *       其中 p1 在 t=1/3, p2 在 t=2/3
+ *       所以段 p1→p2 对应曲线参数 t∈[1/3, 2/3]
+ */
+
+/**
+ * 分段路径类
+ * 根据 segmentTypes 数组决定每段是直线还是曲线
+ */
+declare class SegmentedPath {
+    private segments;
+    private totalLength;
+    /**
+     * @param points 路径点数组
+     * @param segmentTypes 段类型数组，长度 = points.length - 1
+     */
+    constructor(points: THREE.Vector3[], segmentTypes: ('linear' | 'smooth')[]);
+    private buildSegments;
+    /** 数值积分计算曲线在参数范围 [t0, t1] 内的弧长 */
+    private computeSegmentLength;
+    /** 将段内局部参数 t∈[0,1] 映射到曲线参数 t∈[1/3, 2/3] */
+    private mapToCurveT;
+    /** 获取段上某局部参数对应的点 */
+    private getSmoothPoint;
+    /**
+     * 根据进度 t (0-1) 获取路径上的点
+     * 按弧长参数化，保证匀速运动
+     */
+    getPointAt(t: number): THREE.Vector3;
+    /**
+     * 获取路径上的采样点（用于可视化）
+     * @param totalSegments 总采样段数
+     */
+    getPoints(totalSegments?: number): THREE.Vector3[];
+    /**
+     * 按弧长均匀采样路径点（用于粒子均匀分布）
+     * @param count 采样点数量
+     */
+    getSpacedPoints(count?: number): THREE.Vector3[];
+    /** 获取总长度 */
+    getLength(): number;
+    /**
+     * 根据进度 t (0-1) 获取路径在该点的切线方向（单位向量）
+     */
+    getTangentAt(t: number): THREE.Vector3;
+}
+
+/** Draco 解码器路径（打包进 npm 包） */
+declare const DRACO_DECODER_PATH = "assets/draco/gltf/";
+/** Draco 编码器路径（打包进 npm 包） */
+declare const DRACO_ENCODER_PATH = "assets/draco/encoder/";
+
+export { AddAnimationCommand, AddEffectCommand, AddNodeCommand, BatchRemoveCommand, DRACO_DECODER_PATH, DRACO_ENCODER_PATH, FlyPathCommand, GroupCommand, History, InsertPathPointCommand, KeyframeCommand, MaterialOverrideCommand, MovePathPointToEndCommand, ParticleRuntime, PathEditor, PathParticleRuntime, RemoveAnimationCommand, RemoveEffectCommand, RemoveNodeCommand, RemovePathPointCommand, ReparentCommand, SceneStore, SceneViewComponent, SceneViewer, SegmentedPath, SetAlarmCommand, SetDashboardCommand, SetEnvironmentCommand, SetLightPropertyCommand, SetNodeNameCommand, SetNodeTextCommand, SyncMaterialCommand, ToggleSegmentTypeCommand, TransformCommand, UngroupCommand, UpdateAnimationCommand, UpdateEffectCommand, UpdatePathPointsCommand, clone, createNode, createSceneDoc, nextId };
+export type { AlarmConfig, AlarmPopupData, AnimationRule, CameraDoc, CameraKeyframe, Command, DashboardConfig, DashboardDataPoint, DashboardWidget, EnvironmentConfig, FlyPath, MaterialOverride, NodeDoc, ParticleEffect, PathEditorCallbacks, PathParticleEffect, PickEvent, PrimitiveKind, SceneDoc, SceneMeta, ScreenContentEffect, TransformMode, TransformState, UvAnimationEffect, Vec3, ViewerCallbacks, VisualEffect, VisualEffectBase, VisualEffectKind };