@jnrs/lingshu-smart 2.2.46 → 3.0.0

package/dist/controller/AppController.d.ts

@@ -1,4 +1,5 @@
-import { IScene, ILayer, IContainer, ILayerOperating } from '../types';
+import { IScene, ILayer, IContainer, ILayerOperating, EnumResourceType } from '../types';
+import { ModelAbs } from '../ui/abstract/ModelAbs';
 import { App } from 'leafer';
 export declare class AppController {
     app: App;
@@ -8,11 +9,16 @@ export declare class AppController {
     private palletLinks;
     private pendingPalletLinks;
     private syncingPallets;
+    private followRafId;
+    private followingSet;
+    private followDeadlines;
     private appEditable;
     private actions;
     private hideSceneFill;
     private shadowsEnabled;
     private animationsEnabled;
+    private alarmHighlights;
+    private hostExtensions;
     constructor(options?: IContainer);
     start(): void;
     destroy(): void;
@@ -29,14 +35,79 @@ export declare class AppController {
      * @returns 实际复位的模型数量
      */
     resetAllModels(): number;
-    removeModelById(uuid: string): void;
+    /**
+     * 复位单个业务设备（device_init 全量覆盖语义：缺省字段重置为默认值，见文档第七章）
+     * @param className 设备类型（EnumModel 值）
+     * @param id 业务设备 ID
+     * @param stationIndex 同设备多实例时指定目标实例；缺省复位该设备全部实例
+     * @returns 是否至少复位了一个模型
+     */
+    resetModel(className: string, id: string, stationIndex?: number): boolean;
+    /** 复位单个模型实例：重建 UI、回插原位置、重新注册交互事件与调试状态 */
+    private resetSingleModel;
+    removeModelById(id: string): void;
     addModel(modelConfig: ILayer): void;
     private registerPalletLink;
     rerenderModel(modelConfig: ILayer): void;
-    operating(data: ILayerOperating): void;
-    private syncLinkedPallets;
+    operating(data: ILayerOperating): boolean;
+    /**
+     * 托盘/拖链逐帧跟随：
+     * 机器人等设备移动时，读取设备实时位置直接驱动绑定托盘与轨道拖链，
+     * 避免各自独立动画（时长/缓动/中断时机不一致）导致移动不同步。
+     * 连续移动（多步操作）时每次刷新截止时间，跟随持续到设备动画结束。
+     */
+    private startLinkedFollow;
     private globalHandle;
     private batchRemove;
+    /** 是否存在匹配的业务设备模型（command_ack 404 判断） */
+    hasDevice(className: string, id: string): boolean;
+    /** 判断设备是否存在指定序号的工位（任一工位组；多层设备按 layer 定位层） */
+    hasStation(className: string, id: string, stationIndex: number, layer?: number): boolean;
+    /** 判断指定工位是否可放置该资源类型（运行期类型强校验，见文档 4.3） */
+    acceptsResourceType(className: string, id: string, stationIndex: number, resourceType: EnumResourceType, layer?: number): boolean;
+    /** 查找第一个可放置指定资源类型的工位序号（device_station 缺省语义，见文档 3.3） */
+    findFirstStationIndex(className: string, id: string, resourceType: EnumResourceType): number | undefined;
+    /**
+     * 统一工位寻址（宿主 + 扩展托盘合并编号）：
+     * 1. stationIndex 缺省：宿主内找第一个可放置工位；未命中时按绑定顺序在扩展托盘上继续找（允许落到扩展工位）
+     * 2. stationIndex 明确：宿主工位组优先；未命中时按合并编号偏移（宿主工位总数 + 前序扩展托盘工位总数）
+     *    换算扩展托盘局部工位号（局部 = 合并编号 - 偏移，局部 < 1 时该托盘不承接）
+     * @returns 命中目标（模型实例 + 局部工位号 + 合并编号）；宿主与扩展均未命中返回 undefined（调用方回执 404）
+     */
+    resolveStationTarget(className: string, id: string, resourceType: EnumResourceType, stationIndex?: number, layer?: number): {
+        model: ModelAbs;
+        stationIndex: number;
+        mergedIndex: number;
+    } | undefined;
+    /** 在扩展托盘上按合并编号定位工位（偏移量 = 宿主工位总数 + 前序扩展托盘工位总数，逐盘顺延） */
+    private resolveExtensionStation;
+    /** 在扩展托盘上查找第一个可放置指定资源类型的工位（device_station 缺省且宿主无可用工位时顺延） */
+    private findFirstExtensionStation;
+    /**
+     * 扩展工位点击视图：绑定 extendHostId 的托盘工位被点击时，
+     * 返回宿主设备 config（layer 参数替换为宿主）与合并编号（data.index 改写值）
+     */
+    getExtensionTapView(pallet: ModelAbs, localIndex: number): {
+        hostConfig: ILayer;
+        mergedIndex: number;
+        localIndex: number;
+    } | undefined;
+    /** 查找扩展工位宿主模型：优先非托盘设备（托盘与宿主共用 id 时排除托盘自身与其余托盘） */
+    private findExtensionHostModel;
+    /** 获取指定工位槽中心的场景坐标（世界坐标系，供 transfer 搬运动画规划路径） */
+    getStationSlotPoint(className: string, id: string, stationIndex: number, layer?: number): {
+        x: number;
+        y: number;
+    } | undefined;
+    /** 按 className + id（多实例时按工位号消歧）定位模型实例 */
+    private findStationModel;
+    /**
+     * 设备告警高亮联动：告警产生时在设备外围显示旋转虚线高亮环；
+     * 告警解除（同一 alarm_id 以 status: 'resolved' 重推）时移除
+     */
+    setAlarmHighlight(className: string, id: string, on: boolean, level?: 'critical' | 'warning' | 'info'): void;
+    /** 移除全部告警高亮（scene_reset 场景复位时调用） */
+    clearAlarmHighlights(): void;
     worldToLocalPoint(worldX: number, worldY: number): {
         x: number;
         y: number;

package/dist/controller/SocketDispatcher.d.ts

@@ -0,0 +1,59 @@
+import { SocketMessage, CommandAckPayload, IScene } from '../types';
+import { AppController } from './AppController';
+/** 分发器选项 */
+export interface SocketDispatcherOptions {
+    /** 画布控制器（内部 operating 引擎） */
+    appController: AppController;
+    /** 获取场景配置（用于 position 比例值 → 像素换算） */
+    getScene: () => IScene | null;
+    /** 回执回调（画布 → 后端 command_ack） */
+    onAck?: (ack: SocketMessage<CommandAckPayload>) => void;
+    /** 画布无模型的透传消息（alarm_push / runtime_status_push 等） */
+    onRaw?: (msg: SocketMessage<any>) => void;
+}
+export declare class SocketDispatcher {
+    private appController;
+    private getScene;
+    private onAck?;
+    private onRaw?;
+    private pool;
+    /** envelope.id 去重缓存（重复 ID 丢弃，warn 日志） */
+    private seenIds;
+    private seenQueue;
+    constructor(options: SocketDispatcherOptions);
+    /** 场景复位 / 画布复位时清空资源池（全部资源实体离场） */
+    reset(): void;
+    /**
+     * 分发一条完整业务消息（envelope + payload）
+     * @param msg 原始消息
+     */
+    dispatch(msg: unknown): void;
+    private handleDeviceCommand;
+    /** 将 device_command payload 转换为内部 operating（position 比例值 → 像素） */
+    private buildDeviceOperating;
+    /** 协议 position（比例值）→ 内部 operating position（位移像素 / 角度原值）；仅保留显式传入的字段 */
+    private toPixelPosition;
+    private handleDeviceInit;
+    private handleResourceCommand;
+    /**
+     * 资源落位校验（静态强校验，不做业务时序约束，见文档 4.3 / 8.2）：
+     * - 位置结构 / device_type 无效 → 400
+     * - 目标设备未找到 / 工位未找到（含扩展工位）/ 无可用工位 → 404
+     * - 资源类型与目标工位声明类型不匹配 → 409
+     * - device_station 缺省时解析「第一个可用工位」（宿主优先，允许顺延到扩展托盘，见文档 3.3）
+     * 扩展工位寻址：宿主（如机床）工位组未命中时，按合并编号偏移顺延到绑定的扩展托盘（extendHostId），
+     * 返回的 target 为实际承接设备（可能是托盘），资源池与 placeResource 均以其为准
+     */
+    private resolvePlacement;
+    /** 由落位结果构建实际承接位置的 ResourceLocation（扩展工位时为托盘自身寻址，后续 remove/transfer 直接按实际位置寻址） */
+    private toResolvedLocation;
+    /**
+     * 解析「来源位置」到实际承接设备（transfer.from 的扩展工位合并编号寻址；
+     * 未命中时保持原位置，由后续工位移除逻辑自然失败）
+     */
+    private resolveSourceLocation;
+    /** 将资源实体放置/移除到目标工位（device_type + device_id + layer + device_station 定位） */
+    private placeResource;
+    private handleAlarmPush;
+    private ack;
+}

package/dist/fullscreen-BA3oea8O.js

@@ -0,0 +1,53 @@
+import { b as e } from "./index-C6Liz-8o.js";
+import { ref as c, onMounted as t, onUnmounted as N } from "vue";
+function O(s) {
+  return s?.className === e.MACHINE_TOOL;
+}
+function l(s) {
+  return s?.className === e.MACHINE_TOOL || s?.className === e.MARKING_MACHINE || s?.className === e.CLEANING_MACHINE || s?.className === e.LOADING_STATION || s?.className === e.RESOURCE_OPERATION_WINDOW;
+}
+function m(s) {
+  return s?.className === e.RESOURCE_STORE || s?.className === e.SINGLE_JOINT_ROBOT || s?.className === e.DOUBLE_JOINT_ROBOT || s?.className === e.RGV;
+}
+function E(s) {
+  return s?.className === e.SHUTTLE_STATION || s?.className === e.MATERIAL_TRACK || s?.className === e.PALLET || s?.className === e.MACHINE_TOOL || s?.className === e.LOADING_STATION || s?.className === e.MARKING_MACHINE || s?.className === e.CLEANING_MACHINE || s?.className === e.SINGLE_JOINT_ROBOT || s?.className === e.DOUBLE_JOINT_ROBOT || s?.className === e.RGV || s?.className === e.RESOURCE_STORE || s?.className === e.RESOURCE_OPERATION_WINDOW;
+}
+function T(s) {
+  return s?.className === e.RESOURCE_STORE;
+}
+function I(s) {
+  return s?.className === e.SINGLE_JOINT_ROBOT || s?.className === e.DOUBLE_JOINT_ROBOT;
+}
+function _(s) {
+  return s?.className === e.RAIL;
+}
+function i(s) {
+  return s?.className === e.SHUTTLE_STATION;
+}
+function R(s) {
+  return s?.className === e.PALLET;
+}
+const r = () => {
+  const s = c(!1), n = () => {
+    s.value = !!document.fullscreenElement;
+  }, a = () => {
+    document.fullscreenElement ? document.exitFullscreen() : document.documentElement.requestFullscreen();
+  };
+  return t(() => {
+    document.addEventListener("fullscreenchange", n);
+  }), N(() => {
+    document.removeEventListener("fullscreenchange", n);
+  }), { isFullscreen: s, toggleFullscreen: a };
+};
+export {
+  m as a,
+  E as b,
+  T as c,
+  I as d,
+  _ as e,
+  i as f,
+  R as g,
+  l as h,
+  O as i,
+  r as u
+};