@jnrs/lingshu-smart 2.2.38 → 2.2.40

package/dist/types/models/config.types.d.ts

@@ -51,7 +51,7 @@ export interface IShuttleStationLayerConfig {
     index: number;
     /** 工位组配置（托盘或刀具） */
     stationSlotGroup: IStationSlotGroupConfig;
-    /** 层状态灯颜色（默认 '#666' 灰色，运行时由 layerStatus 驱动） */
+    /** 层状态灯颜色（默认 '#666' 灰色，运行时由 layerLightColor 驱动） */
     lightColor?: string;
     /** 是否显示层状态灯（默认 true） */
     lightEnabled?: boolean;
@@ -64,6 +64,23 @@ export interface IShuttleStationConfig extends IModel {
     /** 多工位层配置数组（一层=一个工位组，可托盘或刀具） */
     stationSlotGroups?: IShuttleStationLayerConfig[];
 }
+/**
+ * 料道工位层配置
+ */
+export interface IMaterialTrackLayerConfig {
+    /** 层索引（从 1 开始） */
+    index: number;
+    /** 工位组配置（托盘或刀具） */
+    stationSlotGroup: IStationSlotGroupConfig;
+}
+/**
+ * 料道
+ */
+export interface IMaterialTrackConfig extends IModel {
+    className: EnumModel.MATERIAL_TRACK;
+    /** 多工位层配置数组（一层=一个工位组） */
+    stationSlotGroups?: IMaterialTrackLayerConfig[];
+}
 /**
  * 打标机
  */
@@ -141,8 +158,23 @@ export interface IPalletConfig extends IModel {
     flowOptions?: IFlowConfig;
     stationSlotGroupPallet?: IStationSlotGroupConfig;
     stationSlotGroupTool?: IStationSlotGroupConfig;
+    linkEquipId?: string;
+}
+/**
+ * 资源操作窗口（独立设备）
+ * 参考托盘/料道：窗口框造型，框内为单个工位组（其中的托盘可 Pallet 或 Tool）；
+ * 部件可有状态灯与铭牌；operating 支持 light / resource / stationStatus（按工位序号改色）。
+ */
+export interface IResourceOperationWindowConfig extends IModel {
+    className: EnumModel.RESOURCE_OPERATION_WINDOW;
+    /** 主体背景色（默认 '#5BC5A1'） */
+    backgroundColor?: string;
+    /** 环状矩形边框厚度（默认 10） */
+    ringThickness?: number;
+    /** 单一工位组配置（框内托盘，槽位 resourceType 可为 Pallet / Tool） */
+    stationSlotGroup?: IStationSlotGroupConfig;
 }
 /**
  * 设备层联合类型
  */
-export type ILayer = IMachineToolConfig | ILoadingStationConfig | IShuttleStationConfig | IMarkingMachineConfig | ICleaningMachineConfig | ISingleJointRobotConfig | IDoubleJointRobotConfig | IRGVConfig | IRailConfig | IResourceStoreConfig | IPalletConfig;
+export type ILayer = IMachineToolConfig | ILoadingStationConfig | IShuttleStationConfig | IMaterialTrackConfig | IMarkingMachineConfig | ICleaningMachineConfig | ISingleJointRobotConfig | IDoubleJointRobotConfig | IRGVConfig | IRailConfig | IResourceStoreConfig | IPalletConfig | IResourceOperationWindowConfig;

package/dist/types/models/operating.types.d.ts

@@ -49,10 +49,30 @@ export interface ILoadingStationOperating extends IModelOperating {
 export interface IShuttleStationOperating extends IModelOperating {
     className: EnumModel.SHUTTLE_STATION;
     light?: Omit<ILightOperating, 'rotating'>;
-    /** 各层工位组运行状态，键为层索引（1-based），值为状态码或颜色字符串
-     *  代理器 dictColorMap 转换后值为颜色字符串；未转换时值为状态数字码
+    /** 各层工位组状态灯颜色，键为层索引（1-based），值为状态码或颜色字符串
+     *  代理器 dictColorMap / objDict 转换后值为颜色字符串；未转换时值为状态数字码
+     * 如 { 1: 'red', 2: 100, 3: 'green' }
      */
-    layerStatus?: Record<number, number | string>;
+    layerLightColor?: Record<number, number | string>;
+    /**
+     * 各层工位组状态灯闪烁，键为层索引（1-based），值为是否闪烁（配合 layerLightColor 状态灯使用）
+     * 如 { 1: false, 2: true, 3: true }
+     */
+    layerLightBlinking?: Record<number, boolean>;
+    /**
+     * 各层工位组显示状态，键为层索引（1-based），值为是否可见（通过工位组 visible 属性显隐）
+     * 如 { 1: true, 2: false, 3: true }
+     */
+    layerVisible?: Record<number, boolean>;
+}
+/**
+ * 料道运转状态
+ */
+export interface IMaterialTrackOperating extends IModelOperating {
+    className: EnumModel.MATERIAL_TRACK;
+    light?: Omit<ILightOperating, 'rotating'>;
+    /** 各层工位组显示状态，键为层索引（1-based），值为是否可见（通过工位组 visible 属性显隐） */
+    layerVisible?: Record<number, boolean>;
 }
 /**
  * 打标机站点状态
@@ -141,7 +161,19 @@ export interface IPalletOperating extends IModelOperating {
     y?: number;
     resource?: IResourceOperating;
 }
+/**
+ * 资源操作窗口运转状态
+ */
+export interface IResourceOperationWindowOperating extends IModelOperating {
+    className: EnumModel.RESOURCE_OPERATION_WINDOW;
+    light?: Omit<ILightOperating, 'rotating'>;
+    resource?: IResourceOperating;
+    /** 各工位状态（颜色），键为工位序号 index（1-based），值为状态码或颜色字符串
+     *  代理器转换后值为颜色字符串；未转换时值为状态数字码（内部映射为颜色）
+     *  如 { 1: 'red', 2: 100, 3: '#66DC7A' } */
+    stationStatus?: Record<number, number | string>;
+}
 /**
  * 设备层运转状态的联合类型
  */
-export type ILayerOperating = IMachineToolOperating | ILoadingStationOperating | IShuttleStationOperating | IMarkingMachineOperating | ICleaningMachineOperating | ISingleJointRobotOperating | IDoubleJointRobotOperating | IRGVOperating | IRailOperating | IResourceStoreOperating | IPalletOperating | IGlobalResourceOperating;
+export type ILayerOperating = IMachineToolOperating | ILoadingStationOperating | IShuttleStationOperating | IMaterialTrackOperating | IMarkingMachineOperating | ICleaningMachineOperating | ISingleJointRobotOperating | IDoubleJointRobotOperating | IRGVOperating | IRailOperating | IResourceStoreOperating | IPalletOperating | IResourceOperationWindowOperating | IGlobalResourceOperating;

package/dist/ui/abstract/ModelAbs.d.ts

@@ -25,4 +25,10 @@ export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAb
      */
     removeResourceById(resourceId: string): boolean;
     destroyUI(): void;
+    /**
+     * 复位：销毁当前 UI 并按初始配置重建（编辑器设置值优先，未设置的字段取模型类默认值）
+     * 所有经 operating 修改的内容（位置/关节/灯/进度/资源等）随重建回到初始状态；
+     * 调用方（AppController）负责将新 UI 重新挂载到场景树原位置并重新注册交互事件
+     */
+    resetUI(): void;
 }

package/dist/ui/components/StationSlot.d.ts

@@ -1,6 +1,15 @@
 import { IStationSlotConfig, IResourceOperating } from '../../types';
 import { Box } from 'leafer';
 import { ComponentAbs } from '../abstract/ComponentAbs';
+/**
+ * 工位槽位默认配置（唯一默认值来源，供三处共用，避免多处不同步导致数据漂移）：
+ * 1. StationSlot 构造器合并回退
+ * 2. 编辑器 StationSlotGroupDialog 的 withSlotDefaults 旧数据补齐
+ * 3. 方案持久化压缩层（默认值剥离/合并，规划中）从此导入
+ * 注意 showShadow 取渲染回退值 true（而非 Dialog 创建默认 false）：
+ * 缺失该字段的历史数据一直按 true 渲染，默认表必须与渲染行为一致，否则解压合并后视觉漂移
+ */
+export declare const DEFAULT_SLOT: IStationSlotConfig;
 export declare class StationSlot extends ComponentAbs<IStationSlotConfig> {
     private children;
     private pendingDestroy;
@@ -28,6 +37,12 @@ export declare class StationSlot extends ComponentAbs<IStationSlotConfig> {
      */
     setSiteWorking(flag: boolean): void;
     toggleVisible(visible: boolean | 0): void;
+    /**
+     * 设置工位填充颜色：传值 color 则填充为该颜色；未传值（undefined / 空）时恢复为默认背景色
+     * 供「资源操作窗口」等按工位序号动态改色的设备使用
+     * @param color 目标颜色（如 '#66DC7A'）；缺省时使用工位配置背景色（默认 DEFAULT_BACKGROUND）
+     */
+    setSiteWorkingColor(color?: string): void;
     /**
      * 销毁
      */

package/dist/ui/components/StationSlotGroup.d.ts

@@ -26,4 +26,10 @@ export declare class StationSlotGroup extends ComponentAbs<IStationSlotGroupConf
      * @returns 是否至少移除了一个资源
      */
     removeResourceById(resourceId: string): boolean;
+    /**
+     * 按工位序号修改工位填充颜色（未传 color 时恢复默认背景色）
+     * @param index 工位序号（IStationSlotConfig.index）
+     * @param color 目标颜色；缺省时使用工位默认背景色
+     */
+    setSiteWorkingColor(index: number, color?: string): void;
 }

package/dist/ui/models/MaterialTrack.d.ts

@@ -0,0 +1,29 @@
+import { IMaterialTrackConfig, IMaterialTrackOperating } from '../../types';
+import { Box } from 'leafer';
+import { ModelAbs } from '../abstract/ModelAbs';
+/**
+ * 料道（MaterialTrack）
+ * 参考接驳站的 U 型多层结构，主体为淡蓝色；
+ * 与接驳站的差异：
+ * 1. 无底座和轮子（主体即完整几何）；
+ * 2. 无层状态灯（工位组无状态灯配置）；
+ * 3. operating 支持 layerVisible 按层索引显隐工位组。
+ */
+export declare class MaterialTrack extends ModelAbs<IMaterialTrackConfig> {
+    private static readonly WALL_THICKNESS;
+    private static readonly BASE_HEIGHT;
+    private static readonly LIGHT_Y_OFFSET;
+    private static readonly NAME_PLATE_Y_OFFSET;
+    private static readonly LAYER_GAP;
+    /** 主体填充色（淡蓝色） */
+    private static readonly BODY_FILL;
+    /** 内腔填充色（深蓝，衬托工位） */
+    private static readonly CAVITY_FILL;
+    private light;
+    private layerGroups;
+    private buildUPath;
+    private buildOutlinePath;
+    private buildLayers;
+    protected createUi(): Box;
+    protected operating(data: IMaterialTrackOperating): void;
+}

package/dist/ui/models/ResourceOperationWindow.d.ts

@@ -0,0 +1,39 @@
+import { IResourceOperationWindowConfig, IResourceOperationWindowOperating } from '../../types';
+import { Box } from 'leafer';
+import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
+/**
+ * 资源操作窗口（ResourceOperationWindow）
+ * 参考托盘 / 料道：窗口框造型（外壁 + 内腔），框内为单个工位组（其中的托盘可 Pallet 或 Tool）；
+ * 部件可选状态灯与铭牌。
+ * operating 支持：
+ * - light：主体状态灯
+ * - resource：向框内工位组添加 / 移除托盘资源
+ * - stationStatus：按工位序号 index 修改工位颜色（值可为颜色字符串或状态码）
+ */
+export declare class ResourceOperationWindow extends ModelAbs<IResourceOperationWindowConfig> {
+    private static readonly DEFAULT_RING_THICKNESS;
+    private static readonly LIGHT_Y_OFFSET;
+    private static readonly NAME_PLATE_Y_OFFSET;
+    private static readonly LIGHT_CORNER_RADIUS;
+    /** 环状矩形外壁填充色 */
+    private static readonly BODY_FILL;
+    /** 内腔填充色（衬托框内托盘） */
+    private static readonly CAVITY_FILL;
+    private light;
+    private stationSlotGroup;
+    /** 环厚（取配置，缺省默认 10） */
+    private ringThickness;
+    private buildFramePath;
+    private buildOutlinePath;
+    protected createUi(): Box;
+    protected operating(data: IResourceOperationWindowOperating): void;
+    private applyStationStatus;
+    private resolveColor;
+    private statusToColor;
+    /**
+     * 判断本窗口是否包含指定工位号
+     */
+    containsStationIndex(index: number): boolean;
+    protected collectStationSlotGroups(): StationSlotGroup[];
+}

package/dist/ui/models/ShuttleStation.d.ts

@@ -4,7 +4,7 @@ import { ModelAbs } from '../abstract/ModelAbs';
 /**
  * 接驳站（ShuttleStation）
  * 整体为 U 型结构，支持多层工位组配置（每层 = 一个工位组容器）；
- * 每层独立拥有状态灯，通过 layerStatus 字典数据驱动颜色；
+ * 每层独立拥有状态灯，通过 layerLightColor 字典数据驱动颜色；
  * 主体底部有 #EA9734 底座 + 两端半露轮子。
  */
 export declare class ShuttleStation extends ModelAbs<IShuttleStationConfig> {
@@ -21,14 +21,14 @@ export declare class ShuttleStation extends ModelAbs<IShuttleStationConfig> {
     private light;
     private layerLights;
     private layerGroups;
-    private lastLayerStatus;
+    private lastLayerLightColor;
     private buildUPath;
     private buildOutlinePath;
     private buildLayers;
     private buildBaseAndWheels;
     protected createUi(): Box;
     protected operating(data: IShuttleStationOperating): void;
-    private applyLayerStatus;
+    private applyLayerLightColor;
     private resolveStatusColor;
     private statusToColor;
 }