[Auto release] release 0.21.1

.github/workflows/hotfix-release.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   build:
-    runs-on: macOS-12 # 如果用了electron，记得改成 macOS-latest
+    runs-on: macOS-13 # 如果用了electron，记得改成 macOS-latest
     permissions:
       contents: write
       pull-requests: write

.github/workflows/pre-release.yml

@@ -9,7 +9,7 @@ on:
 
 jobs:
   build:
-    runs-on: macOS-12 # 如果用了electron，记得改成 macOS-latest
+    runs-on: macOS-13 # 如果用了electron，记得改成 macOS-latest
 
     permissions:
       contents: write

.github/workflows/release-changelog.yml

@@ -7,7 +7,7 @@ on:
 jobs:
   update-changelog-after-publish-a-release:
     name: GitHub Actions Test
-    runs-on: macOS-12
+    runs-on: macOS-13
 
     strategy:
       matrix:

.github/workflows/release.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   build:
-    runs-on: macOS-12 # 如果用了electron，记得改成 macOS-latest
+    runs-on: macOS-13 # 如果用了electron，记得改成 macOS-latest
     permissions:
       contents: write
       pull-requests: write

.github/workflows/sync-main-to-develop.yml

@@ -11,7 +11,7 @@ jobs:
   if_merged:
     if: github.event.pull_request.merged == true
 
-    runs-on: macOS-12
+    runs-on: macOS-13
 
     permissions:
       contents: write

.github/workflows/unit-test.yml

@@ -10,7 +10,7 @@ on:
 jobs:
   build:
     runs-on:
-      - macOS-12
+      - macOS-13
 
     strategy:
       matrix:

common/config/rush/version-policies.json

@@ -1 +1 @@
-[{"definitionName":"lockStepVersion","policyName":"vrenderMain","version":"0.21.0","nextBump":"minor"}]
+[{"definitionName":"lockStepVersion","policyName":"vrenderMain","version":"0.21.1","nextBump":"patch"}]

docs/assets/api/en/common/attribute.md

@@ -219,3 +219,10 @@ shadowRoot 在宿主图元的上方还是下方，>0 为下方，<0 为上方
 #${prefix} globalCompositeOperation(CanvasRenderingContext2D['globalCompositeOperation']) = ''
 
 对应 Canvas 的 globalCompositeOperation，用来配置滤镜
+
+#${prefix} boundsPadding(number[]) = []
+
+图元的包围盒的 padding，当自动计算的AABBBounds不满足要求的时候可以配置，可以调整包围盒的大小。
+如果是number，那么四个方向的padding都是这个值
+如果是[number, number] ，那么分别是上下和左右的padding
+如果是[number, number, number, number]，那么分别是上右下左的

docs/assets/api/zh/common/attribute.md

@@ -219,3 +219,10 @@ shadowRoot 在宿主图元的上方还是下方，>0 为下方，<0 为上方
 #${prefix} globalCompositeOperation(CanvasRenderingContext2D['globalCompositeOperation']) = ''
 
 对应 Canvas 的 globalCompositeOperation，用来配置滤镜
+
+#${prefix} boundsPadding(number[]) = []
+
+图元的包围盒的 padding，当自动计算的AABBBounds不满足要求的时候可以配置，可以调整包围盒的大小。
+如果是number，那么四个方向的padding都是这个值
+如果是[number, number] ，那么分别是上下和左右的padding
+如果是[number, number, number, number]，那么分别是上右下左的

docs/assets/contributing/en/1-Setting-Up-the-Development-Environment.md

@@ -0,0 +1,117 @@
+---
+title: 1. Setting up Development Environment
+
+key words: VisActor, VChart, VTable, VStory, VMind, VGrammar, VRender, Visualization, Chart, Data, Table, Graph, Gis, LLM
+---
+
+# Github
+
+## 1.1 Register an Account
+
+The VisActor team usually develops and maintains issues on Github. Please open the [Github website](https://github.com/), click the `Sign up` button in the top right corner, register your own account, and take the first step on your open-source journey.
+
+If, due to special circumstances, you are unable to access the Github site, please inform us and proceed with project development through [Gitee](https://gitee.com/VisActor/VRender).
+
+## 1.2 Fork the Project
+
+First, you need to fork this project. Go to the [VRender project page](https://github.com/VisActor/VRender) and click the Fork button in the top right corner.
+
+<img src='https://cdn.jsdelivr.net/gh/xiaoluoHe/articles/visactor/img/SCR-20241202-oosd.png' alt='' width='1000' height='auto'>
+
+Your github account will show the project xxxx(your github username)/vrender.
+
+<img src='https://cdn.jsdelivr.net/gh/xiaoluoHe/articles/visactor/img/SCR-20241202-okqc.png' alt='' width='600' height='auto'>
+
+# Local Development Environment
+
+## 2.1 Install Git
+
+Since the code is hosted on Github, we use git for version control.
+
+Git is a version control system used to track and manage code changes in software development projects. It helps developers record and manage the history of code, facilitating team collaboration, code version control, code merging, and other operations. With Git, you can track every version of each file and easily switch and compare between different versions. Git also provides branch management functionality, allowing multiple parallel development tasks to be carried out simultaneously.
+
+- Visit the Git official website: [https://git-scm.com/](https://git-scm.com/)
+
+- Download the latest version of the Git installer.
+
+- Run the downloaded installer and follow the installation wizard instructions.
+
+- After installation, you can confirm the successful installation by using the `git version` command in the command line.
+
+```
+git version
+**git version 2.39.2 (Apple Git-143)**
+```
+
+## 2.2 Install Development Tools (Recommended: VSCode)
+
+VisActor is mainly in the front-end technology stack, and there are many tools available for front-end development. We recommend using VSCode. Of course, you can also use your preferred development tool.
+
+If you are not familiar with VSCode, it is recommended to read the official documentation: [https://vscode.js.cn/docs/setup/setup-overview](https://vscode.js.cn/docs/setup/setup-overview)
+
+## 2.3 Install Marscode AI Programming Assistant
+
+[Marscode AI Programming Assistant](https://www.marscode.cn/home?utm_source=developer&utm_medium=oss&utm_campaign=visactor_a)
+
+Marscode AI Programming Assistant is an AI programming assistant provided by Marscode, offering AI features such as intelligent code completion. It supports mainstream programming languages and IDEs, providing suggestions for writing single lines of code or entire functions during development. Additionally, it supports functions such as code interpretation, unit test generation, and issue fixing, improving development efficiency and quality. For more information, please refer to the [documentation of Marscode AI Programming Assistant](https://www.marscode.cn/home?utm_source=developer&utm_medium=oss&utm_campaign=visactor_a).
+
+<img src='https://cdn.jsdelivr.net/gh/xuanhun/articles/visactor/img/DLaKb4PysoADAZx0x1RcYjXbnBe.gif' alt='' width='760' height='auto'>
+
+With Marscode, VisActor developers can more conveniently perform tasks such as code understanding, document writing, feature development, and unit testing. Detailed examples will be provided in the contribution guidelines for various tasks.
+
+<img src='https://cdn.jsdelivr.net/gh/xuanhun/articles/visactor/img/BQeib7E2gonoOaxLPqjcRtAYngh.gif' alt='' height='auto' style="width: 500px">
+
+## 2.4 Clone the Code to Local
+
+Navigate to the VRender folder and add the remote address of VRender.
+
+```
+git remote add upstream https://github.com/VisActor/VRender.git
+```
+
+Get the latest source code of VRender.
+
+```
+git pull upstream develop
+```
+
+# Initialize the Project
+
+First, globally install [<u>@microsoft/rush</u>](https://rushjs.io/pages/intro/get_started/)
+
+```
+$ npm i --global @microsoft/rush
+```
+
+Next, run the command to view the demo.
+
+```
+# Install dependencies
+$ rush update
+# Start the demo page of vrender
+$ rush run -p @visactor/vrender -s start
+# Start the local document site
+$ rush docs
+```
+
+# Next Steps
+
+So far, you have prepared for developing code. Please continue reading the next section of the tutorial to start different types of tasks.
+
+Github: [github.com/VisActor](https://link.juejin.cn/?target=https%3A%2F%2Fgithub.com%2FVisActor)
+
+VisActor WeChat subscription account (you can join the WeChat group through the subscription account menu):
+
+<img src='https://cdn.jsdelivr.net/gh/xuanhun/articles/visactor/img/KLjmbz9TtoGzPIxarv7cmhpgnSY.gif' alt='' width='258' height='auto'>
+
+VisActor official website: [www.visactor.io/](https://link.juejin.cn/?target=https%3A%2F%2Fwww.visactor.io%2Fvtable)
+
+Feishu group:
+
+<img src='https://cdn.jsdelivr.net/gh/xuanhun/articles/visactor/img/Cv9xb0zzLoUWyaxMVgccWuGPn7d.gif' alt='' width='264' height='auto'>
+
+Discord: [https://discord.com/invite/3wPyxVyH6m](https://discord.com/invite/3wPyxVyH6m)
+
+# This document is contributed by the following individuals
+
+[Xuanhun](https://github.com/xuanhun)