43 files changed, 1537 insertions, 67 deletions

diff --git a/.gitattributes b/.gitattributes
index f0f3b61..efb0469 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,3 +1,6 @@
 src/3rdParty/** linguist-vendored
 spec/lib/** linguist-vendored
 win-build/** linguist-vendored
+spec/ export-ignore
+doc/ export-ignore
+.github/ export-ignore
\ No newline at end of file
diff --git a/doc/docs/.vitepress/config.mts b/doc/docs/.vitepress/config.mts
index 872791c..5a04667 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,17 +419,18 @@ 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.licenseMit, link: `${basePath}/reference/license-mit` },
+        { text: text.mascot, link: `${basePath}/extras/mascot` },
+        { text: text.licenseMit, link: `${basePath}/extras/license-mit` },
       ],
     },
   ];
@@ -450,7 +456,10 @@ export default defineConfig({
       },
     ],
     ["meta", { property: "og:type", content: "website" }],
-    ["meta", { property: "og:image", content: withBase("/image/yuescript.png") }],
+    [
+      "meta",
+      { property: "og:image", content: withBase("/image/yuescript.png") },
+    ],
     [
       "meta",
       {
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..4c5ff87
--- /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/components/prism-manual.js b/doc/docs/.vitepress/theme/components/prism-manual.js
index 8f73abd..076dcf3 100644
--- a/doc/docs/.vitepress/theme/components/prism-manual.js
+++ b/doc/docs/.vitepress/theme/components/prism-manual.js
@@ -4,4 +4,3 @@ if (typeof window !== "undefined") {
   window.Prism = window.Prism || {};
   window.Prism.manual = true;
 }
-
diff --git a/doc/docs/.vitepress/theme/custom.css b/doc/docs/.vitepress/theme/custom.css
index 4050784..7e3a04b 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;
   }
 }
 
-.VPHero :deep(.image-src) {
-  max-width: 450px;
-  max-height: 450px;
+@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 .image-src {
+  max-width: 420px;
+  max-height: 360px;
+  object-fit: contain;
 }
 
 /* --- DARK MODE THEME (Midnight Blue) --- */
@@ -221,4 +241,4 @@ h6,
 /* Slight adjustment to code block background to fit the midnight theme */
 .dark .vp-code-group .tabs label {
   background-color: #1a1f2e;
-}
\ No newline at end of file
+}
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/license-mit.md b/doc/docs/de/doc/extras/license-mit.md
index a5e9f70..a5e9f70 100644
--- a/doc/docs/de/doc/reference/license-mit.md
+++ b/doc/docs/de/doc/extras/license-mit.md
diff --git a/doc/docs/de/doc/extras/mascot.md b/doc/docs/de/doc/extras/mascot.md
new file mode 100644
index 0000000..ad0e982
--- /dev/null
+++ b/doc/docs/de/doc/extras/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/de/index.md b/doc/docs/de/index.md
index 94bd00f..d9ebff0 100644
--- a/doc/docs/de/index.md
+++ b/doc/docs/de/index.md
@@ -4,7 +4,7 @@ hero:
   name: YueScript
   tagline: Eine Sprache, die zu Lua kompiliert
   image:
-    src: /image/yuescript.svg
+    src: /image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
     alt: YueScript
   actions:
     - theme: brand
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/license-mit.md b/doc/docs/doc/extras/license-mit.md
index 49eae7e..49eae7e 100644
--- a/doc/docs/doc/reference/license-mit.md
+++ b/doc/docs/doc/extras/license-mit.md
diff --git a/doc/docs/doc/extras/mascot.md b/doc/docs/doc/extras/mascot.md
new file mode 100644
index 0000000..028d17f
--- /dev/null
+++ b/doc/docs/doc/extras/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/license-mit.md b/doc/docs/id-id/doc/extras/license-mit.md
index 5289f50..5289f50 100644
--- a/doc/docs/id-id/doc/reference/license-mit.md
+++ b/doc/docs/id-id/doc/extras/license-mit.md
diff --git a/doc/docs/id-id/doc/extras/mascot.md b/doc/docs/id-id/doc/extras/mascot.md
new file mode 100644
index 0000000..1b16706
--- /dev/null
+++ b/doc/docs/id-id/doc/extras/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/id-id/index.md b/doc/docs/id-id/index.md
index c8b5fab..feef760 100644
--- a/doc/docs/id-id/index.md
+++ b/doc/docs/id-id/index.md
@@ -4,7 +4,7 @@ hero:
   name: YueScript
   tagline: Bahasa yang dikompilasi ke Lua
   image:
-    src: /image/yuescript.svg
+    src: /image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
     alt: YueScript
   actions:
     - theme: brand
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/license-mit.md b/doc/docs/pt-br/doc/extras/license-mit.md
index 0e00e90..0e00e90 100644
--- a/doc/docs/pt-br/doc/reference/license-mit.md
+++ b/doc/docs/pt-br/doc/extras/license-mit.md
diff --git a/doc/docs/pt-br/doc/extras/mascot.md b/doc/docs/pt-br/doc/extras/mascot.md
new file mode 100644
index 0000000..e2ff951
--- /dev/null
+++ b/doc/docs/pt-br/doc/extras/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/pt-br/index.md b/doc/docs/pt-br/index.md
index e62095f..ce0a516 100644
--- a/doc/docs/pt-br/index.md
+++ b/doc/docs/pt-br/index.md
@@ -4,7 +4,7 @@ hero:
   name: YueScript
   tagline: Uma linguagem que compila para Lua
   image:
-    src: /image/yuescript.svg
+    src: /image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
     alt: YueScript
   actions:
     - theme: brand
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/license-mit.md b/doc/docs/zh/doc/extras/license-mit.md
index 7979663..7979663 100644
--- a/doc/docs/zh/doc/reference/license-mit.md
+++ b/doc/docs/zh/doc/extras/license-mit.md
diff --git a/doc/docs/zh/doc/extras/mascot.md b/doc/docs/zh/doc/extras/mascot.md
new file mode 100644
index 0000000..cc6c80e
--- /dev/null
+++ b/doc/docs/zh/doc/extras/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/) 双重许可。
diff --git a/doc/docs/zh/index.md b/doc/docs/zh/index.md
index 4e518b9..0146468 100644
--- a/doc/docs/zh/index.md
+++ b/doc/docs/zh/index.md
@@ -4,7 +4,7 @@ hero:
   name: 月之脚本
   tagline: 一门编译到 Lua 的语言
   image:
-    src: /image/yuescript.svg
+    src: /image/mascot/electrichearts_20260211A_yuescript_xiaoyu.png
     alt: 月之脚本
   actions:
     - theme: brand
diff --git a/spec/cli/cli_test_helper.sh b/spec/cli/cli_test_helper.sh
index ade1546..0f46969 100755
--- a/spec/cli/cli_test_helper.sh
+++ b/spec/cli/cli_test_helper.sh
@@ -123,6 +123,33 @@ assert_output_equals() {
     fi
 }
 
+# Assert that output does NOT contain expected string
+assert_output_not_contains() {
+    local description="$1"
+    local unexpected="$2"
+    shift 2
+    TESTS_RUN=$((TESTS_RUN + 1))
+
+    if "$@" > /tmp/test_stdout.txt 2> /tmp/test_stderr.txt; then
+        if grep -qF -- "$unexpected" /tmp/test_stdout.txt || grep -qF -- "$unexpected" /tmp/test_stderr.txt; then
+            echo -e "${RED}✗${NC} $description (output contains '$unexpected')"
+            echo -e "  ${YELLOW}STDOUT:$(cat /tmp/test_stdout.txt)${NC}"
+            echo -e "  ${YELLOW}STDERR:$(cat /tmp/test_stderr.txt)${NC}"
+            TESTS_FAILED=$((TESTS_FAILED + 1))
+            return 1
+        else
+            echo -e "${GREEN}✓${NC} $description"
+            TESTS_PASSED=$((TESTS_PASSED + 1))
+            return 0
+        fi
+    else
+        echo -e "${RED}✗${NC} $description (command failed)"
+        echo -e "  ${YELLOW}Exit code: $?${NC}"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+        return 1
+    fi
+}
+
 # Assert file exists
 assert_file_exists() {
     local description="$1"
diff --git a/spec/cli/run_all_tests.sh b/spec/cli/run_all_tests.sh
index 43b74bc..c4836ca 100755
--- a/spec/cli/run_all_tests.sh
+++ b/spec/cli/run_all_tests.sh
@@ -105,6 +105,7 @@ run_test_suite() {
 # Run all test suites
 run_test_suite "Basic Options Test" "$SCRIPT_DIR/test_basic_options.sh"
 run_test_suite "Compilation Test" "$SCRIPT_DIR/test_compilation.sh"
+run_test_suite "Reserve Comments Test" "$SCRIPT_DIR/test_reserve_comments.sh"
 run_test_suite "Error Handling Test" "$SCRIPT_DIR/test_error_handling.sh"
 run_test_suite "Execution Test" "$SCRIPT_DIR/test_execution.sh"
 
diff --git a/spec/cli/test_reserve_comments.sh b/spec/cli/test_reserve_comments.sh
new file mode 100755
index 0000000..6c0c1a7
--- /dev/null
+++ b/spec/cli/test_reserve_comments.sh
@@ -0,0 +1,189 @@
+#!/bin/bash
+# Test Reserve Comments Functionality for YueScript CLI
+# Tests: -c, --reserve-comments option
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/cli_test_helper.sh"
+
+# Check binary
+check_yue_binary
+
+# Setup test environment
+setup_test_env
+TMP_DIR=$(get_test_tmp_dir)
+
+echo "========================================"
+echo "Testing Reserve Comments (-c) Option"
+echo "========================================"
+echo ""
+
+# Test 1: Reserve top-level comments
+echo "Testing top-level comments preservation..."
+cat > "$TMP_DIR/top_level.yue" << 'EOF'
+-- Top level comment
+x = 1
+-- Another comment
+y = 2
+EOF
+
+assert_output_contains "Reserve top-level comments" "Top level comment" $YUE_BIN -c -p "$TMP_DIR/top_level.yue"
+assert_output_contains "Reserve second comment" "Another comment" $YUE_BIN -c -p "$TMP_DIR/top_level.yue"
+
+# Test 2: Without -c option, comments should not appear
+echo ""
+echo "Testing comments are removed without -c option..."
+assert_output_not_contains "Comments should be removed without -c" "Top level comment" $YUE_BIN -p "$TMP_DIR/top_level.yue"
+
+# Test 3: Reserve comments in table
+echo ""
+echo "Testing comments in tables..."
+cat > "$TMP_DIR/table_comments.yue" << 'EOF'
+t = {
+    -- First value comment
+    1,
+    -- Second value comment
+    2
+}
+EOF
+
+assert_output_contains "Table comments should be preserved" "First value comment" $YUE_BIN -c -p "$TMP_DIR/table_comments.yue"
+assert_output_contains "Table second comment preserved" "Second value comment" $YUE_BIN -c -p "$TMP_DIR/table_comments.yue"
+
+# Test 4: Reserve comments in if statement
+echo ""
+echo "Testing comments in if statements..."
+cat > "$TMP_DIR/if_comments.yue" << 'EOF'
+if true
+    -- Inside if block
+    print "test"
+EOF
+
+assert_output_contains "If block comments should be preserved" "Inside if block" $YUE_BIN -c -p "$TMP_DIR/if_comments.yue"
+
+# Test 5: Reserve comments in function
+echo ""
+echo "Testing comments in functions..."
+cat > "$TMP_DIR/func_comments.yue" << 'EOF'
+func = =>
+    -- Inside function
+    print "hello"
+EOF
+
+assert_output_contains "Function comments should be preserved" "Inside function" $YUE_BIN -c -p "$TMP_DIR/func_comments.yue"
+
+# Test 6: Reserve comments with empty lines
+echo ""
+echo "Testing empty lines preservation..."
+cat > "$TMP_DIR/empty_lines.yue" << 'EOF'
+-- First comment
+x = 1
+-- Second comment
+EOF
+
+OUTPUT_WITHOUT_C=$($YUE_BIN -p "$TMP_DIR/empty_lines.yue")
+OUTPUT_WITH_C=$($YUE_BIN -c -p "$TMP_DIR/empty_lines.yue")
+if [ $? -eq 0 ]; then
+    # Count newlines - with -c should have more (or equal) lines due to comment preservation
+    LINES_WITHOUT_C=$(echo "$OUTPUT_WITHOUT_C" | wc -l)
+    LINES_WITH_C=$(echo "$OUTPUT_WITH_C" | wc -l)
+    if [ $LINES_WITH_C -ge $LINES_WITHOUT_C ]; then
+        echo -e "${GREEN}✓${NC} Empty lines and comments should be preserved"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+    else
+        echo -e "${RED}✗${NC} Empty lines and comments should be preserved"
+        echo -e "  ${YELLOW}Lines without -c: $LINES_WITHOUT_C, with -c: $LINES_WITH_C${NC}"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+    fi
+    TESTS_RUN=$((TESTS_RUN + 1))
+else
+    echo -e "${RED}✗${NC} Empty lines test failed"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+    TESTS_RUN=$((TESTS_RUN + 1))
+fi
+
+# Test 7: Reserve comments in table with TableBlock syntax
+echo ""
+echo "Testing comments in TableBlock..."
+cat > "$TMP_DIR/tableblock_comments.yue" << 'EOF'
+tbl = {
+    -- Key comment
+    key: "value"
+    -- Another key
+    another: 123
+}
+EOF
+
+assert_output_contains "TableBlock key comment preserved" "Key comment" $YUE_BIN -c -p "$TMP_DIR/tableblock_comments.yue"
+assert_output_contains "TableBlock second comment preserved" "Another key" $YUE_BIN -c -p "$TMP_DIR/tableblock_comments.yue"
+
+# Test 8: Reserve comments - long form option
+echo ""
+echo "Testing --reserve-comments long form option..."
+assert_output_contains "Long form option should preserve comments" "First value comment" $YUE_BIN --reserve-comments -p "$TMP_DIR/table_comments.yue"
+
+# Test 9: Compile to file with reserve comments
+echo ""
+echo "Testing compilation to file with comments..."
+cat > "$TMP_DIR/file_comment.yue" << 'EOF'
+-- This is a test
+value = 42
+EOF
+
+assert_success "Compile with -c to file" $YUE_BIN -c "$TMP_DIR/file_comment.yue" -o "$TMP_DIR/file_comment.lua"
+assert_file_exists "Output file should exist" "$TMP_DIR/file_comment.lua"
+assert_output_contains "Compiled file should contain comments" "This is a test" cat "$TMP_DIR/file_comment.lua"
+
+# Test 10: Reserve comments with multiple statements
+echo ""
+echo "Testing comments with multiple statements..."
+cat > "$TMP_DIR/multi_stmt.yue" << 'EOF'
+-- Assign x
+x = 1
+-- Assign y
+y = 2
+-- Assign z
+z = 3
+EOF
+
+OUTPUT=$($YUE_BIN -c -p "$TMP_DIR/multi_stmt.yue")
+if [ $? -eq 0 ]; then
+    if echo "$OUTPUT" | grep -q "Assign x" && echo "$OUTPUT" | grep -q "Assign y" && echo "$OUTPUT" | grep -q "Assign z"; then
+        echo -e "${GREEN}✓${NC} All comments should be preserved"
+        TESTS_PASSED=$((TESTS_PASSED + 1))
+    else
+        echo -e "${RED}✗${NC} All comments should be preserved"
+        echo -e "  ${YELLOW}Output: $OUTPUT${NC}"
+        TESTS_FAILED=$((TESTS_FAILED + 1))
+    fi
+    TESTS_RUN=$((TESTS_RUN + 1))
+else
+    echo -e "${RED}✗${NC} Multiple statements test failed"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+    TESTS_RUN=$((TESTS_RUN + 1))
+fi
+
+# Test 11: Comments in while loop
+echo ""
+echo "Testing comments in while loop..."
+cat > "$TMP_DIR/while_comments.yue" << 'EOF'
+while true
+    -- Loop body comment
+    print "looping"
+    break
+EOF
+
+assert_output_contains "While loop comments preserved" "Loop body comment" $YUE_BIN -c -p "$TMP_DIR/while_comments.yue"
+
+# Test 12: Comments in for loop
+echo ""
+echo "Testing comments in for loop..."
+cat > "$TMP_DIR/for_comments.yue" << 'EOF'
+for i = 1, 3
+    -- For loop comment
+    print i
+EOF
+
+assert_output_contains "For loop comments preserved" "For loop comment" $YUE_BIN -c -p "$TMP_DIR/for_comments.yue"
+
+echo ""
+print_summary
diff --git a/spec/inputs/compile_doc.yue b/spec/inputs/compile_doc.yue
index f6a8d49..34f810c 100644
--- a/spec/inputs/compile_doc.yue
+++ b/spec/inputs/compile_doc.yue
@@ -35,7 +35,7 @@ getFiles = (locale) ->
                 "doc/docs/#{locale}doc/language-basics/literals.md"
                 "doc/docs/#{locale}doc/language-basics/module.md"
                 "doc/docs/#{locale}doc/reference/license-mit.md"
-                "doc/docs/#{locale}doc/reference/the-yuescript-library.md"
+                "doc/docs/#{locale}doc/advanced/the-yuescript-library.md"
         ]
 docs = [ ["codes_from_doc_#{locale}.lua", "yue-#{locale}.md", getFiles locale] for locale in *["en", "zh", "pt-br", "de", "id-id"]]
 for [compiledFile, docFile, docFiles] in *docs
diff --git a/spec/inputs/luarocks_upload.yue b/spec/inputs/luarocks_upload.yue
index 30e8434..8409484 100644
--- a/spec/inputs/luarocks_upload.yue
+++ b/spec/inputs/luarocks_upload.yue
@@ -1,4 +1,5 @@
 luarocksKey = ...
+
 local version
 with? io.open "src/yuescript/yue_compiler.cpp"
         codes = \read "*a"
@@ -8,17 +9,52 @@ unless version?
         print "failed to get version!"
         os.exit 1
 
+-- ==============================
+-- 1. Prepare minimal source tree
+-- ==============================
+
+local tmpBase = os.getenv("RUNNER_TEMP") or os.getenv("TMPDIR") or "/tmp"
+local pkgRoot = "#{tmpBase}/yuescript_pack_#{version}"
+local srcDir    = "#{pkgRoot}/yuescript-#{version}"
+local tarFile = "#{pkgRoot}/yuescript-#{version}.tar.gz"
+
+run = (cmd) ->
+        print cmd
+        ok = os.execute cmd
+        unless ok == true or ok == 0
+                print "Command failed!"
+                os.exit 1
+
+-- clean & create
+run "rm -rf '#{pkgRoot}'"
+run "mkdir -p '#{srcDir}'"
+
+-- copy whitelist files
+run "cp CMakeLists.txt '#{srcDir}/'"
+run "cp README.md '#{srcDir}/'"
+run "cp LICENSE '#{srcDir}/'"
+run "cp -R src '#{srcDir}/'"
+
+-- create tar.gz
+run "tar -C '#{pkgRoot}' -czf '#{tarFile}' 'yuescript-#{version}'"
+
+local sourceUrl = "file://#{tarFile}"
+
+-- =========================
+-- 2. Generate rockspec
+-- =========================
+
 rockspec = "rockspec_format = '3.0'
 package = 'Yuescript'
 version = '#{version}-1'
 source = {
-        url = 'git+https://github.com/pigpigyyy/yuescript'
+        url = '#{sourceUrl}'
 }
 description = {
         summary = 'Yuescript is a Moonscript dialect.',
         detailed = [[
         Yuescript is a Moonscript dialect. It is derived from Moonscript language 0.5.0 and continuously adopting new features to be more up to date. ]],
-        homepage = 'https://github.com/pigpigyyy/yuescript',
+        homepage = 'https://github.com/IppClub/YueScript',
         maintainer = 'Li Jin <dragon-fly@qq.com>',
         labels = {'yuescript','cpp','transpiler','moonscript'},
         license = 'MIT'
@@ -29,8 +65,8 @@ dependencies = {
 build = {
         type = 'cmake',
         variables = {
-                LUA='$(LUA)',
-                LUA_INCDIR='$(LUA_INCDIR)',
+                LUA = '$(LUA)',
+                LUA_INCDIR = '$(LUA_INCDIR)',
                 CMAKE_BUILD_TYPE='Release'
         },
         install = {
@@ -40,14 +76,34 @@ build = {
                 bin = {
                         'build.luarocks/yue'
                 }
+        },
+        platforms = {
+                windows = {
+                        install = {
+                                lib = {
+                                        'build.luarocks/Release/yue.dll'
+                                },
+                                bin = {
+                                        'build.luarocks/Release/yue.exe'
+                                }
+                        }
+                }
         }
 }"
 
 specFile = "yuescript-#{version}-1.rockspec"
+
 with? io.open specFile, "w+"
         \write rockspec
         \close!
 
+print "Using source: #{sourceUrl}"
+print "Uploading rockspec: #{specFile}"
+
+-- =========================
+-- 3. Upload
+-- =========================
+
 result = io.popen("luarocks upload --api-key #{luarocksKey} #{specFile}")\read '*a'
 unless result\match "Done:"
         print result
diff --git a/spec/inputs/test/reserve_comments_spec.yue b/spec/inputs/test/reserve_comments_spec.yue
new file mode 100644
index 0000000..3c0b824
--- /dev/null
+++ b/spec/inputs/test/reserve_comments_spec.yue
@@ -0,0 +1,413 @@
+describe "reserve_comments option", ->
+        import to_lua from require("yue")
+
+        it "should preserve top-level comments with reserve_comment option", ->
+                code = [[
+-- Top level comment
+x = 1
+-- Another comment
+y = 2
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("Top level comment") ~= nil
+                assert.is_true result\match("Another comment") ~= nil
+
+        it "should NOT preserve comments without reserve_comment option", ->
+                code = [[
+-- Top level comment
+x = 1
+-- Another comment
+y = 2
+]]
+                result = to_lua code, {}
+                assert.is_true result\match("Top level comment") == nil
+                assert.is_true result\match("Another comment") == nil
+
+        it "should preserve comments in table literals", ->
+                code = [[
+t = {
+    -- First value comment
+    1,
+    -- Second value comment
+    2
+}
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("First value comment") ~= nil
+                assert.is_true result\match("Second value comment") ~= nil
+
+        it "should preserve comments in if statement", ->
+                code = [[
+if true
+    -- Inside if block
+    print "test"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("Inside if block") ~= nil
+
+        it "should preserve comments in function body", ->
+                code = [[
+func = =>
+    -- Inside function
+    print "hello"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("Inside function") ~= nil
+
+        it "should preserve comments in while loop", ->
+                code = [[
+while true
+    -- Loop body comment
+    print "looping"
+    break
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("Loop body comment") ~= nil
+
+        it "should preserve comments in for loop", ->
+                code = [[
+for i = 1, 3
+    -- For loop comment
+    print i
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("For loop comment") ~= nil
+
+        it "should preserve comments in TableBlock syntax", ->
+                code = [[
+tbl = {
+    -- Key comment
+    key: "value"
+    -- Another key
+    another: 123
+}
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("Key comment") ~= nil
+                assert.is_true result\match("Another key") ~= nil
+
+        it "should preserve multiple comments across statements", ->
+                code = [[
+-- Assign x
+x = 1
+-- Assign y
+y = 2
+-- Assign z
+z = 3
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("Assign x") ~= nil
+                assert.is_true result\match("Assign y") ~= nil
+                assert.is_true result\match("Assign z") ~= nil
+
+        it "should handle table with mixed values and comments", ->
+                code = [[
+t = {
+    -- First item
+    1,
+    -- Second item
+    2,
+    -- Third item
+    3
+}
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("First item") ~= nil
+                assert.is_true result\match("Second item") ~= nil
+                assert.is_true result\match("Third item") ~= nil
+
+        it "should preserve comments in nested structures", ->
+                code = [[
+outer = {
+    -- outer comment
+    inner: {
+        -- inner comment
+        value: 42
+    }
+}
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("outer comment") ~= nil
+                assert.is_true result\match("inner comment") ~= nil
+
+        it "should preserve comments in else block", ->
+                code = [[
+if false
+    print "if"
+else
+    -- else comment
+    print "else"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("else comment") ~= nil
+
+        it "should preserve comments in elseif block", ->
+                code = [[
+if false
+    print "if"
+elseif true
+    -- elseif comment
+    print "elseif"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("elseif comment") ~= nil
+
+        it "should preserve comments before return statement", ->
+                code = [[
+func = =>
+    -- before return
+    return 42
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("before return") ~= nil
+
+        it "should preserve comments in switch statement", ->
+                code = [[
+switch 2
+    when 1
+        -- case 1 comment
+        print "one"
+    when 2
+        -- case 2 comment
+        print "two"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("case 1 comment") ~= nil
+                assert.is_true result\match("case 2 comment") ~= nil
+
+        it "should preserve comments in with statement", ->
+                code = [[
+with t
+    -- with body comment
+    .value = 10
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("with body comment") ~= nil
+
+        it "should handle empty lines with reserve_comment", ->
+                code = [[
+-- First comment
+x = 1
+-- Second comment
+]]
+                -- Just verify it compiles without error
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result ~= nil
+                assert.is_true type(result) == "string"
+
+        it "should preserve comments in class body", ->
+                code = [[
+class MyClass
+    -- property comment
+    value: 10
+    -- method comment
+    method: => print "hello"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("property comment") ~= nil
+                assert.is_true result\match("method comment") ~= nil
+
+        it "should preserve comments in class with inheritance", ->
+                code = [[
+class Child extends Parent
+    -- child property
+    value: 100
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("child property") ~= nil
+
+        it "should preserve comments in export statement", ->
+                code = [[
+-- export value comment
+export x = 42
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("export value comment") ~= nil
+
+        it "should preserve comments in import statement", ->
+                code = [[
+-- import comment
+import format from "string"
+]]
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("import comment") ~= nil
+
+        -- Additional tests for TableBlock syntax with multiple empty lines
+        it "should preserve empty lines between comments in TableBlock", ->
+                code = "tb =\n\t-- line\n\n\n\n\t--[[ajdjd]]\n\ta: ->\n\n\t-- line 2\n\tb: 123\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("line") ~= nil
+                assert.is_true result\match("ajdjd") ~= nil
+                assert.is_true result\match("line 2") ~= nil
+
+        it "should preserve block comments in TableBlock", ->
+                code = "tb =\n\t--[[block comment]]\n\ta: 1\n\n\t--[[another block]]\n\tb: 2\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("block comment") ~= nil
+                assert.is_true result\match("another block") ~= nil
+
+        it "should preserve multiple empty lines in table literal", ->
+                code = "tb = {\n\t-- line\n\n\n\n\t--[[ajdjd]]\n\ta: ->\n\n\t-- line 2\n\tb: 123\n}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("line") ~= nil
+                assert.is_true result\match("ajdjd") ~= nil
+                assert.is_true result\match("line 2") ~= nil
+
+        it "should preserve mixed single and block comments in TableBlock", ->
+                code = "tb =\n\t-- single line comment\n\ta: 1\n\n\t--[[multi\n\tline\n\tblock\n\tcomment]]\n\tb: 2\n\n\t-- another single\n\tc: 3\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("single line comment") ~= nil
+                assert.is_true result\match("multi") ~= nil
+                assert.is_true result\match("another single") ~= nil
+
+        it "should preserve comments and empty lines in table with colon syntax", ->
+                code = "tbl = {\n\t-- first key\n\tkey1: \"value1\"\n\n\n\t-- second key\n\tkey2: \"value2\"\n\n\t-- third key\n\tkey3: \"value3\"\n}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("first key") ~= nil
+                assert.is_true result\match("second key") ~= nil
+                assert.is_true result\match("third key") ~= nil
+
+        it "should preserve comments in nested TableBlock structures", ->
+                code = "outer =\n\t-- outer item\n\ta: 1\n\n\t-- inner tableblock\n\tinner:\n\t\t-- inner item 1\n\t\tx: 10\n\t\t-- inner item 2\n\t\ty: 20\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("outer item") ~= nil
+                assert.is_true result\match("inner tableblock") ~= nil
+                assert.is_true result\match("inner item 1") ~= nil
+                assert.is_true result\match("inner item 2") ~= nil
+
+        it "should handle function values in TableBlock with comments", ->
+                code = "tb =\n\t-- comment before function\n\tfunc1: => print \"a\"\n\n\t-- another function\n\tfunc2: (x) => x * 2\n\n\t-- method\n\tmethod: =>\n\t\t-- inside method\n\t\tprint \"method\"\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("comment before function") ~= nil
+                assert.is_true result\match("another function") ~= nil
+                assert.is_true result\match("method") ~= nil
+                assert.is_true result\match("inside method") ~= nil
+
+        it "should preserve comments in TableBlock with various value types", ->
+                code = "tb =\n\t-- string value\n\tstr: \"hello\"\n\n\t-- number value\n\tnum: 42\n\n\t-- boolean value\n\tbool: true\n\n\t-- table value\n\ttbl: {1, 2, 3}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("string value") ~= nil
+                assert.is_true result\match("number value") ~= nil
+                assert.is_true result\match("boolean value") ~= nil
+                assert.is_true result\match("table value") ~= nil
+
+        it "should preserve empty lines at end of TableBlock", ->
+                code = "tb =\n\t-- item 1\n\ta: 1\n\n\t-- item 2\n\tb: 2\n\n\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("item 1") ~= nil
+                assert.is_true result\match("item 2") ~= nil
+
+        -- Tests specifically for empty lines between comments
+        it "should preserve empty lines in TableBlock between comments", ->
+                code = "tb =\n\t-- a\n\t\n\t\n\t\n\tval: 1\n"
+                result = to_lua code, {reserve_comment: true}
+                -- Empty lines should produce line number comments in output
+                -- Check that there's a line with just a comment marker (line number)
+                assert.is_true result\match("-- %d+") ~= nil
+
+        it "should preserve empty lines in TableBlock with comments", ->
+                code = "tb =\n\t-- first\n\t\n\t\n\tval: 1\n\t\n\t-- second\n\tval2: 2\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("first") ~= nil
+                assert.is_true result\match("second") ~= nil
+                -- Should have empty line representations (lines with line number comments)
+                assert.is_true result\match("-- %d+") ~= nil
+
+        it "should preserve empty lines in table literal", ->
+                code = "t = {\n\t-- item1\n\t\n\t\n\t1,\n\t\n\t-- item2\n\t2\n}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("item1") ~= nil
+                assert.is_true result\match("item2") ~= nil
+                -- Empty lines should produce line comments
+                assert.is_true result\match("-- %d+") ~= nil
+
+        it "should have more newlines with reserve_comment than without", ->
+                code = "-- comment1\nx = 1\n-- comment2\ny = 2\n"
+                result_with = to_lua code, {reserve_comment: true}
+                result_without = to_lua code, {}
+                -- Count newlines in both results using gmatch
+                newlines_with = 0
+                newlines_without = 0
+                for _ in result_with\gmatch("\n")
+                        newlines_with += 1
+                for _ in result_without\gmatch("\n")
+                        newlines_without += 1
+                -- With reserve_comment should have equal or more newlines
+                assert.is_true newlines_with >= newlines_without
+
+        it "should preserve empty lines in TableBlock between entries", ->
+                code = "tb =\n\t-- key1\n\tkey1: 1\n\t\n\t\n\t-- key2\n\tkey2: 2\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("key1") ~= nil
+                assert.is_true result\match("key2") ~= nil
+                -- Empty lines should produce lines with line number comments
+                assert.is_true result\match("\t-- %d+\n") ~= nil
+
+        it "should preserve empty lines in class body", ->
+                code = "class C\n\t-- prop1\n\tprop1: 1\n\t\n\t\n\t-- prop2\n\tprop2: 2\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("prop1") ~= nil
+                assert.is_true result\match("prop2") ~= nil
+
+        it "should preserve empty lines between comments in table", ->
+                code = "t = {\n\t-- first\n\t\n\t-- second\n\t\n\t-- third\n\tval: 1\n}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("first") ~= nil
+                assert.is_true result\match("second") ~= nil
+                assert.is_true result\match("third") ~= nil
+                -- Empty lines should produce line comments
+                assert.is_true result\match("-- %d+") ~= nil
+
+        it "should preserve multiple consecutive empty lines in TableBlock", ->
+                code = "tb =\n\t-- start\n\tval1: 1\n\t\n\t\n\t\n\t-- middle\n\tval2: 2\n\t\n\t\n\t-- end\n\tval3: 3\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("start") ~= nil
+                assert.is_true result\match("middle") ~= nil
+                assert.is_true result\match("end") ~= nil
+                -- Should have line number comments for empty lines
+                assert.is_true result\match("-- %d+") ~= nil
+
+        -- Comparison tests: Table literal vs TableBlock vs Class
+        it "should preserve comments in table literal", ->
+                code = "t = {\n\t-- comment\n\tkey: 1\n}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("comment") ~= nil
+
+        it "should preserve comments in TableBlock", ->
+                code = "t =\n\t-- comment\n\tkey: 1\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("comment") ~= nil
+
+        it "should preserve comments in class body", ->
+                code = "class C\n\t-- comment\n\tkey: 1\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("comment") ~= nil
+
+        it "should preserve multiple comments in class body", ->
+                code = "class C\n\t-- prop1\n\tprop1: 1\n\t-- prop2\n\tprop2: 2\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("prop1") ~= nil
+                assert.is_true result\match("prop2") ~= nil
+
+        it "should preserve empty lines in table literal", ->
+                code = "t = {\n\t-- a\n\t\n\t-- b\n\tkey: 1\n}\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("a") ~= nil
+                assert.is_true result\match("b") ~= nil
+                -- Empty lines produce line comments
+                assert.is_true result\match("-- %d+") ~= nil
+
+        it "should preserve empty lines in TableBlock", ->
+                code = "t =\n\t-- a\n\t\n\t-- b\n\tkey: 1\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("a") ~= nil
+                assert.is_true result\match("b") ~= nil
+                -- Empty lines produce line comments
+                assert.is_true result\match("-- %d+") ~= nil
+
+        it "should preserve empty lines in class body", ->
+                code = "class C\n\t-- a\n\ta: 1\n\t\n\t-- b\n\tb: 2\n"
+                result = to_lua code, {reserve_comment: true}
+                assert.is_true result\match("a") ~= nil
+                assert.is_true result\match("b") ~= nil
+                -- Empty lines in class should also be preserved
diff --git a/spec/inputs/whitespace.yue b/spec/inputs/whitespace.yue
index e501d3d..a999143 100644
--- a/spec/inputs/whitespace.yue
+++ b/spec/inputs/whitespace.yue
@@ -160,4 +160,43 @@ local a,\
                                 b,\
                                         c
 
+do
+        tb =
+
+
+                -- one
+
+
+                -- a
+                a: 1 -- 1
+
+                -- two
+                b: -> -- 2
+
+        tb2 = {
+
+
+                -- one
+
+
+                -- a
+                a: 1 -- 1
+
+                -- two
+                b: -> -- 2
+        }
+
+        tb3 = class -- dsd
+
+
+
+                -- one
+
+                -- a
+                a: 1 -- 1
+
+                -- two
+                b: -> -- 2
+
+
 nil
diff --git a/spec/outputs/compile_doc.lua b/spec/outputs/compile_doc.lua
index f661bbd..470257d 100644
--- a/spec/outputs/compile_doc.lua
+++ b/spec/outputs/compile_doc.lua
@@ -45,7 +45,7 @@ getFiles = function(locale)
                 "doc/docs/" .. tostring(locale) .. "doc/language-basics/literals.md",
                 "doc/docs/" .. tostring(locale) .. "doc/language-basics/module.md",
                 "doc/docs/" .. tostring(locale) .. "doc/reference/license-mit.md",
-                "doc/docs/" .. tostring(locale) .. "doc/reference/the-yuescript-library.md"
+                "doc/docs/" .. tostring(locale) .. "doc/advanced/the-yuescript-library.md"
         }
 end
 local docs
diff --git a/spec/outputs/luarocks_upload.lua b/spec/outputs/luarocks_upload.lua
index 96988d7..7fa2f73 100644
--- a/spec/outputs/luarocks_upload.lua
+++ b/spec/outputs/luarocks_upload.lua
@@ -12,7 +12,28 @@ if not (version ~= nil) then
         print("failed to get version!")
         os.exit(1)
 end
-local rockspec = "rockspec_format = '3.0'\npackage = 'Yuescript'\nversion = '" .. tostring(version) .. "-1'\nsource = {\n       url = 'git+https://github.com/pigpigyyy/yuescript'\n}\ndescription = {\n        summary = 'Yuescript is a Moonscript dialect.',\n       detailed = [[\n Yuescript is a Moonscript dialect. It is derived from Moonscript language 0.5.0 and continuously adopting new features to be more up to date. ]],\n     homepage = 'https://github.com/pigpigyyy/yuescript',\n  maintainer = 'Li Jin <dragon-fly@qq.com>',\n    labels = {'yuescript','cpp','transpiler','moonscript'},\n       license = 'MIT'\n}\ndependencies = {\n  'lua >= 5.1',\n}\nbuild = {\n   type = 'cmake',\n       variables = {\n         LUA='$(LUA)',\n         LUA_INCDIR='$(LUA_INCDIR)',\n           CMAKE_BUILD_TYPE='Release'\n    },\n    install = {\n           lib = {\n                       'build.luarocks/yue.so'\n               },\n            bin = {\n                       'build.luarocks/yue'\n          }\n     }\n}"
+local tmpBase = os.getenv("RUNNER_TEMP") or os.getenv("TMPDIR") or "/tmp"
+local pkgRoot = tostring(tmpBase) .. "/yuescript_pack_" .. tostring(version)
+local srcDir = tostring(pkgRoot) .. "/yuescript-" .. tostring(version)
+local tarFile = tostring(pkgRoot) .. "/yuescript-" .. tostring(version) .. ".tar.gz"
+local run
+run = function(cmd)
+        print(cmd)
+        local ok = os.execute(cmd)
+        if not (ok == true or ok == 0) then
+                print("Command failed!")
+                return os.exit(1)
+        end
+end
+run("rm -rf '" .. tostring(pkgRoot) .. "'")
+run("mkdir -p '" .. tostring(srcDir) .. "'")
+run("cp CMakeLists.txt '" .. tostring(srcDir) .. "/'")
+run("cp README.md '" .. tostring(srcDir) .. "/'")
+run("cp LICENSE '" .. tostring(srcDir) .. "/'")
+run("cp -R src '" .. tostring(srcDir) .. "/'")
+run("tar -C '" .. tostring(pkgRoot) .. "' -czf '" .. tostring(tarFile) .. "' 'yuescript-" .. tostring(version) .. "'")
+local sourceUrl = "file://" .. tostring(tarFile)
+local rockspec = "rockspec_format = '3.0'\npackage = 'Yuescript'\nversion = '" .. tostring(version) .. "-1'\nsource = {\n       url = '" .. tostring(sourceUrl) .. "'\n}\ndescription = {\n     summary = 'Yuescript is a Moonscript dialect.',\n       detailed = [[\n Yuescript is a Moonscript dialect. It is derived from Moonscript language 0.5.0 and continuously adopting new features to be more up to date. ]],\n     homepage = 'https://github.com/IppClub/YueScript',\n    maintainer = 'Li Jin <dragon-fly@qq.com>',\n    labels = {'yuescript','cpp','transpiler','moonscript'},\n       license = 'MIT'\n}\ndependencies = {\n  'lua >= 5.1',\n}\nbuild = {\n   type = 'cmake',\n       variables = {\n         LUA = '$(LUA)',\n               LUA_INCDIR = '$(LUA_INCDIR)',\n         CMAKE_BUILD_TYPE='Release'\n    },\n    install = {\n           lib = {\n                       'build.luarocks/yue.so'\n               },\n            bin = {\n                       'build.luarocks/yue'\n          }\n     },\n    platforms = {\n         windows = {\n                   install = {\n                           lib = {\n                                       'build.luarocks/Release/yue.dll'\n                              },\n                            bin = {\n                                       'build.luarocks/Release/yue.exe'\n                              }\n                     }\n             }\n     }\n}"
 local specFile = "yuescript-" .. tostring(version) .. "-1.rockspec"
 do
         local _with_0 = io.open(specFile, "w+")
@@ -21,6 +42,8 @@ do
                 _with_0:close()
         end
 end
+print("Using source: " .. tostring(sourceUrl))
+print("Uploading rockspec: " .. tostring(specFile))
 local result = io.popen("luarocks upload --api-key " .. tostring(luarocksKey) .. " " .. tostring(specFile)):read('*a')
 if not result:match("Done:") then
         print(result)
diff --git a/spec/outputs/test/reserve_comments_spec.lua b/spec/outputs/test/reserve_comments_spec.lua
new file mode 100644
index 0000000..b4e8174
--- /dev/null
+++ b/spec/outputs/test/reserve_comments_spec.lua
@@ -0,0 +1,471 @@
+return describe("reserve_comments option", function()
+        local to_lua
+        do
+                local _obj_0 = require("yue")
+                to_lua = _obj_0.to_lua
+        end
+        it("should preserve top-level comments with reserve_comment option", function()
+                local code = [[-- Top level comment
+x = 1
+-- Another comment
+y = 2
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("Top level comment") ~= nil)
+                return assert.is_true(result:match("Another comment") ~= nil)
+        end)
+        it("should NOT preserve comments without reserve_comment option", function()
+                local code = [[-- Top level comment
+x = 1
+-- Another comment
+y = 2
+]]
+                local result = to_lua(code, { })
+                assert.is_true(result:match("Top level comment") == nil)
+                return assert.is_true(result:match("Another comment") == nil)
+        end)
+        it("should preserve comments in table literals", function()
+                local code = [[t = {
+    -- First value comment
+    1,
+    -- Second value comment
+    2
+}
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("First value comment") ~= nil)
+                return assert.is_true(result:match("Second value comment") ~= nil)
+        end)
+        it("should preserve comments in if statement", function()
+                local code = [[if true
+    -- Inside if block
+    print "test"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("Inside if block") ~= nil)
+        end)
+        it("should preserve comments in function body", function()
+                local code = [[func = =>
+    -- Inside function
+    print "hello"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("Inside function") ~= nil)
+        end)
+        it("should preserve comments in while loop", function()
+                local code = [[while true
+    -- Loop body comment
+    print "looping"
+    break
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("Loop body comment") ~= nil)
+        end)
+        it("should preserve comments in for loop", function()
+                local code = [[for i = 1, 3
+    -- For loop comment
+    print i
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("For loop comment") ~= nil)
+        end)
+        it("should preserve comments in TableBlock syntax", function()
+                local code = [[tbl = {
+    -- Key comment
+    key: "value"
+    -- Another key
+    another: 123
+}
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("Key comment") ~= nil)
+                return assert.is_true(result:match("Another key") ~= nil)
+        end)
+        it("should preserve multiple comments across statements", function()
+                local code = [[-- Assign x
+x = 1
+-- Assign y
+y = 2
+-- Assign z
+z = 3
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("Assign x") ~= nil)
+                assert.is_true(result:match("Assign y") ~= nil)
+                return assert.is_true(result:match("Assign z") ~= nil)
+        end)
+        it("should handle table with mixed values and comments", function()
+                local code = [[t = {
+    -- First item
+    1,
+    -- Second item
+    2,
+    -- Third item
+    3
+}
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("First item") ~= nil)
+                assert.is_true(result:match("Second item") ~= nil)
+                return assert.is_true(result:match("Third item") ~= nil)
+        end)
+        it("should preserve comments in nested structures", function()
+                local code = [[outer = {
+    -- outer comment
+    inner: {
+        -- inner comment
+        value: 42
+    }
+}
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("outer comment") ~= nil)
+                return assert.is_true(result:match("inner comment") ~= nil)
+        end)
+        it("should preserve comments in else block", function()
+                local code = [[if false
+    print "if"
+else
+    -- else comment
+    print "else"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("else comment") ~= nil)
+        end)
+        it("should preserve comments in elseif block", function()
+                local code = [[if false
+    print "if"
+elseif true
+    -- elseif comment
+    print "elseif"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("elseif comment") ~= nil)
+        end)
+        it("should preserve comments before return statement", function()
+                local code = [[func = =>
+    -- before return
+    return 42
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("before return") ~= nil)
+        end)
+        it("should preserve comments in switch statement", function()
+                local code = [[switch 2
+    when 1
+        -- case 1 comment
+        print "one"
+    when 2
+        -- case 2 comment
+        print "two"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("case 1 comment") ~= nil)
+                return assert.is_true(result:match("case 2 comment") ~= nil)
+        end)
+        it("should preserve comments in with statement", function()
+                local code = [[with t
+    -- with body comment
+    .value = 10
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("with body comment") ~= nil)
+        end)
+        it("should handle empty lines with reserve_comment", function()
+                local code = [[-- First comment
+x = 1
+-- Second comment
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result ~= nil)
+                return assert.is_true(type(result) == "string")
+        end)
+        it("should preserve comments in class body", function()
+                local code = [[class MyClass
+    -- property comment
+    value: 10
+    -- method comment
+    method: => print "hello"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("property comment") ~= nil)
+                return assert.is_true(result:match("method comment") ~= nil)
+        end)
+        it("should preserve comments in class with inheritance", function()
+                local code = [[class Child extends Parent
+    -- child property
+    value: 100
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("child property") ~= nil)
+        end)
+        it("should preserve comments in export statement", function()
+                local code = [[-- export value comment
+export x = 42
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("export value comment") ~= nil)
+        end)
+        it("should preserve comments in import statement", function()
+                local code = [[-- import comment
+import format from "string"
+]]
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("import comment") ~= nil)
+        end)
+        it("should preserve empty lines between comments in TableBlock", function()
+                local code = "tb =\n\t-- line\n\n\n\n\t--[[ajdjd]]\n\ta: ->\n\n\t-- line 2\n\tb: 123\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("line") ~= nil)
+                assert.is_true(result:match("ajdjd") ~= nil)
+                return assert.is_true(result:match("line 2") ~= nil)
+        end)
+        it("should preserve block comments in TableBlock", function()
+                local code = "tb =\n\t--[[block comment]]\n\ta: 1\n\n\t--[[another block]]\n\tb: 2\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("block comment") ~= nil)
+                return assert.is_true(result:match("another block") ~= nil)
+        end)
+        it("should preserve multiple empty lines in table literal", function()
+                local code = "tb = {\n\t-- line\n\n\n\n\t--[[ajdjd]]\n\ta: ->\n\n\t-- line 2\n\tb: 123\n}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("line") ~= nil)
+                assert.is_true(result:match("ajdjd") ~= nil)
+                return assert.is_true(result:match("line 2") ~= nil)
+        end)
+        it("should preserve mixed single and block comments in TableBlock", function()
+                local code = "tb =\n\t-- single line comment\n\ta: 1\n\n\t--[[multi\n\tline\n\tblock\n\tcomment]]\n\tb: 2\n\n\t-- another single\n\tc: 3\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("single line comment") ~= nil)
+                assert.is_true(result:match("multi") ~= nil)
+                return assert.is_true(result:match("another single") ~= nil)
+        end)
+        it("should preserve comments and empty lines in table with colon syntax", function()
+                local code = "tbl = {\n\t-- first key\n\tkey1: \"value1\"\n\n\n\t-- second key\n\tkey2: \"value2\"\n\n\t-- third key\n\tkey3: \"value3\"\n}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("first key") ~= nil)
+                assert.is_true(result:match("second key") ~= nil)
+                return assert.is_true(result:match("third key") ~= nil)
+        end)
+        it("should preserve comments in nested TableBlock structures", function()
+                local code = "outer =\n\t-- outer item\n\ta: 1\n\n\t-- inner tableblock\n\tinner:\n\t\t-- inner item 1\n\t\tx: 10\n\t\t-- inner item 2\n\t\ty: 20\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("outer item") ~= nil)
+                assert.is_true(result:match("inner tableblock") ~= nil)
+                assert.is_true(result:match("inner item 1") ~= nil)
+                return assert.is_true(result:match("inner item 2") ~= nil)
+        end)
+        it("should handle function values in TableBlock with comments", function()
+                local code = "tb =\n\t-- comment before function\n\tfunc1: => print \"a\"\n\n\t-- another function\n\tfunc2: (x) => x * 2\n\n\t-- method\n\tmethod: =>\n\t\t-- inside method\n\t\tprint \"method\"\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("comment before function") ~= nil)
+                assert.is_true(result:match("another function") ~= nil)
+                assert.is_true(result:match("method") ~= nil)
+                return assert.is_true(result:match("inside method") ~= nil)
+        end)
+        it("should preserve comments in TableBlock with various value types", function()
+                local code = "tb =\n\t-- string value\n\tstr: \"hello\"\n\n\t-- number value\n\tnum: 42\n\n\t-- boolean value\n\tbool: true\n\n\t-- table value\n\ttbl: {1, 2, 3}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("string value") ~= nil)
+                assert.is_true(result:match("number value") ~= nil)
+                assert.is_true(result:match("boolean value") ~= nil)
+                return assert.is_true(result:match("table value") ~= nil)
+        end)
+        it("should preserve empty lines at end of TableBlock", function()
+                local code = "tb =\n\t-- item 1\n\ta: 1\n\n\t-- item 2\n\tb: 2\n\n\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("item 1") ~= nil)
+                return assert.is_true(result:match("item 2") ~= nil)
+        end)
+        it("should preserve empty lines in TableBlock between comments", function()
+                local code = "tb =\n\t-- a\n\t\n\t\n\t\n\tval: 1\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        it("should preserve empty lines in TableBlock with comments", function()
+                local code = "tb =\n\t-- first\n\t\n\t\n\tval: 1\n\t\n\t-- second\n\tval2: 2\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("first") ~= nil)
+                assert.is_true(result:match("second") ~= nil)
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        it("should preserve empty lines in table literal", function()
+                local code = "t = {\n\t-- item1\n\t\n\t\n\t1,\n\t\n\t-- item2\n\t2\n}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("item1") ~= nil)
+                assert.is_true(result:match("item2") ~= nil)
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        it("should have more newlines with reserve_comment than without", function()
+                local code = "-- comment1\nx = 1\n-- comment2\ny = 2\n"
+                local result_with = to_lua(code, {
+                        reserve_comment = true
+                })
+                local result_without = to_lua(code, { })
+                local newlines_with = 0
+                local newlines_without = 0
+                for _ in result_with:gmatch("\n") do
+                        newlines_with = newlines_with + 1
+                end
+                for _ in result_without:gmatch("\n") do
+                        newlines_without = newlines_without + 1
+                end
+                return assert.is_true(newlines_with >= newlines_without)
+        end)
+        it("should preserve empty lines in TableBlock between entries", function()
+                local code = "tb =\n\t-- key1\n\tkey1: 1\n\t\n\t\n\t-- key2\n\tkey2: 2\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("key1") ~= nil)
+                assert.is_true(result:match("key2") ~= nil)
+                return assert.is_true(result:match("\t-- %d+\n") ~= nil)
+        end)
+        it("should preserve empty lines in class body", function()
+                local code = "class C\n\t-- prop1\n\tprop1: 1\n\t\n\t\n\t-- prop2\n\tprop2: 2\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("prop1") ~= nil)
+                return assert.is_true(result:match("prop2") ~= nil)
+        end)
+        it("should preserve empty lines between comments in table", function()
+                local code = "t = {\n\t-- first\n\t\n\t-- second\n\t\n\t-- third\n\tval: 1\n}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("first") ~= nil)
+                assert.is_true(result:match("second") ~= nil)
+                assert.is_true(result:match("third") ~= nil)
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        it("should preserve multiple consecutive empty lines in TableBlock", function()
+                local code = "tb =\n\t-- start\n\tval1: 1\n\t\n\t\n\t\n\t-- middle\n\tval2: 2\n\t\n\t\n\t-- end\n\tval3: 3\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("start") ~= nil)
+                assert.is_true(result:match("middle") ~= nil)
+                assert.is_true(result:match("end") ~= nil)
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        it("should preserve comments in table literal", function()
+                local code = "t = {\n\t-- comment\n\tkey: 1\n}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("comment") ~= nil)
+        end)
+        it("should preserve comments in TableBlock", function()
+                local code = "t =\n\t-- comment\n\tkey: 1\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("comment") ~= nil)
+        end)
+        it("should preserve comments in class body", function()
+                local code = "class C\n\t-- comment\n\tkey: 1\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                return assert.is_true(result:match("comment") ~= nil)
+        end)
+        it("should preserve multiple comments in class body", function()
+                local code = "class C\n\t-- prop1\n\tprop1: 1\n\t-- prop2\n\tprop2: 2\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("prop1") ~= nil)
+                return assert.is_true(result:match("prop2") ~= nil)
+        end)
+        it("should preserve empty lines in table literal", function()
+                local code = "t = {\n\t-- a\n\t\n\t-- b\n\tkey: 1\n}\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("a") ~= nil)
+                assert.is_true(result:match("b") ~= nil)
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        it("should preserve empty lines in TableBlock", function()
+                local code = "t =\n\t-- a\n\t\n\t-- b\n\tkey: 1\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("a") ~= nil)
+                assert.is_true(result:match("b") ~= nil)
+                return assert.is_true(result:match("-- %d+") ~= nil)
+        end)
+        return it("should preserve empty lines in class body", function()
+                local code = "class C\n\t-- a\n\ta: 1\n\t\n\t-- b\n\tb: 2\n"
+                local result = to_lua(code, {
+                        reserve_comment = true
+                })
+                assert.is_true(result:match("a") ~= nil)
+                return assert.is_true(result:match("b") ~= nil)
+        end)
+end)
diff --git a/spec/outputs/whitespace.lua b/spec/outputs/whitespace.lua
index 864f085..60e98bb 100644
--- a/spec/outputs/whitespace.lua
+++ b/spec/outputs/whitespace.lua
@@ -107,4 +107,37 @@ for i = 1, 10, -1 do
         print(i)
 end
 local a, b, c
+do
+        local tb = {
+                a = 1,
+                b = function() end
+        }
+        local tb2 = {
+                a = 1,
+                b = function() end
+        }
+        local tb3
+        local _class_0
+        local _base_0 = {
+                a = 1,
+                b = function() end
+        }
+        if _base_0.__index == nil then
+                _base_0.__index = _base_0
+        end
+        _class_0 = setmetatable({
+                __init = function() end,
+                __base = _base_0,
+                __name = "tb3"
+        }, {
+                __index = _base_0,
+                __call = function(cls, ...)
+                        local _self_0 = setmetatable({ }, _base_0)
+                        cls.__init(_self_0, ...)
+                        return _self_0
+                end
+        })
+        _base_0.__class = _class_0
+        tb3 = _class_0
+end
 return nil
diff --git a/src/yuescript/yue_compiler.cpp b/src/yuescript/yue_compiler.cpp
index a4ce15c..6cf0fc7 100644
--- a/src/yuescript/yue_compiler.cpp
+++ b/src/yuescript/yue_compiler.cpp
@@ -1033,9 +1033,6 @@ private:
 
         const std::string nl(ast_node* node) const {
                 if (_config.reserveLineNumber) {
-                        if (ast_is<EmptyLine_t>(node)) {
-                                return _newLine;
-                        }
                         return " -- "s + std::to_string(node->m_begin.m_line + _config.lineOffset) + _newLine;
                 } else {
                         return _newLine;
@@ -7996,13 +7993,13 @@ private:
                                 case id<YueComment_t>(): {
                                         if (_config.reserveComment) {
                                                 auto comment = static_cast<YueComment_t*>(item);
-                                                temp.push_back(indent() + comment->to_string(&_config) + nl(item));
+                                                temp.push_back(indent() + comment->to_string(&_config) + '\n');
                                         }
                                         break;
                                 }
                                 case id<EmptyLine_t>(): {
                                         if (_config.reserveComment) {
-                                                temp.push_back(nl(item));
+                                                temp.push_back("\n"s);
                                         }
                                         break;
                                 }
@@ -8356,7 +8353,7 @@ private:
                         }
                         if (!isMetamethod) {
                                 if (skipComma) {
-                                        temp.back() = indent() + temp.back() + nl(value);
+                                        temp.back() = indent() + temp.back() + '\n';
                                 } else {
                                         temp.back() = indent() + (value == lastValueNode ? temp.back() : temp.back() + ',') + nl(value);
                                 }
@@ -9984,7 +9981,7 @@ private:
                                         case id<YueComment_t>(): {
                                                 if (_config.reserveComment) {
                                                         auto comment = static_cast<YueComment_t*>(content);
-                                                        baseEntries.emplace_back(indent(1) + comment->to_string(&_config) + nl(content), false);
+                                                        baseEntries.emplace_back(indent(1) + comment->to_string(&_config) + '\n', false);
                                                 }
                                                 break;
                                         }
diff --git a/src/yuescript/yue_parser.cpp b/src/yuescript/yue_parser.cpp
index f712db7..c5c3ef7 100644
--- a/src/yuescript/yue_parser.cpp
+++ b/src/yuescript/yue_parser.cpp
@@ -63,6 +63,7 @@ public:
 YueParser::YueParser() {
         plain_space = *set(" \t");
         line_break = nl(-expr('\r') >> '\n');
+        plain_space_break = plain_space >> line_break;
         any_char = line_break | any();
         stop = line_break | eof();
         comment = "--" >> *(not_(set("\r\n")) >> any_char) >> and_(stop);
@@ -888,43 +889,37 @@ YueParser::YueParser() {
                 SpreadExp |
                 NormalDef;
 
-        table_lit_line =
-                -EmptyLine >> (
-                        push_indent_match >> (
-                                space >> not_(line_break | '}') >> (table_value | expected_expression_error) >> *(space >> ',' >> space >> table_value) >> pop_indent |
-                                YueComment >> pop_indent |
-                                pop_indent
-                        )
-                ) | (
-                        space
-                );
+        table_lit_line = -EmptyLine >> push_indent_match >> (
+                space >> not_(line_break | '}') >> (table_value | expected_expression_error) >> *(space >> ',' >> space >> table_value) >> space >> -(',' >> space) >> pop_indent |
+                YueComment >> pop_indent |
+                pop_indent
+        );
 
-        table_lit_lines = space_break >> table_lit_line >> *(-(space >> ',') >> space_break >> table_lit_line) >> -(space >> ',');
+        table_lit_lines = +plain_space_break >> table_lit_line >> *(line_break >> table_lit_line);
 
         TableLit =
                 '{' >> Seperator >>
-                -(space >> table_value >> *(space >> ',' >> space >> table_value) >> -(space >> ',')) >>
+                -(space >> table_value >> *(space >> ',' >> space >> table_value) >> -(space >> ',')) >> space >>
                 (
                         table_lit_lines >> white >> end_braces_expression |
                         white >> '}'
                 );
 
-        table_block_inner = Seperator >> key_value_line >> *(((plain_space >> line_break) >> key_value_line) | (+space_break >> not_(expr("--")) >> key_value_line));
-        TableBlock = ((+(plain_space >> line_break)) | (+space_break >> not_(expr("--")))) >> advance_match >> ensure(table_block_inner, pop_indent);
+        table_block_inner = Seperator >> key_value_line >> *(line_break >> key_value_line);
+        TableBlock = +plain_space_break >> advance_match >> ensure(table_block_inner, pop_indent);
         TableBlockIndent = ('*' | '-' >> space_one) >> Seperator >> disable_arg_table_block_rule(
                 space >> key_value_list >> -(space >> ',') >>
-                -((plain_space >> line_break >> advance_match >> space >> ensure(key_value_list >> -(space >> ',') >> *(((plain_space >> line_break) >> key_value_line) | (+space_break >> not_(expr("--")) >> key_value_line)), pop_indent)) |
-                  (+space_break >> advance_match >> space >> ensure(key_value_list >> -(space >> ',') >> *(+space_break >> key_value_line), pop_indent))));
+                -(plain_space_break >> advance_match >> space >> ensure(key_value_list >> -(space >> ',') >> *(plain_space_break >> key_value_line), pop_indent)));
 
         ClassMemberList = Seperator >> key_value >> *(space >> ',' >> space >> key_value);
-        class_line =
-                (EmptyLine >> YueComment) |
+        class_line = -EmptyLine >> (
                 YueComment |
-                check_indent_match >> space >> (ClassMemberList | Statement) >> -(space >> ',');
+                check_indent_match >> space >> (ClassMemberList | Statement) >> -(space >> ',')
+        ) >> space;
         ClassBlock =
-                ((+(plain_space >> line_break)) | (+space_break >> not_(expr("--")))) >>
+                +plain_space_break >>
                 advance_match >> Seperator >>
-                class_line >> *(((plain_space >> line_break) >> class_line) | (+space_break >> not_(expr("--")) >> class_line)) >>
+                class_line >> *(plain_space_break >> class_line) >>
                 pop_indent;
 
         ClassDecl =
@@ -932,7 +927,7 @@ YueParser::YueParser() {
                         -(space >> Assignable) >>
                         -(space >> key("extends") >> prevent_indent >> space >> ensure(must_exp, pop_indent)) >>
                         -(space >> key("using") >> prevent_indent >> space >> ensure(ExpList | expected_expression_error, pop_indent))
-                ) >> -ClassBlock;
+                ) >> space >> -ClassBlock;
 
         GlobalValues = NameList >> -(space >> '=' >> space >> (TableBlock | ExpList | expected_expression_error));
         GlobalOp = expr('*') | '^';
@@ -1021,14 +1016,14 @@ YueParser::YueParser() {
                 MetaVariablePair |
                 MetaNormalPair;
         key_value_list = key_value >> *(space >> ',' >> space >> key_value);
-        key_value_line =
-                (EmptyLine >> YueComment) |
+        key_value_line = -EmptyLine >> (
                 YueComment |
                 check_indent_match >> space >> (
                         key_value_list >> -(space >> ',') |
                         TableBlockIndent |
                         ('*' | '-' >> space_one) >> space >> (SpreadExp | Exp | TableBlock)
-                );
+                ) >> space
+        );
 
         fn_arg_def_list = FnArgDef >> *(space >> ',' >> space >> FnArgDef);
 
diff --git a/src/yuescript/yue_parser.h b/src/yuescript/yue_parser.h
index df9f39c..12b19ac 100644
--- a/src/yuescript/yue_parser.h
+++ b/src/yuescript/yue_parser.h
@@ -200,6 +200,7 @@ private:
         NONE_AST_RULE(num_expo_hex);
         NONE_AST_RULE(lj_num);
         NONE_AST_RULE(plain_space);
+        NONE_AST_RULE(plain_space_break);
         NONE_AST_RULE(line_break);
         NONE_AST_RULE(any_char);
         NONE_AST_RULE(white);
diff --git a/yuescript-dev-1.rockspec b/yuescript-dev-1.rockspec
index 1d69998..864cf2e 100644
--- a/yuescript-dev-1.rockspec
+++ b/yuescript-dev-1.rockspec
@@ -2,13 +2,13 @@ rockspec_format = "3.0"
 package = "Yuescript"
 version = "dev-1"
 source = {
-        url = "git+https://github.com/pigpigyyy/yuescript"
+        url = "git+https://github.com/IppClub/YueScript"
 }
 description = {
         summary = "Yuescript is a Moonscript dialect.",
         detailed = [[
         Yuescript is a Moonscript dialect. It is derived from Moonscript language 0.5.0 and continuously adopting new features to be more up to date. ]],
-        homepage = "https://github.com/pigpigyyy/yuescript",
+        homepage = "https://github.com/IppClub/YueScript",
         maintainer = "Li Jin <dragon-fly@qq.com>",
         labels = {"yuescript","cpp","transpiler","moonscript"},
         license = "MIT"
@@ -16,7 +16,6 @@ description = {
 dependencies = {
         "lua >= 5.1",
 }
-
 build = {
         type = "cmake",
         variables = {