@jnrs/lingshu-smart 2.2.33 → 2.2.35

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

@@ -1,18 +1,6 @@
 import { 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 config(): T;
-    protected get width_05(): number;
-    protected get height_05(): number;
-    protected abstract createUi(): UI;
-    protected operating(data: IComponentOperating): void;
-    init(): this;
+import { BaseAbs } from './BaseAbs';
+export declare abstract class ComponentAbs<T extends IComponent = IComponent> extends BaseAbs<T> {
+    protected operating(_data: IComponentOperating): void;
     handleOperation: (data: IComponentOperating) => void;
-    destroyUI(): void;
-    destroy(): void;
 }

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

@@ -1,28 +1,28 @@
 import { ILayer, IEventHandler, ILayerOperating } from '../../types';
-import { UI } from 'leafer';
-export declare abstract class ModelAbs<T extends ILayer = ILayer> {
-    _ui: UI | null;
-    private _config;
+import { StationSlotGroup } from '../components/StationSlotGroup';
+import { BaseAbs } from './BaseAbs';
+export declare abstract class ModelAbs<T extends ILayer = ILayer> extends BaseAbs<T> {
     private eventHandler;
-    private _initialized;
-    constructor(options: T);
-    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 get height_02(): number;
-    protected get height_08(): number;
-    protected abstract createUi(): UI;
     protected abstract operating(data: ILayerOperating): void;
-    init(): this;
     handleOperation: (data: ILayerOperating) => void;
     private shouldHandleInteraction;
     private tapCallback;
     private menuTapCallback;
     private dragCallback;
     setEventHandler(handler: IEventHandler): void;
+    /**
+     * 判断模型是否包含指定工位号
+     * 默认返回 false，由支持工位号的子类（如 ResourceStore）覆盖
+     */
+    containsStationIndex(_index: number): boolean;
+    /**
+     * 收集模型下所有工位槽组实例（子类覆盖；默认无）
+     */
+    protected collectStationSlotGroups(): StationSlotGroup[];
+    /**
+     * 按 resourceId 移除模型下匹配的资源（供全局批量移除调用）
+     * @returns 是否至少移除了一个资源
+     */
+    removeResourceById(resourceId: string): boolean;
     destroyUI(): void;
-    destroy(): void;
 }

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

@@ -10,6 +10,9 @@ export interface IRectLightOperating extends Omit<ILightOperating, 'rotating'> {
  * 圆形灯
  */
 export declare class EllipseLight extends ComponentAbs<IEllipseLight> {
+    private lastColor?;
+    private lastBlinking?;
+    private lastRotating?;
     constructor(options: IEllipseLight);
     protected createUi(): Box;
     operating(val: ILightOperating): void;
@@ -18,6 +21,8 @@ export declare class EllipseLight extends ComponentAbs<IEllipseLight> {
  * 矩形灯
  */
 export declare class RectLight extends ComponentAbs<ILightConfig> {
+    private lastColor?;
+    private lastBlinking?;
     constructor(options: ILightConfig);
     protected createUi(): Box;
     operating(val: IRectLightOperating): void;

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

@@ -3,6 +3,7 @@ import { Box } from 'leafer';
 import { ComponentAbs } from '../abstract/ComponentAbs';
 export declare class StationSlot extends ComponentAbs<IStationSlotConfig> {
     private children;
+    private pendingDestroy;
     constructor(options: IStationSlotConfig);
     protected createUi(): Box;
     private get autoFixRotation();
@@ -13,10 +14,14 @@ export declare class StationSlot extends ComponentAbs<IStationSlotConfig> {
      */
     addPallet(d: IResourceOperating): void;
     /**
-     * 移除托盘
-     * @param d
+     * 移除托盘：先播放退场动画，动画结束后再销毁资源对象
      */
     removeAllPallet(d?: IResourceOperating): void;
+    /**
+     * 按 resourceId 精确移除指定资源（同槽可含多个资源时使用）
+     * 仅移除匹配的资源，不影响同槽内其他资源；动画逻辑与 removeAllPallet 一致
+     */
+    removePalletById(resourceId: string): boolean;
     /**
      * 设置工位是否正在使用
      * @param flag

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

@@ -21,4 +21,9 @@ export declare class StationSlotGroup extends ComponentAbs<IStationSlotGroupConf
      * 操作方法：处理资源新增/移除
      */
     operating(val: IResourceOperating): void;
+    /**
+     * 按 resourceId 遍历所有工位槽，精确移除匹配的资源
+     * @returns 是否至少移除了一个资源
+     */
+    removeResourceById(resourceId: string): boolean;
 }

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

@@ -1,6 +1,7 @@
 import { ICleaningMachineConfig, ICleaningMachineOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 清洗机
  */
@@ -11,4 +12,5 @@ export declare class CleaningMachine extends ModelAbs<ICleaningMachineConfig> {
     private stationSlotGroup;
     protected createUi(): Box;
     protected operating(data: ICleaningMachineOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
 }

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

@@ -1,6 +1,7 @@
 import { IDoubleJointRobotConfig, IDoubleJointRobotOperating, EnumResourceType } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 双关节机器人（DoubleJointRobot）
  */
@@ -17,6 +18,7 @@ export declare class DoubleJointRobot extends ModelAbs<IDoubleJointRobotConfig>
     set currentFixture(type: EnumResourceType);
     protected createUi(): Box;
     protected operating(data: IDoubleJointRobotOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotateR1;
     private handleRotateR2;
     private moveX;

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

@@ -1,6 +1,7 @@
 import { ILoadingStationConfig, ILoadingStationOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 装载站（LoadingStation）
  */
@@ -13,4 +14,5 @@ export declare class LoadingStation extends ModelAbs<ILoadingStationConfig> {
     private stationSlotGroup;
     protected createUi(): Box;
     protected operating(data: ILoadingStationOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
 }

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

@@ -1,6 +1,7 @@
 import { IMachineToolConfig, IMachineToolOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 机床
  */
@@ -15,5 +16,6 @@ export declare class MachineTool extends ModelAbs<IMachineToolConfig> {
     private animating;
     protected createUi(): Box;
     protected operating(data: IMachineToolOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
     private rotateStationContainerWithAnimation;
 }

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

@@ -1,6 +1,7 @@
 import { IMarkingMachineConfig, IMarkingMachineOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 打标机
  */
@@ -11,6 +12,7 @@ export declare class MarkingMachine extends ModelAbs<IMarkingMachineConfig> {
     private stationSlotGroup;
     protected createUi(): Box;
     protected operating(data: IMarkingMachineOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
     private renderLaser;
     private setLaserWorking;
 }

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

@@ -1,6 +1,7 @@
 import { IResourceStoreConfig, IResourceStoreOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 资源库
  */
@@ -10,6 +11,12 @@ export declare class ResourceStore extends ModelAbs<IResourceStoreConfig> {
     private stationSlotGroupPallet;
     private stationSlotGroupTool;
     protected createUi(): Box;
+    /**
+     * 判断本资源库是否包含指定工位号
+     * 用于同一 id 的 ResourceStore 被拆分为多个 UI 时的三级匹配
+     */
+    containsStationIndex(index: number): boolean;
     private moveX;
     protected operating(data: IResourceStoreOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
 }

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

@@ -1,6 +1,7 @@
 import { IRGVConfig, IRGVOperating } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * RGV（轨道导引车）
  */
@@ -15,6 +16,7 @@ export declare class Rgv extends ModelAbs<IRGVConfig> {
     private stationSlotGroupTool;
     protected createUi(): Box;
     protected operating(data: IRGVOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotate;
     private moveX;
     /**

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

@@ -0,0 +1,21 @@
+import { IShuttleStationConfig, IShuttleStationOperating } from '../../types';
+import { Box } from 'leafer';
+import { ModelAbs } from '../abstract/ModelAbs';
+/**
+ * 接驳站（ShuttleStation）
+ * 整体为 U 型结构，通过单个 Path 元素一体化绘制，内部透明；
+ * U 型下方底部区域较宽大，用于放置铭牌与长条状态灯；
+ * 该模型仅支持 light 运转状态
+ */
+export declare class ShuttleStation extends ModelAbs<IShuttleStationConfig> {
+    private static readonly WALL_THICKNESS;
+    private static readonly BASE_HEIGHT;
+    private static readonly BOTTOM_RADIUS;
+    private static readonly LIGHT_Y_OFFSET;
+    private static readonly NAME_PLATE_Y_OFFSET;
+    private light;
+    private buildUPath;
+    private buildOutlinePath;
+    protected createUi(): Box;
+    protected operating(data: IShuttleStationOperating): void;
+}

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

@@ -1,6 +1,7 @@
 import { ISingleJointRobotConfig, ISingleJointRobotOperating, EnumResourceType } from '../../types';
 import { Box } from 'leafer';
 import { ModelAbs } from '../abstract/ModelAbs';
+import { StationSlotGroup } from '../components/StationSlotGroup';
 /**
  * 单关节机器人
  */
@@ -17,6 +18,7 @@ export declare class SingleJointRobot extends ModelAbs<ISingleJointRobotConfig>
     set currentFixture(type: EnumResourceType);
     protected createUi(): Box;
     protected operating(data: ISingleJointRobotOperating): void;
+    protected collectStationSlotGroups(): StationSlotGroup[];
     private handleRotate;
     private moveX;
     private switchFork;

package/dist/utils/debug-flags.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @File   : debug-flags.ts
+ * @Desc.  : 调试标志位工具，提供模块级动画开关状态
+ *           供 UI 组件直接导入使用，无需依赖 Pinia store
+ */
+/** 设置全局动画开关状态 */
+export declare function setAnimationsEnabled(enabled: boolean): void;
+/** 获取当前动画开关状态 */
+export declare function isAnimationsEnabled(): boolean;

package/dist/utils/formatOperating.d.ts

@@ -0,0 +1,7 @@
+import { ILayerOperating } from '../types';
+/**
+ * 将 ILayerOperating 格式化为结构化自然语言
+ * @param data 设备运转数据
+ * @returns 自然语言描述，如 "运行灯:绿色/旋转, 进度条:45%, 运行中, 上下料:上料"
+ */
+export declare function formatOperating(data: ILayerOperating): string;

package/dist/utils/index.d.ts

@@ -1,10 +1,5 @@
-/**
- * @Author : TanRui
- * @WeChat : Tan578853789
- * @File   : index.ts
- * @Date   : 2025/04/29
- * @Desc.  : 工具类
- */
+import { IScene } from '../types';
+export * from './logger';
 /**
  * 数字生成器
  * @param {*} start 起始值
@@ -18,11 +13,11 @@ export declare function numberLoopGenerator(start: number, end: number, shouldLo
  * @param {*} x 初始值
  * @param {*} y 结束值
  * @param {*} n 递增时长
- * @param {*} rate 帧率（别低于100否则进度条动画来不及显示)
+ * @param {*} rate 帧率（别低于100否则进度条动画来不及显示)，仅作为兼容参数保留，实际使用 rAF
  * @param {*} callback 回调函数
  * @returns
  */
-export declare const linearIncrease: (x: number | undefined, y: number | undefined, n: number | undefined, rate: number | undefined, callback: (val: number | string) => void) => false | Promise<unknown>;
+export declare const linearIncrease: (x: number | undefined, y: number | undefined, n: number | undefined, _rate: number | undefined, callback: (val: number | string) => void) => false | Promise<void>;
 /**
  * 根据百分比数字转换为像素，或者根据像素转换为百分比
  * @param {number} val - 百分比数字（范围 0 ~ 1），或者像素数字
@@ -33,12 +28,21 @@ export declare const linearIncrease: (x: number | undefined, y: number | undefin
  */
 export declare function transPercentAndPixel(val?: number, size?: number, precision?: number, getPercent?: boolean): number;
 export declare function transFraction(val?: number, size?: number): number;
-export declare function transRuntimeToPixel(val: number, precision?: number, type?: 'width' | 'height'): number;
+/**
+ * 将运行时百分比数值转换为像素数值
+ * @param val - 运行时百分比数值（范围 [0,1]）
+ * @param scene - 场景配置，用于计算转换比例
+ * @param precision - 保留的小数位数
+ * @param type - 转换类型，'width' 或 'height'
+ * @returns 转换后的像素值
+ */
+export declare function transRuntimeToPixel(val: number, scene: IScene | null | undefined, precision: number, type: 'width' | 'height'): number;
 /**
  * 百分比转换为像素数值
- * @param {number} percent - 百分比数字（范围 [0,1] ）
- * @param {number} [precision=0] - 保留的小数位数，默认为 0
- * @param {string} [type='width'] - 转换类型，'width' 或 'height'，默认 'width'
- * @returns {number} 转换后的像素值
+ * @param percent - 百分比数字（范围 [0,1]）
+ * @param scene - 场景配置，用于计算转换比例
+ * @param precision - 保留的小数位数
+ * @param type - 转换类型，'width' 或 'height'
+ * @returns 转换后的像素值
  */
-export declare function transPercentToPixel(percent: number, precision?: number, type?: 'width' | 'height'): number;
+export declare function transPercentToPixel(percent: number, scene: IScene | null | undefined, precision: number, type: 'width' | 'height'): number;

package/dist/utils/logger.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @File   : logger.ts
+ * @Desc.  : 统一日志工具，按环境控制输出，支持 tag 着色 / LogLevel 过滤
+ */
+/** 日志方法类型（对应 console 方法，operating 为自定义追踪级别） */
+type LogMethod = 'log' | 'info' | 'warn' | 'error' | 'operating';
+/** 日志显示等级，none 表示全部静默，operating 为最详细级别（含 UI 模型操作追踪），operating-only 仅显示 operating + error */
+export type LogLevel = LogMethod | 'none' | 'operating-only';
+/** 设置全局日志显示等级 */
+export declare function setLogLevel(level: LogLevel): void;
+/** 获取当前日志显示等级 */
+export declare function getLogLevel(): LogLevel;
+export interface Logger {
+    log: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    operating: (...args: unknown[]) => void;
+}
+export declare function createLogger(tag?: string): Logger;
+export declare const logger: Logger;
+export {};

package/dist/utils/performance-stats.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @File   : performance-stats.ts
+ * @Desc.  : 性能统计工具，记录页面运行时间、WebSocket 数据接收量、FPS 和连接状态
+ *           统计节点从页面刷新（模块加载）开始
+ */
+/** 性能统计数据 */
+interface PerformanceStats {
+    /** 会话开始时间戳 */
+    sessionStart: number;
+    /** WebSocket 消息接收次数 */
+    wsCount: number;
+    /** WebSocket 消息接收总字节数 */
+    wsSize: number;
+    /** 当前帧率 (FPS) */
+    fps: number;
+    /** WebSocket 是否已连接 */
+    wsConnected: boolean;
+}
+export declare const performanceStats: PerformanceStats;
+/** 设置 WebSocket 连接状态 */
+export declare function setWebSocketConnected(connected: boolean): void;
+/** 启动 FPS 监测（全局只启动一次） */
+export declare function startPerformanceMonitor(): void;
+/** 停止 FPS 监测 */
+export declare function stopPerformanceMonitor(): void;
+/** 记录一次 WebSocket 消息接收 */
+export declare function trackWebSocketMessage(data: unknown): void;
+/** 获取会话持续运行时长（毫秒） */
+export declare function getSessionDuration(): number;
+/** 格式化时长，超过 24 小时时显示天数，如 "1天 23:03:22" */
+export declare function formatDuration(ms: number): string;
+/** 格式化数字，添加千位分隔符 */
+export declare function formatCount(n: number): string;
+/** 格式化字节大小 */
+export declare function formatSize(bytes: number): string;
+/** 格式化时间戳为本地时间字符串 */
+export declare function formatStartTime(ts: number): string;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jnrs/lingshu-smart",
-  "version": "2.2.33",
+  "version": "2.2.35",
   "description": "LingShu Smart 2D Digital Twin System.",
   "keywords": [
     "jnrs",
@@ -17,7 +17,9 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "sideEffects": true,
+  "sideEffects": [
+    "./dist/components/index.js"
+  ],
   "files": [
     "dist",
     "README.md",
@@ -46,7 +48,7 @@
     "pinia-plugin-persistedstate": "^4.7.1",
     "vue": "^3.5.22",
     "vue-i18n": "^9.14.5",
-    "@jnrs/shared": "1.1.34"
+    "@jnrs/shared": "1.1.36"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",