feat(rfc-cm): baseline P0-P3 compute machine, stdlib and resource slices
Implements the first vertical slices of RFC-CM-0001/0002 on top of a113d89:
- P1: opaque Memory regions (64 KiB pages, budgets, grow-only), byte
read/write, Memory-index place assignment, wire/host-boundary rejection.
- CM-A04/A05: value-semantics List/Map/Text/Table primitives and the
recoverable Result map convention.
- CM-A06: opaque Resource handles, resource.open/read/write/close, stdout
write, granted project-file read and buffered write, strict fail-closed.
- CM-A07 Compat-A: explicit .mq.md format/utf8/io chain matching builtin
print for the covered value types; builtin remains default.
- P2 fixtures: allocators, list/tree/graph/hash, integer codecs, UTF-8
encode/decode, CSV/JSON subsets, table filter/sort/join, bytecode VM.
- ADRs 0022-0027, spec updates, evidence reports and 68 semantic goldens.
Gate: cargo fmt --check, clippy -D warnings, 407 tests passed.
This commit is contained in:
1 parent
a113d89496
commit
92bfbf2568
127 files changed
+11351
-141
No files matched your search
@@ -0,0 +1,20 @@
|
||||
---
|
||||
import:
|
||||
io: "./io.mq.md"
|
||||
---
|
||||
|
||||
## main
|
||||
|
||||
**列表 = ["文本", 2, 1.5, [3, true], {a: 1, b: "x"}, None]**
|
||||
|
||||
> io.写值(列表)
|
||||
|
||||
> 打印(列表)
|
||||
|
||||
**表格 = 表(["名称", "分数"], [["甲", 87], ["乙", 92]])**
|
||||
|
||||
> io.写值(表格)
|
||||
|
||||
> 打印(表格)
|
||||
|
||||
*[类型(列表), 类型(表格)]*
|
||||
@@ -0,0 +1,209 @@
|
||||
## 显示
|
||||
|
||||
`(值)`
|
||||
|
||||
按语言值语义格式化,用于与内置 `打印` 的输出对照。
|
||||
当前只覆盖 Unit/None/Bool/Int/Float/Text/List/Map/Table;Formula/Code/
|
||||
FunctionRef/PluginHandle 仍缺少公开观察接口。
|
||||
|
||||
**类别 = 类型(值)**
|
||||
|
||||
1. `类别 == "Unit"`
|
||||
|
||||
*"Unit"*
|
||||
|
||||
2. `类别 == "None"`
|
||||
|
||||
*"None"*
|
||||
|
||||
3. `类别 == "Text"`
|
||||
|
||||
*值*
|
||||
|
||||
4. `类别 == "List"`
|
||||
|
||||
*列表显示(值)*
|
||||
|
||||
5. `类别 == "Map"`
|
||||
|
||||
*映射显示(值)*
|
||||
|
||||
6. `类别 == "Table"`
|
||||
|
||||
*表格显示(值)*
|
||||
|
||||
7. `true`
|
||||
|
||||
*文本(值)*
|
||||
|
||||
## 列表显示
|
||||
|
||||
`(列表)`
|
||||
|
||||
**结果 = "["**
|
||||
|
||||
**下标 = 0**
|
||||
|
||||
- `下标 < 长度(列表)`
|
||||
|
||||
1. `下标 > 0`
|
||||
|
||||
**结果 = 结果 + ", "**
|
||||
|
||||
2. `true`
|
||||
|
||||
**忽略 = 0**
|
||||
|
||||
**结果 = 结果 + 值显示(列表[下标])**
|
||||
|
||||
**下标 = 下标 + 1**
|
||||
|
||||
*结果 + "]"*
|
||||
|
||||
## 映射显示
|
||||
|
||||
`(映射)`
|
||||
|
||||
**键 = map.keys(映射)**
|
||||
|
||||
**结果 = "{"**
|
||||
|
||||
**下标 = 0**
|
||||
|
||||
- `下标 < 长度(键)`
|
||||
|
||||
1. `下标 > 0`
|
||||
|
||||
**结果 = 结果 + ", "**
|
||||
|
||||
2. `true`
|
||||
|
||||
**忽略 = 0**
|
||||
|
||||
**当前键 = 键[下标]**
|
||||
|
||||
**结果 = 结果 + 当前键 + ": " + 值显示(map.get(映射, 当前键))**
|
||||
|
||||
**下标 = 下标 + 1**
|
||||
|
||||
*结果 + "}"*
|
||||
|
||||
## 表格显示
|
||||
|
||||
`(表格)`
|
||||
|
||||
**列 = table.columns(表格)**
|
||||
|
||||
**结果 = "Table[" + 连接文本(列, " | ") + "]{"**
|
||||
|
||||
**行号 = 0**
|
||||
|
||||
- `行号 < 长度(表格)`
|
||||
|
||||
1. `行号 > 0`
|
||||
|
||||
**结果 = 结果 + "; "**
|
||||
|
||||
2. `true`
|
||||
|
||||
**忽略 = 0**
|
||||
|
||||
**行 = table.row(表格, 行号)**
|
||||
|
||||
**单元格 = []**
|
||||
|
||||
**列号 = 0**
|
||||
|
||||
- `列号 < 长度(行)`
|
||||
|
||||
**单元格 = list.append(单元格, 显示(行[列号]))**
|
||||
|
||||
**列号 = 列号 + 1**
|
||||
|
||||
**结果 = 结果 + 连接文本(单元格, " | ")**
|
||||
|
||||
**行号 = 行号 + 1**
|
||||
|
||||
*结果 + "}"*
|
||||
|
||||
## 连接文本
|
||||
|
||||
`(列表, 分隔)`
|
||||
|
||||
**结果 = ""**
|
||||
|
||||
**下标 = 0**
|
||||
|
||||
- `下标 < 长度(列表)`
|
||||
|
||||
1. `下标 > 0`
|
||||
|
||||
**结果 = 结果 + 分隔**
|
||||
|
||||
2. `true`
|
||||
|
||||
**忽略 = 0**
|
||||
|
||||
**结果 = 结果 + 列表[下标]**
|
||||
|
||||
**下标 = 下标 + 1**
|
||||
|
||||
*结果*
|
||||
|
||||
## 值显示
|
||||
|
||||
`(值)`
|
||||
|
||||
列表/映射/表格内部使用 repr 语义:Text 带引号并转义,其它值递归显示。
|
||||
|
||||
**类别 = 类型(值)**
|
||||
|
||||
1. `类别 == "Text"`
|
||||
|
||||
*转义文本(值)*
|
||||
|
||||
2. `true`
|
||||
|
||||
*显示(值)*
|
||||
|
||||
## 转义文本
|
||||
|
||||
`(文本)`
|
||||
|
||||
**点 = text.codepoints(文本)**
|
||||
|
||||
**`结果 = "\""`**
|
||||
|
||||
**下标 = 0**
|
||||
|
||||
- `下标 < 长度(点)`
|
||||
|
||||
**码点 = 点[下标]**
|
||||
|
||||
1. `码点 == 34`
|
||||
|
||||
**`结果 = 结果 + "\\\""`**
|
||||
|
||||
2. `码点 == 92`
|
||||
|
||||
**`结果 = 结果 + "\\\\"`**
|
||||
|
||||
3. `码点 == 10`
|
||||
|
||||
**`结果 = 结果 + "\\n"`**
|
||||
|
||||
4. `码点 == 9`
|
||||
|
||||
**`结果 = 结果 + "\\t"`**
|
||||
|
||||
5. `码点 == 13`
|
||||
|
||||
**`结果 = 结果 + "\\r"`**
|
||||
|
||||
6. `true`
|
||||
|
||||
**结果 = 结果 + text.from_codepoint(码点)**
|
||||
|
||||
**下标 = 下标 + 1**
|
||||
|
||||
*`结果 + "\""`*
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
import:
|
||||
format: "./format.mq.md"
|
||||
text: "./text.mq.md"
|
||||
---
|
||||
|
||||
## 写文本
|
||||
|
||||
`(文本)`
|
||||
|
||||
把文本编码为 UTF-8 并写入已授权的 stdout 资源流。
|
||||
|
||||
**内存 = memory.new(1, 1)**
|
||||
|
||||
**长度 = text.utf8编码(文本, 内存, 0)**
|
||||
|
||||
**流 = resource.open("stdio", "stdout", ["write"])**
|
||||
|
||||
> resource.write(流, 内存, 0, 长度)
|
||||
|
||||
> resource.close(流)
|
||||
|
||||
*None*
|
||||
|
||||
## 写值
|
||||
|
||||
`(值)`
|
||||
|
||||
按语言值语义格式化后输出,并追加换行。
|
||||
|
||||
**文字 = format.显示(值) + "\n"**
|
||||
|
||||
> 写文本(文字)
|
||||
|
||||
*None*
|
||||
@@ -0,0 +1,55 @@
|
||||
## utf8编码
|
||||
|
||||
`(文本, 内存, 基址)`
|
||||
|
||||
把 Unicode 标量序列按 UTF-8 写入 `Memory`,返回字节长度。
|
||||
|
||||
**点 = text.codepoints(文本)**
|
||||
|
||||
**下标 = 0**
|
||||
|
||||
**偏移 = 0**
|
||||
|
||||
- `下标 < 长度(点)`
|
||||
|
||||
**码点 = 点[下标]**
|
||||
|
||||
1. `码点 < 128`
|
||||
|
||||
**`内存[基址 + 偏移] = 码点`**
|
||||
|
||||
**偏移 = 偏移 + 1**
|
||||
|
||||
2. `码点 < 2048`
|
||||
|
||||
**`内存[基址 + 偏移] = 192 + 码点 // 64`**
|
||||
|
||||
**`内存[基址 + 偏移 + 1] = 128 + 码点 % 64`**
|
||||
|
||||
**偏移 = 偏移 + 2**
|
||||
|
||||
3. `码点 < 65536`
|
||||
|
||||
**`内存[基址 + 偏移] = 224 + 码点 // 4096`**
|
||||
|
||||
**`内存[基址 + 偏移 + 1] = 128 + 码点 // 64 % 64`**
|
||||
|
||||
**`内存[基址 + 偏移 + 2] = 128 + 码点 % 64`**
|
||||
|
||||
**偏移 = 偏移 + 3**
|
||||
|
||||
4. `true`
|
||||
|
||||
**`内存[基址 + 偏移] = 240 + 码点 // 262144`**
|
||||
|
||||
**`内存[基址 + 偏移 + 1] = 128 + 码点 // 4096 % 64`**
|
||||
|
||||
**`内存[基址 + 偏移 + 2] = 128 + 码点 // 64 % 64`**
|
||||
|
||||
**`内存[基址 + 偏移 + 3] = 128 + 码点 % 64`**
|
||||
|
||||
**偏移 = 偏移 + 4**
|
||||
|
||||
**下标 = 下标 + 1**
|
||||
|
||||
*偏移*
|
||||
Reference in new issue
Block a user