@jnrs/lingshu-smart 3.0.0 → 3.1.1

package/dist/types/guards.d.ts

@@ -13,7 +13,7 @@ export declare function hasStationSlotLayers(layer: ILayer | null): layer is Ext
     stationSlotGroups?: any[];
 }>;
 export declare function isResourceStore(layer: ILayer | null): layer is import('./index').IResourceStoreConfig;
-export declare function hasFixtureChange(layer: ILayer | null): layer is import('./index').ISingleJointRobotConfig | import('./index').IDoubleJointRobotConfig;
+export declare function isJointRobot(layer: ILayer | null): layer is import('./index').ISingleJointRobotConfig | import('./index').IDoubleJointRobotConfig;
 export declare function isRail(layer: ILayer | null): layer is import('./index').IRailConfig;
 export declare function isShuttleStation(layer: ILayer | null): layer is import('./index').IShuttleStationConfig;
 export declare function isPallet(layer: ILayer | null): layer is Extract<ILayer, {

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

@@ -11,6 +11,13 @@ export interface IPositionOperating {
     x?: number;
     y?: number;
     z?: number;
+    /**
+     * 画布内部字段：协议 `position.x` 的**原始值**（SocketDispatcher 换算像素时附带，不入协议）。
+     * 设备绑定轨道（linkRailId）时用于沿轨定位：≤ 1 视为沿轨道长度的比例（0 = 轨道起点端、1 = 终点端）；
+     * > 1 视为自轨道起点端算起的沿轨像素距离（代理已配置「像素转换」特殊处理的情形）。
+     * 未绑定轨道时不参与定位（仍用 x 的场景像素值）
+     */
+    rawX?: number;
     j1?: number;
     j2?: number;
     fork_xy?: number;
@@ -27,6 +34,11 @@ export interface IModelOperating {
     device_station?: number;
     /** 设备状态（协议 device_state 状态码；画布默认不做任何处理，由使用方按需在代理器自行配置映射） */
     device_state?: number;
+    /**
+     * 铭牌文本（全部设备通用）：传入时更新画布铭牌文字，并按文字长度重算铭牌宽度与两端螺钉孔位置；
+     * 仅影响画布 UI，不写入设备配置——复位（scene_reset）后铭牌回到配置里的初始文本，动态文本需复位后重新下发
+     */
+    nameplate?: string;
     raw_data: IRowData;
     resource?: IResourceOperating;
 }

package/dist/types/socket.types.d.ts

@@ -136,6 +136,11 @@ export interface DeviceCommandPayload {
     raw_data?: object;
     /** 设备状态（状态码）；画布默认不做处理，由使用方按需在代理器自行配置映射 */
     device_state?: number;
+    /**
+     * 铭牌文本（全部设备通用）：传入时更新画布铭牌文字（宽度按文字长度重算）；
+     * 仅影响画布 UI，scene_reset 后回到配置里的初始文本
+     */
+    nameplate?: string;
     light?: SocketLight;
     progress?: SocketProgress;
     passage?: SocketPassage;
@@ -208,6 +213,8 @@ export interface DeviceInitItem {
     device_station?: number;
     /** 设备状态（状态码）；画布默认不做处理，由使用方按需在代理器自行配置映射 */
     device_state?: number;
+    /** 铭牌文本（全部设备通用）：传入时更新画布铭牌文字（宽度按文字长度重算） */
+    nameplate?: string;
     light?: SocketLight;
     progress?: SocketProgress;
     passage?: SocketPassage;

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

@@ -1,4 +1,4 @@
-import { ILayer, InteractiveUi, IEventHandler, ILayerOperating, EnumResourceType } from '../../types';
+import { ILayer, InteractiveUi, IEventHandler, ILayerOperating, IRailConfig, EnumResourceType } from '../../types';
 import { StationSlotGroup } from '../components/StationSlotGroup';
 import { AppController } from '../../controller/AppController';
 import { BaseAbs } from './BaseAbs';
@@ -15,7 +15,28 @@ export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAb
      * 托盘跟随等联动使用该值保持动画同步；子类可覆盖（如双关节机器人 0.5s）
      */
     get moveDuration(): number;
+    /**
+     * 沿 x 位移（搬运设备通用）
+     * - 未绑定轨道（linkRailId）：按场景绝对坐标位移（原行为，x 为像素）
+     * - 已绑定轨道：按「沿轨距离」定位——rawX ≤ 1 为沿轨道长度的比例（0 = 轨道起点端、1 = 终点端），
+     *   rawX > 1 为自轨道起点端算起的沿轨像素距离（代理已配置「像素转换」的情形）；
+     *   横向沿用编辑期设计的「相对轨道偏移」（不消费协议 y），朝向 = 编辑期 rotation + 轨道 rotation
+     * @param x 场景绝对 x（像素，由协议比例按场景宽度换算；> 1 的代理像素值原样透传）
+     * @param rawX 协议 position.x 原始值（画布内部字段，绑定轨道时使用）
+     */
+    protected moveX(x?: number, rawX?: number): void;
+    /** 绑定轨道（linkRailId，或轨道侧 linkEquipIdArray 反查）的轨道配置；未绑定或轨道未加载时返回 null */
+    protected get boundRailConfig(): IRailConfig | null;
+    /** 沿轨定位：协议值 → 沿轨局部距离 → 场景坐标；越出轨道长度收敛到 [0, 轨道长度] */
+    private moveXAlongRail;
     handleOperation: (data: ILayerOperating) => void;
+    /**
+     * 更新设备铭牌文本（铭牌宽度、文字宽度与两端螺钉孔位置同步重算）
+     * 仅作用于画布 UI，不写入 config：复位（resetUI）后铭牌回到配置里的初始文本，
+     * 动态文本（如「名称（资源数/工位数）」）需由使用方在 scene_reset 后重新下发
+     * @param title 铭牌文本
+     */
+    setNameplate(title: string): void;
     /**
      * 将最近一次 operating 接收到的原始数据写入模型 config 及整棵 UI 树的 data 属性，
      * 使点击回调（onTap/onMenuTap/onDragEnd）中的 layer 与 data 都能读取到各自 operatingData。

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

@@ -31,7 +31,6 @@ export declare class DoubleJointRobot extends ModelAbs<IDoubleJointRobotConfig>
     protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotateR1;
     private handleRotateR2;
-    private moveX;
     private switchFork;
     /** 设置托盘夹具状态：辅料夹具沿用工件夹具造型，压扁 + 直角 + 描边补偿，并补偿 y 使垂直中心对齐手抓关节 */
     private setPalletFixture;

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

@@ -17,7 +17,6 @@ export declare class Pallet extends ModelAbs<IPalletConfig> {
     private resolveLayers;
     private buildLayers;
     protected createUi(): Box;
-    private moveX;
     private moveY;
     protected operating(data: IPalletOperating): void;
     /** 资源增删：data.resource 提供 device_layer(>0) 时定位到该层；缺省时默认识别为第一层 */

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

@@ -12,10 +12,12 @@ export declare class Rail extends ModelAbs<IRailConfig> {
      *  （设备移动时 AppController 逐帧调用 followChain，保证拖链与设备相对静止） */
     protected operating(_data: ILayerOperating): void;
     /**
-     * 逐帧跟随（AppController 托盘/拖链联动调用）：
+     * 逐帧跟随（AppController 拖链联动调用）：
      * 以设备实时位置直接驱动拖链，保证拖链与设备移动时相对静止
+     * @param botId 设备业务 id
+     * @param along 设备在「轨道局部坐标系」下的沿轨距离（0 = 轨道起点端，未缩放局部单位）
      */
-    followChain(botId: string, x: number): void;
+    followChain(botId: string, along: number): void;
     private initChains;
     private createChain;
     private moveChain;

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

@@ -21,7 +21,6 @@ export declare class ResourceStore extends ModelAbs<IResourceStoreConfig> {
     containsStationIndex(index: number): boolean;
     /** 定位资源所在的工位组：优先按 device_layer 层号，其次按工位序号在工作位组中匹配，缺省回退资源类型 */
     private findGroupForResource;
-    private moveX;
     protected operating(data: IResourceStoreOperating): void;
     protected collectStationSlotGroups(): StationSlotGroup[];
 }

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

@@ -20,7 +20,6 @@ export declare class Rgv extends ModelAbs<IRGVConfig> {
     private findGroupForResource;
     protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotate;
-    private moveX;
     /**
      * forks 前后移动（直接赋值，高频移动不走动画）
      * @param percent 移动比例，[-1,1]

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

@@ -3,7 +3,7 @@ import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
 import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
- * 单关节机器人
+ * 单关节机器人（SingleJointRobot）
  */
 export declare class SingleJointRobot extends ModelAbs<ISingleJointRobotConfig> {
     private static readonly DEFAULT_WIDTH;
@@ -18,6 +18,8 @@ export declare class SingleJointRobot extends ModelAbs<ISingleJointRobotConfig>
     private slotLayerIndexes;
     get currentFixture(): EnumResourceType | 'none';
     set currentFixture(type: EnumResourceType | 'none');
+    /** 移动动画时长：与 moveX 默认 0.5s 一致，供托盘跟随等联动同步 */
+    get moveDuration(): number;
     protected createUi(): Box;
     protected operating(data: ISingleJointRobotOperating): void;
     /** 资源路由（与夹具装饰无关）：device_layer 层号优先（当前夹具绑定了层时以绑定层为索引基准），其次工位号（优先类型匹配），最后首个工位组 */
@@ -28,7 +30,6 @@ export declare class SingleJointRobot extends ModelAbs<ISingleJointRobotConfig>
     private applyFixtureBindingVisibility;
     protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotate;
-    private moveX;
     private switchFork;
     /** 设置托盘夹具状态：辅料夹具沿用工件夹具造型，压扁 + 直角 + 描边补偿，并补偿 y 使垂直中心对齐手抓关节 */
     private setPalletFixture;

package/dist/ui/shapes/NamePlate.d.ts

@@ -14,4 +14,18 @@ export interface NamePlateOptions {
     screwHole?: boolean;
     zIndex?: number | string;
 }
+/** 铭牌默认字号（未显式指定 width 时使用） */
+export declare const NAME_PLATE_FONT_SIZE = 14;
+/** 铭牌默认高度 */
+export declare const NAME_PLATE_HEIGHT = 18;
+/**
+ * 按字符实际显示宽度估算铭牌宽度：
+ * 中文等全角字符占 1×fontSize，英文/数字等半角字符占 0.5×fontSize，另加左右各 1 字符边距
+ */
+export declare function calcNamePlateWidth(title: string, fontSize?: number): number;
+/**
+ * 运行时更新铭牌文本：同步文字内容、铭牌宽度与两端螺钉孔位置
+ * （字号沿用创建时的设置；铭牌 around 为 center，宽度变化后仍保持居中显示）
+ */
+export declare function updateNamePlate(box: Box, title: string): void;
 export declare function NamePlate(options: NamePlateOptions): Box;

package/dist/ui/utils/railLocal.d.ts

@@ -0,0 +1,36 @@
+import { IRailConfig } from '../../types';
+/** 轨道坐标系参数（由轨道配置一次性解析） */
+export interface IRailFrame {
+    /** 轨道中心场景坐标 x */
+    cx: number;
+    /** 轨道中心场景坐标 y */
+    cy: number;
+    /** 轨道旋转角余弦 */
+    cos: number;
+    /** 轨道旋转角正弦 */
+    sin: number;
+    /** 轨道缩放系数 */
+    scale: number;
+    /** 轨道长度（局部单位，= width） */
+    length: number;
+    /** 轨道厚度（局部单位，= height） */
+    thickness: number;
+}
+/** 解析轨道坐标系参数（rotation / scale 缺省按 0 / 1 处理；兼容编辑器序列化出的空串等非数值） */
+export declare function createRailFrame(rail: IRailConfig): IRailFrame;
+/**
+ * 协议值 → 沿轨局部距离（未缩放的轨道局部单位）
+ * - source ≤ 1：协议比例 [0,1]（0 = 轨道起点端、1 = 终点端）→ 比例 × 轨道长度
+ * - source > 1：已被代理「像素转换」特殊处理成的像素值 → 视为自轨道起点端算起的沿轨像素距离（除以轨道 scale 换算为局部单位）
+ */
+export declare function resolveRailAlong(frame: IRailFrame, source: number): number;
+/** 场景坐标 → 轨道局部坐标（along 沿轨方向、lateral 垂直轨道方向，均为未缩放的轨道局部单位） */
+export declare function sceneToRailLocal(frame: IRailFrame, x: number, y: number): {
+    along: number;
+    lateral: number;
+};
+/** 轨道局部坐标 → 场景坐标（先平移到以轨道中心为原点，再缩放、旋转） */
+export declare function railLocalToScene(frame: IRailFrame, along: number, lateral: number): {
+    x: number;
+    y: number;
+};