From 80efd7c357295c3c644b62b020f3514ededbda3a Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Sun, 24 Aug 2025 12:13:23 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=20os.snow=E7=B3=BB?=
 =?UTF-8?q?=E7=BB=9F=E5=BA=93=E6=A8=A1=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../org/jcnc/snow/pkg/tasks/GenerateTask.java | 13 ++++++--
 .../org/jcnc/snow/pkg/utils/SnowExample.java  | 30 +++++++++++++++----
 2 files changed, 36 insertions(+), 7 deletions(-)

diff --git a/src/main/java/org/jcnc/snow/pkg/tasks/GenerateTask.java b/src/main/java/org/jcnc/snow/pkg/tasks/GenerateTask.java
index 4794994..3364823 100644
--- a/src/main/java/org/jcnc/snow/pkg/tasks/GenerateTask.java
+++ b/src/main/java/org/jcnc/snow/pkg/tasks/GenerateTask.java
@@ -16,7 +16,7 @@ import java.util.List;
  * <code>main.snow</code>。
  *
  * <p>
- * 生成内容包括: 
+ * 生成内容包括:
  * <ul>
  *   <li><code>src/</code>                       —— 源码根目录</li>
  *   <li><code>src/{group package}/</code> —— 按 <code>project.group</code> 创建的包路径
@@ -31,7 +31,9 @@ import java.util.List;
  */
 public final class GenerateTask implements Task {
 
-    /** 项目信息元数据 */
+    /**
+     * 项目信息元数据
+     */
     private final Project project;
 
     /**
@@ -90,6 +92,13 @@ public final class GenerateTask implements Task {
             System.out.println("[generate] created " + root.relativize(mainSnow));
         }
 
+        /* ---------- 5. 写入系统库文件 os.snow ---------- */
+        Path osSnow = packageDir.resolve("OS.snow");
+        if (Files.notExists(osSnow)) {
+            Files.writeString(osSnow, SnowExample.getOsModule());
+            System.out.println("[generate] created " + root.relativize(osSnow));
+        }
+
         System.out.println("[generate] project scaffold is ready.");
     }
 }
diff --git a/src/main/java/org/jcnc/snow/pkg/utils/SnowExample.java b/src/main/java/org/jcnc/snow/pkg/utils/SnowExample.java
index 4cab0b2..a4aba61 100644
--- a/src/main/java/org/jcnc/snow/pkg/utils/SnowExample.java
+++ b/src/main/java/org/jcnc/snow/pkg/utils/SnowExample.java
@@ -1,7 +1,7 @@
 package org.jcnc.snow.pkg.utils;
 
 /**
- * 示例模块模板工具类，提供 main.snow 的标准示例代码字符串。
+ * 示例模块模板工具类，提供标准的示例 Snow 代码片段。
  * <p>
  * 用于项目脚手架生成或帮助用户快速上手 .snow 语言。
  * </p>
@@ -23,12 +23,11 @@ public final class SnowExample {
     public static String getMainModule() {
         return """
                 module: Math
+                    import: os
                     function: main
-                        params:
-                        returns: int
+                        returns: void
                         body:
-                            Math.factorial(6)
-                            return 0
+                            os.print(Math.factorial(6))
                         end body
                     end function
                 
@@ -55,4 +54,25 @@ public final class SnowExample {
                 end module
                 """;
     }
+
+    /**
+     * 获取系统库 os.snow 模块的内容字符串。
+     *
+     * @return os.snow 模块的完整代码
+     */
+    public static String getOsModule() {
+        return """
+                module: os
+                    import: os
+                    function: print
+                        params:
+                            declare i1: int
+                        returns: void
+                        body:
+                            syscall("PRINT", i1)
+                        end body
+                    end function
+                end module
+                """;
+    }
 }