# liii-lang **Repository Path**: MoganLab/liii-lang ## Basic Information - **Project Name**: liii-lang - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-31 - **Last Updated**: 2026-11-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Liii Lang (`liii-lang`) **Liii Lang** 是面向 Scala 工程师的现代 Scheme 语言试验田:`$` 纯语法糖链式管道 + `_` 占位符,在**宏展开期**降解为 `(liii list)` / `(liii vector)` 原生函数调用, 零装箱、零闭包对象、零方法分发。 --- ## 🎯 核心设计:纯语法糖而非运行时对象 ``` 人类开发者 (Human) │ │ ($ xs :filter p :map f :sum) ▼ ┌───────────────────────────┐ │ (liii lang) │ │ 原生 syntax-rules 宏, │ │ 展开期静态去糖 │ └───────────────────────────┘ │ │ (map f (filter p xs)) —— 原生函数嵌套调用 ▼ ┌───────────────────────────┐ │ (liii list) / (liii vector)│ │ 零装箱 · 零闭包 · 零查找 │ └───────────────────────────┘ ``` | 维度 | `(liii lang)`(本仓库规范目标) | `(mogan lang)`(历史参考实现) | |---|---|---| | `$` 实现 | `define-syntax` 纯语法糖 | 运行时函数:`box` 装箱 + 消息分发 | | 性能 | 展开即原生调用,无运行时开销 | 每算子一次闭包分配 + cond 线性匹配 | | 集合宿主 | `(liii list)` / `(liii vector)` | `rich-*` 闭包对象 | | 链尾产物 | 裸值,无 `:collect` | rich 对象,需 `:collect` 拆箱 | > `(mogan lang)` 保留在 `mogan/` 目录,作为行为参考与 Scala Oracle 测试基线, > 不再是规范目标(详见 `spec.md` §1.3)。 --- ## 💡 概念示例 ```scheme (import (liii lang)) ;; Scala: List(1,2,3,4,5).filter(_ <= 3).map(_ * 10).sum ($ '(1 2 3 4 5) :filter (<= _ 3) :map (* _ 10) :sum) ;; => 60,展开为原生调用,无任何运行时包装 ;; 谓词直传(无 _ 原样传递) ($ '(1 2 3 4) :filter odd?) ; => (1 3) ;; Scala 宽容边界:take/drop 越界不抛错(Oracle 验证) ($ '(1 2 3) :take 10) ; => (1 2 3) ($ #(1 2 3) :drop -1) ; => #(1 2 3) ;; 链尾天然是裸值,无需 :collect ($ #(1 2 3 4) :map (+ _ 1) :filter (odd? _) :sum) ; => 4 ``` --- ## ✨ 核心特性 - **`$` 纯语法糖链式管道**:原生 `syntax-rules` 宏,白名单算子展开期直连 `(liii list)` / `(liii vector)` / srfi-133 原生函数; - **`_` 占位符自动提升**:`(:map (+ _ 2))` 即 `(lambda (_) (+ _ 2))`, 多个 `_` 绑定同一参数,无 `_` 则谓词原样传递; - **Scala 宽容边界**:`:take`/`:drop` 采用宽容版(越界/负数不抛错), 与 Scala 标准库逐项一致(`scala -e` 真实输出验证); - **list / vector 双路径**:运行时类型分流,同一套算子语义同构; - **人性化报错**:未命中白名单的算子触发 Did-you-mean 风格诊断, 列出全部支持的算子; - **`(mogan oop)` 现代对象模型**(参考实现):`define-case-class`、 `typed-define`、Option/Either 等,供迁移对照。 --- ## 📂 仓库结构 ```text . ├── liii/ │ └── lang.scm # (liii lang):$ 纯语法糖 + _ 占位符(规范目标) ├── mogan/ # (mogan lang):历史闭包式实现(行为参考) │ ├── lang.scm # 顶层门面与运行时 $ / box │ ├── oop.scm # 对象系统宏 (define-case-class, @, typed-define) │ ├── check.scm # 适配 class=? 的测试断言 │ └── rich-*.scm # rich-list/vector/string/hash-table/set/... ├── tests/ │ ├── liii/ │ │ └── lang/ # (liii lang) 测试:一算子一文件 │ │ ├── README.md # 模块导览 │ │ ├── lang-test.scm # 横切断言(卫生性/未命中报错/链式) │ │ ├── list%map-test.scm # ($ list :map f) │ │ ├── vector%take-test.scm # ($ vector :take n) │ │ └── underscore-lift-test.scm # _ 占位符专项 │ └── mogan/ # mogan 存量单元测试(回归基线) ├── spec.md # (liii lang) 语言与集合规范(Living Standard) └── plan.md # (liii lang) 实施规划 ``` --- ## 🧪 运行与测试 ```bash gf test tests/liii/lang/ # (liii lang) 全部测试 gf test tests/liii/lang/list%map # 单算子 gf test tests/mogan/ # mogan 回归基线 ``` 行为对齐黄金法则:以 `scala -e '...'` 的标准库真实输出为唯一权威判据。 --- ## 📜 许可证 本项目遵循 [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0) 许可证。