Merge pull request #3050 from alibaba/chore/update-codeowners

chore: update code owners

.github/CODEOWNERS

@@ -2,7 +2,7 @@
 
 # These owners will be the default owners for everything in
 # the repo. Unless a later match takes precedence
-* @liujuping @JackLian
+* @liujuping @1ncounter
 
 /modules/material-parser @akirakai
-/modules/code-generator @leoyuan
+/modules/code-generator @qingniaotonghua

.github/workflows/pre build.yml

@@ -0,0 +1,34 @@
+name: Pre Build
+
+on:
+  push:
+    paths:
+      - 'packages/**'
+      - '!packages/**.md'
+  pull_request:
+    paths:
+      - 'packages/**'
+      - '!packages/**.md'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    - name: Install dependencies and setup
+      run: npm install && npm run setup
+
+    - name: Build
+      run: npm run build
+
+    - name: Check build status
+      run: |
+        if [ $? -eq 0 ]; then
+          echo "Build succeeded!"
+        else
+          echo "Build failed!"
+          exit 1
+        fi

.github/workflows/publish docs.yml

@@ -0,0 +1,53 @@
+name: Update and Publish Docs
+
+on:
+  push:
+    branches:
+      - develop
+    paths:
+      - 'docs/docs/**'
+  workflow_dispatch:
+
+jobs:
+  publish-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          ref: 'develop'
+          node-version: '16'
+          registry-url: 'https://registry.npmjs.org'
+      - run: cd docs && npm install
+      - run: |
+          cd docs
+          npm version patch
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add package.json
+          git commit -m "chore(docs): publish documentation"
+          git push
+      - run: cd docs && npm run build && npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Get version
+        id: get_version
+        run: echo "version=$(node -p "require('./docs/package.json').version")" >> $GITHUB_OUTPUT
+
+  comment-pr:
+    needs: publish-docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Comment on PR
+        if: github.event_name == 'pull_request' && github.event.action == 'closed' && github.event.pull_request.merged == true
+        uses: actions/github-script@v4
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            github.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '🚀 New version has been released: ' + '${{ needs.publish-docs.outputs.version }}'
+            })

.github/workflows/publish engine beta.yml

@@ -0,0 +1,30 @@
+name: Publish Engine Beta
+
+on:
+  push:
+    branches:
+      - 'release/[0-9]+.[0-9]+.[0-9]+-beta'
+    paths:
+      - 'packages/**'
+
+jobs:
+  publish-engine:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '14'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm install && npm run setup
+      - run: |
+          npm run build
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+      - run: npm run pub:prerelease
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Get version
+        id: get_version
+        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT

.github/workflows/publish engine.yml

@@ -0,0 +1,33 @@
+name: Publish Engine
+
+on:
+  workflow_dispatch:
+    inputs:
+      publishCommand:
+        description: 'publish command'
+        required: true
+
+jobs:
+  publish-engine:
+    runs-on: ubuntu-latest
+    if: >-
+      contains(github.ref, 'refs/heads/release/') &&
+      (github.actor == '1ncounter' || github.actor == 'liujuping')
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '16'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm install && npm run setup
+      - run: |
+          npm run build
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+      - run: npm run ${{ github.event.inputs.publishCommand }}
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Get version
+        id: get_version
+        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT

.github/workflows/test packages.yml

@@ -105,4 +105,36 @@ jobs:
         run: npm i && npm run setup:skip-build
 
       - name: test
-        run: cd packages/utils && npm test
+        run: cd packages/utils && npm test
+
+  test-editor-core:
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+
+      - uses: actions/setup-node@v2
+        with:
+          node-version: '14'
+
+      - name: install
+        run: npm i && npm run setup:skip-build
+
+      - name: test
+        run: cd packages/editor-core && npm test
+
+  test-plugin-command:
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+
+      - uses: actions/setup-node@v2
+        with:
+          node-version: '14'
+
+      - name: install
+        run: npm i && npm run setup:skip-build
+
+      - name: test
+        run: cd packages/plugin-command && npm test

.gitignore

@@ -108,3 +108,5 @@ typings/
 # codealike
 codealike.json
 .node
+
+.must.config.js

docs/docs/api/canvas.md

@@ -1,6 +1,6 @@
 ---
 title: canvas - 画布 API
-sidebar_position: 12
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiCanvas](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/canvas.ts)<br/>

docs/docs/api/command.md

@@ -0,0 +1,101 @@
+---
+title: command - 指令 API
+sidebar_position: 10
+---
+
+
+
+## 模块概览
+
+该模块使得与命令系统的交互成为可能，提供了一种全面的方式来处理、执行和管理应用程序中的命令。
+
+
+
+## 接口
+
+### IPublicApiCommand
+
+与命令交互的接口。它提供了注册、注销、执行和管理命令的方法。
+
+
+
+## 方法
+
+### registerCommand
+
+注册一个新命令及其处理函数。
+
+```
+typescriptCopy code
+/**
+ * 注册一个新的命令及其处理程序。
+ * @param command {IPublicTypeCommand} - 要注册的命令。
+ */
+registerCommand(command: IPublicTypeCommand): void;
+```
+
+### unregisterCommand
+
+注销一个已存在的命令。
+
+```
+typescriptCopy code
+/**
+ * 注销一个已存在的命令。
+ * @param name {string} - 要注销的命令的名称。
+ */
+unregisterCommand(name: string): void;
+```
+
+### executeCommand
+
+根据名称和提供的参数执行命令，确保参数符合命令的定义。
+
+```
+typescriptCopy code
+/**
+ * 根据名称和提供的参数执行命令。
+ * @param name {string} - 要执行的命令的名称。
+ * @param args {IPublicTypeCommandHandlerArgs} - 命令的参数。
+ */
+executeCommand(name: string, args?: IPublicTypeCommandHandlerArgs): void;
+```
+
+### batchExecuteCommand
+
+批量执行命令，在所有命令执行后进行重绘，历史记录中只记录一次。
+
+```
+typescriptCopy code
+/**
+ * 批量执行命令，随后进行重绘，历史记录中只记录一次。
+ * @param commands {Array} - 命令对象的数组，包含名称和可选参数。
+ */
+batchExecuteCommand(commands: { name: string; args?: IPublicTypeCommandHandlerArgs }[]): void;
+```
+
+### listCommands
+
+列出所有已注册的命令。
+
+```
+typescriptCopy code
+/**
+ * 列出所有已注册的命令。
+ * @returns {IPublicTypeListCommand[]} - 已注册命令的数组。
+ */
+listCommands(): IPublicTypeListCommand[];
+```
+
+### onCommandError
+
+为命令执行过程中的错误注册错误处理回调函数。
+
+```
+typescriptCopy code
+/**
+ * 为命令执行过程中的错误注册一个回调函数。
+ * @param callback {(name: string, error: Error) => void} - 错误处理的回调函数。
+ */
+onCommandError(callback: (name: string, error: Error) => void): void;
+```

docs/docs/api/common.md

@@ -1,6 +1,6 @@
 ---
 title: common - 通用 API
-sidebar_position: 11
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiCommon](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/common.ts)<br/>
@@ -82,7 +82,7 @@ executeTransaction(fn: () => void, type: IPublicEnumTransitionType): void;
 ```
 **@since v1.0.16**
 
-##### 示例
+**示例**
 ```typescript
 import { common } from '@alilc/lowcode-engine';
 import { IPublicEnumTransitionType } from '@alilc/lowcode-types';
@@ -132,7 +132,8 @@ createIntl(instance: string | object): {
 
 **@since v1.0.17**
 
-##### 示例
+**示例**
+
 ```typescript
 import { common } from '@alilc/lowcode-engine';
 import enUS from './en-US.json';
@@ -145,6 +146,22 @@ const { intl, getLocale, setLocale } = common.utils.createIntl({
 
 ```
 
+#### intl
+
+i18n 转换方法
+
+```typescript
+/**
+ * i18n 转换方法
+ */
+intl(data: IPublicTypeI18nData | string, params?: object): string;
+```
+
+**示例**
+```
+const title = common.utils.intl(node.title)
+```
+
 ### skeletonCabin
 #### Workbench
 编辑器框架 View

docs/docs/api/commonUI.md

@@ -0,0 +1,210 @@
+---
+title: commonUI - UI 组件库
+sidebar_position: 10
+---
+
+## 简介
+CommonUI API 是一个专为低代码引擎设计的组件 UI 库，使用它开发的插件，可以保证在不同项目和主题切换中能够保持一致性和兼容性。
+
+## 组件列表
+
+### Tip
+
+提示组件
+
+| 参数      | 说明         | 类型                                  | 默认值 |
+|-----------|--------------|---------------------------------------|--------|
+| className | className    | string (optional)                     |        |
+| children  | tip 的内容   | IPublicTypeI18nData \| ReactNode      |        |
+| direction | tip 的方向   | 'top' \| 'bottom' \| 'left' \| 'right' |        |
+
+
+### HelpTip
+
+带 help icon 的提示组件
+
+| 参数      | 说明   | 类型                              | 默认值 |
+|-----------|--------|-----------------------------------|--------|
+| help      | 描述   | IPublicTypeHelpTipConfig          |        |
+| direction | 方向   | IPublicTypeTipConfig['direction'] | 'top'  |
+| size      | 方向   | IconProps['size']                 | 'small'|
+
+### Title
+
+标题组件
+
+| 参数      | 说明       | 类型                        | 默认值 |
+|-----------|------------|-----------------------------|--------|
+| title     | 标题内容   | IPublicTypeTitleContent     |        |
+| className | className  | string (optional)           |        |
+| onClick   | 点击事件   | () => void (optional)       |        |
+
+### ContextMenu
+
+| 参数   | 说明                                               | 类型                               | 默认值 |
+|--------|----------------------------------------------------|------------------------------------|--------|
+| menus  | 定义上下文菜单的动作数组                           | IPublicTypeContextMenuAction[]     |        |
+| children | 组件的子元素                                      | React.ReactElement[]               |        |
+
+**IPublicTypeContextMenuAction Interface**
+
+| 参数       | 说明                                                         | 类型                                                                                                           | 默认值                                 |
+|------------|--------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|----------------------------------------|
+| name       | 动作的唯一标识符<br/>Unique identifier for the action         | string                                                                                                         |                                        |
+| title      | 显示的标题，可以是字符串或国际化数据<br/>Display title, can be a string or internationalized data | string \| IPublicTypeI18nData (optional)                |                                        |
+| type       | 菜单项类型<br/>Menu item type                                 | IPublicEnumContextMenuType (optional)                                                                          | IPublicEnumContextMenuType.MENU_ITEM  |
+| action     | 点击时执行的动作，可选<br/>Action to execute on click, optional | (nodes: IPublicModelNode[]) => void (optional)                                                                 |                                        |
+| items      | 子菜单项或生成子节点的函数，可选，仅支持两级<br/>Sub-menu items or function to generate child node, optional | Omit<IPublicTypeContextMenuAction, 'items'>[] \| ((nodes: IPublicModelNode[]) => Omit<IPublicTypeContextMenuAction, 'items'>[]) (optional) |                                        |
+| condition  | 显示条件函数<br/>Function to determine display condition      | (nodes: IPublicModelNode[]) => boolean (optional)                                                              |                                        |
+| disabled   | 禁用条件函数，可选<br/>Function to determine disabled condition, optional | (nodes: IPublicModelNode[]) => boolean (optional)                                                              |                                        |
+
+**ContextMenu 示例**
+
+```typescript
+const App = () => {
+  const menuItems: IPublicTypeContextMenuAction[] = [
+    {
+      name: 'a',
+      title: '选项 1',
+      action: () => console.log('选项 1 被点击'),
+    },
+    {
+      name: 'b',
+      title: '选项 2',
+      action: () => console.log('选项 2 被点击'),
+    },
+  ];
+
+  const ContextMenu = ctx.commonUI.ContextMenu;
+
+  return (
+    <div>
+      <ContextMenu menus={menuItems}>
+        <div>右键点击这里</div>
+      </ContextMenu>
+    </div>
+  );
+};
+
+export default App;
+```
+
+**ContextMenu.create 示例**
+
+```typescript
+const App = () => {
+  const menuItems: IPublicTypeContextMenuAction[] = [
+    {
+      name: 'a',
+      title: '选项 1',
+      action: () => console.log('选项 1 被点击'),
+    },
+    {
+      name: 'b',
+      title: '选项 2',
+      action: () => console.log('选项 2 被点击'),
+    },
+  ];
+
+  const ContextMenu = ctx.commonUI.ContextMenu;
+
+  return (
+    <div>
+      <div onClick={(e) => {
+      	ContextMenu.create(menuItems, e);
+      }}>点击这里</div>
+    </div>
+  );
+};
+
+export default App;
+```
+
+### Balloon
+
+详细文档： [Balloon Documentation](https://fusion.design/pc/component/balloon)
+
+### Breadcrumb
+详细文档： [Breadcrumb Documentation](https://fusion.design/pc/component/breadcrumb)
+
+### Button
+详细文档： [Button Documentation](https://fusion.design/pc/component/button)
+
+### Card
+详细文档：[Card Documentation](https://fusion.design/pc/component/card)
+
+### Checkbox
+详细文档：[Checkbox Documentation](https://fusion.design/pc/component/checkbox)
+
+### DatePicker
+详细文档：[DatePicker Documentation](https://fusion.design/pc/component/datepicker)
+
+### Dialog
+详细文档：[Dialog Documentation](https://fusion.design/pc/component/dialog)
+
+### Dropdown
+详细文档：[Dropdown Documentation](https://fusion.design/pc/component/dropdown)
+
+### Form
+详细文档：[Form Documentation](https://fusion.design/pc/component/form)
+
+### Icon
+详细文档：[Icon Documentation](https://fusion.design/pc/component/icon)
+
+引擎默认主题支持的 icon 列表：https://fusion.design/64063/component/icon?themeid=20133
+
+
+### Input
+详细文档：[Input Documentation](https://fusion.design/pc/component/input)
+
+### Loading
+详细文档：[Loading Documentation](https://fusion.design/pc/component/loading)
+
+### Message
+详细文档：[Message Documentation](https://fusion.design/pc/component/message)
+
+### Overlay
+详细文档：[Overlay Documentation](https://fusion.design/pc/component/overlay)
+
+### Pagination
+详细文档：[Pagination Documentation](https://fusion.design/pc/component/pagination)
+
+### Radio
+详细文档：[Radio Documentation](https://fusion.design/pc/component/radio)
+
+### Search
+详细文档：[Search Documentation](https://fusion.design/pc/component/search)
+
+### Select
+详细文档：[Select Documentation](https://fusion.design/pc/component/select)
+
+### SplitButton
+详细文档：[SplitButton Documentation](https://fusion.design/pc/component/splitbutton)
+
+### Step
+详细文档：[Step Documentation](https://fusion.design/pc/component/step)
+
+### Switch
+详细文档：[Switch Documentation](https://fusion.design/pc/component/switch)
+
+### Tab
+详细文档：[Tab Documentation](https://fusion.design/pc/component/tab)
+
+### Table
+详细文档：[Table Documentation](https://fusion.design/pc/component/table)
+
+### Tree
+详细文档：[Tree Documentation](https://fusion.design/pc/component/tree)
+
+### TreeSelect
+详细文档：[TreeSelect Documentation](https://fusion.design/pc/component/treeselect)
+
+### Upload
+详细文档：[Upload Documentation](https://fusion.design/pc/component/upload)
+
+### Divider
+详细文档：[Divider Documentation](https://fusion.design/pc/component/divider)
+
+## 说明
+
+如果需要其他组件，可以提 issue 给我们。

docs/docs/api/config.md

@@ -1,6 +1,6 @@
 ---
 title: config - 配置 API
-sidebar_position: 8
+sidebar_position: 5
 ---
 
 > **@types** [IPublicModelEngineConfig](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/model/engine-config.ts)<br/>
@@ -24,7 +24,7 @@ sidebar_position: 8
  */
 get(key: string, defaultValue?: any): any;
 ```
-#### 示例
+**示例**
 ```typescript
 import { config } from '@alilc/lowcode-engine';
 
@@ -43,7 +43,7 @@ config.get('keyB', { a: 1 });
  */
 set(key: string, value: any): void;
 ```
-#### 示例
+**示例**
 ```typescript
 import { config } from '@alilc/lowcode-engine';
 
@@ -63,7 +63,7 @@ config.set('keyC', 1);
 has(key: string): boolean;
 ```
 
-#### 示例
+**示例**
 ```typescript
 import { config } from '@alilc/lowcode-engine';
 
@@ -81,7 +81,7 @@ config.has('keyD');
  */
 setConfig(config: { [key: string]: any }): void;
 ```
-#### 示例
+**示例**
 ```typescript
 import { config } from '@alilc/lowcode-engine';
 
@@ -134,7 +134,7 @@ config.getPreference().set(`${panelName}-pinned-status-isFloat`, false, 'skeleto
  */
 onceGot(key: string): Promise<any>;
 ```
-#### 示例
+**示例**
 ```typescript
 import { config } from '@alilc/lowcode-engine';
 
@@ -160,7 +160,7 @@ const value = await config.onceGot('keyA');
    */
   onGot(key: string, fn: (data: any) => void): () => void;
 ```
-#### 示例
+**示例**
 ```typescript
 import { config } from '@alilc/lowcode-engine';
 

docs/docs/api/configOptions.md

@@ -1,6 +1,6 @@
 ---
 title: config options - 配置列表
-sidebar_position: 13
+sidebar_position: 5
 ---
 
 > **@types** [IPublicTypeEngineOptions](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/engine-options.ts)<br/>
@@ -185,6 +185,12 @@ config.set('enableCondition', false)
 
 `@type {boolean}` `@default {false}`
 
+#### enableContextMenu - 开启右键菜单
+
+`@type {boolean}` `@default {false}`
+
+是否开启右键菜单
+
 #### disableDetecting
 
 `@type {boolean}` `@default {false}`
@@ -216,6 +222,12 @@ config.set('enableCondition', false)
 
 是否在只有一个 item 的时候隐藏设置 tabs
 
+#### hideComponentAction
+
+`@type {boolean}` `@default {false}`
+
+隐藏设计器辅助层
+
 #### thisRequiredInJSE
 
 `@type {boolean}` `@default {true}`

docs/docs/api/event.md

@@ -1,6 +1,6 @@
 ---
 title: event - 事件 API
-sidebar_position: 7
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiEvent](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/event.ts)<br/>

docs/docs/api/hotkey.md

@@ -1,6 +1,6 @@
 ---
 title:  hotkey - 快捷键 API
-sidebar_position: 5
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiHotkey](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/hotkey.ts)<br/>

docs/docs/api/init.md

@@ -1,6 +1,6 @@
 ---
 title: init - 初始化 API
-sidebar_position: 10
+sidebar_position: 0
 ---
 
 > **@since** v1.0.0

docs/docs/api/logger.md

@@ -1,6 +1,6 @@
 ---
 title: logger - 日志 API
-sidebar_position: 9
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiLogger](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/logger.ts)<br/>

docs/docs/api/material.md

@@ -1,6 +1,6 @@
 ---
 title: material - 物料 API
-sidebar_position: 2
+sidebar_position: 10
 ---
 
 > **@types** [IPublicApiMaterial](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/material.ts)<br/>
@@ -39,7 +39,7 @@ setAssets(assets: IPublicTypeAssetsJson): void;
 相关类型：[IPublicTypeAssetsJson](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/assets-json.ts)
 
 
-##### 示例
+**示例**
 直接在项目中引用 npm 包
 ```javascript
 import { material } from '@alilc/lowcode-engine';
@@ -85,7 +85,7 @@ getAssets(): IPublicTypeAssetsJson;
 相关类型：[IPublicTypeAssetsJson](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/assets-json.ts)
 
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine';
 
@@ -106,7 +106,7 @@ loadIncrementalAssets(incrementalAssets: IPublicTypeAssetsJson): Promise<void>;
 ```
 相关类型：[IPublicTypeAssetsJson](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/assets-json.ts)
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine';
 import assets1 from '@alilc/mc-assets-<siteId>/assets.json';
@@ -116,6 +116,21 @@ material.setAssets(assets1);
 material.loadIncrementalAssets(assets2);
 ```
 
+更新特定物料的描述文件
+
+```typescript
+import { material } from '@alilc/lowcode-engine';
+material.loadIncrementalAssets({
+  version: '',
+  components: [
+      {
+          "componentName": 'Button',
+          "props": [{ name: 'new', title: 'new', propType: 'string' }]
+      }
+  ],
+})
+```
+
 ### 设计器辅助层
 #### addBuiltinComponentAction
 在设计器辅助层增加一个扩展 action
@@ -131,7 +146,7 @@ addBuiltinComponentAction(action: IPublicTypeComponentAction): void;
 相关类型：[IPublicTypeComponentAction](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/component-action.ts)
 
 
-##### 示例
+**示例**
 新增设计扩展位，并绑定事件
 ```typescript
 import { material } from '@alilc/lowcode-engine';
@@ -171,7 +186,7 @@ removeBuiltinComponentAction(name: string): void;
 - lock：锁定，不可编辑
 - unlock：解锁，可编辑
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine';
 
@@ -207,7 +222,7 @@ modifyBuiltinComponentAction(
 
 
 
-##### 示例
+**示例**
 给原始的 remove 扩展时间添加执行前后的日志
 ```typescript
 import { material } from '@alilc/lowcode-engine';
@@ -222,7 +237,90 @@ material.modifyBuiltinComponentAction('remove', (action) => {
 });
 ```
 
+### 右键菜单项
+#### addContextMenuOption
+
+添加右键菜单项
+
+```typescript
+/**
+ * 添加右键菜单项
+ * @param action
+ */
+addContextMenuOption(action: IPublicTypeContextMenuAction): void;
+```
+
+示例
+
+```typescript
+import { IPublicEnumContextMenuType } from '@alilc/lowcode-types';
+
+material.addContextMenuOption({
+  name: 'parentItem',
+  title: 'Parent Item',
+  condition: (nodes) => true,
+  items: [
+    {
+      name: 'childItem1',
+      title: 'Child Item 1',
+      action: (nodes) => console.log('Child Item 1 clicked', nodes),
+      condition: (nodes) => true
+    },
+    // 分割线
+    {
+      type: IPublicEnumContextMenuType.SEPARATOR
+      name: 'separator.1'
+    }
+    // 更多子菜单项...
+  ]
+});
+
+```
+
+#### removeContextMenuOption
+
+删除特定右键菜单项
+
+```typescript
+/**
+ * 删除特定右键菜单项
+ * @param name
+ */
+removeContextMenuOption(name: string): void;
+```
+
+#### adjustContextMenuLayout
+
+调整右键菜单项布局，每次调用都会覆盖之前注册的调整函数，只有最后注册的函数会被应用。
+
+```typescript
+/**
+ * 调整右键菜单项布局
+ * @param actions
+ */
+adjustContextMenuLayout(fn: (actions: IPublicTypeContextMenuItem[]) => IPublicTypeContextMenuItem[]): void;
+```
+
+**示例**
+
+通过 adjustContextMenuLayout 补充分割线
+
+```typescript
+material.adjustContextMenuLayout((actions: IPublicTypeContextMenuAction) => {
+  const names = ['a', 'b'];
+  const newActions = [];
+  actions.forEach(d => {
+    newActions.push(d);
+    if (names.include(d.name)) {
+      newActions.push({ type: 'separator' })
+    }
+  });
+  return newActions
+})
+```
+
 ### 物料元数据
+
 #### getComponentMeta
 获取指定名称的物料元数据
 
@@ -237,7 +335,7 @@ getComponentMeta(componentName: string): IPublicModelComponentMeta | null;
 ```
 相关类型：[IPublicModelComponentMeta](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/model/component-meta.ts)
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine';
 
@@ -258,7 +356,7 @@ material.getComponentMeta('Input');
 ```
 相关类型：[IPublicModelComponentMeta](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/model/component-meta.ts)
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine';
 
@@ -295,7 +393,7 @@ registerMetadataTransducer(
 ): void;
 ```
 
-##### 示例
+**示例**
 给每一个组件的配置添加高级配置面板，其中有一个是否渲染配置项
 ```typescript
 import { material } from '@alilc/lowcode-engine'
@@ -377,7 +475,7 @@ material.registerMetadataTransducer((transducer) => {
 getRegisteredMetadataTransducers(): IPublicTypeMetadataTransducer[];
 ```
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine'
 
@@ -398,7 +496,7 @@ onChangeAssets(fn: () => void): IPublicTypeDisposable;
 
 相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)
 
-##### 示例
+**示例**
 ```typescript
 import { material } from '@alilc/lowcode-engine';
 

docs/docs/api/model/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "模型定义 Models",
-  "position": 14,
+  "position": 100,
   "collapsed": false,
   "collapsible": true
 }

docs/docs/api/model/resource.md

@@ -15,6 +15,12 @@ sidebar_position: 13
 
 `@type {string}`
 
+### id
+
+资源 id
+
+`@type {string}`
+
 ### name
 
 资源名字
@@ -44,3 +50,9 @@ sidebar_position: 13
 资源配置信息
 
 `@type {Object}`
+
+### config
+
+资源配置信息
+
+`@type {Object}`

docs/docs/api/plugins.md

@@ -1,6 +1,6 @@
 ---
 title: plugins - 插件 API
-sidebar_position: 4
+sidebar_position: 2
 ---
 > **@types** [IPublicApiPlugins](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/plugins.ts)<br/>
 > **@since** v1.0.0

docs/docs/api/project.md

@@ -1,6 +1,6 @@
 ---
 title: project - 模型 API
-sidebar_position: 3
+sidebar_position: 10
 ---
 ## 模块简介
 
@@ -201,7 +201,7 @@ addPropsTransducer(
 - [IPublicTypePropsTransducer](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/props-transducer.ts)
 - [IPublicEnumTransformStage](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/enum/transform-stage.ts)
 
-#### 示例
+**示例**
 在保存的时候删除每一个组件的 props.hidden
 ```typescript
 import { project } from '@alilc/lowcode-engine';

docs/docs/api/setters.md

@@ -1,6 +1,6 @@
 ---
 title: setters - 设置器 API
-sidebar_position: 6
+sidebar_position: 10
 ---
 > **@types** [IPublicApiSetters](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/setters.ts)<br/>
 > **@since** v1.0.0

docs/docs/api/simulatorHost.md

@@ -1,6 +1,6 @@
 ---
 title: simulatorHost - 模拟器 API
-sidebar_position: 3
+sidebar_position: 10
 ---
 > **@types** [IPublicApiSimulatorHost](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/simulator-host.ts)<br/>
 > **@since** v1.0.0
@@ -20,7 +20,7 @@ sidebar_position: 3
  */
 set(key: string, value: any): void;
 ```
-#### 示例
+**示例**
 设置若干用于画布渲染的变量，比如画布大小、locale 等。
 
 以设置画布大小为例：

docs/docs/api/skeleton.md

@@ -1,6 +1,6 @@
 ---
 title: skeleton - 面板 API
-sidebar_position: 1
+sidebar_position: 10
 ---
 > **@types** [IPublicApiSkeleton](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/api/skeleton.ts)<br/>
 > **@since** v1.0.0
@@ -69,6 +69,7 @@ skeleton.add({
   props: {
     align: "left",
     icon: "wenjian",
+    title: '标题', // 图标下方展示的标题
     description: "JS 面板",
   },
   panelProps: {
@@ -295,6 +296,85 @@ showArea(areaName: string): void;
  */
 hideArea(areaName: string): void;
 ```
+
+### getAreaItems
+
+获取某个区域下的所有面板实例
+
+```typescript
+/**
+  * 获取某个区域下的所有面板实例
+  * @param areaName IPublicTypeWidgetConfigArea
+  */
+getAreaItems(areaName: IPublicTypeWidgetConfigArea): IPublicModelSkeletonItem[] | undefined;
+```
+
+相关类型：[IPublicModelSkeletonItem](https://github.com/alibaba/lowcode-engine/blob/main/packages/shell/src/model/skeleton-item.ts)
+
+
+
+### registerConfigTransducer
+
+注册一个面板的配置转换器（transducer）。
+
+```typescript
+/**
+ * 注册一个面板的配置转换器（transducer）。
+ * Registers a configuration transducer for a panel.
+ * @param {IPublicTypeConfigTransducer} transducer 
+ *   - 要注册的转换器函数。该函数接受一个配置对象（类型为 IPublicTypeSkeletonConfig）作为输入，并返回修改后的配置对象。
+ *   - The transducer function to be registered. This function takes a configuration object 
+ * 
+ * @param {number} level 
+ *   - 转换器的优先级。优先级较高的转换器会先执行。
+ *   - The priority level of the transducer. Transducers with higher priority levels are executed first.
+ * 
+ * @param {string} [id] 
+ *   - （可选）转换器的唯一标识符。用于在需要时引用或操作特定的转换器。
+ *   - (Optional) A unique identifier for the transducer. Used for referencing or manipulating a specific transducer when needed.
+ */
+registerConfigTransducer(transducer: IPublicTypeConfigTransducer, level: number, id?: string): void;
+```
+
+使用示例
+
+```typescript
+import { IPublicModelPluginContext, IPublicTypeSkeletonConfig } from '@alilc/lowcode-types';
+
+function updatePanelWidth(config: IPublicTypeSkeletonConfig) {
+  if (config.type === 'PanelDock') {
+    return {
+      ...config,
+      panelProps: {
+        ...(config.panelProps || {}),
+        width: 240,
+      },
+    }
+  }
+
+  return config;
+}
+
+const controlPanelWidthPlugin = (ctx: IPublicModelPluginContext) => {
+  const { skeleton } = ctx;
+  (skeleton as any).registerConfigTransducer?.(updatePanelWidth, 1, 'update-panel-width');
+
+  return {
+    init() {},
+  };
+};
+
+controlPanelWidthPlugin.pluginName = 'controlPanelWidthPlugin';
+controlPanelWidthPlugin.meta = {
+  dependencies: [],
+  engines: {
+    lowcodeEngine: '^1.2.3', // 插件需要配合 ^1.0.0 的引擎才可运行
+  },
+};
+
+export default controlPanelWidthPlugin;
+```
+
 ## 事件
 ### onShowPanel
 
@@ -307,7 +387,7 @@ hideArea(areaName: string): void;
  * @param listener
  * @returns
  */
-onShowPanel(listener: (...args: any[]) => void): IPublicTypeDisposable;
+onShowPanel(listener: (paneName?: string, panel?: IPublicModelSkeletonItem) => void): IPublicTypeDisposable;
 ```
 
 相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)
@@ -323,11 +403,38 @@ onShowPanel(listener: (...args: any[]) => void): IPublicTypeDisposable;
  * @param listener
  * @returns
  */
-onHidePanel(listener: (...args: any[]) => void): IPublicTypeDisposable;
+onHidePanel(listener: (paneName?: string, panel?: IPublicModelSkeletonItem) => void): IPublicTypeDisposable;
 ```
 
 相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)
 
+### onDisableWidget
+
+监听 Widget 实例 Disable 事件
+
+```typescript
+/**
+ * 监听 Widget 实例 Disable 事件
+ * @param listener
+ */
+onDisableWidget(listener: (paneName?: string, panel?: IPublicModelSkeletonItem) => void): IPublicTypeDisposable;
+```
+
+相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)
+
+### onEnableWidget
+
+监听 Widget 实例 Enable 事件
+
+```typescript
+/**
+ * 监听 Widget 实例 Enable 事件
+ * @param listener
+ */
+onEnableWidget(listener: (paneName?: string, panel?: IPublicModelSkeletonItem) => void): IPublicTypeDisposable;
+```
+
+相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)
 
 ### onShowWidget
 
@@ -340,7 +447,7 @@ onHidePanel(listener: (...args: any[]) => void): IPublicTypeDisposable;
  * @param listener
  * @returns
  */
-onShowWidget(listener: (...args: any[]) => void): IPublicTypeDisposable;
+onShowWidget(listener: (paneName?: string, panel?: IPublicModelSkeletonItem) => void): IPublicTypeDisposable;
 ```
 
 相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)
@@ -356,7 +463,7 @@ onShowWidget(listener: (...args: any[]) => void): IPublicTypeDisposable;
  * @param listener
  * @returns
  */
-onHideWidget(listener: (...args: any[]) => void): IPublicTypeDisposable;
+onHideWidget(listener: (paneName?: string, panel?: IPublicModelSkeletonItem) => void): IPublicTypeDisposable;
 ```
 
 相关类型：[IPublicTypeDisposable](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/disposable.ts)

docs/docs/api/workspace.md

@@ -1,6 +1,6 @@
 ---
 title: workspace - 应用级 API
-sidebar_position: 12
+sidebar_position: 10
 ---
 
 > **[@experimental](./#experimental)**<br/>
@@ -87,7 +87,7 @@ registerResourceType(resourceTypeModel: IPublicTypeResourceType): void;
 setResourceList(resourceList: IPublicResourceList) {}
 ```
 
-相关类型：[IPublicResourceOptions](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/resource-options.ts)
+相关类型：[IPublicResourceData](https://github.com/alibaba/lowcode-engine/blob/main/packages/types/src/shell/type/resource-list.ts)
 
 ### openEditorWindow
 

docs/docs/article/index.md

@@ -6,6 +6,7 @@
 - [2022/12/21 低代码多分支协同开发的建设与实践](https://mp.weixin.qq.com/s/DmwxL67htHfTUP1U966N-Q)
 - [2022/11/24 低代码引擎半岁啦，来跟大家唠唠嗑...](https://segmentfault.com/a/1190000042884409)
 - [2022/10/27 低代码技术在研发团队的应用模式探讨](https://mp.weixin.qq.com/s/Ynk_wjJbmNw7fEG6UtGZbQ)
+- [2022/08/23 基于 LowCodeEngine 的调试能力建设与实践](https://mp.weixin.qq.com/s/H8KvEOylmzLPgIuuBO0S9w)
 - [2022/06/23 低代码渲染那些事](https://mp.weixin.qq.com/s/yqYey76qLGYPfDtpGkVFfA)
 - [2022/06/16 关于 LowCode&ProCode 混合研发的思考](https://mp.weixin.qq.com/s/TY3VXjkSmsQoT47xma3wig)
 - [2022/04/07 磁贴布局在钉钉宜搭报表设计引擎中的实现](https://mp.weixin.qq.com/s/PSTut5ahAB8nlJ9kBpBaxw)

docs/docs/demoUsage/makeStuff/dialog.md

@@ -2,6 +2,8 @@
 title: 3. 如何通过按钮展示/隐藏弹窗
 sidebar_position: 1
 ---
+> 说明：这个方式依赖低代码弹窗组件是否对外保留了相关的 API，不同的物料支持的方式不一样，这里只针对综合场景的弹窗物料。
+
 ## 1.拖拽一个按钮
 
 ![image.png](https://img.alicdn.com/imgextra/i1/O1CN01kLaWA31D6WwTui9VW_!!6000000000167-2-tps-3584-1812.png)

docs/docs/faq/faq024.md

@@ -0,0 +1,133 @@
+---
+title: workspace 模式常见问题
+sidebar_position: 23
+tags: [FAQ]
+---
+
+#### 如何判断是否开启了IDE模式？
+
+- **通过官方API判断**：您可以通过访问 [workspace.isActive](/site/docs/api/workspace#isactive) 来判断当前是否处于IDE模式。这是阿里低代码引擎提供的一个官方API，专门用于确认是否处于集成开发环境。
+
+
+
+#### 如何使用插件的ctx来做判断在哪个模式下？
+
+- **插件是否为应用级别**：可以通过 **ctx.isPluginRegisteredInWorkspace** 方法来判断一个插件是否是应用级别的插件。这有助于理解插件在阿里低代码引擎中的作用域和潜在的使用场景。
+- **插件的注册级别**：您可以使用 **ctx.registerLevel** 属性来判断插件处于哪个级别。插件级别的值包括：
+  - **Default**：默认级别。非 IDE 模式下的值
+  - **Workspace**：应用级别。
+  - **Resource**：资源级别。
+  - **EditorView**：编辑视图级别。 这些级别代表了插件可能的作用域和使用场景，有助于在开发和管理低代码应用时对插件进行更精确的控制和配置。
+
+
+
+#### 如何在IDE模式下设置资源列表？
+
+- **设置资源列表API**：在IDE模式下，可以通过访问 [workspace.setResourceList](/site/docs/api/workspace#setresourcelist) 来设置或更新IDE中的资源列表。这确保您在编辑器窗口中打开的资源是最新且可访问的。
+
+
+
+#### 如何打开视图窗口？
+
+- **使用推荐的方法**：使用 `openEditorWindow(resource: Resource, sleep?: boolean): Promise<void>;` 来打开视图窗口。这里的 **resource** 参数指的是您要打开的特定资源，可通过 [workspace.resourceList](/site/docs/api/workspace#resourcelist) 获取。
+- **不推荐使用的过时方法**：有一个过时的方法 `openEditorWindow(resourceName: string, id: string, extra: Object, viewName?: string, sleep?: boolean): Promise<void>;` 也用于打开视图窗口。虽然仍然可用，但官方不推荐使用此方法，并计划在后续版本中废弃，因为它在维护和可扩展性方面存在限制。
+
+
+
+#### 如何在全局插件中获取视图的上下文？
+
+- 在阿里低代码引擎的全局插件中获取视图的上下文，可以通过使用 **ProvideViewPluginContext** 函数实现。这个函数来自 **@alilc/lowcode-utils** 库，它使得您的 React 组件能够接收 **pluginContext** 作为 props，进而访问和操作当前视图的状态和属性。
+
+**步骤**
+
+**引入依赖**：首先，确保您的插件文件中已经引入了 **ProvideViewPluginContext** 以及其他必要的依赖。
+
+```
+import { ProvideViewPluginContext } from '@alilc/lowcode-utils';
+```
+
+**定义 React 组件**：创建一个 React 组件，它将使用来自 **ProvideViewPluginContext** 的 **pluginContext**。
+
+```typescript
+const MyComponent = (props) => {
+  const { pluginContext } = props;
+  // 组件逻辑
+  return <div>/* 组件内容 */</div>;
+};
+```
+
+**定义全局插件**：定义一个函数，这个函数会在插件被注册时调用。这个函数通常接受一个上下文对象 **ctx**，它提供了对引擎功能的访问。
+
+```javascript
+const globalPlugin = (ctx) => {
+  const { skeleton } = ctx;
+
+  skeleton.add({
+    type: 'PanelDock',
+    name: 'datapool',
+    content: ProvideViewPluginContext((props) => {
+      // 组件内容
+      return (
+        <MyComponent {...props} />
+      )
+    }),
+    // 其他配置
+    contentProps: {
+      // 需要提供 pluginContext 作为参数
+      pluginContext: ctx,
+    }
+  });
+};
+```
+
+通过这些步骤，您的全局插件中的 React 组件就能够获取并使用视图的上下文了。这为您在插件中实现更复杂的功能和交互提供了基础。
+
+
+
+**注意事项**
+
+- **组件重渲染**：正常情况下，**pluginsContext** 是视图的上下文。当视图切换时，组件会重新渲染。如果需要在组件中处理视图切换导致的重新渲染，可以利用 React 的 **key** 属性。
+
+**示例代码**
+
+```typescript
+ProvideViewPluginContext(props => {
+  return (
+    <DataPoolPane
+      {...props}
+      key={props.pluginContext?.editorWindow?.id}
+    );
+});
+```
+
+通过这种方式，当视图切换时，组件会根据视图的不同进行重新渲染，确保组件状态与当前视图的上下文保持一致。这对于在低代码平台上开发复杂插件和交互功能是非常有用的。
+
+
+
+#### 如何判断插件是否在 Workspace 模式下注册？
+
+**使用** **ctx.isPluginRegisteredInWorkspace()** **方法**:
+
+通过 **ctx.isPluginRegisteredInWorkspace()** 方法，可以判断一个插件是否在 Workspace 级别注册。以下是一个示例代码片段：
+
+```javascript
+if (ctx.isPluginRegisteredInWorkspace('pluginName')) {
+    console.log('插件已在 Workspace 模式下注册。');
+} else {
+    console.log('插件未在 Workspace 模式下注册。');
+}
+```
+
+注意：此方法目前在 beta 版本中，可能会有 TypeScript 提示显示已移除。
+
+**检查** **ctx.registerLevel** **的值**:
+
+可以通过比较 **ctx.registerLevel** 的值来判断插件的注册级别。示例代码如下：
+
+```javascript
+if (ctx.registerLevel !== IPublicEnumPluginRegisterLevel.Workspace) {
+    console.log('插件未在 Workspace 模式下注册。');
+} else {
+    console.log('插件已在 Workspace 模式下注册。');
+}
+```

docs/docs/faq/index.md

@@ -1,7 +1,47 @@
 ---
 title: FAQ 概述
-sidebar_position: 1
+sidebar_position: -1
 tags: [FAQ]
 ---
 
-不定期将社区常见问题及答案维护到此处
+不定期将社区常见问题及答案维护到此处
+
+## Demo 使用
+- [渲染唯一标识（key）](/site/docs/faq/faq002)
+- [点击事件如何添加参数](/site/docs/faq/faq003)
+- [如何通过 API 手动调用数据源请求](/site/docs/faq/faq006)
+
+## 设计器定制
+- [如何通过 this.utils 使用第三方工具扩展](/site/docs/faq/faq005)
+- [设置面板中的高级 tab 如何配置](/site/docs/faq/faq007)
+- [插件面板如何调整位置](/site/docs/faq/faq010)
+- [workspace 模式常见问题](/site/docs/faq/faq024)
+
+## 源码和依赖
+- [某某 npm 包对应的源码在哪里？](/site/docs/faq/faq008)
+
+## 错误和报错
+- [物料出现 Component Not Found 相关报错](/site/docs/faq/faq009)
+- [VERSION_PLACEHOLDER is not defined](/site/docs/faq/faq014)
+- [Cannot read property 'Icon' of Undefined](/site/docs/faq/faq016)
+- [windows 下运行低代码引擎源码出现报错](/site/docs/faq/faq019)
+- [Can't import the named export from non ECMAScript module](/site/docs/faq/faq020)
+- [Slot组件渲染报错问题](/site/docs/faq/faq023)
+
+## 物料相关问题
+- [如何获取物料当前处于编辑态还是渲染态](/site/docs/faq/faq011)
+- [Procode 物料如何调用数据源方法](/site/docs/faq/faq012)
+- [已有组件如何快速接入引擎](/site/docs/faq/faq015)
+- [Modal 类组件 hidden 属性被强制设置 true](/site/docs/faq/faq013)
+- [最小渲染单元配置](/site/docs/faq/faq004)
+- [节点无法拖拽到 Page 下](/site/docs/faq/faq022)
+
+## 其他说明
+- [vue 画布支持说明](/site/docs/faq/faq017)
+- [是否可以生成 Vue 页面代码？](/site/docs/faq/faq018)
+
+## 参与贡献
+- [提交 PR 时，明明签署过 CLA，仍被提示需要签署](/site/docs/faq/faq021)
+
+## 相关依赖文档
+- [build-scripts 的使用文档](/site/docs/faq/faq001)

docs/docs/guide/appendix/npms.md

@@ -12,8 +12,6 @@ sidebar_position: 3
 | @alilc/lowcode-engine | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/engine |
 | @alilc/lowcode-plugin-designer | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/plugin-designer |
 | @alilc/lowcode-plugin-outline-pane | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/plugin-outline-pane |
-| @alilc/lowcode-rax-renderer  | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/rax-renderer |
-| @alilc/lowcode-rax-simulator-renderer | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/rax-simulator-renderer |
 | @alilc/lowcode-react-renderer | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/react-renderer |
 | @alilc/lowcode-react-simulator-renderer | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/react-simulator-renderer |
 | @alilc/lowcode-renderer-core | [https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) | packages/renderer-core |

docs/docs/guide/appendix/repos.md

@@ -15,15 +15,13 @@ sidebar_position: 2
 5. ignitor
 6. plugin-designer
 7. plugin-outline-pane
-8. rax-renderer
-9. rax-simulator-renderer
-10. react-renderer
-11. react-simulator-renderer
-12. renderer-core
-13. types
-14. utils
-15. material-parser
-16. code-generator
+8. react-renderer
+9. react-simulator-renderer
+10. renderer-core
+11. types
+12. utils
+13. material-parser
+14. code-generator
 
 ## 2. 引擎官方扩展包
 包含了常用的设置器（setter）、跟 setter 绑定的插件等

docs/docs/guide/design/renderer.md

@@ -11,7 +11,6 @@ sidebar_position: 4
 ## npm 包与仓库信息
 
 - React 框架渲染 npm 包：@alilc/lowcode-react-renderer
-- Rax 框架渲染 npm 包：@alilc/lowcode-rax-renderer
 - 仓库：[https://github.com/alibaba/lowcode-engine](https://github.com/alibaba/lowcode-engine) 下的
    - packages/renderer-core
    - packages/react-renderer

docs/docs/guide/expand/editor/theme.md

@@ -3,23 +3,47 @@ title: 主题色扩展
 sidebar_position: 9
 ---
 
-## 主题色扩展简述
+## 简介
 
-通过主题色扩展，可以定制多种设计器主题。
+主题色扩展允许用户定制多样的设计器主题，增加界面的个性化和品牌识别度。
 
-## 主题色扩展说明
+## 设计器主题色定制
+
+在 CSS 的根级别定义主题色变量可以确保这些变量在整个应用中都可用。例如：
+
+```css
+:root {
+  --color-brand: rgba(0, 108, 255, 1); /* 主品牌色 */
+  --color-brand-light: rgba(25, 122, 255, 1); /* 浅色品牌色 */
+  --color-brand-dark: rgba(0, 96, 229, 1); /* 深色品牌色 */
+}
+
+```
+
+将样式文件引入到你的设计器中，定义的 CSS 变量就可以改变设计器的主题色了。
 
 ### 主题色变量
 
-- `--color-brand`: 品牌色
-- `--color-brand-light`: 品牌色（light）
-- `--color-brand-dark`: 品牌色（dark）
-- `--color-icon-normal`: 正常 icon 颜色
-- `--color-icon-hover`: icon hover 态颜色
-- `--color-icon-active`: icon active 态颜色
-- `--color-icon-reverse`: icon 反色
-- `--color-icon-disabled`: icon 禁用态颜色
-- `--color-icon-pane`: icon 面板颜色
+以下是低代码引擎设计器支持的主题色变量列表，以及它们的用途说明：
+
+#### 品牌相关颜色
+
+- `--color-brand`: 主品牌色
+- `--color-brand-light`: 浅色品牌色
+- `--color-brand-dark`: 深色品牌色
+
+#### Icon 相关颜色
+
+- `--color-icon-normal`: 默认状态
+- `--color-icon-light`: icon light 状态
+- `--color-icon-hover`: 鼠标悬停状态
+- `--color-icon-active`: 激活状态
+- `--color-icon-reverse`: 反色状态
+- `--color-icon-disabled`: 禁用状态
+- `--color-icon-pane`: 面板颜色
+
+#### 线条和文本颜色
+
 - `--color-line-normal`: 线条颜色
 - `--color-line-darken`: 线条颜色(darken)
 - `--color-title`: 标题颜色
@@ -27,8 +51,15 @@ sidebar_position: 9
 - `--color-text-dark`: 文字颜色(dark)
 - `--color-text-light`: 文字颜色(light)
 - `--color-text-reverse`: 反色情况下，文字颜色
-- `--color-text-regular`: 文字颜色(regular)
 - `--color-text-disabled`: 禁用态文字颜色
+
+#### 菜单颜色
+- `--color-context-menu-text`: 菜单项颜色
+- `--color-context-menu-text-hover`: 菜单项 hover 颜色
+- `--color-context-menu-text-disabled`: 菜单项 disabled 颜色
+
+#### 字段和边框颜色
+
 - `--color-field-label`: field 标签颜色
 - `--color-field-text`: field 文本颜色
 - `--color-field-placeholder`: field placeholder 颜色
@@ -36,6 +67,9 @@ sidebar_position: 9
 - `--color-field-border-hover`: hover 态下，field 边框颜色
 - `--color-field-border-active`: active 态下，field 边框颜色
 - `--color-field-background`: field 背景色
+
+#### 状态颜色
+
 - `--color-success`: success 颜色
 - `--colo-success-dark`: success 颜色(dark)
 - `--color-success-light`: success 颜色(light)
@@ -50,30 +84,60 @@ sidebar_position: 9
 - `--color-error-light`: error 颜色(light)
 - `--color-purple`: purple 颜色
 - `--color-brown`: brown 颜色
-- `--color-pane-background`: 面板背景色
+
+#### 区块背景色
+
 - `--color-block-background-normal`: 区块背景色
-- `--color-block-background-light`: 区块背景色(light), 作用于画布组件 hover 时遮罩背景色。
+- `--color-block-background-light`: 区块背景色(light)。
 - `--color-block-background-shallow`: 区块背景色 shallow
 - `--color-block-background-dark`: 区块背景色(dark)
 - `--color-block-background-disabled`: 区块背景色(disabled)
 - `--color-block-background-active`: 区块背景色(active)
+- `--color-block-background-active-light`: 区块背景色(active light)
 - `--color-block-background-warning`: 区块背景色(warning)
 - `--color-block-background-error`: 区块背景色(error)
 - `--color-block-background-success`: 区块背景色(success)
 - `--color-block-background-deep-dark`: 区块背景色(deep-dark)，作用于多个组件同时拖拽的背景色。
+
+#### 引擎相关颜色
+
+- `--color-canvas-detecting-background`: 画布组件 hover 时遮罩背景色。
+
+#### 其他区域背景色
+
 - `--color-layer-mask-background`: 拖拽元素时，元素原来位置的遮罩背景色
 - `--color-layer-tooltip-background`: tooltip 背景色
+- `--color-pane-background`: 面板背景色
 - `--color-background`: 设计器主要背景色
 - `--color-top-area-background`: topArea 背景色，优先级大于 `--color-pane-background`
 - `--color-left-area-background`: leftArea 背景色，优先级大于 `--color-pane-background`
+- `--color-toolbar-background`: toolbar 背景色，优先级大于 `--color-pane-background`
 - `--color-workspace-left-area-background`: 应用级 leftArea 背景色，优先级大于 `--color-pane-background`
 - `--color-workspace-top-area-background`: 应用级 topArea 背景色，优先级大于 `--color-pane-background`
 - `--color-workspace-sub-top-area-background`: 应用级二级 topArea 背景色，优先级大于 `--color-pane-background`
+
+#### 其他变量
+
 - `--workspace-sub-top-area-height`: 应用级二级 topArea 高度
+- `--top-area-height`: 顶部区域的高度
 - `--workspace-sub-top-area-margin`: 应用级二级 topArea margin
 - `--workspace-sub-top-area-padding`: 应用级二级 topArea padding
+- `--workspace-left-area-width`: 应用级 leftArea width
+- `--left-area-width`: leftArea width
+- `--simulator-top-distance`: simulator 距离容器顶部的距离
+- `--simulator-bottom-distance`:  simulator 距离容器底部的距离
+- `--simulator-left-distance`: simulator 距离容器左边的距离
+- `--simulator-right-distance`: simulator 距离容器右边的距离
+- `--toolbar-padding`: toolbar 的 padding
+- `--toolbar-height`: toolbar 的高度
+- `--pane-title-height`: 面板标题高度
+- `--pane-title-font-size`: 面板标题字体大小
+- `--pane-title-padding`: 面板标题边距
+- `--context-menu-item-height`: 右键菜单项高度
 
-### 生态使用主题色变量
+
+
+### 低代码引擎生态主题色定制
 
 插件、物料、设置器等生态为了支持主题色需要对样式进行改造，需要对生态中的样式升级为 css 变量。例如：
 
@@ -86,6 +150,8 @@ background: var(--color-brand, #006cff);
 
 ```
 
+这里 `var(--color-brand, #默认色)` 表示使用 `--color-brand` 变量，如果该变量未定义，则使用默认颜色（#默认色）。
+
 ### fusion 物料进行主题色扩展
 
-如果使用了 fusion 组件，可以通过 https://fusion.alibaba-inc.com/ 平台进行主题色定制。
+如果使用了 fusion 组件时，可以通过 [fusion 平台](https://fusion.design/) 进行主题色定制。在平台上，您可以选择不同的主题颜色，并直接应用于您的 fusion 组件，这样可以无缝地集成到您的应用设计中。

docs/docs/guide/expand/runtime/renderer.md

@@ -40,7 +40,6 @@ ReactDOM.render((
 ), document.getElementById('root'));
 ```
 
-- rax-renderer：npm 包替换为 @alilc/lowcode-rax-renderer
 ####
 ### 项目使用示例
 > [设计器 demo](https://lowcode-engine.cn/demo/demo-general/index.html)

docs/docs/guide/quickStart/demo.md

@@ -1,6 +1,6 @@
 ---
 title: 试用低代码引擎 Demo
-sidebar_position: 1
+sidebar_position: 2
 ---
 ## 访问地址
 

docs/docs/guide/quickStart/intro.md

@@ -1,6 +1,6 @@
 ---
 title: 简介
-sidebar_position: 0
+sidebar_position: 1
 ---
 
 # 阿里低代码引擎简介
@@ -46,3 +46,18 @@ sidebar_position: 0
 **低代码设计器研发框架**
 
 低代码引擎的核心是设计器，通过扩展、周边生态等可以产出各式各样的设计器。它不是一套可以适合所有人的低代码平台，而是帮助低代码平台的开发者，快速生产低代码平台的工具。
+
+## 寻找适合您的低代码解决方案
+
+帮助用户根据个人或企业需求选择合适的低代码产品。
+
+| 特性/产品        | 低代码引擎                               | Lab平台                                  | UIPaaS                                      |
+|-----------------|-----------------------------------------|-----------------------------------------|--------------------------------------------|
+| **适用用户**    | 前端开发者                               | 需要快速搭建应用/页面的用户              | 企业用户，需要大规模部署低代码解决方案的组织 |
+| **产品特点**    | 设计器研发框架，适合定制开发            | 低代码平台, 可视化操作界面，易于上手                | 低代码平台孵化器，企业级功能                |
+| **使用场景**    | 定制和开发低代码平台的设计器部分        | 通过可视化, 快速开发应用或页面                  | 帮助具有一定规模软件研发团队的的企业低成本定制低代码平台        |
+| **产品关系**    | 开源产品                                 | 基于UIPaaS技术实现, 展示了UIPaaS的部分能力                      | 提供完整的低代码平台解决方案，商业产品                |
+| **收费情况**    | 免费                                     | 可免费使用（有额度限制），不提供私有化部署售卖 | 仅提供私有化部署售卖                        |
+| **官方网站**    | [低代码引擎官网](https://lowcode-engine.cn/) | [Lab平台官网](https://lab.lowcode-engine.cn/) | [UIPaaS官网](https://uipaas.net/)          |
+
+*注：请根据您的具体需求和条件选择合适的产品。如需更详细的信息，请访问各产品的官方网站。*

docs/docs/guide/quickStart/start.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 title: 快速开始
 ---
 

docs/docs/participate/config.md

@@ -1,88 +0,0 @@
----
-title: 工程化配置
-sidebar_position: 3
----
-目前引擎体系共包含 2 个 js 文件 (配套 2 个 css)，即：
-
-
-```html
-<!-- 低代码引擎的页面框架样式 -->
-<link rel="stylesheet" href="https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/1.0.18/dist/css/engine-core.css" />
-<!-- 低代码引擎官方扩展的样式 -->
-<link rel="stylesheet" href="https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine-ext/1.0.5/dist/css/engine-ext.css" />
-
-<!-- 低代码引擎的主包 -->
-<script crossorigin="anonymous" src="https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/1.0.18/dist/js/engine-core.js"></script>
-<!-- 低代码引擎官方扩展的主包 -->
-<script crossorigin="anonymous" src="https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine-ext/1.0.5/dist/js/engine-ext.js"></script>
-```
-
-> 注，这里的版本号是示例，请尽量选用最新版
-
-工程化配置我们进行了统一，具体如下：
-```shell
-{
-  "entry": {
-    ...
-  },
-  "library": "...",
-  "libraryTarget": "umd",
-  "externals": {
-    "react": "var window.React",
-    "react-dom": "var window.ReactDOM",
-    "prop-types": "var window.PropTypes",
-    "@alilc/lowcode-engine": "var window.AliLowCodeEngine",
-    "@alilc/lowcode-engine-ext": "var window.AliLowCodeEngineExt",
-    "moment": "var moment",
-    "lodash": "var _",
-    "@alifd/next": "var Next"
-  },
-  "polyfill": false,
-  "outputDir": "dist",
-  "vendor": false,
-  "ignoreHtmlTemplate": true,
-  "sourceMap": true,
-  "plugins": [
-    "build-plugin-react-app",
-    ["build-plugin-fusion", {
-    }],
-    ["build-plugin-moment-locales", {
-      "locales": ["zh-CN"]
-    }],
-    "./build.plugin.js"
-  ]
-}
-
-```
-总结一下，有 2 点：
-
-1. **都不包含 polyfill，**需要应用级别单独引入 polyfill，推荐动态 polyfill
-2. **都不包含 lodash / moment / next**
-
-
-#### 前置依赖资源：
-```html
-<link rel="stylesheet" href="//alifd.alicdn.com/npm/@alifd/next/1.20.25/next.min.css">
-
-<script src="//polyfill.alicdn.com/s/polyfill.min.js?features=default,es2017,es6,fetch,RegeneratorRuntime"></script>
-<script src="//alifd.alicdn.com/npm/@alifd/next/1.20.25/next.min.js"></script>
-<script src="//g.alicdn.com/platform/c/lodash/4.6.1/lodash.min.js"></script>
-<script src="//g.alicdn.com/mylib/moment/2.24.0/min/moment.min.js"></script>
-```
-
-
-#### 所有资源：
-```html
-<link rel="stylesheet" href="//alifd.alicdn.com/npm/@alifd/next/1.20.25/next.min.css">
-<link rel="stylesheet" href="//uipaas-assets.com/prod/npm/@alilc/lowcode-engine/1.0.18/dist/css/engine-core.css"/>
-<link rel="stylesheet" href="//uipaas-assets.com/prod/npm/@alilc/lowcode-engine/1.0.5/dist/css/engine-ext.css"/>
-
-<script src="//polyfill.alicdn.com/s/polyfill.min.js?features=default,es2017,es6,fetch,RegeneratorRuntime"></script>
-<script src="//alifd.alicdn.com/npm/@alifd/next/1.20.25/next.min.js"></script>
-<script src="//g.alicdn.com/platform/c/lodash/4.6.1/lodash.min.js"></script>
-<script src="//g.alicdn.com/mylib/moment/2.24.0/min/moment.min.js"></script>
-<!-- engine-core 引擎的 core，负责引擎的基础模块 -->
-<script crossorigin="anonymous" src="//uipaas-assets.com/prod/npm/@alilc/lowcode-engine/1.0.18/dist/js/engine-core.js"></script>
-<!-- engine-ext 引擎的扩展包，负责收拢内置 setters / plugins，方便迭代 -->
-<script crossorigin="anonymous" src="//uipaas-assets.com/prod/npm/@alilc/lowcode-engine/1.0.5/dist/js/engine-ext.js"></script>
-```

docs/docs/participate/doc.md

@@ -1,25 +0,0 @@
----
-title: 参与文档贡献
-sidebar_position: 3
----
-
-## 基本原则
-
-### 维护方式
-
-- 官方文档通过 github 管理文档源，官网文档与[主仓库 develop 分支](https://github.com/alibaba/lowcode-engine/tree/develop/docs)保持同步。
-- 点击每篇文档下发的 `编辑此页` 可直接定位到 github 中位置。
-- 欢迎 PR，文档 PR 也会作为贡献者贡献，会用于贡献度统计。
-- **文档同步到官方网站由官方人员进行操作**，如有需要可以通过 issue 或 贡献者群与相关人员沟通。
-- 为了提供更好的阅读和使用体验，文档中的图片文件会定期转换成可信的 CDN 地址。
-
-### PR 提交注意事项
-
-- 指向 develop 分支。
-- 涉及到图片的，需附在文档同级的 img 目录下，通过相对地址引用。
-
-### 文档格式
-
-本项目文档参考[文档编写指南](https://github.com/sparanoid/chinese-copywriting-guidelines)。
-
-使用 vscode 进行编辑的朋友可以安装 vscode 插件 [huacnlee.autocorrect](https://github.com/huacnlee/autocorrect) 辅助文档 lint。

docs/docs/participate/index.md

@@ -1,31 +1,118 @@
 ---
-title: 贡献者指南
+title: 参与贡献
 sidebar_position: 0
 ---
-### 首个 Pull Request
-在写第一个 Pull Request？你可以从这一系列视频中学习怎么做：
-[How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github)
+
+### 环境准备
+
+开发 LowcodeEngine 需要 Node.js 16+。
+
+推荐使用 nvm 管理 Node.js，避免权限问题的同时，还能够随时切换当前使用的 Node.js 的版本。
+
+### 贡献低代码引擎
+
+#### clone 项目
+
+```
+git clone git@github.com:alibaba/lowcode-engine.git
+cd lowcode-engine
+```
+
+#### 安装依赖并构建
+
+```
+npm install && npm run setup
+```
+
+#### 调试环境配置
+
+本质上是将 demo 页面引入的几个 js/css 代理到 engine 项目，可以使用趁手的代理工具，这里推荐 [XSwitch](https://chrome.google.com/webstore/detail/xswitch/idkjhjggpffolpidfkikidcokdkdaogg?hl=en-US)。
+
+本地开发代理规则如下：
+```json
+{
+  "proxy": [
+    [
+      "https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/js/engine-core.js",
+      "http://localhost:5555/js/AliLowCodeEngine.js"
+    ],
+    [
+      "https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/css/engine-core.css",
+      "http://localhost:5555/css/AliLowCodeEngine.css"
+    ],
+    [
+      "https?://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/js/react-simulator-renderer.js",
+      "http://localhost:5555/js/ReactSimulatorRenderer.js"
+    ],
+    [
+      "https?://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/css/react-simulator-renderer.css",
+      "http://localhost:5555/css/ReactSimulatorRenderer.css"
+    ]
+  ]
+}
+```
+
+#### 开发
+
+```
+npm start
+```
+
+选择一个环境进行调试，例如[低代码引擎在线 DEMO](https://lowcode-engine.cn/demo/demo-general/index.html)
+
+开启代理之后，就可以进行开发调试了。
+
+
+### 贡献低代码引擎文档
+
+#### 开发文档
+
+在 lowcode-engine 目录下执行下面命令
+```
+cd docs
+
+npm start
+```
+
+#### 维护方式
+- 官方文档通过 github 管理文档源，官网文档与[主仓库 develop 分支](https://github.com/alibaba/lowcode-engine/tree/develop/docs)保持同步。
+- 点击每篇文档下发的 `编辑此页` 可直接定位到 github 中位置。
+- 欢迎 PR，文档 PR 也会作为贡献者贡献，会用于贡献度统计。
+- **文档同步到官方网站由官方人员进行操作**，如有需要可以通过 issue 或 贡献者群与相关人员沟通。
+- 为了提供更好的阅读和使用体验，文档中的图片文件会定期转换成可信的 CDN 地址。
+
+#### 文档格式
+
+本项目文档参考[文档编写指南](https://github.com/sparanoid/chinese-copywriting-guidelines)。
+
+使用 vscode 进行编辑的朋友可以安装 vscode 插件 [huacnlee.autocorrect](https://github.com/huacnlee/autocorrect) 辅助文档 lint。
+
+
+### 贡献低代码引擎生态
+
+相关源码详见[NPM 包对应源码位置汇总](/site/docs/guide/appendix/npms)
+
+开发调试方式详见[低代码生态脚手架 & 调试机制](/site/docs/guide/expand/editor/cli)
+
+### 发布
+
+PR 被合并之后，我们会尽快发布相关的正式版本或者 beta 版本。
+
+### 加入 Contributor 群
+提交过 Bugfix 或 Feature 类 PR 的同学，如果有兴趣一起参与维护 LowcodeEngine，我们提供了一个核心贡献者交流群。
+
+1. 可以通过[填写问卷](https://survey.taobao.com/apps/zhiliao/4YEtu9gHF)的方式，参与到其中。
+2. 填写问卷后加微信号 `wxidvlalalalal` （注明 github id）我们会拉你到群里。
+
+如果你不知道可以贡献什么，可以到源码里搜 TODO 或 FIXME 找找。
 
 为了使你能够快速上手和熟悉贡献流程，我们这里有个列表 [good first issues](https://github.com/alibaba/lowcode-engine/issues?q=is:open+is:issue+label:%22good+first+issue%22)，里面有相对没那么笼统的漏洞，从这开始是个不错的选择。
 
-如果你想解决一个 issue，请确定检查了该 issue 下的评论以防有人正在处理它。如果目前没人在处理该 issue，那么请留下评论去表明你想处理该 issue 以便其他人不会意外重复你的工作。
+### PR 提交注意事项
 
-如果有人留言表明要处理该 issue 但是超过两周没有跟进，你可以接手工作，不过也应该留言说明。
-
-### 提交 Pull Request
-核心团队时刻关注 pull requests，我们会先评审你的 pull request，之后可能会合并，可能会要求再次更改，也可能会关闭该 pull request 并对此作出解释。我们会尽力全程更新和反馈。
-
-**提交 pull request 前**，请确保完成以下步骤：
-
-1. Fork [此仓库](https://github.com/alibaba/lowcode-engine)，从 main 创建分支。
-2. 在仓库根目录下执行 yarn。
-3. 如果你修复了 bug 或者添加了代码，而这些内容需要测试，请添加测试！
-4. 确保通过测试套件（yarn test）。
-5. 请签订贡献者许可证协议（Contributor License Agreement）。
-   > 如已签署 CLA 仍被提示需要签署，[解决办法](/site/docs/faq/faq021)
-
-### 核心贡献者交流
-如果你想长期参与到项目维护中，我们提供了一个核心贡献者交流群。
-
-1. 可以通过[填写问卷](https://survey.taobao.com/apps/zhiliao/4YEtu9gHF)的方式，参与到其中。
-2. 填写问卷后加微信号 `wxidvlalalalal` 说明一下。
+- lowcode-engine 仓库建议从 develop 创建分支，PR 指向 develop 分支。
+- 其他仓库从 main 分支创建分支，PR 指向 main 分支
+- 如果你修复了 bug 或者添加了代码，而这些内容需要测试，请添加测试！
+- 确保通过测试套件（yarn test）。
+- 请签订贡献者许可证协议（Contributor License Agreement）。
+   > 如已签署 CLA 仍被提示需要签署，[解决办法](/site/docs/faq/faq021)

docs/docs/participate/meet.md

@@ -0,0 +1,55 @@
+---
+title: 开源社区例会
+sidebar_position: 0
+---
+
+## **简介**
+
+低代码引擎开源社区致力于共同推动低代码技术的发展和创新。本社区汇集了低代码技术领域的开发者、技术专家和行业观察者，通过定期的例会来交流思想、分享经验、讨论新技术，并探索低代码技术的未来发展方向。
+
+## 参与要求
+
+为了确保例会的质量和效果，我们建议以下人员参加：
+
+- **已参与低代码引擎贡献的成员**：那些对低代码引擎有实际贡献的社区成员。
+- **参考贡献指南**：可查阅[贡献指南](https://lowcode-engine.cn/site/docs/participate/)获取更多信息。
+- **提供过优秀建议的成员**：那些在过去为低代码引擎提供过有价值建议的成员。
+
+## **时间周期**
+
+- **周期性**：月例会
+
+### **特别说明**
+
+- 例会周期可根据成员反馈进行调整。如果讨论的议题较多，可增加例会频率；若议题较少，单次例会可能取消。若多次取消，可能会暂停例会。
+
+## **例会流程**
+
+### **准备阶段**
+
+- **定期确定议题**：会前一周确定下一次会议的议题。
+- **分发会议通知**：提前发送会议时间、议程和参与方式。
+
+### **会议阶段**
+
+- **开场和介绍**：简短开场和自我介绍，特别是新成员加入时。
+- **议题讨论**：按照议程进行议题讨论，每个议题分配一定时间，并留足够时间供讨论和提问。
+- **记录要点和决定**：记录讨论要点、决策和任何行动事项。
+
+### **后续阶段**
+
+- **分享会议纪要**：会后将会议纪要和行动计划分发给所有成员。
+- **执行和跟进**：根据会议中的讨论和决策执行相关任务，并在下次会议中进行跟进汇报。
+
+## **开源例会议题**
+
+开源例会议题包括但不限于：
+
+- **共建低代码行业发展**：探讨通过开源社区合作加速低代码行业发展。
+- **改进建议和反馈收集**：讨论社区成员对低代码引擎的使用体验和改进建议。
+- **前端技术与低代码的结合**：针对前端开发者，讨论将前端技术与低代码引擎结合的方式。
+- **低代码业务场景和经验分享**：邀请社区成员分享低代码引擎的实际应用经验。
+- **低代码技术原理介绍**：深入理解低代码引擎的技术原理和实现方式。
+- **低代码引擎的最新进展**：分享低代码引擎的最新进展，包括新版本发布和新功能实现等。
+- **低代码技术的未来展望**：讨论低代码技术的未来发展方向。
+- **最新低代码平台功能和趋势分析**：分享和讨论当前低代码平台的新功能、趋势和发展方向。

docs/docs/participate/prepare.md

@@ -1,64 +0,0 @@
----
-title: 调试环境配置
-sidebar_position: 1
----
-低代码引擎的核心仓库是不包含任何物料、插件、setter 的，它本身用于生成低代码引擎的主包。
-
-如果您需要对低代码的主包进行开发和调试，需要用到本文里介绍的知识。
-
-如果您需要对低代码编辑器进行定制，您可能只需要 clone [lowcode-demo 项目](https://github.com/alibaba/lowcode-demo)并进行修改，参考“[配置低代码扩展点](/site/docs/guide/expand/editor/summary)”章节。
-
-> 前置条件：
-> node 推荐使用 16.18.0（14.x 也可以）
-
-### 1. 拉取代码，启动项目
-```bash
-git clone git@github.com:alibaba/lowcode-engine.git
-cd lowcode-engine
-npm install && npm run setup
-npm start
-
-
-git clone git@github.com:alibaba/lowcode-demo.git
-cd lowcode-demo
-npm install && npm start
-```
-
-### 2. 配置资源代理
-本质上是将 demo 页面引入的几个 js/css 代理到 engine 项目，可以使用趁手的代理工具，这里推荐 [XSwitch](https://chrome.google.com/webstore/detail/xswitch/idkjhjggpffolpidfkikidcokdkdaogg?hl=en-US)。
-
-本地开发代理规则如下：
-```json
-{
-  "proxy": [
-    [
-      "https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/js/engine-core.js",
-      "http://localhost:5555/js/engine-core.js"
-    ],
-    [
-      "https://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/css/engine-core.css",
-      "http://localhost:5555/css/engine-core.css"
-    ],
-    [
-      "https?://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/js/react-simulator-renderer.js",
-      "http://localhost:5555/js/react-simulator-renderer.js"
-    ],
-    [
-      "https?://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/css/react-simulator-renderer.css",
-      "http://localhost:5555/css/react-simulator-renderer.css"
-    ],
-    [
-      "https?://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/js/rax-simulator-renderer.js",
-      "http://localhost:5555/js/rax-simulator-renderer.js"
-    ],
-    [
-      "https?://uipaas-assets.com/prod/npm/@alilc/lowcode-engine/(.*)/dist/css/rax-simulator-renderer.css",
-      "http://localhost:5555/css/rax-simulator-renderer.css"
-    ],
-  ]
-}
-```
-
-### 3. 本地调试物料/插件/设置器
-
-详见[低代码生态脚手架 & 调试机制](/site/docs/guide/expand/editor/cli)

docs/docs/specs/lowcode-spec.md

@@ -499,7 +499,6 @@ try {
     - 说明：组件即将从 DOM 中移除
   - componentDidCatch(error, info)
     - 说明：组件捕获到异常
-- Rax：目前没有使用生命周期，使用 hooks 替代生命周期；
 
 该对象由一系列 key-value 组成，key 为生命周期方法名，value 为 JSFunction 的描述，详见下方示例：
 

docs/docs/video/index.md

@@ -1,7 +1,10 @@
 # 官方视频
+- [2023/11/20 云栖大会｜阿里开源低代码引擎及商业解决方案](https://www.bilibili.com/video/BV1Ku4y1w7Zr)
 - [2023/08/03 初识低代码引擎](https://www.bilibili.com/video/BV1gu411p7TC)
 
 # 社区视频
+- [低代码从入门到实战：低代码引擎实践](https://www.bilibili.com/video/BV1aP4y1Q7Xa/)
+- [低代码技术在研发团队的应用模式](https://www.bilibili.com/video/BV1L14y1Y72J/)
 - [阿里低代码引擎项目实战 (1)-引擎 demo 部署到 faas 服务](https://www.bilibili.com/video/BV1B44y1P7GM/)
 - [【有翻车】阿里低代码引擎项目实战 (2)-保存页面到远端存储](https://www.bilibili.com/video/BV1AS4y1K7DP/)
 - [阿里巴巴低代码引擎项目实战 (3)-自定义组件接入](https://www.bilibili.com/video/BV1dZ4y1m76S/)

docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alilc/lowcode-engine-docs",
-  "version": "1.1.15",
+  "version": "1.2.31",
   "description": "低代码引擎版本化文档",
   "license": "MIT",
   "files": [

docs/scripts/sync-oss.js

@@ -19,7 +19,7 @@ const onResponse = function (res) {
     chunks.push(chunk);
   });
 
-  res.on('end', (chunk) => {
+  res.on('end', () => {
     const body = Buffer.concat(chunks);
     console.table(JSON.stringify(JSON.parse(body.toString()), null, 2));
   });
@@ -39,9 +39,9 @@ const postData = JSON.stringify({
     },
   ],
   // 可以发布指定源的 npm 包，默认公网 npm
-  useTnpm: false,
+  useTnpm: true,
 });
 
 req.write(postData);
 
-req.end();
+req.end();

lerna.json

@@ -1,6 +1,6 @@
 {
   "lerna": "4.0.0",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "npmClient": "yarn",
   "useWorkspaces": true,
   "packages": [

modules/code-generator/README.md

@@ -94,16 +94,26 @@ await CodeGenerator.init();
 4. 出码
 
 ```js
-const result = await CodeGenerator.generateCode({
+const project = await CodeGenerator.generateCode({
   solution: 'icejs', // 出码方案 (目前内置有 icejs 和 rax )
   schema, // 编排搭建出来的 schema
 });
 
-console.log(result); // 出码结果(默认是递归结构描述的，可以传 flattenResult: true 以生成扁平结构的结果)
+console.log(project); // 出码结果(默认是递归结构描述的，可以传 flattenResult: true 以生成扁平结构的结果)
 ```
 
 注：一般来说在浏览器中出码适合做即时预览功能。
 
+5. 下载 zip 包
+
+```js
+// 写入到 zip 包
+await CodeGenerator.publishers.zip().publish({
+  project, // 上一步生成的 project
+  projectSlug: 'your-project-slug', // 项目标识 -- 对应下载 your-project-slug.zip 文件
+});
+```
+
 ### 5）自定义出码
 
 前端框架灵活多变，默认内置的出码方案很难满足所有人的需求，好在此代码生成器支持非常灵活的插件机制 -- 欢迎参考 ./src/plugins/xxx 来编写您自己的出码插件，然后参考 ./src/solutions/xxx 将各种插件组合成一套适合您的业务场景的出码方案。

modules/code-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alilc/lowcode-code-generator",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "出码引擎 for LowCode Engine",
   "license": "MIT",
   "main": "lib/index.js",
@@ -80,6 +80,7 @@
     "change-case": "^3.1.0",
     "commander": "^6.1.0",
     "debug": "^4.3.2",
+    "file-saver": "^2.0.5",
     "fp-ts": "^2.11.9",
     "fs-extra": "9.x",
     "glob": "^7.2.0",
@@ -109,6 +110,7 @@
   "devDependencies": {
     "@iceworks/spec": "^1.4.2",
     "@types/babel__traverse": "^7.11.0",
+    "@types/file-saver": "^2.0.7",
     "@types/jest": "^27.0.2",
     "@types/lodash": "^4.14.162",
     "@types/node": "^14.14.20",

modules/code-generator/src/publisher/zip/index.ts

@@ -2,9 +2,9 @@ import { ResultDir } from '@alilc/lowcode-types';
 import { PublisherFactory, IPublisher, IPublisherFactoryParams, PublisherError } from '../../types';
 import { getErrorMessage } from '../../utils/errors';
 import { isNodeProcess, writeZipToDisk, generateProjectZip } from './utils';
+import { saveAs } from 'file-saver';
 
-// export type ZipBuffer = Buffer | Blob;
-export type ZipBuffer = Buffer;
+export type ZipBuffer = Buffer | Blob;
 
 declare type ZipPublisherResponse = string | ZipBuffer;
 
@@ -44,10 +44,16 @@ export const createZipPublisher: PublisherFactory<ZipFactoryParams, ZipPublisher
     try {
       const zipContent = await generateProjectZip(projectToPublish);
 
-      // If not output path is provided, zip is not written to disk
-      const projectOutputPath = options.outputPath || outputPath;
-      if (projectOutputPath && isNodeProcess()) {
-        await writeZipToDisk(projectOutputPath, zipContent, zipName);
+      if (isNodeProcess()) {
+        // If not output path is provided on the node side, zip is not written to disk
+        const projectOutputPath = options.outputPath || outputPath;
+        if (projectOutputPath) {
+          await writeZipToDisk(projectOutputPath, zipContent, zipName);
+        }
+      } else {
+        // the browser end does not require a path
+        // auto download zip files
+        saveAs(zipContent as Blob, `${zipName}.zip`);
       }
 
       return { success: true, payload: zipContent };

modules/code-generator/src/publisher/zip/utils.ts

@@ -40,8 +40,7 @@ export const writeZipToDisk = (
 export const generateProjectZip = async (project: ResultDir): Promise<ZipBuffer> => {
   let zip = new JSZip();
   zip = writeFolderToZip(project, zip, true);
-  // const zipType = isNodeProcess() ? 'nodebuffer' : 'blob';
-  const zipType = 'nodebuffer'; // 目前先只支持 node 调用
+  const zipType = isNodeProcess() ? 'nodebuffer' : 'blob';
   return zip.generateAsync({ type: zipType });
 };
 

modules/code-generator/tests/public/publisher/zip/zip.test.ts

@@ -1,6 +1,14 @@
 import CodeGen from '../../../../src';
+import fileSaver from 'file-saver';
+import * as utils from '../../../../src/publisher/zip/utils';
+
+jest.mock('file-saver');
 
 describe('public/publisher/zip/zip', () => {
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
   it('should works', async () => {
     const zip = CodeGen.publishers.zip({
       outputPath: 'demo-output',
@@ -19,15 +27,15 @@ describe('public/publisher/zip/zip', () => {
       ],
     };
 
-    expect(zip.getOutputPath()).toMatchInlineSnapshot(`"demo-output"`);
+    expect(zip.getOutputPath()).toMatchInlineSnapshot('"demo-output"');
 
-    expect(zip.getProject()).toMatchInlineSnapshot(`undefined`);
+    expect(zip.getProject()).toMatchInlineSnapshot('undefined');
     zip.setProject(demoProject);
     expect(zip.getProject()).toBeTruthy();
 
-    expect(zip.getOutputPath()).toMatchInlineSnapshot(`"demo-output"`);
+    expect(zip.getOutputPath()).toMatchInlineSnapshot('"demo-output"');
     expect(zip.setOutputPath('output')).toBe(undefined);
-    expect(zip.getOutputPath()).toMatchInlineSnapshot(`"output"`);
+    expect(zip.getOutputPath()).toMatchInlineSnapshot('"output"');
 
     const publishRes = await zip.publish({
       project: demoProject,
@@ -41,4 +49,39 @@ describe('public/publisher/zip/zip', () => {
     const zip = CodeGen.publishers.zip({});
     expect(zip.publish()).rejects.toBeTruthy();
   });
+
+  it('should publish the project as a zip file in the browser', async () => {
+    const zipContent = 'zip content';
+    const zipName = 'example-project';
+    jest.spyOn(utils, 'isNodeProcess').mockReturnValue(false);
+    // new Zip 里面也有平台判断，所以这里 mock
+    jest.spyOn(utils, 'generateProjectZip').mockResolvedValue(zipContent as any);
+    const spy = jest.spyOn(fileSaver, 'saveAs');
+
+    const zip = CodeGen.publishers.zip({
+      projectSlug: zipName,
+    });
+
+    const demoProject = {
+      name: 'demo',
+      dirs: [],
+      files: [
+        {
+          name: 'package',
+          ext: 'json',
+          content: '{ "name": "demo", "version": "1.0.0" }',
+        },
+      ],
+    };
+
+    zip.setProject(demoProject);
+    const publishRes = await zip.publish({
+      project: demoProject,
+    });
+
+    expect(publishRes.success).toBeTruthy();
+    expect(spy).toBeCalledWith(zipContent, `${zipName}.zip`);
+    spy.mockReset();
+    spy.mockRestore();
+  });
 });

package.json

@@ -20,11 +20,13 @@
     "lint:fix": "f2elint fix -i ./packages/*/src",
     "lint:modules": "f2elint scan -q -i ./modules/*/src",
     "lint:modules:fix": "f2elint fix -i ./modules/*/src",
-    "pub": "npm run watchdog:build && lerna publish patch --force-publish --exact --no-changelog",
+    "pub": "npm run watchdog:build && lerna publish patch --yes --force-publish --exact --no-changelog",
+    "pub:minor": "npm run watchdog:build && lerna publish minor --yes --force-publish --exact --no-changelog",
+    "pub:major": "npm run watchdog:build && lerna publish major --yes --force-publish --exact --no-changelog",
     "pub:premajor": "npm run watchdog:build && lerna publish premajor --force-publish --exact --dist-tag beta --preid beta --no-changelog",
     "pub:preminor": "npm run watchdog:build && lerna publish preminor --force-publish --exact --dist-tag beta --preid beta --no-changelog",
     "pub:prepatch": "npm run watchdog:build && lerna publish prepatch --force-publish --exact --dist-tag beta --preid beta --no-changelog",
-    "pub:prerelease": "npm run watchdog:build && lerna publish prerelease --force-publish --exact --dist-tag beta --preid beta --no-changelog",
+    "pub:prerelease": "npm run watchdog:build && lerna publish prerelease --yes --force-publish --exact --dist-tag beta --preid beta --no-changelog",
     "setup": "node ./scripts/setup.js",
     "setup:test": "./scripts/setup-for-test.sh",
     "setup:skip-build": "./scripts/setup-skip-build.sh",
@@ -52,7 +54,7 @@
     "yarn": "^1.22.17",
     "rimraf": "^3.0.2",
     "@types/react-router": "5.1.18",
-    "@alilc/build-plugin-lce": "^0.0.3",
+    "@alilc/build-plugin-lce": "^0.0.5",
     "babel-jest": "^26.5.2",
     "@alilc/lowcode-test-mate": "^1.0.1"
   },

packages/designer/jest.config.js

@@ -20,6 +20,8 @@ const jestConfig = {
   // testMatch: ['**/node.test.ts'],
   // testMatch: ['**/builtin-hotkey.test.ts'],
   // testMatch: ['**/selection.test.ts'],
+  // testMatch: ['**/plugin/sequencify.test.ts'],
+  // testMatch: ['**/builtin-simulator/utils/parse-metadata.test.ts'],
   transformIgnorePatterns: [
     `/node_modules/(?!${esModules})/`,
   ],

packages/designer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alilc/lowcode-designer",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "description": "Designer for Ali LowCode Engine",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -15,9 +15,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@alilc/lowcode-editor-core": "1.2.2",
-    "@alilc/lowcode-types": "1.2.2",
-    "@alilc/lowcode-utils": "1.2.2",
+    "@alilc/lowcode-editor-core": "1.3.2",
+    "@alilc/lowcode-types": "1.3.2",
+    "@alilc/lowcode-utils": "1.3.2",
     "classnames": "^2.2.6",
     "react": "^16",
     "react-dom": "^16.7.0",

packages/designer/src/builtin-simulator/bem-tools/bem-tools.less

@@ -6,5 +6,5 @@
   bottom: 0;
   right: 0;
   overflow: visible;
-  z-index: 800;
+  z-index: 1;
 }

packages/designer/src/builtin-simulator/bem-tools/border-selecting.tsx

@@ -9,7 +9,7 @@ import {
   ComponentType,
 } from 'react';
 import classNames from 'classnames';
-import { observer, computed, Tip } from '@alilc/lowcode-editor-core';
+import { observer, computed, Tip, engineConfig } from '@alilc/lowcode-editor-core';
 import { createIcon, isReactComponent, isActionContentObject } from '@alilc/lowcode-utils';
 import { IPublicTypeActionContentObject } from '@alilc/lowcode-types';
 import { BuiltinSimulatorHost } from '../host';
@@ -47,14 +47,18 @@ export class BorderSelectingInstance extends Component<{
     });
 
     const { hideSelectTools } = observed.node.componentMeta.advanced;
+    const hideComponentAction = engineConfig.get('hideComponentAction');
 
     if (hideSelectTools) {
       return null;
     }
 
     return (
-      <div className={className} style={style}>
-        {!dragging && <Toolbar observed={observed} />}
+      <div
+        className={className}
+        style={style}
+      >
+        {(!dragging && !hideComponentAction) ? <Toolbar observed={observed} /> : null}
       </div>
     );
   }
@@ -143,7 +147,7 @@ function createAction(content: ReactNode | ComponentType<any> | IPublicTypeActio
           });
         }}
       >
-        {icon && createIcon(icon)}
+        {icon && createIcon(icon, { key, node: node.internalToShellNode() })}
         <Tip>{title}</Tip>
       </div>
     );

packages/designer/src/builtin-simulator/bem-tools/borders.less

@@ -100,7 +100,7 @@
   &&-detecting {
     z-index: 1;
     border-style: dashed;
-    background: var(--color-block-background-light, rgba(0,121,242,.04));
+    background: var(--color-canvas-detecting-background, rgba(0,121,242,.04));
   }
 
   &&-selecting {

packages/designer/src/builtin-simulator/host.less

@@ -73,10 +73,10 @@
   }
 
   &-device-default {
-    top: 16px;
-    right: 16px;
-    bottom: 16px;
-    left: 16px;
+    top: var(--simulator-top-distance, 16px);
+    right: var(--simulator-right-distance, 16px);
+    bottom: var(--simulator-bottom-distance, 16px);
+    left: var(--simulator-left-distance, 16px);
     width: auto;
     box-shadow: 0 1px 4px 0 var(--color-block-background-shallow, rgba(31, 50, 88, 0.125));
   }

packages/designer/src/builtin-simulator/host.ts

@@ -39,6 +39,7 @@ import {
   isDragAnyObject,
   isDragNodeObject,
   isLocationData,
+  Logger,
 } from '@alilc/lowcode-utils';
 import {
   isShaken,
@@ -72,6 +73,8 @@ import { IScroller } from '../designer/scroller';
 import { isElementNode, isDOMNodeVisible } from '../utils/misc';
 import { debounce } from 'lodash';
 
+const logger = new Logger({ level: 'warn', bizName: 'designer' });
+
 export type LibraryItem = IPublicTypePackage & {
   package: string;
   library: string;
@@ -122,21 +125,6 @@ const defaultSimulatorUrl = (() => {
   return urls;
 })();
 
-const defaultRaxSimulatorUrl = (() => {
-  const publicPath = getPublicPath();
-  let urls;
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const [_, prefix = '', dev] = /^(.+?)(\/js)?\/?$/.exec(publicPath) || [];
-  if (dev) {
-    urls = [`${prefix}/css/rax-simulator-renderer.css`, `${prefix}/js/rax-simulator-renderer.js`];
-  } else if (process.env.NODE_ENV === 'production') {
-    urls = [`${prefix}/rax-simulator-renderer.css`, `${prefix}/rax-simulator-renderer.js`];
-  } else {
-    urls = [`${prefix}/rax-simulator-renderer.css`, `${prefix}/rax-simulator-renderer.js`];
-  }
-  return urls;
-})();
-
 const defaultEnvironment = [
   // https://g.alicdn.com/mylib/??react/16.11.0/umd/react.production.min.js,react-dom/16.8.6/umd/react-dom.production.min.js,prop-types/15.7.2/prop-types.min.js
   assetItem(
@@ -151,17 +139,6 @@ const defaultEnvironment = [
   ),
 ];
 
-const defaultRaxEnvironment = [
-  assetItem(
-    AssetType.JSText,
-    'window.Rax=parent.Rax;window.React=parent.React;window.ReactDOM=parent.ReactDOM;window.VisualEngineUtils=parent.VisualEngineUtils;window.VisualEngine=parent.VisualEngine',
-  ),
-  assetItem(
-    AssetType.JSText,
-    'window.PropTypes=parent.PropTypes;React.PropTypes=parent.PropTypes; window.__REACT_DEVTOOLS_GLOBAL_HOOK__ = window.parent.__REACT_DEVTOOLS_GLOBAL_HOOK__;',
-  ),
-];
-
 export class BuiltinSimulatorHost implements ISimulatorHost<BuiltinSimulatorProps> {
   readonly isSimulator = true;
 
@@ -467,11 +444,15 @@ export class BuiltinSimulatorHost implements ISimulatorHost<BuiltinSimulatorProp
 
     const libraryAsset: AssetList = this.buildLibrary();
 
+    if (this.renderEnv === 'rax') {
+      logger.error('After LowcodeEngine v1.3.0, Rax is no longer supported.');
+    }
+
     const vendors = [
       // required & use once
       assetBundle(
         this.get('environment') ||
-          (this.renderEnv === 'rax' ? defaultRaxEnvironment : defaultEnvironment),
+        defaultEnvironment,
         AssetLevel.Environment,
       ),
       // required & use once
@@ -484,7 +465,7 @@ export class BuiltinSimulatorHost implements ISimulatorHost<BuiltinSimulatorProp
       // required & use once
       assetBundle(
         this.get('simulatorUrl') ||
-          (this.renderEnv === 'rax' ? defaultRaxSimulatorUrl : defaultSimulatorUrl),
+        defaultSimulatorUrl,
         AssetLevel.Runtime,
       ),
     ];
@@ -851,16 +832,22 @@ export class BuiltinSimulatorHost implements ISimulatorHost<BuiltinSimulatorProp
     doc.addEventListener('contextmenu', (e: MouseEvent) => {
       const targetElement = e.target as HTMLElement;
       const nodeInst = this.getNodeInstanceFromElement(targetElement);
+      const editor = this.designer?.editor;
       if (!nodeInst) {
+        editor?.eventBus.emit('designer.builtinSimulator.contextmenu', {
+          originalEvent: e,
+        });
         return;
       }
       const node = nodeInst.node || this.project.currentDocument?.focusNode;
       if (!node) {
+        editor?.eventBus.emit('designer.builtinSimulator.contextmenu', {
+          originalEvent: e,
+        });
         return;
       }
 
       // dirty code should refector
-      const editor = this.designer?.editor;
       const npm = node?.componentMeta?.npm;
       const selected =
         [npm?.package, npm?.componentName].filter((item) => !!item).join('-') ||

packages/designer/src/builtin-simulator/index.ts

@@ -2,3 +2,4 @@ export * from './host';
 export * from './host-view';
 export * from './renderer';
 export * from './live-editing/live-editing';
+export { LowcodeTypes } from './utils/parse-metadata';

packages/designer/src/builtin-simulator/utils/parse-metadata.ts

@@ -16,8 +16,16 @@ export const primitiveTypes = [
   'any',
 ];
 
+interface LowcodeCheckType {
+  // isRequired, props, propName, componentName, location, propFullName, secret
+  (props: any, propName: string, componentName: string, ...rest: any[]): Error | null;
+  // (...reset: any[]): Error | null;
+  isRequired?: LowcodeCheckType;
+  type?: string | object;
+}
+
 // eslint-disable-next-line @typescript-eslint/ban-types
-function makeRequired(propType: any, lowcodeType: string | object) {
+function makeRequired(propType: any, lowcodeType: string | object): LowcodeCheckType {
   function lowcodeCheckTypeIsRequired(...rest: any[]) {
     return propType.isRequired(...rest);
   }
@@ -34,7 +42,7 @@ function makeRequired(propType: any, lowcodeType: string | object) {
 }
 
 // eslint-disable-next-line @typescript-eslint/ban-types
-function define(propType: any = PropTypes.any, lowcodeType: string | object = {}) {
+function define(propType: any = PropTypes.any, lowcodeType: string | object = {}): LowcodeCheckType {
   if (!propType._inner && propType.name !== 'lowcodeCheckType') {
     propType.lowcodeType = lowcodeType;
   }
@@ -46,13 +54,15 @@ function define(propType: any = PropTypes.any, lowcodeType: string | object = {}
   return lowcodeCheckType;
 }
 
-const LowcodeTypes: any = {
+export const LowcodeTypes: any = {
   ...PropTypes,
   define,
 };
 
 (window as any).PropTypes = LowcodeTypes;
-(window as any).React.PropTypes = LowcodeTypes;
+if ((window as any).React) {
+  (window as any).React.PropTypes = LowcodeTypes;
+}
 
 // override primitive type checkers
 primitiveTypes.forEach((type) => {

packages/designer/src/component-meta.ts

@@ -48,13 +48,17 @@ export function buildFilter(rule?: string | string[] | RegExp | IPublicTypeNesti
     return rule;
   }
   if (isRegExp(rule)) {
-    return (testNode: Node | IPublicTypeNodeSchema) => rule.test(testNode.componentName);
+    return (testNode: Node | IPublicTypeNodeSchema) => {
+      return rule.test(testNode.componentName);
+    };
   }
   const list = ensureAList(rule);
   if (!list) {
     return null;
   }
-  return (testNode: Node | IPublicTypeNodeSchema) => list.includes(testNode.componentName);
+  return (testNode: Node | IPublicTypeNodeSchema) => {
+    return list.includes(testNode.componentName);
+  };
 }
 
 export interface IComponentMeta extends IPublicModelComponentMeta<INode> {

packages/designer/src/context-menu-actions.scss

@@ -0,0 +1,10 @@
+.engine-context-menu {
+  &.next-menu.next-ver .next-menu-item {
+    padding-right: 30px;
+
+    .next-menu-item-inner {
+      height: var(--context-menu-item-height, 30px);
+      line-height: var(--context-menu-item-height, 30px);
+    }
+  }
+}

packages/designer/src/context-menu-actions.ts

@@ -0,0 +1,233 @@
+import { IPublicTypeContextMenuAction, IPublicEnumContextMenuType, IPublicTypeContextMenuItem, IPublicApiMaterial, IPublicModelPluginContext } from '@alilc/lowcode-types';
+import { IDesigner, INode } from './designer';
+import { createContextMenu, parseContextMenuAsReactNode, parseContextMenuProperties, uniqueId } from '@alilc/lowcode-utils';
+import { Menu } from '@alifd/next';
+import { engineConfig } from '@alilc/lowcode-editor-core';
+import './context-menu-actions.scss';
+
+export interface IContextMenuActions {
+  actions: IPublicTypeContextMenuAction[];
+
+  adjustMenuLayoutFn: (actions: IPublicTypeContextMenuItem[]) => IPublicTypeContextMenuItem[];
+
+  addMenuAction: IPublicApiMaterial['addContextMenuOption'];
+
+  removeMenuAction: IPublicApiMaterial['removeContextMenuOption'];
+
+  adjustMenuLayout: IPublicApiMaterial['adjustContextMenuLayout'];
+}
+
+let adjustMenuLayoutFn: Function = (actions: IPublicTypeContextMenuAction[]) => actions;
+
+export class GlobalContextMenuActions {
+  enableContextMenu: boolean;
+
+  dispose: Function[];
+
+  contextMenuActionsMap: Map<string, ContextMenuActions> = new Map();
+
+  constructor() {
+    this.dispose = [];
+
+    engineConfig.onGot('enableContextMenu', (enable) => {
+      if (this.enableContextMenu === enable) {
+        return;
+      }
+      this.enableContextMenu = enable;
+      this.dispose.forEach(d => d());
+      if (enable) {
+        this.initEvent();
+      }
+    });
+  }
+
+  handleContextMenu = (
+    event: MouseEvent,
+  ) => {
+    event.stopPropagation();
+    event.preventDefault();
+
+    const actions: IPublicTypeContextMenuAction[] = [];
+    let contextMenu: ContextMenuActions = this.contextMenuActionsMap.values().next().value;
+    this.contextMenuActionsMap.forEach((contextMenu) => {
+      actions.push(...contextMenu.actions);
+    });
+
+    let destroyFn: Function | undefined;
+
+    const destroy = () => {
+      destroyFn?.();
+    };
+    const pluginContext: IPublicModelPluginContext = contextMenu.designer.editor.get('pluginContext') as IPublicModelPluginContext;
+
+    const menus: IPublicTypeContextMenuItem[] = parseContextMenuProperties(actions, {
+      nodes: [],
+      destroy,
+      event,
+      pluginContext,
+    });
+
+    if (!menus.length) {
+      return;
+    }
+
+    const layoutMenu = adjustMenuLayoutFn(menus);
+
+    const menuNode = parseContextMenuAsReactNode(layoutMenu, {
+      destroy,
+      nodes: [],
+      pluginContext,
+    });
+
+    const target = event.target;
+
+    const { top, left } = target?.getBoundingClientRect();
+
+    const menuInstance = Menu.create({
+      target: event.target,
+      offset: [event.clientX - left, event.clientY - top],
+      children: menuNode,
+      className: 'engine-context-menu',
+    });
+
+    destroyFn = (menuInstance as any).destroy;
+  };
+
+  initEvent() {
+    this.dispose.push(
+      (() => {
+        const handleContextMenu = (e: MouseEvent) => {
+          this.handleContextMenu(e);
+        };
+
+        document.addEventListener('contextmenu', handleContextMenu);
+
+        return () => {
+          document.removeEventListener('contextmenu', handleContextMenu);
+        };
+      })(),
+    );
+  }
+
+  registerContextMenuActions(contextMenu: ContextMenuActions) {
+    this.contextMenuActionsMap.set(contextMenu.id, contextMenu);
+  }
+}
+
+const globalContextMenuActions = new GlobalContextMenuActions();
+
+export class ContextMenuActions implements IContextMenuActions {
+  actions: IPublicTypeContextMenuAction[] = [];
+
+  designer: IDesigner;
+
+  dispose: Function[];
+
+  enableContextMenu: boolean;
+
+  id: string = uniqueId('contextMenu');;
+
+  constructor(designer: IDesigner) {
+    this.designer = designer;
+    this.dispose = [];
+
+    engineConfig.onGot('enableContextMenu', (enable) => {
+      if (this.enableContextMenu === enable) {
+        return;
+      }
+      this.enableContextMenu = enable;
+      this.dispose.forEach(d => d());
+      if (enable) {
+        this.initEvent();
+      }
+    });
+
+    globalContextMenuActions.registerContextMenuActions(this);
+  }
+
+  handleContextMenu = (
+    nodes: INode[],
+    event: MouseEvent,
+  ) => {
+    const designer = this.designer;
+    event.stopPropagation();
+    event.preventDefault();
+
+    const actions = designer.contextMenuActions.actions;
+
+    const { bounds } = designer.project.simulator?.viewport || { bounds: { left: 0, top: 0 } };
+    const { left: simulatorLeft, top: simulatorTop } = bounds;
+
+    let destroyFn: Function | undefined;
+
+    const destroy = () => {
+      destroyFn?.();
+    };
+
+    const pluginContext: IPublicModelPluginContext = this.designer.editor.get('pluginContext') as IPublicModelPluginContext;
+
+    const menus: IPublicTypeContextMenuItem[] = parseContextMenuProperties(actions, {
+      nodes: nodes.map(d => designer.shellModelFactory.createNode(d)!),
+      destroy,
+      event,
+      pluginContext,
+    });
+
+    if (!menus.length) {
+      return;
+    }
+
+    const layoutMenu = adjustMenuLayoutFn(menus);
+
+    const menuNode = parseContextMenuAsReactNode(layoutMenu, {
+      destroy,
+      nodes: nodes.map(d => designer.shellModelFactory.createNode(d)!),
+      pluginContext,
+    });
+
+    destroyFn = createContextMenu(menuNode, {
+      event,
+      offset: [simulatorLeft, simulatorTop],
+    });
+  };
+
+  initEvent() {
+    const designer = this.designer;
+    this.dispose.push(
+      designer.editor.eventBus.on('designer.builtinSimulator.contextmenu', ({
+        node,
+        originalEvent,
+      }: {
+        node: INode;
+        originalEvent: MouseEvent;
+      }) => {
+        originalEvent.stopPropagation();
+        originalEvent.preventDefault();
+        // 如果右键的节点不在 当前选中的节点中，选中该节点
+        if (!designer.currentSelection.has(node.id)) {
+          designer.currentSelection.select(node.id);
+        }
+        const nodes = designer.currentSelection.getNodes();
+        this.handleContextMenu(nodes, originalEvent);
+      }),
+    );
+  }
+
+  addMenuAction(action: IPublicTypeContextMenuAction) {
+    this.actions.push({
+      type: IPublicEnumContextMenuType.MENU_ITEM,
+      ...action,
+    });
+  }
+
+  removeMenuAction(name: string) {
+    const i = this.actions.findIndex((action) => action.name === name);
+    if (i > -1) {
+      this.actions.splice(i, 1);
+    }
+  }
+
+  adjustMenuLayout(fn: (actions: IPublicTypeContextMenuItem[]) => IPublicTypeContextMenuItem[]) {
+    adjustMenuLayoutFn = fn;
+  }
+}

packages/designer/src/designer/clipboard.ts

@@ -36,6 +36,10 @@ class Clipboard implements IClipboard {
 
   private waitFn?: (data: any, e: ClipboardEvent) => void;
 
+  constructor() {
+    this.injectCopyPaster(document);
+  }
+
   isCopyPasteEvent(e: Event) {
     this.isCopyPaster(e.target);
   }
@@ -69,7 +73,13 @@ class Clipboard implements IClipboard {
     }
     const copyPaster = document.createElement<'textarea'>('textarea');
     copyPaster.style.cssText = 'position: absolute;left: -9999px;top:-100px';
-    document.body.appendChild(copyPaster);
+    if (document.body) {
+      document.body.appendChild(copyPaster);
+    } else {
+      document.addEventListener('DOMContentLoaded', () => {
+        document.body.appendChild(copyPaster);
+      });
+    }
     const dispose = this.initCopyPaster(copyPaster);
     return () => {
       dispose();

packages/designer/src/designer/designer-view.tsx

@@ -4,7 +4,6 @@ import BuiltinDragGhostComponent from './drag-ghost';
 import { Designer, DesignerProps } from './designer';
 import { ProjectView } from '../project';
 import './designer.less';
-import { clipboard } from './clipboard';
 
 type IProps = DesignerProps & {
   designer?: Designer;
@@ -44,7 +43,6 @@ export class DesignerView extends Component<IProps> {
     if (onMount) {
       onMount(this.designer);
     }
-    clipboard.injectCopyPaster(document);
     this.designer.postEvent('mount', this.designer);
   }
 

packages/designer/src/designer/designer.ts

@@ -20,7 +20,7 @@ import {
 } from '@alilc/lowcode-types';
 import { mergeAssets, IPublicTypeAssetsJson, isNodeSchema, isDragNodeObject, isDragNodeDataObject, isLocationChildrenDetail, Logger } from '@alilc/lowcode-utils';
 import { IProject, Project } from '../project';
-import { Node, DocumentModel, insertChildren, INode } from '../document';
+import { Node, DocumentModel, insertChildren, INode, ISelection } from '../document';
 import { ComponentMeta, IComponentMeta } from '../component-meta';
 import { INodeSelector, Component } from '../simulator';
 import { Scroller } from './scroller';
@@ -32,6 +32,7 @@ import { OffsetObserver, createOffsetObserver } from './offset-observer';
 import { ISettingTopEntry, SettingTopEntry } from './setting';
 import { BemToolsManager } from '../builtin-simulator/bem-tools/manager';
 import { ComponentActions } from '../component-actions';
+import { ContextMenuActions, IContextMenuActions } from '../context-menu-actions';
 
 const logger = new Logger({ level: 'warn', bizName: 'designer' });
 
@@ -72,12 +73,16 @@ export interface IDesigner {
 
   get componentActions(): ComponentActions;
 
+  get contextMenuActions(): ContextMenuActions;
+
   get editor(): IPublicModelEditor;
 
   get detecting(): Detecting;
 
   get simulatorComponent(): ComponentType<any> | undefined;
 
+  get currentSelection(): ISelection;
+
   createScroller(scrollable: IPublicTypeScrollable): IPublicModelScroller;
 
   refreshComponentMetasMap(): void;
@@ -122,6 +127,8 @@ export class Designer implements IDesigner {
 
   readonly componentActions = new ComponentActions();
 
+  readonly contextMenuActions: IContextMenuActions;
+
   readonly activeTracker = new ActiveTracker();
 
   readonly detecting = new Detecting();
@@ -198,6 +205,8 @@ export class Designer implements IDesigner {
       this.postEvent('dragstart', e);
     });
 
+    this.contextMenuActions = new ContextMenuActions(this);
+
     this.dragon.onDrag((e) => {
       if (this.props?.onDrag) {
         this.props.onDrag(e);

packages/designer/src/designer/setting/setting-top-entry.ts

@@ -1,4 +1,4 @@
-import { IPublicTypeCustomView, IPublicModelEditor, IPublicModelSettingTopEntry } from '@alilc/lowcode-types';
+import { IPublicTypeCustomView, IPublicModelEditor, IPublicModelSettingTopEntry, IPublicApiSetters } from '@alilc/lowcode-types';
 import { isCustomView } from '@alilc/lowcode-utils';
 import { computed, IEventBus, createModuleEventBus } from '@alilc/lowcode-editor-core';
 import { ISettingEntry } from './setting-entry-type';
@@ -6,7 +6,6 @@ import { ISettingField, SettingField } from './setting-field';
 import { INode } from '../../document';
 import type { IComponentMeta } from '../../component-meta';
 import { IDesigner } from '../designer';
-import { Setters } from '@alilc/lowcode-shell';
 
 function generateSessionId(nodes: INode[]) {
   return nodes
@@ -19,18 +18,18 @@ export interface ISettingTopEntry extends ISettingEntry, IPublicModelSettingTopE
   INode,
   ISettingField
 > {
-  purge(): void;
-
-  items: Array<ISettingField | IPublicTypeCustomView>;
-
   readonly top: ISettingTopEntry;
 
   readonly parent: ISettingTopEntry;
 
   readonly path: never[];
 
+  items: Array<ISettingField | IPublicTypeCustomView>;
+
   componentMeta: IComponentMeta | null;
 
+  purge(): void;
+
   getExtraPropValue(propName: string): void;
 
   setExtraPropValue(propName: string, value: any): void;
@@ -92,7 +91,7 @@ export class SettingTopEntry implements ISettingTopEntry {
 
   readonly designer: IDesigner | undefined;
 
-  readonly setters: Setters;
+  readonly setters: IPublicApiSetters;
 
   disposeFunctions: any[] = [];
 
@@ -103,7 +102,7 @@ export class SettingTopEntry implements ISettingTopEntry {
     this.id = generateSessionId(nodes);
     this.first = nodes[0];
     this.designer = this.first.document?.designer;
-    this.setters = editor.get('setters') as Setters;
+    this.setters = editor.get('setters') as IPublicApiSetters;
 
     // setups
     this.setupComponentMeta();

packages/designer/src/designer/setting/utils.ts

@@ -70,7 +70,7 @@ export class Transducer {
     }
     if (isDynamicSetter(setter) && isDynamic) {
       try {
-        setter = setter.call(context, context);
+        setter = setter.call(context.internalToShellField(), context.internalToShellField());
       } catch (e) { console.error(e); }
     }
 

packages/designer/src/document/node/node-children.ts

@@ -462,6 +462,9 @@ export class NodeChildren implements INodeChildren {
           const node: INode = this.owner.document?.createNode(child);
           this.children.push(node);
           node.internalSetParent(this.owner);
+          /* istanbul ignore next */
+          const editor = node.document?.designer.editor;
+          editor?.eventBus.emit('node.add', { node });
         });
         changed = true;
       }

packages/designer/src/document/node/node.ts

@@ -392,7 +392,7 @@ export class Node<Schema extends IPublicTypeNodeSchema = IPublicTypeNodeSchema>
 
     this.isInited = true;
     this.emitter = createModuleEventBus('Node');
-    const editor = this.document.designer.editor;
+    const { editor } = this.document.designer;
     this.onVisibleChange((visible: boolean) => {
       editor?.eventBus.emit(EDITOR_EVENT.NODE_VISIBLE_CHANGE, this, visible);
     });
@@ -440,23 +440,23 @@ export class Node<Schema extends IPublicTypeNodeSchema = IPublicTypeNodeSchema>
   }
 
   private initialChildren(children: IPublicTypeNodeData | IPublicTypeNodeData[] | undefined): IPublicTypeNodeData[] {
-    // FIXME! this is dirty code
+    const { initialChildren } = this.componentMeta.advanced;
+
     if (children == null) {
-      const { initialChildren } = this.componentMeta.advanced;
       if (initialChildren) {
         if (typeof initialChildren === 'function') {
           return initialChildren(this.internalToShellNode()!) || [];
         }
         return initialChildren;
       }
-    }
-    if (Array.isArray(children)) {
-      return children;
-    } else if (children) {
-      return [children];
-    } else {
       return [];
     }
+
+    if (Array.isArray(children)) {
+      return children;
+    }
+
+    return [children];
   }
 
   isContainer(): boolean {
@@ -1094,7 +1094,7 @@ export class Node<Schema extends IPublicTypeNodeSchema = IPublicTypeNodeSchema>
   }
 
   /**
-   * 是否可执行某action
+   * 是否可执行某 action
    */
   canPerformAction(actionName: string): boolean {
     const availableActions =
@@ -1219,11 +1219,18 @@ export class Node<Schema extends IPublicTypeNodeSchema = IPublicTypeNodeSchema>
   /**
    * 获取磁贴相关信息
    */
-  getRGL() {
+  getRGL(): {
+    isContainerNode: boolean;
+    isEmptyNode: boolean;
+    isRGLContainerNode: boolean;
+    isRGLNode: boolean;
+    isRGL: boolean;
+    rglNode: Node | null;
+  } {
     const isContainerNode = this.isContainer();
     const isEmptyNode = this.isEmpty();
     const isRGLContainerNode = this.isRGLContainer;
-    const isRGLNode = this.getParent()?.isRGLContainer;
+    const isRGLNode = (this.getParent()?.isRGLContainer) as boolean;
     const isRGL = isRGLContainerNode || (isRGLNode && (!isContainerNode || !isEmptyNode));
     let rglNode = isRGLContainerNode ? this : isRGL ? this?.getParent() : null;
     return { isContainerNode, isEmptyNode, isRGLContainerNode, isRGLNode, isRGL, rglNode };

packages/designer/src/document/node/props/prop.ts

@@ -290,10 +290,6 @@ export class Prop implements IProp, IPropParent {
     }
 
     if (type === 'literal' || type === 'expression') {
-      // TODO 后端改造之后删除此逻辑
-      if (this._value === null && stage === IPublicEnumTransformStage.Save) {
-        return '';
-      }
       return this._value;
     }
 
@@ -357,7 +353,6 @@ export class Prop implements IProp, IPropParent {
   @action
   setValue(val: IPublicTypeCompositeValue) {
     if (val === this._value) return;
-    const editor = this.owner.document?.designer.editor;
     const oldValue = this._value;
     this._value = val;
     this._code = null;
@@ -390,22 +385,31 @@ export class Prop implements IProp, IPropParent {
     this.setupItems();
 
     if (oldValue !== this._value) {
-      const propsInfo = {
-        key: this.key,
-        prop: this,
-        oldValue,
-        newValue: this._value,
-      };
-
-      editor?.eventBus.emit(GlobalEvent.Node.Prop.InnerChange, {
-        node: this.owner as any,
-        ...propsInfo,
-      });
-
-      this.owner?.emitPropChange?.(propsInfo);
+      this.emitChange({ oldValue });
     }
   }
 
+  emitChange = ({
+    oldValue,
+  }: {
+    oldValue: IPublicTypeCompositeValue | UNSET;
+  }) => {
+    const editor = this.owner.document?.designer.editor;
+    const propsInfo = {
+      key: this.key,
+      prop: this,
+      oldValue,
+      newValue: this.type === 'unset' ? undefined : this._value,
+    };
+
+    editor?.eventBus.emit(GlobalEvent.Node.Prop.InnerChange, {
+      node: this.owner as any,
+      ...propsInfo,
+    });
+
+    this.owner?.emitPropChange?.(propsInfo);
+  };
+
   getValue(): IPublicTypeCompositeValue {
     return this.export(IPublicEnumTransformStage.Serilize);
   }
@@ -466,7 +470,12 @@ export class Prop implements IProp, IPropParent {
    */
   @action
   unset() {
-    this._type = 'unset';
+    if (this._type !== 'unset') {
+      this._type = 'unset';
+      this.emitChange({
+        oldValue: this._value,
+      });
+    }
   }
 
   /**
@@ -561,6 +570,7 @@ export class Prop implements IProp, IPropParent {
   @action
   remove() {
     this.parent.delete(this);
+    this.unset();
   }
 
   /**

packages/designer/src/index.ts

@@ -6,3 +6,4 @@ export * from './project';
 export * from './builtin-simulator';
 export * from './plugin';
 export * from './types';
+export * from './context-menu-actions';

packages/designer/src/plugin/plugin-context.ts

@@ -19,6 +19,7 @@ import {
   IPublicApiWorkspace,
   IPublicEnumPluginRegisterLevel,
   IPublicModelWindow,
+  IPublicApiCommonUI,
 } from '@alilc/lowcode-types';
 import {
   IPluginContextOptions,
@@ -45,6 +46,8 @@ export default class PluginContext implements
   workspace: IPublicApiWorkspace;
   registerLevel: IPublicEnumPluginRegisterLevel;
   editorWindow: IPublicModelWindow;
+  commonUI: IPublicApiCommonUI;
+  isPluginRegisteredInWorkspace: false;
 
   constructor(
       options: IPluginContextOptions,

packages/designer/src/plugin/plugin-types.ts

@@ -18,6 +18,8 @@ import {
   IPublicTypePluginRegisterOptions,
   IPublicModelWindow,
   IPublicEnumPluginRegisterLevel,
+  IPublicApiCommonUI,
+  IPublicApiCommand,
 } from '@alilc/lowcode-types';
 import PluginContext from './plugin-context';
 
@@ -60,6 +62,9 @@ export interface ILowCodePluginContextPrivate {
   set workspace(workspace: IPublicApiWorkspace);
   set editorWindow(window: IPublicModelWindow);
   set registerLevel(level: IPublicEnumPluginRegisterLevel);
+  set isPluginRegisteredInWorkspace(flag: boolean);
+  set commonUI(commonUI: IPublicApiCommonUI);
+  set command(command: IPublicApiCommand);
 }
 export interface ILowCodePluginContextApiAssembler {
   assembleApis(

packages/designer/src/plugin/sequencify.ts

@@ -1,19 +1,50 @@
-function sequence(tasks, names, results, missing, recursive, nest) {
+interface ITaks {
+  [key: string]: {
+    name: string;
+    dep: string[];
+  };
+}
+
+export function sequence({
+  tasks,
+  names,
+  results,
+  missing,
+  recursive,
+  nest,
+  parentName,
+}: {
+  tasks: ITaks;
+  names: string[];
+  results: string[];
+  missing: string[];
+  recursive: string[][];
+  nest: string[];
+  parentName: string;
+}) {
   names.forEach((name) => {
     if (results.indexOf(name) !== -1) {
       return; // de-dup results
     }
     const node = tasks[name];
     if (!node) {
-      missing.push(name);
+      missing.push([parentName, name].filter((d => !!d)).join('.'));
     } else if (nest.indexOf(name) > -1) {
       nest.push(name);
       recursive.push(nest.slice(0));
-      nest.pop(name);
+      nest.pop();
     } else if (node.dep.length) {
       nest.push(name);
-      sequence(tasks, node.dep, results, missing, recursive, nest); // recurse
-      nest.pop(name);
+      sequence({
+        tasks,
+        parentName: name,
+        names: node.dep,
+        results,
+        missing,
+        recursive,
+        nest,
+      }); // recurse
+      nest.pop();
     }
     results.push(name);
   });
@@ -21,12 +52,19 @@ function sequence(tasks, names, results, missing, recursive, nest) {
 
 // tasks: object with keys as task names
 // names: array of task names
-export default function (tasks, names) {
-  let results = []; // the final sequence
-  const missing = []; // missing tasks
-  const recursive = []; // recursive task dependencies
+export default function (tasks: ITaks, names: string[]) {
+  let results: string[] = []; // the final sequence
+  const missing: string[] = []; // missing tasks
+  const recursive: string[][] = []; // recursive task dependencies
 
-  sequence(tasks, names, results, missing, recursive, []);
+  sequence({
+    tasks,
+    names,
+    results,
+    missing,
+    recursive,
+    nest: [],
+  });
 
   if (missing.length || recursive.length) {
     results = []; // results are incomplete at best, completely wrong at worst, remove them to avoid confusion

packages/designer/tests/builtin-simulator/utils/parse-metadata.test.ts

@@ -1,5 +1,7 @@
 import '../../fixtures/window';
-import { parseMetadata } from '../../../src/builtin-simulator/utils/parse-metadata';
+import PropTypes from 'prop-types';
+import { LowcodeTypes, parseMetadata, parseProps } from '../../../src/builtin-simulator/utils/parse-metadata';
+import { default as ReactPropTypesSecret } from 'prop-types/lib/ReactPropTypesSecret';
 
 describe('parseMetadata', () => {
   it('parseMetadata', async () => {
@@ -11,3 +13,165 @@ describe('parseMetadata', () => {
     expect(result).toBeDefined();
   });
 });
+
+describe('LowcodeTypes basic type validators', () => {
+  it('should validate string types', () => {
+    const stringValidator = LowcodeTypes.string;
+    // 对 stringValidator 进行测试
+    const props = { testProp: 'This is a string' };
+    const propName = 'testProp';
+    const componentName = 'TestComponent';
+
+    const result = stringValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(result).toBeNull(); // No error for valid string
+  });
+
+  it('should fail with a non-string type', () => {
+    const stringValidator = LowcodeTypes.string;
+    const props = { testProp: 42 };
+    const propName = 'testProp';
+    const componentName = 'TestComponent';
+
+    const result = stringValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(result).toBeInstanceOf(Error); // Error for non-string type
+    expect(result.message).toContain('Invalid prop `testProp` of type `number` supplied to `TestComponent`, expected `string`.');
+  });
+
+  it('should pass with a valid number', () => {
+    const numberValidator = LowcodeTypes.number;
+    const props = { testProp: 42 };
+    const propName = 'testProp';
+    const componentName = 'TestComponent';
+
+    const result = numberValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(result).toBeNull(); // No error for valid number
+  });
+
+  it('should fail with a non-number type', () => {
+    const numberValidator = LowcodeTypes.number;
+    const props = { testProp: 'Not a number' };
+    const propName = 'testProp';
+    const componentName = 'TestComponent';
+
+    const result = numberValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(result).toBeInstanceOf(Error); // Error for non-number type
+    expect(result.message).toContain('Invalid prop `testProp` of type `string` supplied to `TestComponent`, expected `number`.');
+  });
+});
+
+describe('Custom type constructors', () => {
+  it('should create a custom type validator using define', () => {
+    const customType = LowcodeTypes.define(PropTypes.string, 'customType');
+    const props = { testProp: 'This is a string' };
+    const propName = 'testProp';
+    const componentName = 'TestComponent';
+
+    // 测试有效值
+    const validResult = customType(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(validResult).toBeNull(); // No error for valid string
+
+    // 测试无效值
+    const invalidProps = { testProp: 42 };
+    const invalidResult = customType(invalidProps, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(invalidResult).toBeInstanceOf(Error); // Error for non-string type
+
+    // 验证 lowcodeType 属性
+    expect(customType.lowcodeType).toEqual('customType');
+
+    // 验证 isRequired 属性
+    const requiredResult = customType.isRequired(invalidProps, propName, componentName, 'prop', null, ReactPropTypesSecret);
+    expect(requiredResult).toBeInstanceOf(Error); // Error for non-string type
+  });
+});
+
+
+describe('Advanced type constructors', () => {
+  describe('oneOf Type Validator', () => {
+    const oneOfValidator = LowcodeTypes.oneOf(['red', 'green', 'blue']);
+    const propName = 'color';
+    const componentName = 'ColorPicker';
+
+    it('should pass with a valid value', () => {
+      const props = { color: 'red' };
+      const result = oneOfValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+      expect(result).toBeNull(); // No error for valid value
+    });
+
+    it('should fail with an invalid value', () => {
+      const props = { color: 'yellow' };
+      const result = oneOfValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+      expect(result).toBeInstanceOf(Error); // Error for invalid value
+      expect(result.message).toContain(`Invalid prop \`${propName}\` of value \`yellow\` supplied to \`${componentName}\`, expected one of ["red","green","blue"].`);
+    });
+
+    it('should fail with a non-existing value', () => {
+      const props = { color: 'others' };
+      const result = oneOfValidator(props, propName, componentName, 'prop', null, ReactPropTypesSecret);
+      expect(result).toBeInstanceOf(Error); // Error for non-existing value
+      expect(result.message).toContain(`Invalid prop \`${propName}\` of value \`others\` supplied to \`${componentName}\`, expected one of ["red","green","blue"].`);
+    });
+  });
+});
+
+
+describe('parseProps function', () => {
+  it('should correctly parse propTypes and defaultProps', () => {
+    const component = {
+      propTypes: {
+        name: LowcodeTypes.string,
+        age: LowcodeTypes.number,
+      },
+      defaultProps: {
+        name: 'John Doe',
+        age: 30,
+      },
+    };
+    const parsedProps = parseProps(component);
+
+    // 测试结果长度
+    expect(parsedProps.length).toBe(2);
+
+    // 测试 name 属性
+    const nameProp: any = parsedProps.find(prop => prop.name === 'name');
+    expect(nameProp).toBeDefined();
+    expect(nameProp.propType).toEqual('string');
+    expect(nameProp.defaultValue).toEqual('John Doe');
+
+    // 测试 age 属性
+    const ageProp: any = parsedProps.find(prop => prop.name === 'age');
+    expect(ageProp).toBeDefined();
+    expect(ageProp.propType).toEqual('number');
+    expect(ageProp.defaultValue).toEqual(30);
+  });
+});
+
+describe('parseProps function', () => {
+  it('should correctly parse propTypes and defaultProps', () => {
+    const component = {
+      propTypes: {
+        name: LowcodeTypes.string,
+        age: LowcodeTypes.number,
+      },
+      defaultProps: {
+        name: 'John Doe',
+        age: 30,
+      },
+    };
+    const parsedProps = parseProps(component);
+
+    // 测试结果长度
+    expect(parsedProps.length).toBe(2);
+
+    // 测试 name 属性
+    const nameProp: any = parsedProps.find(prop => prop.name === 'name');
+    expect(nameProp).toBeDefined();
+    expect(nameProp.propType).toEqual('string');
+    expect(nameProp.defaultValue).toEqual('John Doe');
+
+    // 测试 age 属性
+    const ageProp: any = parsedProps.find(prop => prop.name === 'age');
+    expect(ageProp).toBeDefined();
+    expect(ageProp.propType).toEqual('number');
+    expect(ageProp.defaultValue).toEqual(30);
+  });
+});

packages/designer/tests/document/node/node.test.ts

@@ -54,7 +54,60 @@ describe('Node 方法测试', () => {
     project = null;
   });
 
-  it('condition group', () => {});
+  // Case 1: When children is null
+  test('initialChildren returns result of initialChildren function when children is null ', () => {
+    const node = new Node(doc, { componentName: 'Button', props: { a: 1 } });
+    const result = node.initialChildren(null);
+    // 预期结果是一个空数组
+    expect(result).toEqual([]);
+  });
+
+  // Case 2: When children is undefined
+  test('initialChildren returns result of initialChildren function when children is null ', () => {
+    const node = new Node(doc, { componentName: 'Button', props: { a: 1 } });
+    const result = node.initialChildren(undefined);
+    // 预期结果是一个空数组
+    expect(result).toEqual([]);
+  });
+
+  // Case 3: When children is array
+  test('initialChildren returns result of initialChildren function when children is null ', () => {
+    const node = new Node(doc, { componentName: 'Button', props: { a: 1 } });
+    const childrenArray = [{ id: 1, name: 'Child 1' }, { id: 2, name: 'Child 2' }];
+    const result = node.initialChildren(childrenArray);
+    // 预期结果是一个数组
+    expect(result).toEqual(childrenArray);
+  });
+
+  // Case 4: When children is not null and not an array
+  test('initialChildren returns result of initialChildren function when children is null ', () => {
+    const node = new Node(doc, { componentName: 'Button', props: { a: 1 } });
+    const childObject = { id: 1, name: 'Child 1' };
+    const result = node.initialChildren(childObject);
+    // 预期结果是一个数组
+    expect(result).toEqual([childObject]);
+  });
+
+  // Case 5: When children 0
+  test('initialChildren returns result of initialChildren function when children is null ', () => {
+    const node = new Node(doc, { componentName: 'Button', props: { a: 1 } });
+    const childObject = 0;
+    const result = node.initialChildren(childObject);
+    // 预期结果是一个数组
+    expect(result).toEqual([0]);
+  });
+
+  // Case 6: When children false
+  test('initialChildren returns result of initialChildren function when children is null ', () => {
+    const node = new Node(doc, { componentName: 'Button', props: { a: 1 } });
+    const childObject = false;
+    const result = node.initialChildren(childObject);
+    // 预期结果是一个数组
+    expect(result).toEqual([false]);
+  });
+
+
+  it('condition group', () => { });
 
   it('getExtraProp / setExtraProp', () => {
     const firstBtn = doc.getNode('node_k1ow3cbn')!;
@@ -367,7 +420,7 @@ describe('Node 方法测试', () => {
     expect(mockFn).not.toHaveBeenCalled();
   });
 
-  it('addSlot / unlinkSlot / removeSlot', () => {});
+  it('addSlot / unlinkSlot / removeSlot', () => { });
 
   it('setProps', () => {
     const firstBtn = doc.getNode('node_k1ow3cbn')!;
@@ -407,7 +460,7 @@ describe('Node 方法测试', () => {
     designer.createComponentMeta(btnMetadata);
     const btn = doc.getNode('node_k1ow3cbn');
     // 从 componentMeta 中获取到 title 值
-    expect(btn.title).toEqual({ type: 'i18n', 'zh-CN': '按钮', 'en-US': 'Button' } );
+    expect(btn.title).toEqual({ type: 'i18n', 'zh-CN': '按钮', 'en-US': 'Button' });
     // 从 extraProp 中获取值
     btn.setExtraProp('title', 'hello button');
     expect(btn.title).toBe('hello button');
@@ -546,7 +599,7 @@ describe('Node 方法测试', () => {
     expect(comparePosition(firstBtn, firstCard)).toBe(PositionNO.BeforeOrAfter);
   });
 
-  it('getZLevelTop', () => {});
+  it('getZLevelTop', () => { });
   it('propsData', () => {
     expect(new Node(doc, { componentName: 'Leaf' }).propsData).toBeNull();
     expect(new Node(doc, { componentName: 'Fragment' }).propsData).toBeNull();

packages/designer/tests/document/node/props/prop.test.ts

@@ -3,7 +3,7 @@ import { Editor, engineConfig } from '@alilc/lowcode-editor-core';
 import { Designer } from '../../../../src/designer/designer';
 import { DocumentModel } from '../../../../src/document/document-model';
 import { Prop, isProp, isValidArrayIndex } from '../../../../src/document/node/props/prop';
-import { IPublicEnumTransformStage } from '@alilc/lowcode-types';
+import { GlobalEvent, IPublicEnumTransformStage } from '@alilc/lowcode-types';
 import { shellModelFactory } from '../../../../../engine/src/modules/shell-model-factory';
 
 const slotNodeImportMockFn = jest.fn();
@@ -24,14 +24,24 @@ const mockOwner = {
         remove: slotNodeRemoveMockFn,
       };
     },
-    designer: {},
+    designer: {
+      editor: {
+        eventBus: {
+          emit: jest.fn(),
+        },
+      },
+    },
   },
   isInited: true,
+  emitPropChange: jest.fn(),
+  delete() {},
 };
 
 const mockPropsInst = {
   owner: mockOwner,
+  delete() {},
 };
+
 mockPropsInst.props = mockPropsInst;
 
 describe('Prop 类测试', () => {
@@ -136,7 +146,7 @@ describe('Prop 类测试', () => {
       expect(boolProp.export(IPublicEnumTransformStage.Save)).toBe(true);
       expect(strProp.export(IPublicEnumTransformStage.Save)).toBe('haha');
       expect(numProp.export(IPublicEnumTransformStage.Save)).toBe(1);
-      expect(nullProp.export(IPublicEnumTransformStage.Save)).toBe('');
+      expect(nullProp.export(IPublicEnumTransformStage.Save)).toBe(null);
       expect(nullProp.export(IPublicEnumTransformStage.Serilize)).toBe(null);
       expect(expProp.export(IPublicEnumTransformStage.Save)).toEqual({
         type: 'JSExpression',
@@ -564,3 +574,124 @@ describe('其他导出函数', () => {
     expect(isValidArrayIndex('2', 1)).toBeFalsy();
   });
 });
+
+describe('setValue with event', () => {
+  let propInstance;
+  let mockEmitChange;
+  let mockEventBusEmit;
+  let mockEmitPropChange;
+
+  beforeEach(() => {
+    // Initialize the instance of your class
+    propInstance = new Prop(mockPropsInst, true, 'stringProp');;
+
+    // Mock necessary methods and properties
+    mockEmitChange = jest.spyOn(propInstance, 'emitChange');
+    propInstance.owner = {
+      document: {
+        designer: {
+          editor: {
+            eventBus: {
+              emit: jest.fn(),
+            },
+          },
+        },
+      },
+      emitPropChange: jest.fn(),
+      delete() {},
+    };
+    mockEventBusEmit = jest.spyOn(propInstance.owner.document.designer.editor.eventBus, 'emit');
+    mockEmitPropChange = jest.spyOn(propInstance.owner, 'emitPropChange');
+  });
+
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  it('should correctly handle string values and emit changes', () => {
+    const oldValue = propInstance._value;
+    const newValue = 'new string value';
+
+    propInstance.setValue(newValue);
+
+    const expectedPartialPropsInfo = expect.objectContaining({
+      key: propInstance.key,
+      newValue, // You can specifically test only certain keys
+      oldValue,
+    });
+
+    expect(propInstance.getValue()).toBe(newValue);
+    expect(propInstance.type).toBe('literal');
+    expect(mockEmitChange).toHaveBeenCalledWith({ oldValue });
+    expect(mockEventBusEmit).toHaveBeenCalledWith(GlobalEvent.Node.Prop.InnerChange, expectedPartialPropsInfo);
+    expect(mockEmitPropChange).toHaveBeenCalledWith(expectedPartialPropsInfo);
+  });
+
+  it('should handle object values and set type to map', () => {
+    const oldValue = propInstance._value;
+    const newValue = 234;
+
+    const expectedPartialPropsInfo = expect.objectContaining({
+      key: propInstance.key,
+      newValue, // You can specifically test only certain keys
+      oldValue,
+    });
+
+    propInstance.setValue(newValue);
+
+    expect(propInstance.getValue()).toEqual(newValue);
+    expect(propInstance.type).toBe('literal');
+    expect(mockEmitChange).toHaveBeenCalledWith({ oldValue });
+    expect(mockEventBusEmit).toHaveBeenCalledWith(GlobalEvent.Node.Prop.InnerChange, expectedPartialPropsInfo);
+    expect(mockEmitPropChange).toHaveBeenCalledWith(expectedPartialPropsInfo);
+  });
+
+  it('should has event when unset call', () => {
+    const oldValue = propInstance._value;
+
+    propInstance.unset();
+
+    const expectedPartialPropsInfo = expect.objectContaining({
+      key: propInstance.key,
+      newValue: undefined, // You can specifically test only certain keys
+      oldValue,
+    });
+
+    expect(propInstance.getValue()).toEqual(undefined);
+    expect(propInstance.type).toBe('unset');
+    expect(mockEmitChange).toHaveBeenCalledWith({
+      oldValue,
+      newValue: undefined,
+    });
+    expect(mockEventBusEmit).toHaveBeenCalledWith(GlobalEvent.Node.Prop.InnerChange, expectedPartialPropsInfo);
+    expect(mockEmitPropChange).toHaveBeenCalledWith(expectedPartialPropsInfo);
+
+    propInstance.unset();
+    expect(mockEmitChange).toHaveBeenCalledTimes(1);
+  });
+
+  // remove
+  it('should has event when remove call', () => {
+    const oldValue = propInstance._value;
+
+    propInstance.remove();
+
+    const expectedPartialPropsInfo = expect.objectContaining({
+      key: propInstance.key,
+      newValue: undefined, // You can specifically test only certain keys
+      oldValue,
+    });
+
+    expect(propInstance.getValue()).toEqual(undefined);
+    // expect(propInstance.type).toBe('unset');
+    expect(mockEmitChange).toHaveBeenCalledWith({
+      oldValue,
+      newValue: undefined,
+    });
+    expect(mockEventBusEmit).toHaveBeenCalledWith(GlobalEvent.Node.Prop.InnerChange, expectedPartialPropsInfo);
+    expect(mockEmitPropChange).toHaveBeenCalledWith(expectedPartialPropsInfo);
+
+    propInstance.remove();
+    expect(mockEmitChange).toHaveBeenCalledTimes(1);
+  });
+});

packages/designer/tests/fixtures/schema/form.ts

@@ -267,7 +267,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                               },
@@ -337,7 +337,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                               },
@@ -407,7 +407,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                               },
@@ -489,7 +489,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                               },
@@ -578,7 +578,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                                 searchDelay: 300,
@@ -697,7 +697,7 @@ export default {
                         labelTipsText: {
                           type: 'i18n',
                           use: 'zh-CN',
-                          'en-US': null,
+                          'en-US': '',
                           'zh-CN': '',
                         },
                       },
@@ -789,7 +789,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                               },
@@ -871,7 +871,7 @@ export default {
                                 labelTipsText: {
                                   type: 'i18n',
                                   use: 'zh-CN',
-                                  'en-US': null,
+                                  'en-US': '',
                                   'zh-CN': '',
                                 },
                               },

packages/designer/tests/plugin/sequencify.test.ts

@@ -0,0 +1,128 @@
+import sequencify, { sequence } from '../../src/plugin/sequencify';
+
+describe('sequence', () => {
+  it('handles tasks with no dependencies', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: [] },
+      task2: { name: 'Task 2', dep: [] }
+    };
+    const results = [];
+    const missing = [];
+    const recursive = [];
+    sequence({ tasks, names: ['task1', 'task2'], results, missing, recursive, nest: [] });
+
+    expect(results).toEqual(['task1', 'task2']);
+    expect(missing).toEqual([]);
+    expect(recursive).toEqual([]);
+  });
+
+  it('correctly orders tasks based on dependencies', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: [] },
+      task2: { name: 'Task 2', dep: ['task1'] }
+    };
+    const results = [];
+    const missing = [];
+    const recursive = [];
+    sequence({ tasks, names: ['task2', 'task1'], results, missing, recursive, nest: [] });
+
+    expect(results).toEqual(['task1', 'task2']);
+    expect(missing).toEqual([]);
+    expect(recursive).toEqual([]);
+  });
+
+  it('identifies missing tasks', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: [] }
+    };
+    const results = [];
+    const missing = [];
+    const recursive = [];
+    const nest = []
+    sequence({ tasks, names: ['task2'], results, missing, recursive, nest });
+
+    expect(results).toEqual(['task2']);
+    expect(missing).toEqual(['task2']);
+    expect(recursive).toEqual([]);
+    expect(nest).toEqual([]);
+  });
+
+  it('detects recursive dependencies', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: ['task2'] },
+      task2: { name: 'Task 2', dep: ['task1'] }
+    };
+    const results = [];
+    const missing = [];
+    const recursive = [];
+    const nest = []
+    sequence({ tasks, names: ['task1', 'task2'], results, missing, recursive, nest });
+
+    expect(results).toEqual(['task1', 'task2', 'task1']);
+    expect(missing).toEqual([]);
+    expect(recursive).toEqual([['task1', 'task2', 'task1']]);
+    expect(nest).toEqual([]);
+  });
+});
+
+describe('sequence', () => {
+
+  it('should return tasks in sequence without dependencies', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: [] },
+      task2: { name: 'Task 2', dep: [] },
+      task3: { name: 'Task 3', dep: [] }
+    };
+    const names = ['task1', 'task2', 'task3'];
+    const expected = {
+      sequence: ['task1', 'task2', 'task3'],
+      missingTasks: [],
+      recursiveDependencies: []
+    };
+    expect(sequencify(tasks, names)).toEqual(expected);
+  });
+
+  it('should handle tasks with dependencies', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: [] },
+      task2: { name: 'Task 2', dep: ['task1'] },
+      task3: { name: 'Task 3', dep: ['task2'] }
+    };
+    const names = ['task3', 'task2', 'task1'];
+    const expected = {
+      sequence: ['task1', 'task2', 'task3'],
+      missingTasks: [],
+      recursiveDependencies: []
+    };
+    expect(sequencify(tasks, names)).toEqual(expected);
+  });
+
+  it('should identify missing tasks', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: [] },
+      task2: { name: 'Task 2', dep: ['task3'] } // task3 is missing
+    };
+    const names = ['task1', 'task2'];
+    const expected = {
+      sequence: [],
+      missingTasks: ['task2.task3'],
+      recursiveDependencies: []
+    };
+    expect(sequencify(tasks, names)).toEqual(expected);
+  });
+
+  it('should detect recursive dependencies', () => {
+    const tasks = {
+      task1: { name: 'Task 1', dep: ['task2'] },
+      task2: { name: 'Task 2', dep: ['task1'] } // Recursive dependency
+    };
+    const names = ['task1', 'task2'];
+    const expected = {
+      sequence: [],
+      missingTasks: [],
+      recursiveDependencies: [['task1', 'task2', 'task1']]
+    };
+    expect(sequencify(tasks, names)).toEqual(expected);
+  });
+
+});

packages/editor-core/build.test.json

@@ -0,0 +1,9 @@
+{
+  "plugins": [
+    "@alilc/build-plugin-lce",
+    "@alilc/lowcode-test-mate/plugin/index.ts"
+  ],
+  "babelPlugins": [
+    ["@babel/plugin-proposal-private-property-in-object", { "loose": true }]
+  ]
+}

packages/editor-core/jest.config.js

@@ -0,0 +1,26 @@
+const fs = require('fs');
+const { join } = require('path');
+const esModules = [].join('|');
+const pkgNames = fs.readdirSync(join('..')).filter(pkgName => !pkgName.startsWith('.'));
+
+const jestConfig = {
+  transformIgnorePatterns: [
+    `/node_modules/(?!${esModules})/`,
+  ],
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'json'],
+  collectCoverage: false,
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/icons/**',
+    '!src/locale/**',
+    '!**/node_modules/**',
+    '!**/vendor/**',
+  ],
+};
+
+// 只对本仓库内的 pkg 做 mapping
+jestConfig.moduleNameMapper = {};
+jestConfig.moduleNameMapper[`^@alilc/lowcode\\-(${pkgNames.join('|')})$`] = '<rootDir>/../$1/src';
+
+module.exports = jestConfig;

packages/editor-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alilc/lowcode-editor-core",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "description": "Core Api for Ali lowCode engine",
   "license": "MIT",
   "main": "lib/index.js",
@@ -10,12 +10,14 @@
     "es"
   ],
   "scripts": {
-    "build": "build-scripts build"
+    "build": "build-scripts build",
+    "test": "build-scripts test --config build.test.json",
+    "test:cov": "build-scripts test --config build.test.json --jest-coverage"
   },
   "dependencies": {
     "@alifd/next": "^1.19.16",
-    "@alilc/lowcode-types": "1.2.2",
-    "@alilc/lowcode-utils": "1.2.2",
+    "@alilc/lowcode-types": "1.3.2",
+    "@alilc/lowcode-utils": "1.3.2",
     "classnames": "^2.2.6",
     "debug": "^4.1.1",
     "intl-messageformat": "^9.3.1",

packages/editor-core/src/command.ts

@@ -0,0 +1,91 @@
+import { IPublicApiCommand, IPublicEnumTransitionType, IPublicModelPluginContext, IPublicTypeCommand, IPublicTypeCommandHandlerArgs, IPublicTypeListCommand } from '@alilc/lowcode-types';
+import { checkPropTypes } from '@alilc/lowcode-utils';
+export interface ICommand extends Omit<IPublicApiCommand, 'registerCommand' | 'batchExecuteCommand'> {
+  registerCommand(command: IPublicTypeCommand, options?: {
+    commandScope?: string;
+  }): void;
+
+  batchExecuteCommand(commands: { name: string; args: IPublicTypeCommandHandlerArgs }[], pluginContext?: IPublicModelPluginContext): void;
+}
+
+export interface ICommandOptions {
+  commandScope?: string;
+}
+
+export class Command implements ICommand {
+  private commands: Map<string, IPublicTypeCommand> = new Map();
+  private commandErrors: Function[] = [];
+
+  registerCommand(command: IPublicTypeCommand, options?: ICommandOptions): void {
+    if (!options?.commandScope) {
+      throw new Error('plugin meta.commandScope is required.');
+    }
+    const name = `${options.commandScope}:${command.name}`;
+    if (this.commands.has(name)) {
+      throw new Error(`Command '${command.name}' is already registered.`);
+    }
+    this.commands.set(name, {
+      ...command,
+      name,
+    });
+  }
+
+  unregisterCommand(name: string): void {
+    if (!this.commands.has(name)) {
+      throw new Error(`Command '${name}' is not registered.`);
+    }
+    this.commands.delete(name);
+  }
+
+  executeCommand(name: string, args: IPublicTypeCommandHandlerArgs): void {
+    const command = this.commands.get(name);
+    if (!command) {
+      throw new Error(`Command '${name}' is not registered.`);
+    }
+    command.parameters?.forEach(d => {
+      if (!checkPropTypes(args[d.name], d.name, d.propType, 'command')) {
+        throw new Error(`Command '${name}' arguments ${d.name} is invalid.`);
+      }
+    });
+    try {
+      command.handler(args);
+    } catch (error) {
+      if (this.commandErrors && this.commandErrors.length) {
+        this.commandErrors.forEach(callback => callback(name, error));
+      } else {
+        throw error;
+      }
+    }
+  }
+
+  batchExecuteCommand(commands: { name: string; args: IPublicTypeCommandHandlerArgs }[], pluginContext: IPublicModelPluginContext): void {
+    if (!commands || !commands.length) {
+      return;
+    }
+    pluginContext.common.utils.executeTransaction(() => {
+      commands.forEach(command => this.executeCommand(command.name, command.args));
+    }, IPublicEnumTransitionType.REPAINT);
+  }
+
+  listCommands(): IPublicTypeListCommand[] {
+    return Array.from(this.commands.values()).map(d => {
+      const result: IPublicTypeListCommand = {
+        name: d.name,
+      };
+
+      if (d.description) {
+        result.description = d.description;
+      }
+
+      if (d.parameters) {
+        result.parameters = d.parameters;
+      }
+
+      return result;
+    });
+  }
+
+  onCommandError(callback: (name: string, error: Error) => void): void {
+    this.commandErrors.push(callback);
+  }
+}

packages/editor-core/src/config.ts

@@ -44,7 +44,7 @@ const VALID_ENGINE_OPTIONS = {
   },
   renderEnv: {
     type: 'string',
-    enum: ['react', 'rax', 'any string value'],
+    enum: ['react', 'any string value'],
     default: 'react',
     description: '渲染器类型',
   },
@@ -159,6 +159,16 @@ const VALID_ENGINE_OPTIONS = {
     type: 'function',
     description: '应用级设计模式下，窗口为空时展示的占位组件',
   },
+  enableContextMenu: {
+    type: 'boolean',
+    description: '是否开启右键菜单',
+    default: false,
+  },
+  hideComponentAction: {
+    type: 'boolean',
+    description: '是否隐藏设计器辅助层',
+    default: false,
+  },
 };
 
 const getStrictModeValue = (engineOptions: IPublicTypeEngineOptions, defaultValue: boolean): boolean => {

packages/editor-core/src/di/setter.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { IPublicApiSetters, IPublicTypeCustomView, IPublicTypeRegisteredSetter } from '@alilc/lowcode-types';
+import { IPublicApiSetters, IPublicModelSettingField, IPublicTypeCustomView, IPublicTypeRegisteredSetter } from '@alilc/lowcode-types';
 import { createContent, isCustomView } from '@alilc/lowcode-utils';
 
 const settersMap = new Map<string, IPublicTypeRegisteredSetter & {
@@ -28,7 +28,7 @@ export function registerSetter(
   if (!setter.initialValue) {
     const initial = getInitialFromSetter(setter.component);
     if (initial) {
-      setter.initialValue = (field: any) => {
+      setter.initialValue = (field: IPublicModelSettingField) => {
         return initial.call(field, field.getValue());
       };
     }
@@ -81,7 +81,7 @@ export class Setters implements ISetters {
     if (!setter.initialValue) {
       const initial = getInitialFromSetter(setter.component);
       if (initial) {
-        setter.initialValue = (field: any) => {
+        setter.initialValue = (field: IPublicModelSettingField) => {
           return initial.call(field, field.getValue());
         };
       }

packages/editor-core/src/index.ts

@@ -6,3 +6,4 @@ export * from './hotkey';
 export * from './widgets';
 export * from './config';
 export * from './event-bus';
+export * from './command';

packages/editor-core/src/intl/index.ts

@@ -3,6 +3,7 @@ import { IntlMessageFormat } from 'intl-messageformat';
 import { globalLocale } from './global-locale';
 import { isI18nData } from '@alilc/lowcode-utils';
 import { observer } from '../utils';
+import { IPublicTypeI18nData } from '@alilc/lowcode-types';
 
 function generateTryLocales(locale: string) {
   const tries = [locale, locale.replace('-', '_')];
@@ -26,18 +27,9 @@ function injectVars(msg: string, params: any, locale: string): string {
   }
   const formater = new IntlMessageFormat(msg, locale);
   return formater.format(params as any) as string;
-  /*
-
-  return template.replace(/({\w+})/g, (_, $1) => {
-    const key = (/\d+/.exec($1) || [])[0] as any;
-    if (key && params[key] != null) {
-      return params[key];
-    }
-    return $1;
-  }); */
 }
 
-export function intl(data: any, params?: object): ReactNode {
+export function intl(data: IPublicTypeI18nData | string, params?: object): ReactNode {
   if (!isI18nData(data)) {
     return data;
   }

packages/editor-core/src/widgets/tip/help-tips.tsx

@@ -0,0 +1,40 @@
+import { IPublicTypeHelpTipConfig, IPublicTypeTipConfig } from '@alilc/lowcode-types';
+import { Tip } from './tip';
+import { Icon } from '@alifd/next';
+import { IconProps } from '@alifd/next/types/icon';
+
+export function HelpTip({
+  help,
+  direction = 'top',
+  size = 'small',
+}: {
+  help: IPublicTypeHelpTipConfig;
+  direction?: IPublicTypeTipConfig['direction'];
+  size?: IconProps['size'];
+}) {
+  if (typeof help === 'string') {
+    return (
+      <div>
+        <Icon type="help" size={size} className="lc-help-tip" />
+        <Tip direction={direction}>{help}</Tip>
+      </div>
+    );
+  }
+
+  if (typeof help === 'object' && help.url) {
+    return (
+      <div>
+        <a href={help.url} target="_blank" rel="noopener noreferrer">
+          <Icon type="help" size={size} className="lc-help-tip" />
+        </a>
+        <Tip direction={direction}>{help.content}</Tip>
+      </div>
+    );
+  }
+  return (
+    <div>
+      <Icon type="help" size="small" className="lc-help-tip" />
+      <Tip direction={direction}>{help.content}</Tip>
+    </div>
+  );
+}

packages/editor-core/src/widgets/tip/index.ts

@@ -2,3 +2,4 @@ import './style.less';
 
 export * from './tip';
 export * from './tip-container';
+export * from './help-tips';

packages/editor-core/src/widgets/title/index.tsx

@@ -1,7 +1,7 @@
 import { Component, isValidElement, ReactNode } from 'react';
 import classNames from 'classnames';
 import { createIcon, isI18nData, isTitleConfig } from '@alilc/lowcode-utils';
-import { IPublicTypeTitleContent, IPublicTypeI18nData, IPublicTypeTitleConfig } from '@alilc/lowcode-types';
+import { IPublicTypeI18nData, IPublicTypeTitleConfig, IPublicTypeTitleProps } from '@alilc/lowcode-types';
 import { intl } from '../../intl';
 import { Tip } from '../tip';
 import './title.less';
@@ -36,13 +36,7 @@ import './title.less';
   return fragments;
 }
 
-export class Title extends Component<{
-  title: IPublicTypeTitleContent;
-  className?: string;
-  onClick?: () => void;
-  match?: boolean;
-  keywords?: string;
-}> {
+export class Title extends Component<IPublicTypeTitleProps> {
   constructor(props: any) {
     super(props);
     this.handleClick = this.handleClick.bind(this);

packages/editor-core/test/command.test.ts

@@ -0,0 +1,326 @@
+import { Command } from '../src/command';
+
+describe('Command', () => {
+  let commandInstance;
+  let mockHandler;
+
+  beforeEach(() => {
+    commandInstance = new Command();
+    mockHandler = jest.fn();
+  });
+
+  describe('registerCommand', () => {
+    it('should register a command successfully', () => {
+      const command = {
+        name: 'testCommand',
+        handler: mockHandler,
+      };
+      commandInstance.registerCommand(command, { commandScope: 'testScope' });
+
+      const registeredCommand = commandInstance.listCommands().find(c => c.name === 'testScope:testCommand');
+      expect(registeredCommand).toBeDefined();
+      expect(registeredCommand.name).toBe('testScope:testCommand');
+    });
+
+    it('should throw an error if commandScope is not provided', () => {
+      const command = {
+        name: 'testCommand',
+        handler: mockHandler,
+      };
+
+      expect(() => {
+        commandInstance.registerCommand(command);
+      }).toThrow('plugin meta.commandScope is required.');
+    });
+
+    it('should throw an error if command is already registered', () => {
+      const command = {
+        name: 'testCommand',
+        handler: mockHandler,
+      };
+      commandInstance.registerCommand(command, { commandScope: 'testScope' });
+
+      expect(() => {
+        commandInstance.registerCommand(command, { commandScope: 'testScope' });
+      }).toThrow(`Command 'testCommand' is already registered.`);
+    });
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+});
+
+describe('unregisterCommand', () => {
+  let commandInstance;
+  let mockHandler;
+
+  beforeEach(() => {
+    commandInstance = new Command();
+    mockHandler = jest.fn();
+    // 先注册一个命令以便之后注销
+    const command = {
+      name: 'testCommand',
+      handler: mockHandler,
+    };
+    commandInstance.registerCommand(command, { commandScope: 'testScope' });
+  });
+
+  it('should unregister a command successfully', () => {
+    const commandName = 'testScope:testCommand';
+    expect(commandInstance.listCommands().find(c => c.name === commandName)).toBeDefined();
+
+    commandInstance.unregisterCommand(commandName);
+
+    expect(commandInstance.listCommands().find(c => c.name === commandName)).toBeUndefined();
+  });
+
+  it('should throw an error if the command is not registered', () => {
+    const nonExistingCommandName = 'testScope:nonExistingCommand';
+    expect(() => {
+      commandInstance.unregisterCommand(nonExistingCommandName);
+    }).toThrow(`Command '${nonExistingCommandName}' is not registered.`);
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+});
+
+describe('executeCommand', () => {
+  let commandInstance;
+  let mockHandler;
+
+  beforeEach(() => {
+    commandInstance = new Command();
+    mockHandler = jest.fn();
+    // 注册一个带参数校验的命令
+    const command = {
+      name: 'testCommand',
+      handler: mockHandler,
+      parameters: [
+        { name: 'param1', propType: 'string' },
+        { name: 'param2', propType: 'number' }
+      ],
+    };
+    commandInstance.registerCommand(command, { commandScope: 'testScope' });
+  });
+
+  it('should execute a command successfully', () => {
+    const commandName = 'testScope:testCommand';
+    const args = { param1: 'test', param2: 42 };
+
+    commandInstance.executeCommand(commandName, args);
+
+    expect(mockHandler).toHaveBeenCalledWith(args);
+  });
+
+  it('should throw an error if the command is not registered', () => {
+    const nonExistingCommandName = 'testScope:nonExistingCommand';
+    expect(() => {
+      commandInstance.executeCommand(nonExistingCommandName, {});
+    }).toThrow(`Command '${nonExistingCommandName}' is not registered.`);
+  });
+
+  it('should throw an error if arguments are invalid', () => {
+    const commandName = 'testScope:testCommand';
+    const invalidArgs = { param1: 'test', param2: 'not-a-number' }; // param2 should be a number
+
+    expect(() => {
+      commandInstance.executeCommand(commandName, invalidArgs);
+    }).toThrow(`Command '${commandName}' arguments param2 is invalid.`);
+  });
+
+  it('should handle errors thrown by the command handler', () => {
+    const commandName = 'testScope:testCommand';
+    const args = { param1: 'test', param2: 42 };
+    const errorMessage = 'Command handler error';
+    mockHandler.mockImplementation(() => {
+      throw new Error(errorMessage);
+    });
+
+    expect(() => {
+      commandInstance.executeCommand(commandName, args);
+    }).toThrow(errorMessage);
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+});
+
+describe('batchExecuteCommand', () => {
+  let commandInstance;
+  let mockHandler;
+  let mockExecuteTransaction;
+  let mockPluginContext;
+
+  beforeEach(() => {
+    commandInstance = new Command();
+    mockHandler = jest.fn();
+    mockExecuteTransaction = jest.fn(callback => callback());
+    mockPluginContext = {
+      common: {
+        utils: {
+          executeTransaction: mockExecuteTransaction
+        }
+      }
+    };
+
+    // 注册几个命令
+    const command1 = {
+      name: 'testCommand1',
+      handler: mockHandler,
+    };
+    const command2 = {
+      name: 'testCommand2',
+      handler: mockHandler,
+    };
+    commandInstance.registerCommand(command1, { commandScope: 'testScope' });
+    commandInstance.registerCommand(command2, { commandScope: 'testScope' });
+  });
+
+  it('should execute a batch of commands', () => {
+    const commands = [
+      { name: 'testScope:testCommand1', args: { param: 'value1' } },
+      { name: 'testScope:testCommand2', args: { param: 'value2' } },
+    ];
+
+    commandInstance.batchExecuteCommand(commands, mockPluginContext);
+
+    expect(mockExecuteTransaction).toHaveBeenCalledTimes(1);
+    expect(mockHandler).toHaveBeenCalledWith({ param: 'value1' });
+    expect(mockHandler).toHaveBeenCalledWith({ param: 'value2' });
+  });
+
+  it('should not execute anything if commands array is empty', () => {
+    commandInstance.batchExecuteCommand([], mockPluginContext);
+
+    expect(mockExecuteTransaction).not.toHaveBeenCalled();
+    expect(mockHandler).not.toHaveBeenCalled();
+  });
+
+  it('should handle errors thrown during command execution', () => {
+    const errorMessage = 'Command handler error';
+    mockHandler.mockImplementation(() => {
+      throw new Error(errorMessage);
+    });
+
+    const commands = [
+      { name: 'testScope:testCommand1', args: { param: 'value1' } },
+      { name: 'testScope:testCommand2', args: { param: 'value2' } },
+    ];
+
+    expect(() => {
+      commandInstance.batchExecuteCommand(commands, mockPluginContext);
+    }).toThrow(errorMessage);
+
+    expect(mockExecuteTransaction).toHaveBeenCalledTimes(1); // Still called once
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+});
+
+describe('listCommands', () => {
+  let commandInstance;
+  let mockHandler;
+
+  beforeEach(() => {
+    commandInstance = new Command();
+    mockHandler = jest.fn();
+  });
+
+  it('should list all registered commands', () => {
+    // 注册几个命令
+    const command1 = {
+      name: 'testCommand1',
+      handler: mockHandler,
+      description: 'Test Command 1',
+      parameters: [{ name: 'param1', propType: 'string' }]
+    };
+    const command2 = {
+      name: 'testCommand2',
+      handler: mockHandler,
+      description: 'Test Command 2',
+      parameters: [{ name: 'param2', propType: 'number' }]
+    };
+    commandInstance.registerCommand(command1, { commandScope: 'testScope' });
+    commandInstance.registerCommand(command2, { commandScope: 'testScope' });
+
+    const listedCommands = commandInstance.listCommands();
+
+    expect(listedCommands.length).toBe(2);
+    expect(listedCommands).toEqual(expect.arrayContaining([
+      expect.objectContaining({
+        name: 'testScope:testCommand1',
+        description: 'Test Command 1',
+        parameters: [{ name: 'param1', propType: 'string' }]
+      }),
+      expect.objectContaining({
+        name: 'testScope:testCommand2',
+        description: 'Test Command 2',
+        parameters: [{ name: 'param2', propType: 'number' }]
+      })
+    ]));
+  });
+
+  it('should return an empty array if no commands are registered', () => {
+    const listedCommands = commandInstance.listCommands();
+    expect(listedCommands).toEqual([]);
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+});
+
+describe('onCommandError', () => {
+  let commandInstance;
+  let mockHandler;
+  let mockErrorHandler1;
+  let mockErrorHandler2;
+
+  beforeEach(() => {
+    commandInstance = new Command();
+    mockHandler = jest.fn();
+    mockErrorHandler1 = jest.fn();
+    mockErrorHandler2 = jest.fn();
+
+    // 注册一个命令，该命令会抛出错误
+    const command = {
+      name: 'testCommand',
+      handler: () => {
+        throw new Error('Command execution failed');
+      },
+    };
+    commandInstance.registerCommand(command, { commandScope: 'testScope' });
+  });
+
+  it('should call all registered error handlers when a command throws an error', () => {
+    const commandName = 'testScope:testCommand';
+    commandInstance.onCommandError(mockErrorHandler1);
+    commandInstance.onCommandError(mockErrorHandler2);
+
+    expect(() => {
+      commandInstance.executeCommand(commandName, {});
+    }).not.toThrow();
+
+    // 确保所有错误处理函数都被调用，并且传递了正确的参数
+    expect(mockErrorHandler1).toHaveBeenCalledWith(commandName, expect.any(Error));
+    expect(mockErrorHandler2).toHaveBeenCalledWith(commandName, expect.any(Error));
+  });
+
+  it('should throw the error if no error handlers are registered', () => {
+    const commandName = 'testScope:testCommand';
+
+    expect(() => {
+      commandInstance.executeCommand(commandName, {});
+    }).toThrow('Command execution failed');
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+});

packages/editor-skeleton/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alilc/lowcode-editor-skeleton",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "description": "alibaba lowcode editor skeleton",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -19,10 +19,10 @@
   ],
   "dependencies": {
     "@alifd/next": "^1.20.12",
-    "@alilc/lowcode-designer": "1.2.2",
-    "@alilc/lowcode-editor-core": "1.2.2",
-    "@alilc/lowcode-types": "1.2.2",
-    "@alilc/lowcode-utils": "1.2.2",
+    "@alilc/lowcode-designer": "1.3.2",
+    "@alilc/lowcode-editor-core": "1.3.2",
+    "@alilc/lowcode-types": "1.3.2",
+    "@alilc/lowcode-utils": "1.3.2",
     "classnames": "^2.2.6",
     "react": "^16.8.1",
     "react-dom": "^16.8.1"

packages/editor-skeleton/src/components/settings/settings-pane.tsx

@@ -225,7 +225,7 @@ class SettingFieldView extends Component<SettingFieldViewProps, SettingFieldView
 
     const value = this.value;
 
-    let _onChange = extraProps?.onChange;
+    let onChangeAPI = extraProps?.onChange;
     let stageName = this.stageName;
 
     return createField(
@@ -261,7 +261,7 @@ class SettingFieldView extends Component<SettingFieldViewProps, SettingFieldView
             value,
           });
           field.setValue(value, true);
-          if (_onChange) _onChange(value, field);
+          if (onChangeAPI) onChangeAPI(value, field.internalToShellField());
         },
         onInitial: () => {
           if (initialValue == null) {

packages/editor-skeleton/src/components/settings/settings-primary-pane.tsx

@@ -65,8 +65,10 @@ export class SettingsPrimaryPane extends Component<ISettingsPrimaryPaneProps, {
           {createIcon(settings.componentMeta?.icon, {
             className: 'lc-settings-navigator-icon',
           })}
-          <Title title={settings.componentMeta!.title} />
-          <span> x {settings.nodes.length}</span>
+          <div style={{ marginLeft: '5px' }}>
+            <Title title={settings.componentMeta!.title} />
+            <span> x {settings.nodes.length}</span>
+          </div>
         </div>
       );
     }

packages/editor-skeleton/src/components/widget-views/index.tsx

@@ -1,7 +1,6 @@
 import { Component, ReactElement } from 'react';
-import { Icon } from '@alifd/next';
 import classNames from 'classnames';
-import { Title, observer, Tip } from '@alilc/lowcode-editor-core';
+import { Title, observer, HelpTip } from '@alilc/lowcode-editor-core';
 import { DockProps } from '../../types';
 import { PanelDock } from '../../widget/panel-dock';
 import { composeTitle } from '../../widget/utils';
@@ -26,25 +25,6 @@ export function DockView({ title, icon, description, size, className, onClick }:
   );
 }
 
-function HelpTip({ tip }: any) {
-  if (tip && tip.url) {
-    return (
-      <div>
-        <a href={tip.url} target="_blank" rel="noopener noreferrer">
-          <Icon type="help" size="small" className="lc-help-tip" />
-        </a>
-        <Tip>{tip.content}</Tip>
-      </div>
-    );
-  }
-  return (
-    <div>
-      <Icon type="help" size="small" className="lc-help-tip" />
-      <Tip>{tip.content}</Tip>
-    </div>
-  );
-}
-
 @observer
 export class PanelDockView extends Component<DockProps & { dock: PanelDock }> {
   private lastActived = false;
@@ -232,12 +212,8 @@ export class PanelView extends Component<{
       this.lastVisible = currentVisible;
       if (this.lastVisible) {
         panel.skeleton.postEvent(SkeletonEvents.PANEL_SHOW, panel.name, panel);
-        // FIXME! remove this line
-        panel.skeleton.postEvent('leftPanel.show' as any, panel.name, panel);
       } else {
         panel.skeleton.postEvent(SkeletonEvents.PANEL_HIDE, panel.name, panel);
-        // FIXME! remove this line
-        panel.skeleton.postEvent('leftPanel.hide' as any, panel.name, panel);
       }
     }
   }
@@ -270,15 +246,28 @@ export class PanelView extends Component<{
 }
 
 @observer
-export class TabsPanelView extends Component<{ container: WidgetContainer<Panel> }> {
+export class TabsPanelView extends Component<{
+  container: WidgetContainer<Panel>;
+  // shouldHideSingleTab: 一个布尔值，用于控制当 Tabs 组件只有一个标签时是否隐藏该标签。
+  shouldHideSingleTab?: boolean;
+}> {
   render() {
     const { container } = this.props;
     const titles: ReactElement[] = [];
     const contents: ReactElement[] = [];
-    container.items.forEach((item: any) => {
-      titles.push(<PanelTitle key={item.id} panel={item} className="lc-tab-title" />);
-      contents.push(<PanelView key={item.id} panel={item} hideOperationRow hideDragLine />);
-    });
+    // 如果只有一个标签且 shouldHideSingleTab 为 true，则不显示 Tabs
+    if (this.props.shouldHideSingleTab && container.items.length === 1) {
+      contents.push(<PanelView key={container.items[0].id} panel={container.items[0]} hideOperationRow hideDragLine />);
+    } else {
+      container.items.forEach((item: any) => {
+        titles.push(<PanelTitle key={item.id} panel={item} className="lc-tab-title" />);
+        contents.push(<PanelView key={item.id} panel={item} hideOperationRow hideDragLine />);
+      });
+    }
+
+    if (!titles.length) {
+      return contents;
+    }
 
     return (
       <div className="lc-tabs">
@@ -319,7 +308,7 @@ class PanelTitle extends Component<{ panel: Panel; className?: string }> {
         data-name={panel.name}
       >
         <Title title={panel.title || panel.name} />
-        {panel.help ? <HelpTip tip={panel.help} /> : null}
+        {panel.help ? <HelpTip help={panel.help} /> : null}
       </div>
     );
   }

packages/editor-skeleton/src/layouts/left-fixed-pane.tsx

@@ -2,17 +2,16 @@ import { Component, Fragment } from 'react';
 import classNames from 'classnames';
 import { observer } from '@alilc/lowcode-editor-core';
 import { Area } from '../area';
-import { PanelConfig } from '../types';
 import { Panel } from '../widget/panel';
+import { IPublicTypePanelConfig } from '@alilc/lowcode-types';
 
 @observer
-export default class LeftFixedPane extends Component<{ area: Area<PanelConfig, Panel> }> {
+export default class LeftFixedPane extends Component<{ area: Area<IPublicTypePanelConfig, Panel> }> {
   componentDidUpdate() {
     // FIXME: dirty fix, need deep think
     this.props.area.skeleton.editor.get('designer')?.touchOffsetObserver();
   }
 
-
   render() {
     const { area } = this.props;
     const width = area.current?.config.props?.width;
@@ -36,7 +35,7 @@ export default class LeftFixedPane extends Component<{ area: Area<PanelConfig, P
 }
 
 @observer
-class Contents extends Component<{ area: Area<PanelConfig, Panel> }> {
+class Contents extends Component<{ area: Area<IPublicTypePanelConfig, Panel> }> {
   render() {
     const { area } = this.props;
     return <Fragment>{area.container.items.map((panel) => panel.content)}</Fragment>;