Updated docs.

Author: pigpigyyy

doc/docs/.vitepress/config.mts

@@ -299,6 +299,7 @@ function createSidebar(basePath: string, locale: SidebarLocale) {
           text: text.attributes,
           link: `${basePath}/language-basics/attributes`,
         },
+        { text: text.module, link: `${basePath}/language-basics/module` },
       ],
     },
     {
@@ -389,7 +390,6 @@ function createSidebar(basePath: string, locale: SidebarLocale) {
       collapsed: true,
       items: [
         { text: text.macro, link: `${basePath}/advanced/macro` },
-        { text: text.module, link: `${basePath}/advanced/module` },
         {
           text: text.lineDecorators,
           link: `${basePath}/advanced/line-decorators`,
@@ -510,6 +510,11 @@ export default defineConfig({
   document.head.appendChild(s);
 })();`,
     ],
+    [
+      "style",
+      {},
+      ".dark .vp-code span{color:var(--shiki-dark,inherit)}html:not(.dark) .vp-code span{color:var(--shiki-light,inherit)}",
+    ],
   ],
   vite: {
     publicDir: resolve(__dirname, "public"),

doc/docs/de/doc/advanced/do.md

@@ -20,7 +20,27 @@ print var -- nil hier
 
 </YueDisplay>
 
-YueScripts **do** kann auch als Ausdruck verwendet werden. So kannst du mehrere Zeilen in einem Ausdruck kombinieren. Das Ergebnis des `do`-Ausdrucks ist die letzte Anweisung im Block.
+YueScripts **do** kann auch als Ausdruck verwendet werden. So kannst du mehrere Zeilen in einem Ausdruck kombinieren. Das Ergebnis des `do`-Ausdrucks ist die letzte Anweisung im Block. `do`-Ausdrücke unterstützen die Verwendung von `break`, um den Kontrollfluss zu unterbrechen und mehrere Rückgabewerte vorzeitig zurückzugeben.
+
+```yuescript
+status, value = do
+  n = 12
+  if n > 10
+    break "large", n
+  break "small", n
+```
+
+<YueDisplay>
+
+```yue
+status, value = do
+  n = 12
+  if n > 10
+    break "large", n
+  break "small", n
+```
+
+</YueDisplay>
 
 ```yuescript
 counter = do

doc/docs/de/doc/control-flow/for-loop.md

@@ -86,7 +86,7 @@ doubled_evens = for i = 1, 20
 
 </YueDisplay>
 
-Zusätzlich unterstützen `for`-Schleifen `break` mit Rückgabewert, sodass die Schleife selbst als Ausdruck verwendet werden kann, der früh mit einem sinnvollen Ergebnis endet.
+Zusätzlich unterstützen `for`-Schleifen `break` mit Rückgabewerten, sodass die Schleife selbst als Ausdruck verwendet werden kann, der früh mit einem sinnvollen Ergebnis endet. `for`-Ausdrücke unterstützen mehrere `break`-Werte.
 
 Beispiel: die erste Zahl größer als 10 finden:
 
@@ -106,6 +106,20 @@ first_large = for n in *numbers
 
 Diese `break`-mit-Wert-Syntax ermöglicht knappe und ausdrucksstarke Such- bzw. Early-Exit-Muster direkt in Schleifenausdrücken.
 
+```yuescript
+key, score = for k, v in pairs data
+  break k, v * 10 if k == "target"
+```
+
+<YueDisplay>
+
+```yue
+key, score = for k, v in pairs data
+  break k, v * 10 if k == "target"
+```
+
+</YueDisplay>
+
 Du kannst Werte auch filtern, indem du den `for`-Ausdruck mit `continue` kombinierst.
 
 `for`-Schleifen am Ende eines Funktionsrumpfs werden nicht in eine Tabelle für einen Rückgabewert gesammelt (stattdessen gibt die Funktion `nil` zurück). Du kannst entweder explizit `return` verwenden oder die Schleife in eine Listen-Comprehension umwandeln.

doc/docs/de/doc/control-flow/while-loop.md

@@ -45,7 +45,25 @@ until running == false do my_function!
 
 </YueDisplay>
 
-Wie bei `for`-Schleifen kann die `while`-Schleife auch als Ausdruck verwendet werden. Damit eine Funktion den akkumulierten Wert einer `while`-Schleife zurückgibt, muss die Anweisung explizit mit `return` zurückgegeben werden.
+Wie bei `for`-Schleifen kann die `while`-Schleife auch als Ausdruck verwendet werden. `while`- und `until`-Ausdrücke unterstützen `break` mit mehreren Rückgabewerten.
+
+```yuescript
+value, doubled = while true
+  n = get_next!
+  break n, n * 2 if n > 10
+```
+
+<YueDisplay>
+
+```yue
+value, doubled = while true
+  n = get_next!
+  break n, n * 2 if n > 10
+```
+
+</YueDisplay>
+
+Damit eine Funktion den akkumulierten Wert einer `while`-Schleife zurückgibt, muss die Anweisung explizit mit `return` zurückgegeben werden.
 
 ## Repeat-Schleife
 
@@ -70,3 +88,25 @@ until i == 0
 ```
 
 </YueDisplay>
+
+`repeat`-Ausdrücke unterstützen ebenfalls `break` mit mehreren Rückgabewerten:
+
+```yuescript
+i = 1
+value, scaled = repeat
+  break i, i * 100 if i > 3
+  i += 1
+until false
+```
+
+<YueDisplay>
+
+```yue
+i = 1
+value, scaled = repeat
+  break i, i * 100 if i > 3
+  i += 1
+until false
+```
+
+</YueDisplay>

doc/docs/de/doc/advanced/module.md doc/docs/de/doc/language-basics/module.mddoc/docs/de/doc/advanced/module.md renamed to doc/docs/de/doc/language-basics/module.md

@@ -44,6 +44,50 @@ file = with File "Lieblingsessen.txt"
 
 </YueDisplay>
 
+`with`-Ausdrücke unterstützen `break` mit genau einem Wert:
+
+```yuescript
+result = with obj
+  break .value
+```
+
+<YueDisplay>
+
+```yue
+result = with obj
+  break .value
+```
+
+</YueDisplay>
+
+Sobald `break value` in `with` verwendet wird, gibt der `with`-Ausdruck nicht mehr sein Zielobjekt zurück, sondern den von `break` gelieferten Wert.
+
+```yuescript
+a = with obj
+  .x = 1
+-- a ist obj
+
+b = with obj
+  break .x
+-- b ist .x, nicht obj
+```
+
+<YueDisplay>
+
+```yue
+a = with obj
+  .x = 1
+-- a ist obj
+
+b = with obj
+  break .x
+-- b ist .x, nicht obj
+```
+
+</YueDisplay>
+
+Im Unterschied zu `for` / `while` / `repeat` / `do` unterstützt `with` nur einen `break`-Wert.
+
 Oder …
 
 ```yuescript

doc/docs/de/doc/objects/with-statement.md

@@ -22,6 +22,28 @@ print var -- nil here
 
 YueScript's **do** can also be used an expression . Allowing you to combine multiple lines into one. The result of the do expression is the last statement in its body.
 
+`do` expressions also support using `break` to interrupt control flow and return multiple values early:
+
+```yuescript
+status, value = do
+  n = 12
+  if n > 10
+    break "large", n
+  break "small", n
+```
+
+<YueDisplay>
+
+```yue
+status, value = do
+  n = 12
+  if n > 10
+    break "large", n
+  break "small", n
+```
+
+</YueDisplay>
+
 ```yuescript
 counter = do
   i = 0

doc/docs/doc/advanced/do.md

@@ -86,7 +86,7 @@ doubled_evens = for i = 1, 20
 
 </YueDisplay>
 
-In addition, for loops support break with a return value, allowing the loop itself to be used as an expression that exits early with a meaningful result.
+In addition, for loops support break with return values, allowing the loop itself to be used as an expression that exits early with meaningful results.
 
 For example, to find the first number greater than 10:
 
@@ -106,6 +106,22 @@ first_large = for n in *numbers
 
 This break-with-value syntax enables concise and expressive search or early-exit patterns directly within loop expressions.
 
+For loop expressions can break with multiple values:
+
+```yuescript
+key, score = for k, v in pairs data
+  break k, v * 10 if k == "target"
+```
+
+<YueDisplay>
+
+```yue
+key, score = for k, v in pairs data
+  break k, v * 10 if k == "target"
+```
+
+</YueDisplay>
+
 You can also filter values by combining the for loop expression with the continue statement.
 
 For loops at the end of a function body are not accumulated into a table for a return value (Instead the function will return nil). Either an explicit return statement can be used, or the loop can be converted into a list comprehension.

doc/docs/doc/control-flow/for-loop.md

@@ -45,7 +45,25 @@ until running == false do my_function!
 
 </YueDisplay>
 
-Like for loops, the while loop can also be used an expression. Additionally, for a function to return the accumulated value of a while loop, the statement must be explicitly returned.
+Like for loops, the while loop can also be used as an expression. While and until loop expressions support `break` with multiple return values.
+
+```yuescript
+value, doubled = while true
+  n = get_next!
+  break n, n * 2 if n > 10
+```
+
+<YueDisplay>
+
+```yue
+value, doubled = while true
+  n = get_next!
+  break n, n * 2 if n > 10
+```
+
+</YueDisplay>
+
+Additionally, for a function to return the accumulated value of a while loop, the statement must be explicitly returned.
 
 ## Repeat Loop
 
@@ -70,3 +88,25 @@ until i == 0
 ```
 
 </YueDisplay>
+
+Repeat loop expressions also support `break` with multiple return values:
+
+```yuescript
+i = 1
+value, scaled = repeat
+  break i, i * 100 if i > 3
+  i += 1
+until false
+```
+
+<YueDisplay>
+
+```yue
+i = 1
+value, scaled = repeat
+  break i, i * 100 if i > 3
+  i += 1
+until false
+```
+
+</YueDisplay>