Updated docs. [skip CI]

3 files changed, 156 insertions, 22 deletions

diff --git a/doc/docs/.vuepress/components/YueCompiler.vue b/doc/docs/.vuepress/components/YueCompiler.vue
index 6b6042c..3a22d1c 100755
--- a/doc/docs/.vuepress/components/YueCompiler.vue
+++ b/doc/docs/.vuepress/components/YueCompiler.vue
@@ -1,21 +1,21 @@
 <template>
                 <div style="width: 100%; height: auto;">
                         <div class="parent" style="background-color: #f5f7ff;">
-                                <div class="childL" style="height: 2.5em;">
+                                <div class="editor-section">
                                         <div class="childTitle">YueScript {{ info }}</div>
+                                        <div class="editor-container" ref='yueEditor'>
+                                                <ClientOnly>
+                                                        <prism-editor class="my-editor" v-model="code" :highlight="highlighterYue" @input="codeChanged($event)" line-numbers :readonly="readonly"></prism-editor>
+                                                </ClientOnly>
+                                        </div>
                                 </div>
-                                <div class="childR" style="height: 2.5em;">
+                                <div class="editor-section">
                                         <div class="childTitle">Lua</div>
-                                </div>
-                                <div class="childL" ref='yueEditor' style="height: 30em;">
-                                        <ClientOnly>
-                                                <prism-editor class="my-editor" v-model="code" :highlight="highlighterYue" @input="codeChanged($event)" line-numbers :readonly="readonly"></prism-editor>
-                                        </ClientOnly>
-                                </div>
-                                <div class="childR" style="height: 30em;">
-                                        <ClientOnly>
-                                                <prism-editor class="my-editor" v-model="compiled" :highlight="highlighterLua" @input="codeChanged($event)" readonly></prism-editor>
-                                        </ClientOnly>
+                                        <div class="editor-container">
+                                                <ClientOnly>
+                                                        <prism-editor class="my-editor" v-model="compiled" :highlight="highlighterLua" @input="codeChanged($event)" :line-numbers="isMobileLayout" readonly></prism-editor>
+                                                </ClientOnly>
+                                        </div>
                                 </div>
                         </div>
                         <div v-if="!compileronly">
@@ -57,9 +57,18 @@
                                 code: '',
                                 compiled: '',
                                 result: '',
+                                windowWidth: 0,
                         };
                 },
+                computed: {
+                        isMobileLayout() {
+                                return this.windowWidth <= 768;
+                        },
+                },
                 mounted () {
+                        this.windowWidth = window.innerWidth;
+                        window.addEventListener('resize', this.handleResize);
+
                         if (this.text !== '') {
                                 this.$data.code = this.text;
                                 this.codeChanged(this.text);
@@ -86,7 +95,13 @@
                         })(this);
                         check();
                 },
+                beforeDestroy() {
+                        window.removeEventListener('resize', this.handleResize);
+                },
                 methods: {
+                        handleResize() {
+                                this.windowWidth = window.innerWidth;
+                        },
                         runCode() {
                                 if (window.yue && this.$data.compiled !== '') {
                                         let res = '';
@@ -136,27 +151,35 @@
                 resize: none;
                 margin-top: 5px;
         }
-        .childL {
-                float: left;
-                width: 50%;
-                box-sizing: border-box;
-                background-clip: content-box;
-                background: #f5f7ff;
+
+        .parent {
+                display: flex;
+                flex-wrap: wrap;
+                width: 100%;
         }
-        .childR {
-                float: left;
+
+        .editor-section {
                 width: 50%;
                 box-sizing: border-box;
-                background-clip: content-box;
                 background: #f5f7ff;
         }
+
+        .editor-container {
+                height: 55vh;
+        }
+
         .childTitle {
                 width: 100%;
                 font-size: 1.2em;
                 color: #b7ae8f;
                 text-align: center;
                 padding: 0.2em;
+                height: 2.5em;
+                display: flex;
+                align-items: center;
+                justify-content: center;
         }
+
         .button {
                 float: right;
                 border: none;
@@ -173,9 +196,11 @@
                 margin-top: 10px;
                 margin-right: 5px;
         }
+
         .button:hover {
                 background-color: #beb69a;
         }
+
         .button:focus,
         .button:active:focus,
         .button.active:focus,
@@ -207,5 +232,19 @@
         .my-editor >>> .prism-editor__textarea:focus {
                 outline: none;
         }
-</style>
 
+        /* 移动端响应式布局 */
+        @media screen and (max-width: 768px) {
+                .parent {
+                        flex-direction: column;
+                }
+
+                .editor-section {
+                        width: 100%;
+                }
+
+                .editor-container {
+                        height: 30vh;
+                }
+        }
+</style>
diff --git a/doc/docs/doc/README.md b/doc/docs/doc/README.md
index 5b8fc59..57f27c8 100755
--- a/doc/docs/doc/README.md
+++ b/doc/docs/doc/README.md
@@ -2161,6 +2161,53 @@ f2 arg1, arg2
 </pre>
 </YueDisplay>
 
+### Prefixed Return Expression
+
+When working with deeply nested function bodies, it can be tedious to maintain readability and consistency of the return value. To address this, YueScript introduces the **Prefixed Return Expression** syntax. Its form is as follows:
+
+```moon
+findFirstEven = (list): nil ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+```
+<YueDisplay>
+<pre>
+findFirstEven = (list): nil ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+</pre>
+</YueDisplay>
+
+This is equivalent to:
+
+```moon
+findFirstEven = (list) ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+  nil
+```
+<YueDisplay>
+<pre>
+findFirstEven = (list) ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+  nil
+</pre>
+</YueDisplay>
+
+The only difference is that you can move the final return expression before the `->` or `=>` token to indicate the function’s implicit return value as the last statement. This way, even in functions with multiple nested loops or conditional branches, you no longer need to write a trailing return expression at the end of the function body, making the logic structure more straightforward and easier to follow.
 
 ## Backcalls
 
diff --git a/doc/docs/zh/doc/README.md b/doc/docs/zh/doc/README.md
index 0aea3d5..5cfe4e6 100755
--- a/doc/docs/zh/doc/README.md
+++ b/doc/docs/zh/doc/README.md
@@ -2121,6 +2121,54 @@ f2 arg1, arg2
 </pre>
 </YueDisplay>
 
+### 前置返回表达式
+
+在深度嵌套的函数体中，为了提升返回值的可读性及编写便利性，我们新增了 “前置返回表达式” 语法。其形式如下：
+
+```moon
+findFirstEven = (list): nil ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+```
+<YueDisplay>
+<pre>
+findFirstEven = (list): nil ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+</pre>
+</YueDisplay>
+
+这个写法等价于：
+
+```moon
+findFirstEven = (list) ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+  nil
+```
+<YueDisplay>
+<pre>
+findFirstEven = (list) ->
+  for item in *list
+    if type(item) == "table"
+      for sub in *item
+        if sub % 2 == 0
+          return sub
+  nil
+</pre>
+</YueDisplay>
+
+唯一的区别在于：你可以将函数的返回值表达式提前写在 `->` 或 `=>` 前，用以指示该函数应隐式返回该表达式的值。这样即使在多层循环或条件判断的场景下，也无需编写尾行悬挂的返回表达式，逻辑结构会更加直观清晰。
+
 ## 反向回调
 
 反向回调用于减少函数回调的嵌套。它们使用指向左侧的箭头，并且默认会被定义为传入后续函数调用的最后一个参数。它的语法大部分与常规箭头函数相同，只是它指向另一方向，并且后续的函数体不需要进行缩进。