@jnrs/lingshu-smart 2.2.36 → 2.2.38

package/AGENTS.md

@@ -501,7 +501,7 @@ type ILayerOperating =
 | `IRGVOperating`              | `RGV`                | `light?`, `x?`, `j1?`, `forkXY?`, `forkZ?`, `resource?`            | 双状态灯、轨道位移、旋转、货叉 XY/Z、双工位槽      | `Rgv`              |
 | `IRailOperating`             | `RAIL`               | `x?`, `botId?`                                                     | 拖链动画（关联 botId 的设备移动时拖链跟随）        | `Rail`             |
 | `IResourceStoreOperating`    | `RESOURCE_STORE`     | `light?`, `x?`, `resource?`                                        | 状态灯、轨道位移、托盘/刀具工位槽                  | `ResourceStore`    |
-| `IPalletOperating`           | `PALLET`             | `light?`, `x?`, `y?`                                               | 状态灯、X/Y 位移                                   | `Pallet`           |
+| `IPalletOperating`           | `PALLET`             | `light?`, `x?`, `y?`, `resource?`                                  | 状态灯、X/Y 位移、托盘/刀具工位槽                  | `Pallet`           |
 
 ### 子类型字段详情
 
@@ -611,11 +611,12 @@ type ILayerOperating =
 
 #### IPalletOperating
 
-| 属性    | 类型              | 说明                    |
-| ------- | ----------------- | ----------------------- |
-| `light` | `ILightOperating` | 状态灯                  |
-| `x`     | `number`          | 沿 X 轴移动位置（像素） |
-| `y`     | `number`          | 沿 Y 轴移动位置（像素） |
+| 属性       | 类型                 | 说明                    |
+| ---------- | -------------------- | ----------------------- |
+| `light`    | `ILightOperating`    | 状态灯                  |
+| `x`        | `number`             | 沿 X 轴移动位置（像素） |
+| `y`        | `number`             | 沿 Y 轴移动位置（像素） |
+| `resource` | `IResourceOperating` | 托盘/刀具工位槽资源增删 |
 
 ### 子组件运转类型（IComponentOperating）
 
@@ -636,6 +637,7 @@ type ILayerOperating =
 | -------------------------------- | ------------------------------ |
 | `@jnrs/lingshu-smart`            | 主模块，包含类型定义和工具函数 |
 | `@jnrs/lingshu-smart/components` | Vue 组件库（编辑器、预览器）   |
+| `@jnrs/lingshu-smart/stores`     | Pinia stores（data/editor/app/debug） |
 | `@jnrs/lingshu-smart/locales`    | 国际化配置                     |
 
 ---

package/README.md

@@ -136,7 +136,7 @@ ws.onmessage = (event) => {
 通过 `useDebugStore` 的 `setLocale` 方法切换语言，切换后库内所有组件文本实时更新：
 
 ```typescript
-import { useDebugStore } from '@jnrs/lingshu-smart/stores/useDebugStore'
+import { useDebugStore } from '@jnrs/lingshu-smart/stores'
 
 const debugStore = useDebugStore()
 
@@ -180,7 +180,7 @@ i18n.global.mergeLocaleMessage('ja', {
 ```typescript
 // 方案1：监听宿主语言变化，同步到库
 import { watch } from 'vue'
-import { useDebugStore } from '@jnrs/lingshu-smart/stores/useDebugStore'
+import { useDebugStore } from '@jnrs/lingshu-smart/stores'
 
 const debugStore = useDebugStore()
 watch(

package/dist/assets/data/editor_preset_menu.d.ts

@@ -1,2 +1,10 @@
 import { IEquipmentsMenu } from '../../types';
 export declare const EQUIPMENTS_MENU: IEquipmentsMenu[];
+/**
+ * 获取设备模型的默认宽高
+ * 用于布局面板的"重置"按钮，以及部件配置中"无部件时模型高度不低于默认值"的联动计算
+ */
+export declare function getModelDefaultSize(className?: string): {
+    width: number;
+    height: number;
+} | undefined;

package/dist/components/debug/WsProxy/MappingGrid.vue.d.ts

@@ -0,0 +1,32 @@
+import { FieldMapper } from './proxy';
+type __VLS_Props = {
+    /** 字段映射列表 */
+    mappers: FieldMapper[];
+    /** 画布字段是否可编辑（false=只读，true=可修改） */
+    targetFieldEditable?: boolean;
+    /** 是否已配置 dictFn（用于「字典 Label / 字典 Color」选项右侧 tag 显示） */
+    hasDictFn?: boolean;
+    /** 是否显示底部「画布字段修改 + 添加映射」栏（默认 true） */
+    showFooter?: boolean;
+    /** 底部栏是否包含「画布字段修改」开关（默认 true；Resource 区域在组外统一控制时传 false） */
+    showToggle?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    add: () => any;
+    remove: (idx: number) => any;
+    update: () => any;
+    "update:targetFieldEditable": (value: boolean) => any;
+    "open-condition": (mapper: FieldMapper) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAdd?: (() => any) | undefined;
+    onRemove?: ((idx: number) => any) | undefined;
+    onUpdate?: (() => any) | undefined;
+    "onUpdate:targetFieldEditable"?: ((value: boolean) => any) | undefined;
+    "onOpen-condition"?: ((mapper: FieldMapper) => any) | undefined;
+}>, {
+    targetFieldEditable: boolean;
+    hasDictFn: boolean;
+    showFooter: boolean;
+    showToggle: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/components/debug/WsProxy/proxy.d.ts

@@ -39,29 +39,14 @@ export interface FieldMapper {
  *  @param type  'label' 字典Label / 'color' 字典Color
  *  @returns 转换后的字符串值，赋值给画布字段 */
 export type DictFn = (name: string, value: string | number | undefined, type: 'label' | 'color') => string;
-/** 资源操作字段配置：定义 payload 中各字段的来源路径 */
-export interface ResourceFieldConfig {
-    /** 资源 className 的源字段路径（如 addType / removeType） */
-    className: string;
-    /** 资源 ID 的源字段路径（如 addId / removeId） */
-    id: string;
-    /** 资源类型的源字段路径（如 resourceType） */
-    resourceType: string;
-    /** 资源 ID 的源字段路径（用于全局查找匹配，如 resourceId） */
-    resourceId?: string;
-    /** 工位索引的源字段路径（如 addSiteNumber / removeSiteNumber） */
-    index: string;
-    /** 资源名称的源字段路径（仅 add 需要，如 name） */
-    name?: string;
-    /** 资源颜色的源字段路径（仅 add 需要，如 displayColor） */
-    color?: string;
-}
-/** 资源增删字段映射：分别配置 add / remove 两组字段来源 */
+/** 资源增删字段映射：分别配置 add / remove 两组动态字段映射
+ *  目标路径支持点号嵌套，className / id 为目标设备匹配字段，resource.* 为资源对象字段
+ *  （如 resource.resourceType / resource.index），未配置时使用内置默认映射 */
 export interface ResourceFieldMap {
-    /** 新增资源字段映射（不需要新增时可不配置） */
-    add?: ResourceFieldConfig;
-    /** 移除资源字段映射（不需要移除时可不配置） */
-    remove?: ResourceFieldConfig;
+    /** 新增资源字段映射列表（无需新增时可不配置或为空数组） */
+    add?: FieldMapper[];
+    /** 移除资源字段映射列表（无需移除时可不配置或为空数组） */
+    remove?: FieldMapper[];
 }
 /** 全局操作字段配置（operate: 'global' 时生效） */
 export interface GlobalFieldConfig {
@@ -82,8 +67,8 @@ export interface ProxyRule {
     operate: 'single' | 'resource' | 'global';
     /** 字段映射列表（operate: 'single' 时生效） */
     mappings: FieldMapper[];
-    /** 资源增删字段映射（operate: 'resource' 时生效，未配置时使用内置默认字段名） */
-    resourceFields?: ResourceFieldMap;
+    /** 资源增删字段映射（operate: 'resource' 时生效，未配置时使用内置默认字段映射） */
+    resourceMappings?: ResourceFieldMap;
     /** 全局操作字段映射（operate: 'global' 时生效） */
     globalFields?: GlobalFieldConfig;
 }
@@ -126,8 +111,9 @@ export declare function resolveMapper(payload: Record<string, unknown>, mapper:
 /** 根据单条规则构建 operating 对象（operate: 'single'） */
 export declare function buildOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn): ILayerOperating | null;
 /** 根据 Resource 规则构建资源增删 operating 列表（operate: 'resource'）
- *  字段来源由 rule.resourceFields 配置，未配置时使用内置默认字段名 */
-export declare function buildResourceOperating(payload: Record<string, unknown>, rule: ProxyRule): ILayerOperating[];
+ *  字段来源由 rule.resourceMappings.add / remove 动态映射配置，未配置时使用内置默认映射。
+ *  target 支持点号嵌套：className / id 为目标设备匹配字段，resource.* 为资源对象字段。 */
+export declare function buildResourceOperating(payload: Record<string, unknown>, rule: ProxyRule, scene?: IScene | null, dictFn?: DictFn): ILayerOperating[];
 /** 根据全局操作规则构建 operating（operate: 'global'）
  *  resourceIds 从源消息中按 globalFields.resourceIds 路径提取，为空时使用 payloadKey */
 export declare function buildGlobalOperating(msg: Record<string, unknown>, rule: ProxyRule, payloadKey: string): ILayerOperating[];
@@ -143,6 +129,10 @@ export declare function buildGlobalOperating(msg: Record<string, unknown>, rule:
  * @returns operating 列表（可能为空数组；非标准数组数据返回空数组由 @raw 处理）
  */
 export declare function applyProxy(rawMessage: unknown, rules: ProxyRule[], scene?: IScene | null, payloadKey?: string, sourceTypeField?: string, dictFn?: DictFn): ILayerOperating[];
+/** 资源新增字段默认映射（target 取自 IModelOperating + IResourceOperating，源字段名取自 ViewPageDemo.vue 中 Resource 操作的标准 payload 字段） */
+export declare const DEFAULT_RESOURCE_ADD_MAPPERS: FieldMapper[];
+/** 资源移除字段默认映射 */
+export declare const DEFAULT_RESOURCE_REMOVE_MAPPERS: FieldMapper[];
 /** 默认代理配置 */
 export declare function createDefaultConfig(): WsProxyConfig;
 /** 校验导入的配置结构是否合法 */

package/dist/components/editor/OptionCard/Equipment/stationSlot/StationSlotGroupDialog.vue.d.ts

@@ -6,6 +6,7 @@ interface Props {
     flowOptions?: IFlowConfig;
     stationSlots?: IStationSlotConfig[];
     hideBounds?: boolean;
+    visible?: boolean | 0;
     containerWidth?: number;
     containerHeight?: number;
 }
@@ -15,6 +16,7 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
         flowOptions: IFlowConfig;
         stationSlots: IStationSlotConfig[];
         hideBounds: boolean;
+        visible: boolean | 0;
     }) => any;
 }, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
@@ -22,11 +24,13 @@ declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, imp
         flowOptions: IFlowConfig;
         stationSlots: IStationSlotConfig[];
         hideBounds: boolean;
+        visible: boolean | 0;
     }) => any) | undefined;
 }>, {
     hideBounds: boolean;
     stationSlots: IStationSlotConfig[];
     flowOptions: IFlowConfig;
+    visible: boolean | 0;
     containerWidth: number;
     containerHeight: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;