One Markdown-to-program mapping, no version selector or legacy mapper. Frontend/runtime: - resolve @exec/@knowledge heading declarations with nearest-ancestor inheritance; only an Exec H2 is callable; add UnitKind::Knowledge and sem.* diagnostics (mode marker, unit name, exec-without-function, payload nesting/empty, syntax, control stack, params position, version directive, inferred-signature lint) - extract Strong/Emph/inline Code as one-statement carriers, refuse nested carriers, and honour heading segment boundaries so an if/while cannot be closed across a heading - lower if/else/while/end to the existing Branch/Loop/Return IR with a compile-time control stack; keep payload-relative source spans through expression parsing and rewrite them onto the file - accept params(...) only as the first direct Exec H2 payload; keep the existing free-variable inference and named-only rule for inferred signatures; fix duplicate-mode/else/end and Knowledge-body inertness - reject marqdo_semantics/syntax front matter directives Data and tests: - migrate stdlib/**/*.mq.md, regenerate stdlib.json digest - migrate examples and the full semantics/negative/runtime corpus to the only current syntax; expected values/runtime codes preserved - migrate Rust-embedded .mq.md fixtures, init template, CLI help and security-lane fixtures Verified: cargo fmt --check, cargo clippy -D warnings and cargo test --workspace --locked (green).
848 lines
11 KiB
Markdown
848 lines
11 KiB
Markdown
## @exec 成功值
|
|
|
|
`params(值, 下一位置)`
|
|
|
|
`return {ok: true, value: 值, next: 下一位置}`
|
|
|
|
## @exec 失败
|
|
|
|
`params(代码, 消息)`
|
|
|
|
`return {ok: false, code: 代码, message: 消息}`
|
|
|
|
## @exec 是空白
|
|
|
|
`params(码点: Int)`
|
|
|
|
`return 码点 == 32 or 码点 == 9 or 码点 == 10 or 码点 == 13`
|
|
|
|
## @exec 是数字
|
|
|
|
`params(码点: Int)`
|
|
|
|
`return 码点 >= 48 and 码点 <= 57`
|
|
|
|
## @exec 跳过空白
|
|
|
|
`params(点: List, 位置: Int)`
|
|
|
|
`当前 = 位置`
|
|
|
|
`while 当前 < 长度(点) and 是空白(点[当前])`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`end`
|
|
|
|
`return 当前`
|
|
|
|
## @exec 匹配
|
|
|
|
`params(点: List, 位置: Int, 文本: Text)`
|
|
|
|
`目标 = text.codepoints(文本)`
|
|
|
|
`下标 = 0`
|
|
|
|
`结果 = true`
|
|
|
|
`while 下标 < 长度(目标) and 结果`
|
|
|
|
`if 位置 + 下标 >= 长度(点)`
|
|
|
|
`结果 = false`
|
|
|
|
`else`
|
|
|
|
`if 点[位置 + 下标] != 目标[下标]`
|
|
|
|
`结果 = false`
|
|
|
|
`else`
|
|
|
|
`继续 = 0`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`下标 = 下标 + 1`
|
|
|
|
`end`
|
|
|
|
`return 结果`
|
|
|
|
## @exec 片段
|
|
|
|
`params(点: List, 起点: Int, 终点: Int)`
|
|
|
|
`结果 = ""`
|
|
|
|
`下标 = 起点`
|
|
|
|
`while 下标 < 终点`
|
|
|
|
`结果 = 结果 + text.from_codepoint(点[下标])`
|
|
|
|
`下标 = 下标 + 1`
|
|
|
|
`end`
|
|
|
|
`return 结果`
|
|
|
|
## @exec 解析数字
|
|
|
|
`params(点: List, 位置: Int)`
|
|
|
|
JSON 数字:可选负号、整数位、可选小数位、可选指数;含 ./e 返回 Float。
|
|
|
|
`开始 = 位置`
|
|
|
|
`当前 = 位置`
|
|
|
|
`if text.from_codepoint(点[当前]) == "-"`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`else`
|
|
|
|
`非负 = 0`
|
|
|
|
`end`
|
|
|
|
`整数位 = 0`
|
|
|
|
`while 当前 < 长度(点) and 是数字(点[当前])`
|
|
|
|
`整数位 = 整数位 + 1`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`end`
|
|
|
|
`有小数 = false`
|
|
|
|
`小数位 = 0`
|
|
|
|
`if 当前 < 长度(点) and text.from_codepoint(点[当前]) == "."`
|
|
|
|
`有小数 = true`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`while 当前 < 长度(点) and 是数字(点[当前])`
|
|
|
|
`小数位 = 小数位 + 1`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`忽略 = 0`
|
|
|
|
`end`
|
|
|
|
`指数位 = 0`
|
|
|
|
`指数标记 = false`
|
|
|
|
`if 当前 < 长度(点) and (text.from_codepoint(点[当前]) == "e" or text.from_codepoint(点[当前]) == "E")`
|
|
|
|
`有小数 = true`
|
|
|
|
`指数标记 = true`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`if 当前 < 长度(点) and (text.from_codepoint(点[当前]) == "+" or text.from_codepoint(点[当前]) == "-")`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`else`
|
|
|
|
`忽略指数符号 = 0`
|
|
|
|
`end`
|
|
|
|
`while 当前 < 长度(点) and 是数字(点[当前])`
|
|
|
|
`指数位 = 指数位 + 1`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`if 整数位 == 0`
|
|
|
|
`return 失败("json.invalid_number", "数字缺少整数位")`
|
|
|
|
`else`
|
|
|
|
`if 有小数 and not 指数标记 and 小数位 == 0`
|
|
|
|
`return 失败("json.invalid_number", "小数缺少位数")`
|
|
|
|
`else`
|
|
|
|
`if 指数标记 and 指数位 == 0`
|
|
|
|
`return 失败("json.invalid_number", "指数缺少位数")`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`原文 = 片段(点, 开始, 当前)`
|
|
|
|
`if 有小数`
|
|
|
|
`return 成功值(小数(原文), 当前)`
|
|
|
|
`end`
|
|
|
|
`return 成功值(整数(原文), 当前)`
|
|
|
|
## @exec 十六进制值
|
|
|
|
`params(码点: Int)`
|
|
|
|
`if 码点 >= 48 and 码点 <= 57`
|
|
|
|
`return 码点 - 48`
|
|
|
|
`else`
|
|
|
|
`if 码点 >= 65 and 码点 <= 70`
|
|
|
|
`return 码点 - 55`
|
|
|
|
`else`
|
|
|
|
`if 码点 >= 97 and 码点 <= 102`
|
|
|
|
`return 码点 - 87`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`return 0 - 1`
|
|
|
|
## @exec 解析字符串
|
|
|
|
`params(点: List, 位置: Int)`
|
|
|
|
`当前 = 位置 + 1`
|
|
|
|
`结果 = ""`
|
|
|
|
`完成 = false`
|
|
|
|
`错误 = ""`
|
|
|
|
`while 当前 < 长度(点) and not 完成 and 错误 == ""`
|
|
|
|
`码点 = 点[当前]`
|
|
|
|
`if 码点 == 34`
|
|
|
|
`完成 = true`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`else`
|
|
|
|
`if 码点 == 92`
|
|
|
|
`if 当前 + 1 >= 长度(点)`
|
|
|
|
`错误 = "json.invalid_escape"`
|
|
|
|
`else`
|
|
|
|
`转义码点 = 点[当前 + 1]`
|
|
|
|
`if 转义码点 == 34`
|
|
|
|
`结果 = 结果 + text.from_codepoint(34)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 92`
|
|
|
|
`结果 = 结果 + text.from_codepoint(92)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 47`
|
|
|
|
`结果 = 结果 + text.from_codepoint(47)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 98`
|
|
|
|
`结果 = 结果 + text.from_codepoint(8)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 102`
|
|
|
|
`结果 = 结果 + text.from_codepoint(12)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 110`
|
|
|
|
`结果 = 结果 + text.from_codepoint(10)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 114`
|
|
|
|
`结果 = 结果 + text.from_codepoint(13)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 116`
|
|
|
|
`结果 = 结果 + text.from_codepoint(9)`
|
|
|
|
`当前 = 当前 + 2`
|
|
|
|
`else`
|
|
|
|
`if 转义码点 == 117`
|
|
|
|
`if 当前 + 5 >= 长度(点)`
|
|
|
|
`错误 = "json.invalid_escape"`
|
|
|
|
`else`
|
|
|
|
`数字 = 十六进制值(点[当前 + 2]) * 4096 + 十六进制值(点[当前 + 3]) * 256 + 十六进制值(点[当前 + 4]) * 16 + 十六进制值(点[当前 + 5])`
|
|
|
|
`if 数字 < 0 or (数字 >= 55296 and 数字 <= 57343)`
|
|
|
|
`错误 = "json.invalid_escape"`
|
|
|
|
`else`
|
|
|
|
`结果 = 结果 + text.from_codepoint(数字)`
|
|
|
|
`当前 = 当前 + 6`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`错误 = "json.invalid_escape"`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`结果 = 结果 + text.from_codepoint(码点)`
|
|
|
|
`当前 = 当前 + 1`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`if 错误 != ""`
|
|
|
|
`return 失败("json.invalid_string", "字符串转义无效")`
|
|
|
|
`else`
|
|
|
|
`if not 完成`
|
|
|
|
`return 失败("json.unexpected_eof", "字符串未闭合")`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`return 成功值(结果, 当前)`
|
|
|
|
## @exec 解析对象
|
|
|
|
`params(点: List, 位置: Int)`
|
|
|
|
`return 解析对象项(点, 位置 + 1, {})`
|
|
|
|
## @exec 解析对象项
|
|
|
|
`params(点: List, 位置: Int, 已解析: Map)`
|
|
|
|
`位置 = 跳过空白(点, 位置)`
|
|
|
|
`if 位置 >= 长度(点)`
|
|
|
|
`return 失败("json.unexpected_eof", "对象未闭合")`
|
|
|
|
`end`
|
|
|
|
`当前 = text.from_codepoint(点[位置])`
|
|
|
|
`if 当前 == "}"`
|
|
|
|
`return 成功值(已解析, 位置 + 1)`
|
|
|
|
`end`
|
|
|
|
`键结果 = 解析字符串(点, 位置)`
|
|
|
|
`if not 键结果.ok`
|
|
|
|
`return 键结果`
|
|
|
|
`end`
|
|
|
|
`键 = 键结果.value`
|
|
|
|
`位置 = 跳过空白(点, 键结果.next)`
|
|
|
|
`if 位置 >= 长度(点)`
|
|
|
|
`return 失败("json.unexpected_eof", "对象缺少冒号")`
|
|
|
|
`else`
|
|
|
|
`if text.from_codepoint(点[位置]) != ":"`
|
|
|
|
`return 失败("json.invalid_object", "对象缺少冒号")`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`位置 = 跳过空白(点, 位置 + 1)`
|
|
|
|
`值结果 = 解析值(点, 位置)`
|
|
|
|
`if not 值结果.ok`
|
|
|
|
`return 值结果`
|
|
|
|
`end`
|
|
|
|
`新的已解析 = map.set(已解析, 键, 值结果.value)`
|
|
|
|
`位置 = 跳过空白(点, 值结果.next)`
|
|
|
|
`if 位置 >= 长度(点)`
|
|
|
|
`return 失败("json.unexpected_eof", "对象未闭合")`
|
|
|
|
`end`
|
|
|
|
`分隔 = text.from_codepoint(点[位置])`
|
|
|
|
`if 分隔 == ","`
|
|
|
|
`return 解析对象项(点, 位置 + 1, 新的已解析)`
|
|
|
|
`else`
|
|
|
|
`if 分隔 == "}"`
|
|
|
|
`return 成功值(新的已解析, 位置 + 1)`
|
|
|
|
`else`
|
|
|
|
`return 失败("json.invalid_object", "对象缺少逗号或 }")`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
## @exec 解析值
|
|
|
|
`params(点: List, 位置: Int)`
|
|
|
|
`位置 = 跳过空白(点, 位置)`
|
|
|
|
`if 位置 >= 长度(点)`
|
|
|
|
`return 失败("json.unexpected_eof", "需要值")`
|
|
|
|
`end`
|
|
|
|
`首 = text.from_codepoint(点[位置])`
|
|
|
|
`首码点 = 点[位置]`
|
|
|
|
`if 首码点 == 34`
|
|
|
|
`return 解析字符串(点, 位置)`
|
|
|
|
`else`
|
|
|
|
`if 首码点 == 123`
|
|
|
|
`return 解析对象(点, 位置)`
|
|
|
|
`else`
|
|
|
|
`if 首 == "["`
|
|
|
|
`return 解析数组(点, 位置)`
|
|
|
|
`else`
|
|
|
|
`if 首 == "-" or 是数字(点[位置])`
|
|
|
|
`return 解析数字(点, 位置)`
|
|
|
|
`else`
|
|
|
|
`if 首 == "t"`
|
|
|
|
`if 匹配(点, 位置, "true")`
|
|
|
|
`return 成功值(true, 位置 + 4)`
|
|
|
|
`else`
|
|
|
|
`return 失败("json.invalid_literal", "无效字面量")`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`if 首 == "f"`
|
|
|
|
`if 匹配(点, 位置, "false")`
|
|
|
|
`return 成功值(false, 位置 + 5)`
|
|
|
|
`else`
|
|
|
|
`return 失败("json.invalid_literal", "无效字面量")`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`if 首 == "n"`
|
|
|
|
`if 匹配(点, 位置, "null")`
|
|
|
|
`return 成功值(None, 位置 + 4)`
|
|
|
|
`else`
|
|
|
|
`return 失败("json.invalid_literal", "无效字面量")`
|
|
|
|
`end`
|
|
|
|
`else`
|
|
|
|
`return 失败("json.unexpected_token", "不支持的值")`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
## @exec 解析数组
|
|
|
|
`params(点: List, 位置: Int)`
|
|
|
|
`return 解析数组项(点, 位置 + 1, [])`
|
|
|
|
## @exec 解析数组项
|
|
|
|
`params(点: List, 位置: Int, 已解析: List)`
|
|
|
|
`位置 = 跳过空白(点, 位置)`
|
|
|
|
`if 位置 >= 长度(点)`
|
|
|
|
`return 失败("json.unexpected_eof", "数组未闭合")`
|
|
|
|
`end`
|
|
|
|
`当前 = text.from_codepoint(点[位置])`
|
|
|
|
`if 当前 == "]"`
|
|
|
|
`return 成功值(已解析, 位置 + 1)`
|
|
|
|
`end`
|
|
|
|
`项 = 解析值(点, 位置)`
|
|
|
|
`if not 项.ok`
|
|
|
|
`return 项`
|
|
|
|
`end`
|
|
|
|
`新的已解析 = list.append(已解析, 项.value)`
|
|
|
|
`位置 = 跳过空白(点, 项.next)`
|
|
|
|
`if 位置 >= 长度(点)`
|
|
|
|
`return 失败("json.unexpected_eof", "数组未闭合")`
|
|
|
|
`end`
|
|
|
|
`分隔 = text.from_codepoint(点[位置])`
|
|
|
|
`if 分隔 == ","`
|
|
|
|
`return 解析数组项(点, 位置 + 1, 新的已解析)`
|
|
|
|
`else`
|
|
|
|
`if 分隔 == "]"`
|
|
|
|
`return 成功值(新的已解析, 位置 + 1)`
|
|
|
|
`else`
|
|
|
|
`return 失败("json.invalid_array", "数组缺少逗号或 ]")`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
## @exec 格式化文本
|
|
|
|
`params(文本: Text)`
|
|
|
|
`点 = text.codepoints(文本)`
|
|
|
|
`结果 = "\""`
|
|
|
|
`下标 = 0`
|
|
|
|
`while 下标 < 长度(点)`
|
|
|
|
`码点 = 点[下标]`
|
|
|
|
`if 码点 == 34`
|
|
|
|
`结果 = 结果 + "\\\""`
|
|
|
|
`else`
|
|
|
|
`if 码点 == 92`
|
|
|
|
`结果 = 结果 + "\\\\"`
|
|
|
|
`else`
|
|
|
|
`if 码点 == 10`
|
|
|
|
`结果 = 结果 + "\\n"`
|
|
|
|
`else`
|
|
|
|
`if 码点 == 9`
|
|
|
|
`结果 = 结果 + "\\t"`
|
|
|
|
`else`
|
|
|
|
`if 码点 == 13`
|
|
|
|
`结果 = 结果 + "\\r"`
|
|
|
|
`else`
|
|
|
|
`结果 = 结果 + text.from_codepoint(码点)`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`下标 = 下标 + 1`
|
|
|
|
`end`
|
|
|
|
`return 结果 + "\""`
|
|
|
|
## @exec 格式化列表
|
|
|
|
`params(列表: List)`
|
|
|
|
`结果 = "["`
|
|
|
|
`下标 = 0`
|
|
|
|
`while 下标 < 长度(列表)`
|
|
|
|
`if 下标 > 0`
|
|
|
|
`结果 = 结果 + ", "`
|
|
|
|
`else`
|
|
|
|
`忽略 = 0`
|
|
|
|
`end`
|
|
|
|
`结果 = 结果 + 格式化(列表[下标])`
|
|
|
|
`下标 = 下标 + 1`
|
|
|
|
`end`
|
|
|
|
`return 结果 + "]"`
|
|
|
|
## @exec 格式化对象
|
|
|
|
`params(映射: Map)`
|
|
|
|
`键列表 = map.keys(映射)`
|
|
|
|
`结果 = "{"`
|
|
|
|
`下标 = 0`
|
|
|
|
`while 下标 < 长度(键列表)`
|
|
|
|
`if 下标 > 0`
|
|
|
|
`结果 = 结果 + ", "`
|
|
|
|
`else`
|
|
|
|
`忽略 = 0`
|
|
|
|
`end`
|
|
|
|
`当前键 = 键列表[下标]`
|
|
|
|
`结果 = 结果 + 格式化文本(当前键) + ": " + 格式化(map.get(映射, 当前键))`
|
|
|
|
`下标 = 下标 + 1`
|
|
|
|
`end`
|
|
|
|
`return 结果 + "}"`
|
|
|
|
## @exec 格式化
|
|
|
|
`params(值)`
|
|
|
|
`类别 = 类型(值)`
|
|
|
|
`if 类别 == "Text"`
|
|
|
|
`return 格式化文本(值)`
|
|
|
|
`else`
|
|
|
|
`if 类别 == "None"`
|
|
|
|
`return "null"`
|
|
|
|
`else`
|
|
|
|
`if 类别 == "Bool" or 类别 == "Int" or 类别 == "Float"`
|
|
|
|
`return 文本(值)`
|
|
|
|
`else`
|
|
|
|
`if 类别 == "List"`
|
|
|
|
`return 格式化列表(值)`
|
|
|
|
`else`
|
|
|
|
`if 类别 == "Map"`
|
|
|
|
`return 格式化对象(值)`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`end`
|
|
|
|
`return "null"`
|
|
|
|
## @exec main
|
|
|
|
`对象结果 = 解析值(text.codepoints("{\"a\": 1, \"b\": [true, null, \"说\\\"好\"]}"), 0)`
|
|
|
|
`字符串结果 = 解析值(text.codepoints("\"a\\nb\""), 0)`
|
|
|
|
`浮点结果 = 解析值(text.codepoints("[1, 2.5, -3e2, 4E-1, {\"a\": 1.0}, \"x\"]"), 0)`
|
|
|
|
`格式化结果 = 格式化(浮点结果.value)`
|
|
|
|
`return [解析值(text.codepoints(" [1, 23, [4, 5], -6] "), 0), 解析值(text.codepoints("[1 2]"), 0), 解析值(text.codepoints("[1,"), 0), 对象结果, 字符串结果, 浮点结果, 格式化结果]`
|