Abs —— 类型系统
Abs 是 abstract value(抽象值) 的缩写,来自抽象解释。Nudo 的目标是在源码中看到变量接近运行时的样子。Abs 是支撑该目标的表示:不是宽泛的类型名,而是带有值身份与约束的、可能 JavaScript 值的符号集合。
Abs 可以精确到单个具体值(42、"hello"),也可以覆盖共享某些特征的所有值(「任意数字」「字面量 1」)。
Abs(shape × term × pred × conf)是唯一的类型系统:可计算的值,其约束参与代数(x > 0 ⇒ x + 1 > 1)。分析、inlay 展示、签名与投影(.d.ts / zod / guard)全部直接消费 Abs;不存在独立 IR。生产分析是 Abs 原生的——没有东西读回投影。
四个组成
- shape —— 外延载体:值长什么样。种类:
prim(带litterm 即精确值)、obj、arr、tuple、fn、eff(promise<…>/generator<…>)、brand(名义实例)、sum(联合)、never、any(无约束)、unknown(推导失败 —— 见 any vs unknown)。 - term —— 抽象值身份:
lit(具体)、var(符号 α,如A1)或app(应用表达式,如(x + 2))。 - pred —— 相对 term 的约束:
(x + 2) > 3。 - conf — 抽象精确度。由强到弱:
exact→path→widened→mock→partial→opaque(合并取更弱侧)。
| conf | 含义 |
|---|---|
exact | 字面量 / 可精确求值(25 #exact) |
path | 依赖路径约束 / 符号 term((x+1) · > 1 #path) |
widened | 结构丢失后的保守外延(循环合流、预算) |
mock | 声明的 mock / harvest 形面,非观测求值 |
partial | 集合内容不完整 |
opaque | 无可用内容(预算截断、求值失败) |
仅 exact / path 会投影进 dts / schema 细节。
Abs 解剖 —— 四个分量与一组示例(x + 1 / number / > 1 / path)。
构造器(num()、strLit(…)、obj({…})…)与核心函数(leqAbs、formatAbs、checkSource…)见 core API。
字面量
带 lit term 的 prim shape 表示恰好一个具体值 —— 引擎从代码字面量或具体 @nudo:case 实参产出它:
25 #exact // 精确的数字 25
"localhost" #exact // 一个特定字符串
基本类型
不带 lit term 的 prim shape 是整个域 —— 知道值属于该类型但不知道具体是哪个:
number // 任意数字
string // 任意字符串
boolean // true 或 false
对象、数组、元组
obj 携带已知槽位(每键 { value, optional? }),arr 单一元素类型,tuple 定长逐元素:
{ host: "localhost", port: 8080, debug: false }
[2, 4, 6] // 字面量元组 —— 元素抽象时为 arr
number[] // 抽象元素
函数与 Promise
fn 携带参数名(或 paramTypes/returnType 签名);eff 包装异步效应,小写渲染:
load: (id) => ? // 函数值,结果尚未精确
promise<{ id: 7, name: "u7" }> // 异步结果
联合
sum 是成员 Abs 的联合 —— 值可能是任一成员:
25 | 9 // 两个精确数字(来自两个调用点)
number | string // 异构联合
never 是空集(不可达)。
any 与 unknown
二者在产品语义上不是同一概念,在文档与 CLI 输出中绝不可混为一谈:
any | unknown | |
|---|---|---|
| 含义 | 无约束:JS 值的并集;开发者负责细化 | 推导失败 / 引擎无信息;Nudo 负责修 |
| 来源 | 未标注入口参数、显式 any()、refine 解析失败回退 | 求值失败、native 未建模、截断、泄漏、opaque |
| 运算 | 按真实 JS 语义取并集;不是「分析失败」 | 不得假装成合法契约;应触发引擎债诊断 |
| 窄化 | 条件语句可窄化(typeof / === / Array.isArray / switch / 真值 / 判别字段) | 用户条件不能「合法化」;先修推导或补 env/mock/refine |
| 展示 | any(可带 type-var 如 A1) | unknown + conf 标注 |
| 产品话术 | 「未写契约 ⇒ 默认约束为 any + JS 运行时效果」 | 「Nudo 遇到无法处理的场景」 |
规则(Nudo 展示面): 无约束入口参数显示为 any,绝不显示为 unknown。CLI / check 签名遵循此契约。此规则只约束 Nudo 自己的展示 / CLI 输出,不管辖 TypeScript 声明产物。
TS 投影面(2026-11-06 裁定): Nudo 的 any 表示「任意 JS 值、无约束」,对应 TypeScript 的 unknown(top,消费方须先收窄),不是 TS 的 any(关闭类型检查的逃生舱)。因此 .d.ts 与 zod / standard / guard 三面校验器一样,把 Nudo any 与 Nudo unknown 都投影成 TS unknown。.d.ts 里未收窄的无约束返回值触发 TS2571 是正确的类型安全提示,不是假红(见 Bug 544)。
指令中的类型表达式
@nudo:case / @nudo:mock / @nudo:contract 的实参用约束表达式文法书写 —— 与 *.nudo.js 模板相同的构建器:
| 表达式 | 含义 | 示例 |
|---|---|---|
number() / string() / boolean() | 基本类型域 | @nudo:case "symbolic" (number()) |
lit(v) | 字面量域 | lit(42) / lit("ada") / lit(true) |
union(…) | 成员联合 | union(lit(1), lit(2)) |
shape({ … }) | 对象形状(字段递归) | shape({ id: number().gt(0) }) |
array(…) | 数组元素约束 | array(number()) |
any() | 无约束域(与未标注入口参数相同) | any() |
fn({ … }, …) | 函数关系 | fn({ x: number().gt(0) }, number()) |
| 构建器链 | .gt/.ge/.lt/.le/.int/.min/.max/.length/.shift… | number().gt(0).int() |
| 裸字面量 | 直接解析 | 42、"abc"、true、[1, 2]、null、undefined、unknown、never |
指令类型表达式使用上面的约束构建器加具体字面量。@nudo:mock body 内写普通 JavaScript 值和闭包 —— 不要把构建器调用当作返回负载。
/**
* @nudo:case "concrete" (5, 3)
* @nudo:case "symbolic" (number(), number())
* @nudo:case "mixed" (lit(0), string())
*/
function combine(a, b) {
return a + b;
}
设计原则
Nudo 的类型值体系遵循四条核心原则,决定运算与推断的行为。
1. 字面量保持
所有输入都是字面量时,输出也是字面量。引擎计算出具体结果。
combine(5, 3) // → 8 #exact,不是 number
"ab" + "c" // → "abc" #exact
信息足够时推断类型保持精确。
2. 抽象时拓宽
任一输入抽象(非字面量)时,结果拓宽到相应域 —— 但 Nudo 尽可能保留结构。
1 + number // → number #path(展示为域)
"xy" + string // → string #path(展示为域)
string + string // → string(无结构可保留)
字符串拼接涉及至少一个字面量时,Nudo 内部追踪模板字符串 —— 已知前后缀被保留,这正是 ("user-" + x).startsWith("user-") 在符号 x 下也能折叠为 true #exact 的原因。
3. 惰性联合分布
联合按原样传播。符号值上的运算保持符号 —— 不会急切展开成成员笛卡尔积。这避免组合爆炸并保持相关性:
function selfAdd(a) {
return a + a; // intension: (A1 + A1) —— 一个符号变量,不是 A1 + A1'
}
selfAdd(1); // → 2 #exact(逐调用点)
selfAdd(2); // → 4 #exact
// Observed: 2 | 4 —— 相关性保持,绝不会是 1+1 | 1+2 | 2+1 | 2+2
抽象实参下结果拓宽到代数判定的域(2 + x,其中 x: number | string → number | string;selfAdd(number) → number #widened)—— 只有运算符或方法必须区分成员时才逐成员展开。
4. 守卫窄化(逐调用点)
类型守卫只有在守卫测试对调用点的具体实参确定为真/假时分叉分支。每条 call@L… case 用该调用的精确实参求值,匹配的分支运行,另一个被消除:
function len(x) {
if (typeof x === "string") return x.length;
return -1;
}
len("abc"); // → 3 (string 调用走该分支)
len(5); // → -1 (number 调用落空)
抽象实参(number()、union(...))无法判定条件——两个分支以相同值运行,结果 join。不存在抽象联合的交集/减法。已验证模式与当前边界:控制流收窄。