@jnrs/lingshu-smart 2.2.6 → 2.2.8

package/dist/types/enums.d.ts

@@ -11,17 +11,20 @@ export declare enum EnumTag {
     OTHER = "\u5176\u4ED6"
 }
 export declare enum EnumModel {
-    SINGLE_GRIPPER_ROBOT = "SingleGripperRobot",
+    SINGLE_JOINT_ROBOT = "SingleJointRobot",
     DOUBLE_GRIPPER_ROBOT = "DoubleGripperRobot",
     RGV = "Rgv",
     MACHINE_TOOL = "MachineTool",
+    MARKING_MACHINE = "MarkingMachine",
     CLEANING_MACHINE = "CleaningMachine",
     LOADING_STATION = "LoadingStation",
     PALLET_STORAGE = "PalletStorage",
     TOOL_STORAGE = "ToolStorage",
     BUFFER_DOCK = "BufferDock",
     GROUND_RAIL = "GroundRail",
-    FOLLOWING_TUGGER = "FollowingTugger"
+    FOLLOWING_TUGGER = "FollowingTugger",
+    RAIL = "Rail",
+    RESOURCE_STORE = "ResourceStore"
 }
 export declare enum EnumComponent {
     STATION_SLOT = "StationSlot",

package/dist/types/enums.js

@@ -0,0 +1,46 @@
+// 步骤操作类型
+export var EnumStepType;
+(function (EnumStepType) {
+    EnumStepType["UNDO"] = "Undo";
+    EnumStepType["REDO"] = "Redo";
+})(EnumStepType || (EnumStepType = {}));
+// 设备标签枚举
+export var EnumTag;
+(function (EnumTag) {
+    EnumTag["TRANSPORT"] = "\u642C\u8FD0\u8BBE\u5907";
+    EnumTag["MACHINE"] = "\u673A\u5E8A";
+    EnumTag["CLEANING"] = "\u6E05\u6D17\u673A";
+    EnumTag["STATION"] = "\u88C5\u8F7D\u7AD9";
+    EnumTag["STORAGE"] = "\u5E93";
+    EnumTag["OTHER"] = "\u5176\u4ED6";
+})(EnumTag || (EnumTag = {}));
+// 设备类型枚举
+export var EnumModel;
+(function (EnumModel) {
+    EnumModel["SINGLE_JOINT_ROBOT"] = "SingleJointRobot";
+    EnumModel["DOUBLE_GRIPPER_ROBOT"] = "DoubleGripperRobot";
+    EnumModel["RGV"] = "Rgv";
+    EnumModel["MACHINE_TOOL"] = "MachineTool";
+    EnumModel["MARKING_MACHINE"] = "MarkingMachine";
+    EnumModel["CLEANING_MACHINE"] = "CleaningMachine";
+    EnumModel["LOADING_STATION"] = "LoadingStation";
+    EnumModel["PALLET_STORAGE"] = "PalletStorage";
+    EnumModel["TOOL_STORAGE"] = "ToolStorage";
+    EnumModel["BUFFER_DOCK"] = "BufferDock";
+    EnumModel["GROUND_RAIL"] = "GroundRail";
+    EnumModel["FOLLOWING_TUGGER"] = "FollowingTugger";
+    EnumModel["RAIL"] = "Rail";
+    EnumModel["RESOURCE_STORE"] = "ResourceStore";
+})(EnumModel || (EnumModel = {}));
+// 组件类型枚举
+export var EnumComponent;
+(function (EnumComponent) {
+    EnumComponent["STATION_SLOT"] = "StationSlot";
+    EnumComponent["RESOURCE"] = "Resource";
+})(EnumComponent || (EnumComponent = {}));
+// 资源类型枚举
+export var EnumResourceType;
+(function (EnumResourceType) {
+    EnumResourceType["PALLET"] = "Pallet";
+    EnumResourceType["TOOL"] = "Tool";
+})(EnumResourceType || (EnumResourceType = {}));

package/dist/types/guards.d.ts

@@ -1,2 +1,12 @@
-import { ILayer } from './index';
-export declare function hasStationSlotGroup(layer: ILayer | null): layer is import('./index').IMachineToolConfig;
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : guards.ts
+ * @Date   : 2026/04/07
+ * @Desc.  : 类型守卫函数
+ */
+import { type ILayer } from './index';
+export declare function isMachineTool(layer: ILayer | null): layer is import("./index").IMachineToolConfig;
+export declare function hasStationSlotGroup(layer: ILayer | null): layer is import("./index").IMachineToolConfig | import("./index").ILoadingStationConfig | import("./index").IMarkingMachineConfig | import("./index").ICleaningMachineConfig | import("./index").IResourceStoreConfig;
+export declare function hasFixtureChange(layer: ILayer | null): layer is import("./index").ISingleJointRobotConfig;
+export declare function isRail(layer: ILayer | null): layer is import("./index").IRailConfig;

package/dist/types/guards.js

@@ -0,0 +1,28 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : guards.ts
+ * @Date   : 2026/04/07
+ * @Desc.  : 类型守卫函数
+ */
+import { EnumModel } from './index';
+// 是否为机床
+export function isMachineTool(layer) {
+    return layer?.className === EnumModel.MACHINE_TOOL;
+}
+// 是否拥有工位组配置
+export function hasStationSlotGroup(layer) {
+    return (layer?.className === EnumModel.MACHINE_TOOL ||
+        layer?.className === EnumModel.MARKING_MACHINE ||
+        layer?.className === EnumModel.CLEANING_MACHINE ||
+        layer?.className === EnumModel.LOADING_STATION ||
+        layer?.className === EnumModel.RESOURCE_STORE);
+}
+// 是否拥有夹具切换配置
+export function hasFixtureChange(layer) {
+    return layer?.className === EnumModel.SINGLE_JOINT_ROBOT;
+}
+// 是否为轨道配置
+export function isRail(layer) {
+    return layer?.className === EnumModel.RAIL;
+}

package/dist/types/index.d.ts

@@ -1,5 +1,3 @@
-import { ILayer } from './models/config.types';
-import { IStationSlotConfig, IResourceConfig } from './components/config.types';
 export * from './enums';
 export * from './app.types';
 export * from './base.types';
@@ -8,6 +6,8 @@ export * from './models/operating.types';
 export * from './components/config.types';
 export * from './components/operating.types';
 export * from './guards';
+import type { ILayer } from './models/config.types';
+import type { IStationSlotConfig, IResourceConfig } from './components/config.types';
 /**
  * 可交互设备类型
  * @description 可交互UI类型：设备模型（ILayer）、工位槽（IStationSlot）、资源（IResource）

package/dist/types/index.js

@@ -0,0 +1,8 @@
+export * from './enums';
+export * from './app.types';
+export * from './base.types';
+export * from './models/config.types';
+export * from './models/operating.types';
+export * from './components/config.types';
+export * from './components/operating.types';
+export * from './guards';

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

@@ -1,45 +1,90 @@
-import { EnumModel, EnumTag } from '../enums';
-import { IRowData, IBaseConfig, IEventState } from '../base.types';
-import { IStationSlotGroupConfig } from '../components/config.types';
+import { EnumModel, EnumTag, EnumResourceType } from '../enums'
+import type { IRowData, IBaseConfig, IEventState } from '../base.types'
+import type { IStationSlotGroupConfig } from '../components/config.types'
 /**
  * 设备模型基类
  */
 export interface IModel extends IBaseConfig, IEventState {
-    uuid: string;
-    equipmentName: string;
-    nameplate?: string;
-    model?: string;
-    manufacturer?: string;
-    group?: string;
-    tags?: EnumTag[];
-    x: number;
-    y: number;
-    percentX: number;
-    percentY: number;
-    zIndex: number;
-    rotation: number;
-    scale: number;
-    rawData: IRowData;
-    editable: boolean;
-    selected: boolean;
+  uuid: string
+  equipmentName: string
+  nameplate?: string
+  model?: string
+  manufacturer?: string
+  group?: string
+  tags?: EnumTag[]
+  x: number
+  y: number
+  percentX: number
+  percentY: number
+  zIndex: number
+  rotation: number
+  scale: number
+  rawData: IRowData
+  editable: boolean
+  selected: boolean
 }
 /**
  * 机床
  */
 export interface IMachineToolConfig extends IModel {
-    className: EnumModel.MACHINE_TOOL;
-    stationSlotGroup?: IStationSlotGroupConfig;
+  className: EnumModel.MACHINE_TOOL
+  stationContainerDirection?: 'horizontal' | 'vertical'
+  stationSlotGroup?: IStationSlotGroupConfig
 }
 /**
- * 单手夹爪机器人
+ * 装载站
  */
-export interface ISingleGripperRobotConfig extends IModel {
-    className: EnumModel.SINGLE_GRIPPER_ROBOT;
-    currentFixture: 'pallet' | 'cutter';
-    linkRailId?: string;
-    linkTrailerId?: string;
+export interface ILoadingStationConfig extends IModel {
+  className: EnumModel.LOADING_STATION
+  stationContainerDirection?: 'horizontal' | 'vertical'
+  stationSlotGroup?: IStationSlotGroupConfig
+}
+/**
+ * 打标机
+ */
+export interface IMarkingMachineConfig extends IModel {
+  className: EnumModel.MARKING_MACHINE
+  stationSlotGroup?: IStationSlotGroupConfig
+}
+/**
+ * 清洗机
+ */
+export interface ICleaningMachineConfig extends IModel {
+  className: EnumModel.CLEANING_MACHINE
+  stationSlotGroup?: IStationSlotGroupConfig
+}
+/**
+ * 单关节机器人
+ */
+export interface ISingleJointRobotConfig extends IModel {
+  className: EnumModel.SINGLE_JOINT_ROBOT
+  currentFixture: EnumResourceType
+  linkRailId?: string
+  linkTrailerId?: string
+}
+/**
+ * 轨道
+ */
+export interface IRailConfig extends IModel {
+  className: EnumModel.RAIL
+  chainDirection?: 'left' | 'right'
+  linkEquipIdArray?: string[]
+}
+/**
+ * 资源库
+ */
+export interface IResourceStoreConfig extends IModel {
+  className: EnumModel.RESOURCE_STORE
+  stationSlotGroup?: IStationSlotGroupConfig
 }
 /**
  * 设备层联合类型
  */
-export type ILayer = IMachineToolConfig | ISingleGripperRobotConfig;
+export type ILayer =
+  | IMachineToolConfig
+  | ILoadingStationConfig
+  | IMarkingMachineConfig
+  | ICleaningMachineConfig
+  | ISingleJointRobotConfig
+  | IRailConfig
+  | IResourceStoreConfig

package/dist/types/models/config.types.js

@@ -0,0 +1 @@
+import { EnumModel, EnumTag, EnumResourceType } from '../enums';

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

@@ -1,34 +1,100 @@
-import { EnumModel } from '../enums';
-import { IRowData } from '../base.types';
-import { ILightOperating, IProgressOperating, IEntranceOperating, IResourceOperating } from '../components/operating.types';
+import { EnumModel, EnumResourceType } from '../enums'
+import type { IRowData } from '../base.types'
+import type {
+  ILightOperating,
+  IProgressOperating,
+  IEntranceOperating,
+  IResourceOperating
+} from '../components/operating.types'
 /**
  * 设备运转基类
  */
 export interface IModelOperating {
-    id: string;
-    className: EnumModel;
-    rawData: IRowData;
-    resource?: IResourceOperating;
+  id: string
+  className: EnumModel
+  rawData: IRowData
+  resource?: IResourceOperating
 }
 /**
  * 机床运转状态
  */
 export interface IMachineToolOperating extends IModelOperating {
-    className: EnumModel.MACHINE_TOOL;
-    light?: ILightOperating;
-    progress?: IProgressOperating;
-    entrance?: IEntranceOperating;
+  className: EnumModel.MACHINE_TOOL
+  light?: ILightOperating
+  progress?: IProgressOperating
+  entrance?: IEntranceOperating
+  stationRotatable?: boolean
 }
 /**
- * 单手夹爪机器人运转状态
+ * 装载站运转状态
+ */
+export interface ILoadingStationOperating extends IModelOperating {
+  className: EnumModel.LOADING_STATION
+  light?: Omit<ILightOperating, 'rotating'>
+  progress?: IProgressOperating
+  entrance?: IEntranceOperating
+  stationRotatable?: boolean
+}
+/**
+ * 打标机站点状态
+ */
+export interface ILaserSiteState {
+  site: number
+  active: boolean
+}
+/**
+ * 打标机运转状态
+ */
+export interface IMarkingMachineOperating extends IModelOperating {
+  className: EnumModel.MARKING_MACHINE
+  light?: Omit<ILightOperating, 'rotating'>
+  progress?: IProgressOperating
+  entrance?: IEntranceOperating
+  laserSiteNumberArray?: ILaserSiteState[]
+}
+/**
+ * 清洗机运转状态
+ */
+export interface ICleaningMachineOperating extends IModelOperating {
+  className: EnumModel.CLEANING_MACHINE
+  light?: Omit<ILightOperating, 'rotating'>
+  progress?: IProgressOperating
+  entrance?: IEntranceOperating
+}
+/**
+ * 单关节机器人运转状态
  */
 export interface ISingleGripperRobotOperating extends IModelOperating {
-    className: EnumModel.SINGLE_GRIPPER_ROBOT;
-    light: ILightOperating;
-    x: number;
-    y: number;
+  className: EnumModel.SINGLE_JOINT_ROBOT
+  light?: ILightOperating
+  x?: number
+  y?: number
+  r?: number
+  currentFixture?: EnumResourceType
+}
+/**
+ * 轨道运转状态
+ */
+export interface IRailOperating extends IModelOperating {
+  className: EnumModel.RAIL
+  x?: number
+  botId?: string
+}
+/**
+ * 资源库运转状态
+ */
+export interface IResourceStoreOperating extends IModelOperating {
+  className: EnumModel.RESOURCE_STORE
+  light?: ILightOperating
 }
 /**
  * 设备层运转状态的联合类型
  */
-export type ILayerOperating = IMachineToolOperating | ISingleGripperRobotOperating;
+export type ILayerOperating =
+  | IMachineToolOperating
+  | ILoadingStationOperating
+  | IMarkingMachineOperating
+  | ICleaningMachineOperating
+  | ISingleGripperRobotOperating
+  | IRailOperating
+  | IResourceStoreOperating

package/dist/types/models/operating.types.js

@@ -0,0 +1 @@
+import { EnumModel, EnumResourceType } from '../enums';

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

@@ -1,11 +1,18 @@
-import { IComponent, IComponentOperating } from '../../types';
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : ComponentAbs.ts
+ * @Date   : 2026/02/13
+ * @Desc.  : 抽象类：子组件（Model-View 分离）
+ */
+import type { IComponent, IComponentOperating } from '@/types';
 import { UI } from 'leafer';
 export declare abstract class ComponentAbs<T extends IComponent = IComponent> {
     _ui: UI | null;
     private _config;
     private _initialized;
     constructor(options: T);
-    get ui(): UI<import('leafer').IUIInputData>;
+    get ui(): UI<import("leafer").IUIInputData>;
     get config(): T;
     protected get width_05(): number;
     protected get height_05(): number;

package/dist/ui/abstract/ComponentAbs.js

@@ -0,0 +1,64 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : ComponentAbs.ts
+ * @Date   : 2026/02/13
+ * @Desc.  : 抽象类：子组件（Model-View 分离）
+ */
+import { UI } from 'leafer';
+import { cloneDeep } from '@jnrs/shared/lodash';
+export class ComponentAbs {
+    _ui = null;
+    _config;
+    _initialized = false;
+    constructor(options) {
+        this._config = cloneDeep(options);
+    }
+    get ui() {
+        if (!this._ui) {
+            throw new Error('访问 ui 失败：UI 实例未创建，请先调用 init() 方法');
+        }
+        return this._ui;
+    }
+    get config() {
+        return this._config;
+    }
+    // 宽度计算 - 50%（中心点）
+    get width_05() {
+        return this.config.width * 0.5;
+    }
+    // 高度计算 - 50%（中心点）
+    get height_05() {
+        return this.config.height * 0.5;
+    }
+    // 设备操作
+    operating(data) { }
+    // 初始化 UI（必须在 setEventHandler 之前调用）
+    init() {
+        if (this._initialized) {
+            console.warn('元素已经初始化，重复初始化');
+            return this;
+        }
+        this._ui = this.createUi();
+        this._initialized = true;
+        return this;
+    }
+    // 处理设备操作
+    handleOperation = (data) => {
+        this.operating(data);
+    };
+    // 销毁 UI 和事件绑定
+    destroyUI() {
+        if (!this._initialized) {
+            console.warn('销毁失败，元素未初始化');
+            return;
+        }
+        this.ui.destroy();
+        this._initialized = false;
+    }
+    // 销毁
+    destroy() {
+        this.destroyUI();
+        this._ui = null;
+    }
+}

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

@@ -1,4 +1,12 @@
-import { ILayer, IEventHandler, ILayerOperating } from '../../types';
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : ModelAbs.ts
+ * @Date   : 2026/02/13
+ * @Desc.  : 抽象类：设备
+ * @Intro. : Model-View 分离架构
+ */
+import type { ILayer, IEventHandler, ILayerOperating } from '@/types';
 import { UI } from 'leafer';
 export declare abstract class ModelAbs<T extends ILayer = ILayer> {
     _ui: UI | null;
@@ -6,9 +14,11 @@ export declare abstract class ModelAbs<T extends ILayer = ILayer> {
     private eventHandler;
     private _initialized;
     constructor(options: T);
-    get ui(): UI<import('leafer').IUIInputData>;
+    get ui(): UI<import("leafer").IUIInputData>;
     get config(): T;
     protected get width_05(): number;
+    protected get width_02(): number;
+    protected get width_08(): number;
     protected get height_05(): number;
     protected abstract createUi(): UI;
     protected abstract operating(data: ILayerOperating): void;

package/dist/ui/abstract/ModelAbs.js

@@ -0,0 +1,119 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : ModelAbs.ts
+ * @Date   : 2026/02/13
+ * @Desc.  : 抽象类：设备
+ * @Intro. : Model-View 分离架构
+ */
+import { UI, PointerEvent, DragEvent } from 'leafer';
+import { cloneDeep, debounce } from '@jnrs/shared/lodash';
+const DEBOUNCE_TIME = 300; // 防抖时间 300ms
+export class ModelAbs {
+    _ui = null;
+    _config;
+    eventHandler = null;
+    _initialized = false;
+    constructor(options) {
+        this._config = cloneDeep(options);
+    }
+    get ui() {
+        if (!this._ui) {
+            throw new Error('访问 ui 失败：UI 实例未创建，请先调用 init() 方法');
+        }
+        return this._ui;
+    }
+    get config() {
+        return this._config;
+    }
+    // 宽度计算 - 50%（中心点）
+    get width_05() {
+        return this.config.width * 0.5;
+    }
+    get width_02() {
+        return this.config.width * 0.2;
+    }
+    get width_08() {
+        return this.config.width * 0.8;
+    }
+    // 高度计算 - 50%（中心点）
+    get height_05() {
+        return this.config.height * 0.5;
+    }
+    // 初始化 UI（必须在 setEventHandler 之前调用）
+    init() {
+        if (this._initialized) {
+            console.warn('元素已经初始化，重复初始化');
+            return this;
+        }
+        this._ui = this.createUi();
+        this._initialized = true;
+        return this;
+    }
+    // 处理设备操作
+    handleOperation = (data) => {
+        this.operating(data);
+    };
+    // 赋值函数，用于判断是否注册交互事件
+    shouldHandleInteraction(e, selfEnabled) {
+        const isTargetSelf = e.target === this.ui;
+        // 情况1禁止注册: hitSelf 为 false，且点击的是自身
+        if (!this.config.hitSelf && isTargetSelf)
+            return false;
+        // 情况2禁止注册: 点击、右击、移动等交互的是自身，但自身不可点击、右击、移动等
+        if (isTargetSelf && !selfEnabled)
+            return false;
+        return true;
+    }
+    // 点击事件回调
+    tapCallback = debounce((e) => {
+        if (!this.shouldHandleInteraction(e, this.config.clickable))
+            return;
+        this.eventHandler?.onTap?.(this.config, e.target.data);
+    }, DEBOUNCE_TIME);
+    // 右键点击事件回调
+    menuTapCallback = debounce((e) => {
+        if (!this.shouldHandleInteraction(e, this.config.menuClickable))
+            return;
+        this.eventHandler?.onMenuTap?.(this.config, e.target.data);
+    }, DEBOUNCE_TIME);
+    // 拖拽事件回调
+    dragCallback = (e) => {
+        if (!this.shouldHandleInteraction(e, this.config.draggable))
+            return;
+        this.eventHandler?.onDragEnd?.(this.config, e.target.data);
+    };
+    // 注册事件（事件委托模式）
+    setEventHandler(handler) {
+        // 不可交互时不注册自定义事件（不在 UI 上设置 hittable 属性，防止编辑模式下无法选中设备）
+        if (!this.config.hittable)
+            return;
+        this.eventHandler = handler;
+        if (Object.hasOwn(handler, 'onTap')) {
+            this.ui.on(PointerEvent.TAP, this.tapCallback);
+        }
+        if (Object.hasOwn(handler, 'onMenuTap')) {
+            this.ui.on(PointerEvent.MENU_TAP, this.menuTapCallback);
+        }
+        if (Object.hasOwn(handler, 'onDragEnd')) {
+            this.ui.on(DragEvent.END, this.dragCallback);
+        }
+    }
+    // 销毁 UI 和事件绑定
+    destroyUI() {
+        if (!this._initialized) {
+            console.warn('销毁失败，元素未初始化');
+            return;
+        }
+        this.ui.off(PointerEvent.TAP, this.tapCallback);
+        this.ui.off(PointerEvent.MENU_TAP, this.menuTapCallback);
+        this.ui.off(DragEvent.END, this.dragCallback);
+        this.ui.destroy();
+        this._initialized = false;
+    }
+    // 销毁
+    destroy() {
+        this.destroyUI();
+        this._ui = null;
+    }
+}

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

@@ -1,5 +1,12 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : Entrance.ts
+ * @Date   : 2025/01/18
+ * @desc.  : 设备入口
+ */
 import { Box } from 'leafer';
-import { IEntranceConfig, IEntranceOperating } from '../../types';
+import { type IEntranceConfig, type IEntranceOperating } from '@/types';
 import { ComponentAbs } from '../abstract/ComponentAbs';
 export declare class Entrance extends ComponentAbs<IEntranceConfig> {
     constructor(options: IEntranceConfig);