From 5b3dba9c9c62562ce8982113b2fc96a775e73354 Mon Sep 17 00:00:00 2001
From: Li Jin <dragon-fly@qq.com>
Date: Fri, 29 Aug 2025 10:50:05 +0800
Subject: Updated docs. [skip CI]

---
 doc/docs/.vuepress/components/YueCompiler.vue | 83 ++++++++++++++++++++-------
 doc/docs/doc/README.md                        | 47 +++++++++++++++
 doc/docs/zh/doc/README.md                     | 48 ++++++++++++++++
 3 files changed, 156 insertions(+), 22 deletions(-)

(limited to 'doc')

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>
+
+唯一的区别在于：你可以将函数的返回值表达式提前写在 `->` 或 `=>` 前，用以指示该函数应隐式返回该表达式的值。这样即使在多层循环或条件判断的场景下，也无需编写尾行悬挂的返回表达式，逻辑结构会更加直观清晰。
+
 ## 反向回调
 
 反向回调用于减少函数回调的嵌套。它们使用指向左侧的箭头，并且默认会被定义为传入后续函数调用的最后一个参数。它的语法大部分与常规箭头函数相同，只是它指向另一方向，并且后续的函数体不需要进行缩进。
-- 
cgit v1.2.3-55-g6feb