Initial commit: Oraset3 programming language with OS-level features

docs/LANGUAGE_SPEC.md

@@ -0,0 +1,196 @@
+# Oraset3 编程语言规范
+
+## 1. 概述
+
+Oraset3 是一种现代化的通用编程语言，结合了 Go 的简洁性和 C++ 的性能。
+
+### 1.1 设计目标
+- 简洁的语法，易于学习
+- 高性能的编译型语言
+- 跨平台支持（Windows/Linux）
+- 内存安全
+
+## 2. 词法结构
+
+### 2.1 关键字
+```
+var, let, const, func, struct, interface, if, else, for, while, return, break, continue, import, export, true, false, nil
+```
+
+### 2.2 标识符
+字母开头，可包含字母、数字、下划线
+
+### 2.3 字面量
+- 整数: `42`, `-100`, `0x1A`
+- 浮点数: `3.14`, `-0.5`, `1e10`
+- 字符串: `"hello"`, `'world'`
+- 布尔值: `true`, `false`
+- 空值: `nil`
+
+### 2.4 运算符
+- 算术: `+`, `-`, `*`, `/`, `%`
+- 比较: `==`, `!=`, `<`, `>`, `<=`, `>=`
+- 逻辑: `&&`, `||`, `!`
+- 赋值: `=`, `:=`, `+=`, `-=`, `*=`, `/=`
+
+## 3. 语法结构
+
+### 3.1 变量声明（简化语法）
+
+**推荐写法 - 使用类型推断:**
+```oraset
+x := 42           // 自动推断为 int
+name := "Alice"   // 自动推断为 string
+flag := true      // 自动推断为 bool
+pi := 3.14        // 自动推断为 float
+```
+
+**传统写法:**
+```oraset
+var x int = 42
+let name string = "Alice"
+const PI float = 3.14
+```
+
+### 3.2 函数定义
+
+**简洁写法 - 省略返回类型（void）:**
+```oraset
+func greet(name string) {
+    println("Hello, " + name)
+}
+```
+
+**带返回值:**
+```oraset
+func add(a int, b int) int {
+    return a + b
+}
+```
+
+**无参数:**
+```oraset
+func main() {
+    println("Hello, Oraset3!")
+}
+```
+
+### 3.3 条件语句
+```oraset
+if x > 0 {
+    println("Positive")
+} else if x < 0 {
+    println("Negative")
+} else {
+    println("Zero")
+}
+```
+
+### 3.4 循环
+```oraset
+// while 循环
+while i < 10 {
+    println(i)
+    i := i + 1
+}
+
+// for 循环
+for i := 0; i < 10; i := i + 1 {
+    println(i)
+}
+```
+
+### 3.5 结构体
+```oraset
+struct Point {
+    x int
+    y int
+}
+```
+
+### 3.6 接口
+```oraset
+interface Shape {
+    area() float
+}
+```
+
+## 4. 内置函数
+
+Oraset3 提供以下内置函数，无需声明即可使用：
+
+| 函数 | 说明 |
+|------|------|
+| `print(value)` | 输出值到控制台（不换行） |
+| `println(value)` | 输出值到控制台（换行） |
+
+**支持的类型:**
+- `int` - 整数
+- `float` - 浮点数
+- `string` - 字符串
+- `bool` - 布尔值
+
+**示例:**
+```oraset
+func main() {
+    println(42)                    // 输出整数
+    println(3.14)                  // 输出浮点数
+    println("Hello, World!")       // 输出字符串
+    println(true)                  // 输出布尔值
+    
+    print("Hello")                 // 不换行输出
+    println(" World!")             // 换行输出
+}
+```
+
+## 5. 类型系统
+
+### 5.1 基本类型
+- `int` - 整数（64位）
+- `float` - 浮点数（64位）
+- `bool` - 布尔值
+- `string` - 字符串
+- `nil` - 空值
+
+### 5.2 复合类型
+- 数组: `[5]int`
+- 切片: `[]int`
+- 字典: `map[string]int`
+- 函数: `func(int) int`
+
+## 6. 内存管理
+
+Oraset3 使用自动垃圾回收机制，无需手动管理内存。
+
+## 7. 模块系统
+
+```oraset
+import "math"
+export func main() {
+    // 入口函数
+}
+```
+
+## 8. 代码风格建议
+
+### 8.1 分号
+分号在 Oraset3 中是可选的，推荐省略分号以保持代码简洁：
+
+**推荐:**
+```oraset
+x := 42
+println(x)
+```
+
+**也支持:**
+```oraset
+x := 42;
+println(x);
+```
+
+### 8.2 缩进
+使用 4 个空格进行缩进。
+
+### 8.3 命名规范
+- 变量和函数名使用蛇形命名: `my_variable`, `my_function`
+- 类型名使用 Pascal 命名: `MyStruct`, `MyInterface`