17 files changed, 238 insertions, 17 deletions

diff --git a/doc/docs/.vitepress/config.mts b/doc/docs/.vitepress/config.mts
index 872791c..01a0854 100644
--- a/doc/docs/.vitepress/config.mts
+++ b/doc/docs/.vitepress/config.mts
@@ -64,6 +64,7 @@ const sidebarText = {
     functionStubs: "Funktions-Stubs",
     usingClause: "Die Using-Klausel; Kontrolle destruktiver Zuweisung",
     yuescriptLibrary: "Die YueScript-Bibliothek",
+    mascot: "Maskottchen – Xiaoyu",
     licenseMit: "Lizenz: MIT",
   },
   en: {
@@ -99,6 +100,7 @@ const sidebarText = {
     functionStubs: "Function Stubs",
     usingClause: "The Using Clause; Controlling Destructive Assignment",
     yuescriptLibrary: "The YueScript Library",
+    mascot: "Mascot - Xiaoyu",
     licenseMit: "License: MIT",
   },
   idId: {
@@ -134,6 +136,7 @@ const sidebarText = {
     functionStubs: "Fungsi Sementara",
     usingClause: "Klausa Using; Mengontrol Penugasan Destruktif",
     yuescriptLibrary: "Pustaka YueScript",
+    mascot: "Maskot – Xiaoyu",
     licenseMit: "Lisensi: MIT",
   },
   ptBr: {
@@ -169,6 +172,7 @@ const sidebarText = {
     functionStubs: "Stubs de função",
     usingClause: "Cláusula using; controlando atribuição destrutiva",
     yuescriptLibrary: "A biblioteca do YueScript",
+    mascot: "Mascote – Xiaoyu",
     licenseMit: "Licença: MIT",
   },
   zh: {
@@ -204,6 +208,7 @@ const sidebarText = {
     functionStubs: "函数存根",
     usingClause: "使用 using 语句：防止破坏性赋值",
     yuescriptLibrary: "月之脚本语言库",
+    mascot: "吉祥物 – 小玉",
     licenseMit: "MIT 许可证",
   },
 } as const;
@@ -219,7 +224,7 @@ type SidebarGroupText = {
   dataStructures: string;
   objects: string;
   advancedFeatures: string;
-  reference: string;
+  extras: string;
 };
 
 const sidebarGroups: Record<SidebarLocale, SidebarGroupText> = {
@@ -232,7 +237,7 @@ const sidebarGroups: Record<SidebarLocale, SidebarGroupText> = {
     dataStructures: "Datenstrukturen",
     objects: "Objekte",
     advancedFeatures: "Erweiterte Funktionen",
-    reference: "Referenz",
+    extras: "Extras",
   },
   en: {
     gettingStarted: "Getting Started",
@@ -243,7 +248,7 @@ const sidebarGroups: Record<SidebarLocale, SidebarGroupText> = {
     dataStructures: "Data Structures",
     objects: "Objects",
     advancedFeatures: "Advanced Features",
-    reference: "Reference",
+    extras: "Extras",
   },
   idId: {
     gettingStarted: "Memulai",
@@ -254,7 +259,7 @@ const sidebarGroups: Record<SidebarLocale, SidebarGroupText> = {
     dataStructures: "Struktur Data",
     objects: "Objek",
     advancedFeatures: "Fitur Lanjutan",
-    reference: "Referensi",
+    extras: "Ekstra",
   },
   ptBr: {
     gettingStarted: "Primeiros passos",
@@ -265,7 +270,7 @@ const sidebarGroups: Record<SidebarLocale, SidebarGroupText> = {
     dataStructures: "Estruturas de dados",
     objects: "Objetos",
     advancedFeatures: "Recursos avançados",
-    reference: "Referência",
+    extras: "Extras",
   },
   zh: {
     gettingStarted: "起步",
@@ -276,7 +281,7 @@ const sidebarGroups: Record<SidebarLocale, SidebarGroupText> = {
     dataStructures: "数据结构",
     objects: "面向对象",
     advancedFeatures: "高级特性",
-    reference: "���考",
+    extras: "���他",
   },
 };
 
@@ -414,16 +419,17 @@ function createSidebar(basePath: string, locale: SidebarLocale) {
         },
         { text: text.do, link: `${basePath}/advanced/do` },
         { text: text.try, link: `${basePath}/advanced/try` },
+        {
+          text: text.yuescriptLibrary,
+          link: `${basePath}/advanced/the-yuescript-library`,
+        },
       ],
     },
     {
-      text: group.reference,
+      text: group.extras,
       collapsed: true,
       items: [
-        {
-          text: text.yuescriptLibrary,
-          link: `${basePath}/reference/the-yuescript-library`,
-        },
+        { text: text.mascot, link: `${basePath}/reference/mascot` },
         { text: text.licenseMit, link: `${basePath}/reference/license-mit` },
       ],
     },
diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
new file mode 100644
index 0000000..5bab134
--- /dev/null
+++ b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip
new file mode 100644
index 0000000..e84ff36
--- /dev/null
+++ b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip
diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png
new file mode 100644
index 0000000..fdf8475
--- /dev/null
+++ b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png
diff --git a/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png
new file mode 100644
index 0000000..90e4f47
--- /dev/null
+++ b/doc/docs/.vitepress/public/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png
diff --git a/doc/docs/.vitepress/theme/custom.css b/doc/docs/.vitepress/theme/custom.css
index 4050784..a4ae4d3 100644
--- a/doc/docs/.vitepress/theme/custom.css
+++ b/doc/docs/.vitepress/theme/custom.css
@@ -40,16 +40,36 @@
   --vp-c-text-2: #4a5568;
 }
 
-/* Hero image - enlarge container to fit 450px image without overflow */
+/* Hero image - adjust container to fit mascot artwork without overflow */
 @media (min-width: 960px) {
   .VPHero .image-container {
-    width: 450px !important;
+    width: 420px !important;
+  }
+
+  .VPHero .image-src {
+    margin-top: 2.7rem !important;
+    padding-bottom: 2.7rem !important;
+  }
+}
+
+@media (max-width: 960px) {
+  .VPHero .image-src {
+    margin-top: 1rem !important;
+    padding-bottom: 3.2rem !important;
+  }
+}
+
+@media (max-width: 639px) {
+  .VPHero .image-src {
+    margin-top: 3.2rem !important;
+    padding-bottom: 7.4rem !important;
   }
 }
 
-.VPHero :deep(.image-src) {
-  max-width: 450px;
-  max-height: 450px;
+.VPHero .image-src {
+  max-width: 420px;
+  max-height: 360px;
+  object-fit: contain;
 }
 
 /* --- DARK MODE THEME (Midnight Blue) --- */
diff --git a/doc/docs/de/doc/reference/the-yuescript-library.md b/doc/docs/de/doc/advanced/the-yuescript-library.md
index 0c371bf..0c371bf 100644
--- a/doc/docs/de/doc/reference/the-yuescript-library.md
+++ b/doc/docs/de/doc/advanced/the-yuescript-library.md
diff --git a/doc/docs/de/doc/reference/mascot.md b/doc/docs/de/doc/reference/mascot.md
new file mode 100644
index 0000000..ad0e982
--- /dev/null
+++ b/doc/docs/de/doc/reference/mascot.md
@@ -0,0 +1,39 @@
+# Maskottchen – Xiaoyu
+
+## Über
+
+<img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png" alt="Xiaoyu das Cyber-Kaninchen" style="max-width: 420px; width: 100%; border-radius: 12px; margin-bottom: 1.5em;" />
+
+Xiaoyu (小玉, „kleines Jade") ist ein Cyber-Kaninchen und das offizielle Maskottchen des YueScript-Projekts. Man findet sie meistens auf einer Mondsichel sitzend, an ihrem Laptop tüftelnd – natürlich YueScript schreibend.
+
+Ihr vollständiger Titel ist Xiaoyu das Cyber-Kaninchen (机兔小玉), und sie verkörpert alles, was YueScript sein möchte: elegant, ausdrucksstark und ein kleines bisschen verspielt.
+
+Xiaoyu wurde von **[Tyson Tan](https://tysontan.com)** entworfen und illustriert, der sie großzügigerweise kostenlos für das Projekt erstellt hat – wofür wir unglaublich dankbar sind.
+
+## Bilder
+
+Hochauflösende Kunstwerke stehen unten zum Download bereit. Klicken Sie auf ein Bild, um es in voller Größe zu öffnen.
+
+### Vollständiges Kunstwerk
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" alt="Xiaoyu — vollständiges Kunstwerk mit Hintergrund" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" download>Vollständiges PNG herunterladen</a></p>
+
+### Transparenter Hintergrund
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" alt="Xiaoyu — transparenter Hintergrund" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" download>Transparentes PNG herunterladen</a></p>
+
+### Gezippte .kra-Datei
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip" download>Gezippte .kra-Datei herunterladen</a></p>
+
+## Lizenz
+
+Xiaoyu ist unter der [MIT-Lizenz](https://opensource.org/licenses/MIT) und der Creative-Commons-Lizenz [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) doppelt lizenziert.
diff --git a/doc/docs/doc/reference/the-yuescript-library.md b/doc/docs/doc/advanced/the-yuescript-library.md
index 817bfab..817bfab 100644
--- a/doc/docs/doc/reference/the-yuescript-library.md
+++ b/doc/docs/doc/advanced/the-yuescript-library.md
diff --git a/doc/docs/doc/reference/mascot.md b/doc/docs/doc/reference/mascot.md
new file mode 100644
index 0000000..028d17f
--- /dev/null
+++ b/doc/docs/doc/reference/mascot.md
@@ -0,0 +1,39 @@
+# Mascot - Xiaoyu
+
+## About
+
+<img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png" alt="Xiaoyu the Cyber Rabbit" style="max-width: 420px; width: 100%; border-radius: 12px; margin-bottom: 1.5em;" />
+
+Xiaoyu (小玉, "little jade") is a cyber rabbit and the official mascot of the YueScript project. She can usually be found perched atop a crescent moon, tinkering away on her laptop - writing YueScript, naturally.
+
+Her full title is Xiaoyu the Cyber Rabbit (机兔小玉), and she embodies everything YueScript strives to be: elegant, expressive, and a little bit playful.
+
+Xiaoyu was designed and illustrated by **[Tyson Tan](https://tysontan.com)**, who generously created her for the project free of charge - something we're incredibly grateful for.
+
+## Images
+
+Full‑resolution artwork is available for download below. Click any image to open it at full size.
+
+### Full Artwork
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" alt="Xiaoyu — full artwork with background" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" download>Download full-size PNG</a></p>
+
+### Transparent Background
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" alt="Xiaoyu — transparent background" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" download>Download transparent PNG</a></p>
+
+### Zipped .kra File
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip" download>Download zipped .kra file</a></p>
+
+## License
+
+Xiaoyu is dual‑licensed under the [MIT License](https://opensource.org/licenses/MIT) and the Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
diff --git a/doc/docs/id-id/doc/reference/the-yuescript-library.md b/doc/docs/id-id/doc/advanced/the-yuescript-library.md
index 3adfe63..3adfe63 100644
--- a/doc/docs/id-id/doc/reference/the-yuescript-library.md
+++ b/doc/docs/id-id/doc/advanced/the-yuescript-library.md
diff --git a/doc/docs/id-id/doc/reference/mascot.md b/doc/docs/id-id/doc/reference/mascot.md
new file mode 100644
index 0000000..1b16706
--- /dev/null
+++ b/doc/docs/id-id/doc/reference/mascot.md
@@ -0,0 +1,39 @@
+# Maskot – Xiaoyu
+
+## Tentang
+
+<img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png" alt="Xiaoyu si Kelinci Siber" style="max-width: 420px; width: 100%; border-radius: 12px; margin-bottom: 1.5em;" />
+
+Xiaoyu (小玉, "giok kecil") adalah seekor kelinci siber dan maskot resmi proyek YueScript. Ia biasanya ditemukan bertengger di atas bulan sabit, mengutak-atik laptopnya – menulis YueScript, tentu saja.
+
+Gelar lengkapnya adalah Xiaoyu si Kelinci Siber (机兔小玉), dan ia mewujudkan segala hal yang dicita-citakan YueScript: elegan, ekspresif, dan sedikit menyenangkan.
+
+Xiaoyu dirancang dan diilustrasikan oleh **[Tyson Tan](https://tysontan.com)**, yang dengan murah hati menciptakannya untuk proyek ini secara gratis – sesuatu yang sangat kami syukuri.
+
+## Gambar
+
+Karya seni resolusi penuh tersedia untuk diunduh di bawah ini. Klik gambar mana saja untuk membukanya dalam ukuran penuh.
+
+### Karya Seni Lengkap
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" alt="Xiaoyu — karya seni lengkap dengan latar belakang" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" download>Unduh PNG ukuran penuh</a></p>
+
+### Latar Belakang Transparan
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" alt="Xiaoyu — latar belakang transparan" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" download>Unduh PNG transparan</a></p>
+
+### File .kra Terkompresi
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip" download>Unduh file .kra terkompresi</a></p>
+
+## Lisensi
+
+Xiaoyu dilisensikan ganda di bawah [Lisensi MIT](https://opensource.org/licenses/MIT) dan Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
diff --git a/doc/docs/index.md b/doc/docs/index.md
index 016b688..7d34f11 100644
--- a/doc/docs/index.md
+++ b/doc/docs/index.md
@@ -4,7 +4,7 @@ hero:
   name: YueScript
   tagline: A language that compiles to Lua
   image:
-    src: /image/yuescript.svg
+    src: /image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
     alt: YueScript
   actions:
     - theme: brand
diff --git a/doc/docs/pt-br/doc/reference/the-yuescript-library.md b/doc/docs/pt-br/doc/advanced/the-yuescript-library.md
index 7775cd5..7775cd5 100644
--- a/doc/docs/pt-br/doc/reference/the-yuescript-library.md
+++ b/doc/docs/pt-br/doc/advanced/the-yuescript-library.md
diff --git a/doc/docs/pt-br/doc/reference/mascot.md b/doc/docs/pt-br/doc/reference/mascot.md
new file mode 100644
index 0000000..e2ff951
--- /dev/null
+++ b/doc/docs/pt-br/doc/reference/mascot.md
@@ -0,0 +1,39 @@
+# Mascote – Xiaoyu
+
+## Sobre
+
+<img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png" alt="Xiaoyu, a Coelha Cibernética" style="max-width: 420px; width: 100%; border-radius: 12px; margin-bottom: 1.5em;" />
+
+Xiaoyu (小玉, "pequeno jade") é uma coelha cibernética e a mascote oficial do projeto YueScript. Ela geralmente pode ser encontrada empoleirada em uma lua crescente, mexendo em seu laptop – escrevendo YueScript, naturalmente.
+
+Seu título completo é Xiaoyu, a Coelha Cibernética (机兔小玉), e ela incorpora tudo o que o YueScript aspira ser: elegante, expressivo e um pouquinho divertido.
+
+Xiaoyu foi projetada e ilustrada por **[Tyson Tan](https://tysontan.com)**, que generosamente a criou para o projeto de forma gratuita – algo pelo qual somos incrivelmente gratos.
+
+## Imagens
+
+Artes em resolução completa estão disponíveis para download abaixo. Clique em qualquer imagem para abri-la em tamanho real.
+
+### Arte Completa
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" alt="Xiaoyu — arte completa com fundo" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" download>Baixar PNG em tamanho real</a></p>
+
+### Fundo Transparente
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" alt="Xiaoyu — fundo transparente" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" download>Baixar PNG transparente</a></p>
+
+### Arquivo .kra Compactado
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip" download>Baixar arquivo .kra compactado</a></p>
+
+## Licença
+
+Xiaoyu é duplamente licenciada sob a [Licença MIT](https://opensource.org/licenses/MIT) e a Creative Commons [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
diff --git a/doc/docs/zh/doc/reference/the-yuescript-library.md b/doc/docs/zh/doc/advanced/the-yuescript-library.md
index 9565b01..9565b01 100644
--- a/doc/docs/zh/doc/reference/the-yuescript-library.md
+++ b/doc/docs/zh/doc/advanced/the-yuescript-library.md
diff --git a/doc/docs/zh/doc/reference/mascot.md b/doc/docs/zh/doc/reference/mascot.md
new file mode 100644
index 0000000..cc6c80e
--- /dev/null
+++ b/doc/docs/zh/doc/reference/mascot.md
@@ -0,0 +1,39 @@
+# 吉祥物 – 小玉
+
+## 简介
+
+<img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png" alt="机兔小玉" style="max-width: 420px; width: 100%; border-radius: 12px; margin-bottom: 1.5em;" />
+
+小玉（Xiaoyu，意为"小小的玉"）是一只赛博兔，也是 YueScript 项目的官方吉祥物。她通常栖息在一弯新月之上，在笔记本电脑上忙碌着——当然是在写 YueScript。
+
+她的全称是机兔小玉，体现了 YueScript 所追求的一切：优雅、富有表现力，还带着一点俏皮。
+
+小玉由 **[Tyson Tan](https://tysontan.com)** 设计和绘制，他慷慨地免费为本项目创作了她——我们对此深表感激。
+
+## 图片
+
+以下提供全分辨率画作供下载。点击任意图片可查看原始尺寸。
+
+### 完整画作
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" alt="小玉 — 含背景的完整画作" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_full.png" download>下载完整 PNG</a></p>
+
+### 透明背景
+
+<a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" target="_blank">
+  <img src="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" alt="小玉 — 透明背景" style="max-width: 480px; width: 100%; border-radius: 12px;" />
+</a>
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu_trans.png" download>下载透明背景 PNG</a></p>
+
+### .kra 压缩文件
+
+<p><a href="/image/mascot/electrichearts_20260211A_yuescript_xiaoyu.zip" download>下载 .kra 压缩文件</a></p>
+
+## 许可证
+
+小玉采用 [MIT 许可证](https://opensource.org/licenses/MIT) 和知识共享 [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) 双重许可。