@jnrs/lingshu-smart 3.0.0 → 3.1.0

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

@@ -27,6 +27,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

@@ -16,6 +16,13 @@ export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAb
      */
     get moveDuration(): number;
     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/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 层号优先（当前夹具绑定了层时以绑定层为索引基准），其次工位号（优先类型匹配），最后首个工位组 */

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;