@nudojs/core 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -1,17 +1,27 @@
-import { Node } from '@babel/types';
+import { Node, File } from '@babel/types';
+import { P as Phi, A as AstEnv, a as Abs, C as Confidence, b as Pred, S as Shape, c as PrimName, T as Term, R as RelSource, H as HofSite, L as LeakBudget } from './index-CVYjXnwU.js';
+export { $ as $add, d as $arr, e as $async, f as $asyncReturn, g as $await, h as $call, i as $callNamed, j as $catchVal, k as $class, l as $concat, m as $div, n as $elems, o as $eq, p as $fnVal, q as $for, r as $forIter, s as $forOf, t as $fork, u as $ge, v as $gen, w as $get, x as $gt, y as $idx, z as $idxSet, B as $invoke, D as $invokeSuper, E as $join, F as $le, G as $len, I as $lit, J as $lt, K as $mod, M as $mul, N as $ne, O as $neg, Q as $new, U as $not, V as $obj, W as $optionalGet, X as $optionalInvoke, Y as $orDefault, Z as $set, _ as $setKey, a0 as $spread, a1 as $staticInvoke, a2 as $sub, a3 as $super, a4 as $switch, a5 as $thisGet, a6 as $thisSet, a7 as $throw, a8 as $typeof, a9 as $while, aa as $whileSeq, ab as $yield, ac as AbsAssignRecord, ad as AbsCallRecord, ae as AbsModuleExports, af as BCallRecord, ag as BClassSpec, ah as BMemberDiag, ai as DEFAULT_MAX_LOOP_ITERS, aj as EvalOptions, ak as EvalResult, al as HofCollectCtx, am as MAX_CALL_DEPTH, an as MAX_TOTAL_CALLS, ao as NudoThrow, ap as RunTranspiledOptions, aq as TranspileOptions, ar as TranspiledCallResult, as as abs, at as absToString, au as alphaOf, av as analyzeFn, aw as and, ax as anyVar, ay as app, az as applyAbsFn, aA as applyCallbackAbs, aB as asAbs, aC as asAbsVal, aD as betaOf, aE as bindImports, aF as bool, aG as boolLit, aH as callFunction, aI as callTranspiledExport, aJ as callTranspiledExportFull, aK as clearBClasses, aL as collectAbsExports, aM as collectAbsNodeTypes, aN as confJoin, aO as createHofCollectCtx, aP as currentExecPhi, aQ as defaultLeakBudget, aR as emptyEnv, aS as emptyPhi, aT as eq, aU as evalMethodBody, aV as evalNode, aW as evalProgramAbs, aX as evalSource, aY as exceedsBudget, aZ as findAbsAtPosition, a_ as ge, a$ as geNum, b0 as getAbsOrigin, b1 as getBCallCollector, b2 as getBClass, b3 as gt, b4 as gtNum, b5 as implies, b6 as instantiateReturn, b7 as isDefinitelyFalse, b8 as isDefinitelyTrue, b9 as isExactLit, ba as isNudoThrow, bb as isNumPrim, bc as isRelFn, bd as isStrPrim, be as le, bf as leNum, bg as leakIfNeeded, bh as lit, bi as litValue, bj as lt, bk as ltNum, bl as mapElementFallback, bm as maybeLeak, bn as ne, bo as never, bp as not, bq as noteMemberDispatchMiss, br as notePrimMemberMissing, bs as noteUnknownMemberMissing, bt as num, bu as numLit, bv as numVar, bw as obj, bx as or, by as pFalse, bz as pTrue, bA as phiAnd, bB as predEquals, bC as predToString, bD as predVars, bE as projectFlatMapResult, bF as promoteParamShape, bG as ptypeof, bH as recordMemberDiag, bI as registerBClass, bJ as resetAbsCallBudget, bK as resetLeakCounter, bL as runTranspiled, bM as setAbsAssignCollector, bN as setAbsCallCollector, bO as setAbsNodeCollector, bP as setAbsTruncationCollector, bQ as setApplyCallbackHost, bR as setBCallCollector, bS as setMemberDiagCollector, bT as shapeOfTerm, bU as shapeToString, bV as simplifyTerm, bW as snapshotAbs, bX as str, bY as strLit, bZ as substAbs, b_ as substPred, b$ as substPredAbs, c0 as tagAbsOrigin, c1 as termDepth, c2 as termEquals, c3 as termNodes, c4 as termToString, c5 as transpile, c6 as transpileExpression, c7 as transpileFile, c8 as transpileSource, c9 as tryPromoteDirectCall, ca as tryPromoteForOfIteratee, cb as tryPromoteHofCallback, cc as tryPromoteReceiverAsArr, cd as undefAbs, ce as unknown, cf as v, cg as withExecPhi, ch as withVar } from './index-CVYjXnwU.js';
 
 type Environment = {
     lookup(name: string): TypeValue;
     bind(name: string, value: TypeValue): Environment;
     update(name: string, value: TypeValue): boolean;
     extend(bindings: Record<string, TypeValue>): Environment;
+    fork(): Environment;
     has(name: string): boolean;
     snapshot(): Environment;
     getOwnBindings(): Record<string, TypeValue>;
 };
 declare function createEnvironment(parent?: Environment, bindings?: Map<string, TypeValue>): Environment;
 
-type LiteralValue = string | number | boolean | null | undefined;
+type LiteralValue = string | number | boolean | bigint | null | undefined;
+type SigImpl = (args: TypeValue[], thisVal?: TypeValue) => TypeValue | undefined;
+type FunctionSignature = {
+    paramTypes: TypeValue[];
+    returnType: TypeValue;
+    throwsType: TypeValue;
+    impl?: SigImpl;
+};
 type Refinement = {
     name: string;
     meta: Record<string, unknown>;
@@ -80,10 +90,21 @@ declare const T: {
     readonly union: typeof createUnion;
     readonly fn: (params: string[], body: Node, closure: Environment) => TypeValue;
     readonly refine: (base: TypeValue, refinement: Refinement) => TypeValue;
+    readonly fnSig: (paramTypes: TypeValue[], returnType: TypeValue, throwsType?: TypeValue, impl?: SigImpl) => TypeValue;
 };
 declare function typeValueEquals(a: TypeValue, b: TypeValue): boolean;
 declare function simplifyUnion(members: TypeValue[]): TypeValue;
 declare function widenLiteral(tv: TypeValue): TypeValue;
+/**
+ * union 成员全部为同原语基底的字面量且数量 > maxLiterals 时塌缩为该基类型；
+ * 非 union、混合类型、或数量不超限的原样返回。
+ *
+ * 复用 simplifyUnion（内含吸收律与去重）：先让「基类型已在场」的字面量被吸收
+ * （3 | number → number），再对剩余的纯字面量联合做阈值坍缩（1|2|…|20 → number）。
+ * 两步不冲突也不重复：吸收只删基类型已在场的字面量，阈值坍缩只处理无基类型
+ * 在场的纯字面量联合。
+ */
+declare function collapseLiteralUnion(tv: TypeValue, maxLiterals: number): TypeValue;
 declare function isSubtypeOf(a: TypeValue, b: TypeValue): boolean;
 declare function deepCloneTypeValue(tv: TypeValue, idMap?: Map<symbol, symbol>): TypeValue;
 declare function mergeObjectProperties(a: TypeValue & {
@@ -96,32 +117,46 @@ declare function narrowType(tv: TypeValue, predicate: (member: TypeValue) => boo
 declare function subtractType(tv: TypeValue, predicate: (member: TypeValue) => boolean): TypeValue;
 declare function getPrimitiveTypeOf(tv: TypeValue): string | undefined;
 declare function getRefinedBase(tv: TypeValue): TypeValue;
+declare function isFnSig(tv: TypeValue): boolean;
+declare function getFnSig(tv: TypeValue): FunctionSignature | undefined;
+
+/**
+ * 残差 IR 兜底（不是类型运算真理源）。
+ *
+ * 真理在 algebra：算术/比较/相等/typeof/!/−/字符串词法序/nullish 均走 Abs。
+ * 这里只保留：
+ * - add：代数拒绝时的混合 `+`
+ * - 比较/相等：代数无法判定时的保守 boolean / 字面量折叠
+ * - dispatchMethod/Property：宿主 refined 扩展（startsWith、length…）
+ */
 
 declare const Ops: {
     readonly add: (left: TypeValue, right: TypeValue) => TypeValue;
-    readonly sub: (left: TypeValue, right: TypeValue) => TypeValue;
-    readonly mul: (left: TypeValue, right: TypeValue) => TypeValue;
-    readonly div: (left: TypeValue, right: TypeValue) => TypeValue;
-    readonly mod: (left: TypeValue, right: TypeValue) => TypeValue;
     readonly strictEq: (left: TypeValue, right: TypeValue) => TypeValue;
     readonly strictNeq: (left: TypeValue, right: TypeValue) => TypeValue;
     readonly gt: (left: TypeValue, right: TypeValue) => TypeValue;
     readonly lt: (left: TypeValue, right: TypeValue) => TypeValue;
     readonly gte: (left: TypeValue, right: TypeValue) => TypeValue;
     readonly lte: (left: TypeValue, right: TypeValue) => TypeValue;
-    readonly typeof_: (operand: TypeValue) => TypeValue;
     readonly not: (operand: TypeValue) => TypeValue;
-    readonly neg: (operand: TypeValue) => TypeValue;
 };
 declare function applyBinaryOp(op: string, left: TypeValue, right: TypeValue): TypeValue;
 declare function dispatchBinaryOp(op: string, left: TypeValue, right: TypeValue): TypeValue;
 declare function dispatchMethod(receiver: TypeValue, name: string, args: TypeValue[]): TypeValue | undefined;
 declare function dispatchProperty(receiver: TypeValue, name: string): TypeValue | undefined;
 
+/**
+ * 模板字面量谓词，独立于 template.ts 以断开运行时循环引用：
+ * type-value.ts（联合吸收律）与 template.ts 都依赖本模块，而本模块对
+ * type-value.ts 只有 `import type` 边（编译后消失），运行时依赖保持单向
+ * type-value.ts / template.ts -> template-predicates.ts。
+ */
+declare function isTemplate(tv: TypeValue): boolean;
+
 declare function getKnownPrefix(parts: TypeValue[]): string;
 declare function getKnownSuffix(parts: TypeValue[]): string;
 declare function createTemplate(parts: TypeValue[]): TypeValue;
-declare function isTemplate(tv: TypeValue): boolean;
+
 declare function getTemplateParts(tv: TypeValue): TypeValue[] | undefined;
 declare function concatTemplates(left: TypeValue, right: TypeValue): TypeValue;
 
@@ -134,4 +169,912 @@ declare function createRange(meta: RangeMeta): TypeValue;
 declare function isRange(tv: TypeValue): boolean;
 declare function getRangeMeta(tv: TypeValue): RangeMeta | undefined;
 
-export { type Environment, type LiteralValue, Ops, type RangeMeta, type Refinement, T, type TypeValue, applyBinaryOp, concatTemplates, createEnvironment, createRange, createTemplate, deepCloneTypeValue, dispatchBinaryOp, dispatchMethod, dispatchProperty, getKnownPrefix, getKnownSuffix, getPrimitiveTypeOf, getRangeMeta, getRefinedBase, getTemplateParts, isRange, isSubtypeOf, isTemplate, mergeObjectProperties, narrowType, simplifyUnion, subtractType, typeValueEquals, typeValueToString, widenLiteral };
+/**
+ * Nudo Mock 帮助函数
+ *
+ * 提供类型安全的 mock 创建，替代 sinon 表达式
+ */
+
+type MockHelper = {
+    kind: "mock-helper";
+    returnValue?: TypeValue;
+    resolvedValue?: TypeValue;
+    rejectedValue?: TypeValue;
+    implementation?: (...args: TypeValue[]) => TypeValue;
+    onFirstCallValue?: TypeValue;
+    onSecondCallValue?: TypeValue;
+    withArgsCases?: {
+        args: TypeValue[];
+        returnValue: TypeValue;
+    }[];
+    callsFakeImpl?: TypeValue;
+};
+/**
+ * 创建一个 stub mock
+ * 用法: @nudo:mock fetch = stub()
+ */
+declare function stub(): MockHelper;
+declare namespace stub {
+    var returns: (value: TypeValue) => MockHelper;
+    var resolves: (value: TypeValue) => MockHelper;
+    var rejects: (value: TypeValue) => MockHelper;
+    var onFirstCall: (value: TypeValue) => MockHelper;
+    var onSecondCall: (value: TypeValue) => MockHelper;
+    var withArgs: (...args: TypeValue[]) => MockHelper;
+    var callsFake: (fn: TypeValue) => MockHelper;
+}
+/**
+ * 创建一个 spy mock
+ * 用法: @nudo:mock handler = spy()
+ */
+declare function spy(): MockHelper;
+declare namespace spy {
+    var returns: (value: TypeValue) => MockHelper;
+}
+/**
+ * 创建一个 mock
+ * 用法: @nudo:mock service = mock()
+ */
+declare function mock(): MockHelper;
+/**
+ * 将 MockHelper 转换为 TypeValue
+ */
+declare function mockHelperToTypeValue(helper: MockHelper, env: Environment): TypeValue;
+
+/**
+ * 原地剥除 AST 中的 TS-only 语法节点/字段，返回同一棵 AST（便于链式使用）。
+ * 不改写任何 loc/start/end；语句删除只影响所在数组，不重排兄弟节点。
+ */
+declare function stripTypes<T extends Node>(ast: T): T;
+
+declare function resetParseSourceCache(): void;
+declare function getParseSourceCacheSize(): number;
+declare function parseSource(source: string, opts?: {
+    errorRecovery?: boolean;
+}): File;
+
+/**
+ * 路径约束栈（Φ）。
+ *
+ * Φ 是当前控制流路径上的合取前提。代数运算（add/cmp/…）读取它做单调传播；
+ * evaluator 在 if 守卫处 push/pop。栈属于类型系统，不属于 host CLI。
+ */
+
+declare function currentPhi(): Phi;
+declare function pushPhi(p: Phi): void;
+declare function popPhi(): void;
+declare function resetPhi(): void;
+/** 在当前 Φ 上合取额外约束，body 结束后恢复 */
+declare function withPhiConstraint(extra: Phi, body: () => void): void;
+declare function describePhi(): string;
+
+/**
+ * Abs 上的一等函数：shape 是 fn，实现在旁路（不污染 Shape）。
+ * 与 term-registry 同一纪律：不给共享单例挂 impl。
+ */
+
+type AbsFnImpl = {
+    params: string[];
+    /** 可选：无 body 时走 relation（纯关系 fn） */
+    body?: Node;
+    async?: boolean;
+    /** 声明时捕获的环境（闭包） */
+    env?: AstEnv;
+    kind?: string;
+    /** 调用时直接派发（mock withArgs 等），优先于 body */
+    apply?: (args: Abs[]) => Abs;
+    /**
+     * Optional content key for cache fingerprints. formatAbs cannot see
+     * WeakMap-side mock semantics (returns/withArgs/callsFake), so hosts that
+     * build mocks should stamp a stable fingerprint here.
+     * relation-only 必填（未传时 relationFn 自动生成）。
+     */
+    fingerprint?: string;
+    /** 无 body 时，按 paramTypes 做 α 替换得到返回 */
+    relation?: {
+        paramTypes: Abs[];
+        returnType: Abs;
+    };
+};
+declare function attachFnImpl(a: Abs, impl: AbsFnImpl): void;
+declare function getFnImpl(a: Abs): AbsFnImpl | undefined;
+/** 造一个带实现的 Abs 函数值 */
+declare function absFunction(params: string[], impl: Omit<AbsFnImpl, "params">): Abs;
+/** relationFn 稳定 fingerprint（同签名共享，见 §3.3 已知限制） */
+declare function relationFingerprint(paramTypes: Abs[], returnType: Abs): string;
+/**
+ * 无 body、纯关系的 fn Abs。params 仅记 arity。
+ *
+ * **双写纪律：** 同一份关系数据必须同时写到——
+ *   1. `shape.paramTypes` / `shape.returnType`  —— format / leq / 展示读这里
+ *   2. `impl.relation`                         —— D 路径应用读这里
+ * 两槽共享同一数组/对象引用（防内容分叉）；构造后请勿原地 mutate。
+ *
+ * 默认 conf="path"（与提升产物一致）。禁止静默对齐 absFunction 的 "exact"。
+ * fingerprint 必填（call-budget）；未传时由 paramTypes+returnType 稳定序列化生成。
+ * 同签名 relationFn 共享 fingerprint → 共享 budget 键（见 design §3.3 已知限制）。
+ */
+declare function relationFn(paramTypes: Abs[], returnType: Abs, opts?: {
+    params?: string[];
+    conf?: Confidence;
+    fingerprint?: string;
+}): Abs;
+/** 仅写 shape 槽（E 路径 / §5.2 提升产物）；禁止 attachFnImpl */
+declare function shapeOnlyFn(paramTypes: Abs[], returnType: Abs, opts?: {
+    params?: string[];
+    conf?: Confidence;
+}): Abs;
+
+/**
+ * 算术核：单调性 + 常量折叠 + 约束传播。
+ * 这是「类型即计算」的主武器——x>0 时 x+1 必须得到 >1。
+ */
+
+/**
+ * 抽象加法：eval(a + b) —— 跟真实 JS，不无根据地假定 number。
+ * 1. 双方字面量 → 直接求值
+ * 2. 双方 number prim → term + 单调性 pred，shape=number
+ * 3. 含 string/template → 拼接
+ * 4. any / type-var 参与 → 按 JS + 的可能结果取并集：number | string
+ *    （bool/null 走 ToNumber→number；object 默认 ToPrimitive→string；
+ *      bigint/symbol 边角不在默认并集里，由调用点实例化再收窄）
+ *    无契约的 score(x){return x+1}：score("x") 合法，不得钉成 number。
+ */
+declare function add(a: Abs, b: Abs, phi?: Phi): Abs;
+type NumBounds = {
+    lo?: {
+        value: number;
+        strict: boolean;
+    };
+    hi?: {
+        value: number;
+        strict: boolean;
+    };
+};
+/**
+ * 提取 Abs 上相对 term 的数值界。
+ * 优先用自身 pred；否则查 Φ（针对 var id）。
+ */
+declare function numericBounds(a: Abs, phi?: Phi): NumBounds | undefined;
+/** 减法：a - b = a + (-b)，数值上做单调性 */
+declare function sub(a: Abs, b: Abs, phi?: Phi): Abs;
+/** 乘法：字面量直接求值；×正数同向缩放；×负数翻转不等式；×0 归零 */
+declare function mul(a: Abs, b: Abs, phi?: Phi): Abs;
+/**
+ * 除法：字面量折叠；除以正/负常数时按单调性推界。
+ * 除以 0：JS 语义为 ±Infinity / NaN，shape 仍 number（不报违例）。
+ */
+declare function div(a: Abs, b: Abs, phi?: Phi): Abs;
+/**
+ * 取模：字面量折叠；`x % k`（k>0 字面量）结果界在 (−|k|, |k|)。
+ * 整数模可收紧到 [0, k)，此处先做保守实数界。
+ */
+declare function mod(a: Abs, b: Abs, phi?: Phi): Abs;
+/** 比较：返回 boolean Abs；若双字面量则 exact */
+declare function cmp(op: "lt" | "le" | "gt" | "ge" | "eq" | "ne", a: Abs, b: Abs, phi?: Phi): Abs;
+/** 从比较结果 Abs 提取「若为真」的额外约束（供 if 使用） */
+declare function trueConstraint(c: Abs): Pred | undefined;
+declare function falseConstraint(c: Abs): Pred | undefined;
+
+/**
+ * 语言表面运算（仍在 Abs 上）：typeof / 一元- / ! / nullish 相等。
+ * 类型即计算——一元与控制流判定与二元算术同一运算域。
+ */
+
+/** JS typeof：结果域永远是 string */
+declare function typeofAbs(a: Abs): Abs;
+/** 一元负号：字面量折叠；符号数翻转不等式 */
+declare function negAbs(a: Abs, _phi?: Phi): Abs;
+/** 逻辑非 */
+declare function notAbs(a: Abs): Abs;
+/** 该 shape 在 JS 上一定不是 null/undefined */
+declare function definitelyNotNullishShape(s: Shape): boolean;
+declare function isNullishLitAbs(a: Abs): boolean;
+/**
+ * 严格相等（Abs）：双字面量折叠；nullish 与 definitely-not-nullish → false。
+ * 返回 undefined = 无法判定（交给 boolean + 调用方）。
+ */
+declare function strictEqAbs(a: Abs, b: Abs): boolean | undefined;
+
+/**
+ * Abs 侧常用 builtin：shape 级运算，不依赖 TypeValue host 库。
+ * 覆盖 Math / Object / JSON / Number / 全局转换函数的常见面。
+ */
+
+/** Math.* — 字面量可折叠的返回精确值，否则 number */
+declare function evalMathMethod(name: string, args: Abs[]): Abs | undefined;
+/** Object.keys/values/entries/assign */
+declare function evalObjectMethod(name: string, args: Abs[]): Abs | undefined;
+/** JSON.parse / stringify */
+declare function evalJsonMethod(name: string, args: Abs[]): Abs | undefined;
+/** Number.isInteger / isNaN / parseFloat 等 */
+declare function evalNumberStatic(name: string, args: Abs[]): Abs | undefined;
+/** 全局 parseInt / parseFloat / isNaN / Number / String / Boolean */
+declare function evalGlobalFn(name: string, args: Abs[]): Abs | undefined;
+/** Array.isArray / Array.from / Array.of */
+declare function evalArrayStatic(name: string, args: Abs[]): Abs | undefined;
+/** new Date() / Date.now / date.getTime */
+declare function evalDateCtor(args: Abs[]): Abs;
+declare function evalDateStatic(name: string, _args: Abs[]): Abs | undefined;
+declare function evalDateMethod(name: string, _recv: Abs, _args: Abs[]): Abs | undefined;
+/** new RegExp / regexp.test / exec */
+declare function evalRegExpCtor(_args: Abs[]): Abs;
+declare function evalRegExpMethod(name: string, _recv: Abs, _args: Abs[]): Abs | undefined;
+/** Promise：new Promise / Promise.resolve / reject / all */
+declare function evalPromiseCtor(_args: Abs[]): Abs;
+declare function evalPromiseStatic(name: string, args: Abs[]): Abs | undefined;
+/** 命名空间分派入口 */
+declare function evalNamespaceCall(ns: string, method: string, args: Abs[]): Abs | undefined;
+/** new X(...) */
+declare function evalBuiltinNew(className: string, args: Abs[]): Abs | undefined;
+/** brand 实例方法（Date/RegExp/Map/Set） */
+declare function evalBuiltinInstanceMethod(brandName: string, method: string, recv: Abs, args: Abs[]): Abs | undefined;
+
+/**
+ * Abs 方法表：模板字符串 / 结构值上的方法与属性。
+ * 类型即计算——方法结果仍是 Abs，可继续参与约束推理。
+ * 宿主 TypeValue 的 dispatchMethod 只服务 IR 兜底，不是真理源。
+ */
+
+/**
+ * 调用 Abs 方法。返回 undefined = 未接管（调用方走其它路径）。
+ */
+declare function callAbsMethod(recv: Abs, name: string, args: Abs[]): Abs | undefined;
+/** 属性读取：template/string.length 等 */
+declare function getAbsProperty(recv: Abs, name: string): Abs | undefined;
+
+/**
+ * 结构层：对象槽位、spread、函数重载并。
+ * 纪律：积之和默认；optional 塌缩是显式损失；函数并保输入→输出相关性。
+ */
+
+type Slot = {
+    value: Abs;
+    optional?: boolean;
+    readonly?: boolean;
+};
+type ObjShape = {
+    k: "obj";
+    slots: Record<string, Slot>;
+    index?: {
+        key: Abs;
+        value: Abs;
+    };
+    open?: boolean;
+};
+declare function objOf(slots: Record<string, Slot>, opts?: {
+    index?: {
+        key: Abs;
+        value: Abs;
+    };
+    open?: boolean;
+}): Abs;
+declare function isObj(a: Abs): a is Abs & {
+    shape: ObjShape;
+};
+/**
+ * spread：base ⊕ over（右侧覆盖，不是 join）
+ * 未出现在 over 的 key 保留 base；over 的 key 覆盖。
+ */
+declare function spread(base: Abs, over: Abs): Abs;
+/**
+ * 对象 join：默认积之和（sum），不自动折 optional。
+ * 同 key 集：槽位级 join（字面量并）；异 key 集：保持 sum。
+ */
+declare function joinObjects(a: Abs, b: Abs): Abs;
+/** 值级 join：字面量保留为… Phase A 对 prim 做 term 保留策略 */
+declare function joinValues(a: Abs, b: Abs): Abs;
+declare function makeSum(a: Abs, b: Abs): Abs;
+/**
+ * 显式损失：sum-of-products → optional 槽（仅 emit/阈值）。
+ * 强制 #widened。
+ */
+declare function collapseToOptional(sum: Abs): Abs;
+type FnAbs = Abs & {
+    shape: {
+        k: "fn";
+        params: string[];
+        name?: string;
+        /** 外延参数类型（若已知） */
+        paramTypes?: Abs[];
+        /** 外延返回类型 */
+        returnType?: Abs;
+    };
+};
+declare function fnOf(params: string[], name?: string): Abs;
+/**
+ * 函数 join：签名并（重载），禁止 (A|C)→(B|D)。
+ */
+declare function joinFunctions(a: Abs, b: Abs): Abs;
+/** 通用 join：分派到对象/函数/值 */
+declare function joinAbs(a: Abs, b: Abs): Abs;
+
+/**
+ * 结构可赋值：src ≤ tgt（Abs 上的 leq）。
+ *
+ * 规则与 TS 结构子类型同构，但作用在推断出的 Abs 上：
+ * - 对象宽度 + 深度；optional 可缺
+ * - brand 名义；fn 参数逆变、返回协变
+ * - pred：src 蕴含 tgt（更严的值可赋给更宽的目标）
+ *
+ * 不是完备 checker 的替代——是 Abs 之间的兼容判定。
+ */
+
+type LeqResult = {
+    ok: boolean;
+    /** Nudo 式原因（actual ⊭ target），不是 TS 文案 */
+    reason?: string;
+};
+/**
+ * src 可赋给 tgt。
+ * phi：路径前提（可选）；env：用于 brand 继承链。
+ */
+declare function leqAbs(src: Abs, tgt: Abs, opts?: {
+    phi?: Phi;
+    env?: AstEnv;
+}): LeqResult;
+
+/**
+ * 格式化：把 Abs 渲染成人类可读 / CLI 友好的字符串。
+ */
+
+type FormatOptions = {
+    /** 是否显示 term= */
+    showTerm?: boolean;
+    /** 是否显示 pred */
+    showPred?: boolean;
+    indent?: string;
+};
+declare function formatAbs(a: Abs, opts?: FormatOptions): string;
+/** fn/arr 槽位：shape + 非 lit term（禁止在 format 里内联复制 term 逻辑） */
+declare function formatShapeSlot(a: Abs): string;
+declare function formatShape(a: Abs): string;
+/** 多行展示，CLI 用 */
+declare function formatAbsMultiline(a: Abs, label?: string): string;
+
+/**
+ * 约束模板构建器（参数无关）。
+ *
+ *   number().gt(0)                    → 占位项 self 上的 Pred
+ *   number().int().ge(0)              → 整数 + 下界
+ *   string().min(1)                   → 非空串（长度）
+ *   array(number().gt(0))             → 元素约束
+ *   shape({ id: number().gt(0) })     → object 形状约束
+ *   instantiate("ms")                 → Pred ms > 0 / u.id > 0 ∧ …
+ *
+ * 在 *.nudo.js 里执行；不是 zod 绑定，是我们自己的运行时 API。
+ * 不需要 interface/type 语法——契约用 JS 表达式声明。
+ */
+
+/** 模板占位项；instantiate 时换成真实参数名 */
+declare const SELF = "__nudo_self__";
+/** 字段访问项：u.id */
+declare function getTerm(obj: Term, key: string): Term;
+/** 长度项：length(u) */
+declare function lenTerm(t: Term): Term;
+type NudoField = {
+    constraint: NudoConstraint;
+    optional?: boolean;
+};
+type NudoConstraint = {
+    readonly __nudoConstraint: true;
+    readonly prim?: PrimName;
+    readonly preds: Pred[];
+    /** object 形状：字段名 → 嵌套约束 */
+    readonly fields?: Record<string, NudoField>;
+    /** array 元素约束 */
+    readonly element?: NudoConstraint;
+    /** 整数（number 链式 .int()） */
+    readonly int?: boolean;
+    /** 该约束整体可选（shape 字段用；不用 optional 以免与链式方法撞名） */
+    readonly isOptional?: boolean;
+};
+declare function isNudoConstraint(x: unknown): x is NudoConstraint;
+/** 链式约束：不可变，每次 .gt() 返回新对象 */
+type ConstraintBuilder = NudoConstraint & {
+    gt(n: number): ConstraintBuilder;
+    ge(n: number): ConstraintBuilder;
+    lt(n: number): ConstraintBuilder;
+    le(n: number): ConstraintBuilder;
+    /** number：要求整数 */
+    int(): ConstraintBuilder;
+    /** string：长度下界 */
+    min(n: number): ConstraintBuilder;
+    /** string：长度上界 */
+    max(n: number): ConstraintBuilder;
+    /** string：精确长度 */
+    length(n: number): ConstraintBuilder;
+    /** 字段可选（仅在 shape 内有意义） */
+    optional(): ConstraintBuilder;
+};
+/** number() —— 约束 number 原语 + 后续链式界 */
+declare function number(): ConstraintBuilder;
+declare function string(): ConstraintBuilder;
+declare function boolean(): ConstraintBuilder;
+/** array(item) —— 数组，元素满足 item */
+declare function array(item: NudoConstraint | ConstraintBuilder): ConstraintBuilder;
+/**
+ * object 形状约束（契约规范形状，无需 interface）：
+ *
+ *   shape({ id: number().gt(0), name: string() })
+ */
+declare function shape(fields: Record<string, NudoConstraint | ConstraintBuilder>): ConstraintBuilder;
+/** 把模板绑定到参数名：self → paramName；shape 展开为字段访问 Pred */
+declare function instantiateConstraint(c: NudoConstraint, paramName: string): Pred;
+/**
+ * 契约 → 函数入口 param Abs（infer/hover 用）。
+ * 标量：prim + pred；shape：obj slots 递归。
+ */
+declare function constraintToEntryAbs(c: NudoConstraint, paramName: string): Abs;
+
+/**
+ * 精化契约解析：唯一形态
+ *
+ *   @nudo:refine <param> <constraint>    参数精化（挂入口 Abs，参与运算）
+ *   @nudo:refine return <constraint>     返回精化（推断返回值 ⊭ 时红）
+ *
+ * 不叫 requires：那只是「校验挡板」。
+ * refine 表示约束是类型的一部分——Abs = shape × term × **pred** × conf，
+ * pred 会流入代数（x>0 ⇒ x+1>1），不只是调用点挡一下。
+ *
+ * constraint 来自 *.nudo.js 导出的模板（number().gt(0) 等），
+ * 由 /// @nudo:import { delay } from "./delay.nudo.js" 引入。
+ * 不支持写 `x > 0`（绑死参数名）。
+ * 不用 JSDoc @param/@return：那是类型注解语法。
+ */
+
+/** `/// @nudo:import { delay, percent } from "./delay.nudo.js"` */
+type NamedImport = {
+    names: string[];
+    spec: string;
+};
+declare function extractNudoImports(source: string): NamedImport[];
+/**
+ * 执行 *.nudo.js（真实 JS + 我们的构建器）。
+ * 把 export const 改写成 const，末尾 return { names }。
+ */
+declare function execNudoModule(src: string): Record<string, unknown>;
+type RefineResolveOpts = {
+    loadModule?: (spec: string, fromFile: string) => string | undefined;
+    fromFile?: string;
+};
+declare function resetNudoModuleExecCache(): void;
+/**
+ * 解析 `ms delay` / `n percent` → [param, Pred]
+ * 多条用 && 或换行连接。
+ * 同时保留原始 NudoConstraint（shape 字段检查用）。
+ */
+type RefineEntry = {
+    param: string;
+    pred: Pred;
+    constraint: NudoConstraint;
+};
+declare function extractRefinesFromSource(source: string, fnName: string, opts?: RefineResolveOpts): RefineEntry[];
+/** refine 参数 → 带约束模板的下标表（shape 检查用） */
+declare function refineToIndexedFull(source: string, fnName: string, paramNames: string[], opts?: RefineResolveOpts): Array<[number, RefineEntry]>;
+/**
+ * 解析 `@nudo:refine return positive` → 返回精化。
+ * 返回 undefined = 无声明（不猜后置）。
+ */
+declare function extractRefineReturnFromSource(source: string, fnName: string, opts?: RefineResolveOpts): {
+    name: string;
+    constraint: NudoConstraint;
+} | undefined;
+
+type LoadDepsFingerprint = {
+    fp: string;
+    paths: string[];
+    /** BFS 撞到节点上限：剩余 dep 未进指纹，键不可信 */
+    truncated: boolean;
+};
+declare function normPath(p: string): string;
+/** core 不引 path：相对 spec 纯字符串拼接（与 LSP resolve 对齐时双方 norm） */
+declare function resolveDepPath(fromFile: string, spec: string): string;
+/**
+ * All string module specs that analysis may resolve through loadModule.
+ * Regex over-approximates (may hit comments) — extra dep fingerprint is safe
+ * (more misses, never a stale hit).
+ */
+declare function extractAllLoadSpecs(source: string): string[];
+/**
+ * Fingerprint every loadModule-reachable dep (not only `*.nudo.js`), including
+ * one hop of transitive specs from each dep source.
+ */
+declare function loadModuleDepsFingerprint(source: string, loadModule: (spec: string, fromFile: string) => string | undefined, fromFile: string): LoadDepsFingerprint;
+
+declare function resetGeneralizeMemo(): void;
+declare function getGeneralizeMemoSize(): number;
+/**
+ * LSP/宿主：`*.nudo.js` 变更后按路径定向逐出依赖它的 L0 条目。
+ * 返回删除的条目数。路径需与 generalize 时 resolveDepPath 形态一致（建议先 norm）。
+ */
+declare function evictGeneralizeMemoForPaths(paths: string[]): number;
+type TypeParam = {
+    id: string;
+    value: Abs;
+};
+type PolyFn = {
+    name: string;
+    params: string[];
+    typeParams: TypeParam[];
+    instantiate: (args: Abs[], phi?: Phi) => Abs;
+    symbolic: Abs;
+    display: string;
+    /** 入口契约（@nudo:refine），供签名/inlay 展示 */
+    entryReqs?: Array<{
+        param: string;
+        pred: Pred;
+    }>;
+    /**
+     * 函数形参的符号外延（与 typeParams 同 α 空间）。
+     * symbolic 一次跑正常结束时从 env 快照拷出；instantiate 重跑不写。
+     */
+    fnRels?: Map<string, {
+        abs: Abs;
+        source: RelSource;
+    }>;
+    /**
+     * 值形参（非函数）的提升快照，如 `items → arr(A1)`。
+     */
+    entryShapes?: Map<string, {
+        abs: Abs;
+        source: RelSource;
+    }>;
+    /** body 内对该形参的应用点（check/hover/dts 用） */
+    hofSites?: HofSite[];
+};
+declare function extractFn(source: string, fnName: string, fileAst?: ReturnType<typeof parseSource>): {
+    params: string[];
+    body: Node;
+    env: AstEnv;
+} | undefined;
+declare function generalizeFromAst(fnName: string, source: string, opts?: {
+    budget?: LeakBudget;
+    label?: string;
+    /** 传入则把 @nudo:refine 挂到入口 param Abs */
+    refine?: RefineResolveOpts;
+    /** 预解析 AST，避免 check 批量场景重复 parse */
+    file?: ReturnType<typeof parseSource>;
+    /** 预计算 load-deps 指纹（checkSource 整文件一次，避免 per-fn 重读） */
+    depsFp?: LoadDepsFingerprint;
+}): PolyFn | undefined;
+declare function generalizeAll(source: string, opts?: {
+    budget?: LeakBudget;
+}): PolyFn[];
+/** 列出源码中的顶层函数名 */
+declare function listFunctionNames(source: string): string[];
+/**
+ * 按 assume 集合构造实参：被 assume 的参数给带约束的符号，其余 unknown。
+ */
+declare function buildArgsFromAssume(source: string, fnName: string, assumeIds: Set<string>): Abs[];
+
+/**
+ * 约束诊断：检查调用点实参是否满足函数的前置约束 / 参数 shape。
+ * 输出可行动的建议，而不是 TS 式「类型不匹配」。
+ */
+
+type Diagnostic = {
+    severity: "error" | "warning" | "info";
+    code: string;
+    message: string;
+    suggestion?: string;
+    fn?: string;
+    argIndex?: number;
+};
+/**
+ * 检查实参是否满足「期望约束」。
+ * expect: 相对参数 term 的 pred，例如 term > 0
+ * arg: 实际实参 Abs
+ */
+declare function checkArg(arg: Abs, expect: Pred | undefined, phi?: Phi): Diagnostic | undefined;
+/**
+ * 对一次函数调用做诊断：实参 shape + 约束。
+ */
+declare function checkCall(source: string, fnName: string, args: Abs[], phi?: Phi): Diagnostic[];
+declare function formatDiagnostics(diags: Diagnostic[]): string;
+
+/**
+ * Template string 拼接（代数侧）。
+ * 表示：prim(string) + refinement.meta.templateParts = Abs[]
+ * 与 core 的 createTemplate 对齐，使 `"x" + string + "!"` 得到 template refined。
+ */
+
+type TemplateMeta = {
+    templateParts: Abs[];
+};
+/** 从 Abs 提取 template parts（已是 template 则展开，否则 [self]） */
+declare function templatePartsOf(a: Abs): Abs[];
+/**
+ * 构造 template Abs。
+ * - 全字面量 → exact lit
+ * - 单 string prim → prim
+ * - 否则 prim(string) + pred(name=template, meta.templateParts)
+ */
+declare function createTemplateAbs(parts: Abs[]): Abs;
+declare function isTemplateLike(a: Abs): boolean;
+/** 字符串拼接：字面量折叠 + template parts 合并 */
+declare function concatString(a: Abs, b: Abs): Abs;
+
+/**
+ * 语言覆盖：class / new / instanceof / this / async await。
+ * brand 表示名义类；eff("promise") 表示异步效应。
+ *
+ * 方法体：ClassDef.methods 存 AST body，调用时在 this=receiver 下求值。
+ */
+
+type MethodDef = {
+    name: string;
+    params: string[];
+    body: Node;
+    kind?: string;
+    async?: boolean;
+};
+type ClassDef = {
+    name: string;
+    instanceShape: Abs;
+    ctorParams: string[];
+    methods: Map<string, MethodDef>;
+    superClass?: string;
+};
+declare function defineClass(env: AstEnv, def: ClassDef): void;
+declare function getClass(env: AstEnv, name: string): ClassDef | undefined;
+/** 沿继承链找类 */
+declare function getClassChain(env: AstEnv, name: string): ClassDef[];
+/** new C(...) → brand 实例；并跑 constructor 以写入字段 */
+declare function instantiateClass(env: AstEnv, className: string, args: Abs[], evalBody?: (fn: {
+    params: string[];
+    body: Node;
+}, args: Abs[], thisVal: Abs, env: AstEnv) => Abs): Abs;
+/** 读取当前 this 所属类的父类名 */
+declare function superNameOf(env: AstEnv, className: string): string | undefined;
+/**
+ * instanceof：沿继承链匹配 brand 名。
+ */
+declare function instanceOf(left: Abs, rightClassName: string, env?: AstEnv): Abs;
+declare function projectBrand(self: Abs, key: string): Abs;
+/** 在 brand 上查找方法定义（含继承） */
+declare function lookupMethod(env: AstEnv, receiver: Abs, methodName: string): MethodDef | undefined;
+/** 沿继承链查找方法，返回定义与所在类名 */
+declare function lookupMethodWithOwner(env: AstEnv, receiver: Abs, methodName: string): {
+    def: MethodDef;
+    owner: string;
+} | undefined;
+/** super.method()：从父类开始找（跳过当前类） */
+declare function lookupSuperMethod(env: AstEnv, receiver: Abs, fromClass: string, methodName: string): {
+    def: MethodDef;
+    owner: string;
+} | undefined;
+declare function wrapPromise(inner: Abs): Abs;
+declare function awaitAbs(v: Abs): Abs;
+declare function coerceAsyncReturn(value: Abs): Abs;
+/** 从 ClassMethod 列表构造 methods map + instance shape */
+declare function classFromMethods(name: string, methods: MethodDef[], superClass?: string, superShape?: Abs): ClassDef;
+
+declare function hashSource(s: string): string;
+declare function resetHashSourceCache(): void;
+
+/**
+ * Analysis-stable source key: strip trailing noise that cannot affect types.
+ * Keeps every line that may carry @nudo directives.
+ *
+ * Fast path: already-stable sources return the same string identity (O(1)
+ * compare in B-path / analysis caches when the caller reuses the buffer).
+ */
+declare function stableAnalyzeKeySource(source: string): string;
+
+/**
+ * per-function fingerprint: after-edit only dirty fn + callers miss L0.
+ *
+ * - own: function declaration slice (incl. leading comments / refine)
+ * - deps: transitively referenced sibling own hashes + non-fn top-level context
+ * - context change (import/class/const...) -> all miss (conservative)
+ *
+ * Multi-declarator `const a = fn, b = fn` yields one fingerprint per function;
+ * each own-slice is its own declarator (first also carries statement leading comments).
+ */
+
+type FnFp = {
+    own: string;
+    deps: string;
+    nRefs: number;
+};
+declare function resetFnFpCache(): void;
+type FnDeclInfo = {
+    name: string;
+    body: Node;
+    /** Function/arrow node (own-slice end; also scanned for sibling refs incl. defaults). */
+    fnNode: Node;
+    /** Declarator start when from a VariableDeclaration; else undefined. */
+    declaratorStart?: number;
+    /** First leading-comment start on this declarator (multi-decl refine/@nudo). */
+    declaratorLeadStart?: number;
+};
+/** Every top-level function binding in a declaration node (not just the first). */
+declare function getFnNameAndBodies(decl: Node): FnDeclInfo[];
+/** source -> (fnName -> own/deps); LRU */
+declare function fnFingerprints(source: string, file: File): Map<string, FnFp>;
+/** L0 source part: per-fn fingerprint when AST available; else full-file hash */
+declare function generalizeSourceKeyPart(source: string, fnName: string, file?: File): string;
+/**
+ * 无 refine、无模块语法、无兄弟调用、无任何调用表达式 → scanLiteralCalls 可整段跳过。
+ * 必须保守：`const x = f(-1)` / `if (f(-1))` / `require("x")` 都含 CallExpression，
+ * 只认顶层 ExpressionStatement 会漏报约束违规。
+ */
+declare function canSkipLiteralCallScan(source: string, file: File): boolean;
+
+/**
+ * check 报告面：数据模型 + 渲染/序列化。
+ *
+ * 分析在 check.ts（Abs 优先的 Nudo 原生诊断），这里只投影：
+ * - formatCheckReport → 人类可读文本
+ * - serializeCheckJson → `nudo check --json` 稳定契约（CI / Agent，v1）
+ */
+
+/** 无损函数签名（类型即计算） */
+type NudoSig = {
+    name: string;
+    params: string[];
+    /** 符号 Abs 本体 */
+    abs: Abs;
+    /** formatAbs 单行 */
+    display: string;
+    /** formatAbsMultiline */
+    detail: string;
+    conf: Confidence;
+};
+type CheckIssue = Diagnostic & {
+    fn?: string;
+    line?: number;
+    column?: number;
+    /** 实参 / 实际值的 Abs 展示 */
+    actual?: string;
+    /** 期望约束（Pred 或 Abs 展示） */
+    expected?: string;
+};
+type CheckReport = {
+    file: string;
+    issues: CheckIssue[];
+    /** 有 error 则 CI 应失败 */
+    ok: boolean;
+    /** Abs 优先的签名表（替代 TS 式 display-only） */
+    signatures: NudoSig[];
+    summary: {
+        errors: number;
+        warnings: number;
+        infos: number;
+        functions: number;
+    };
+};
+/**
+ * `nudo check --json` 稳定契约（供 CI / Agent）。
+ * 字段只增不改语义；Abs 以 formatAbs 字符串给出，不序列化内部 shape 图。
+ */
+type CheckJson = {
+    version: 1;
+    file: string;
+    ok: boolean;
+    summary: CheckReport["summary"];
+    signatures: Array<{
+        name: string;
+        params: string[];
+        display: string;
+        detail: string;
+        conf: string;
+        abs: string;
+    }>;
+    issues: Array<{
+        severity: string;
+        code: string;
+        message: string;
+        fn?: string;
+        line?: number;
+        column?: number;
+        actual?: string;
+        expected?: string;
+        suggestion?: string;
+    }>;
+};
+declare function serializeCheckJson(r: CheckReport): CheckJson;
+/**
+ * Nudo 原生报告：Abs 签名表 + actual ⊭ expected。
+ * 不是 tsc 输出的换皮。
+ */
+declare function formatCheckReport(r: CheckReport, opts?: {
+    verbose?: boolean;
+}): string;
+
+/**
+ * nudo check 门禁：对源码跑代数分析，产出 error/warning。
+ *
+ * 报告是 **Nudo 原生格式**（Abs 优先），不是 TS 诊断的换皮：
+ * - 签名表给出无损 Abs（shape/term/pred/conf）
+ * - 违例写清 actual ⊭ expected（实参 Abs vs 前置 Pred）
+ * - dts/TS 兼容不是本报告的职责
+ */
+
+declare function resetCheckSourceMemo(): void;
+declare function getCheckSourceMemoSize(): number;
+/** `*.nudo.js` 变更后定向逐出依赖它的整文件 check 缓存 */
+declare function evictCheckSourceMemoForPaths(paths: string[]): number;
+/**
+ * check 选项：core 不碰 fs；host 用 loadModule 喂 require 目标源码。
+ */
+type CheckOptions = {
+    /** 相对/绝对 require 说明符 → 模块源码；undefined = 解析失败 */
+    loadModule?: (spec: string, fromFile: string) => string | undefined;
+    /** 当前文件路径（供 loadModule 解析相对 spec） */
+    fromFile?: string;
+};
+/**
+ * 检查一个文件：
+ * - 每个顶层函数 generalize；无法得到任何签名 → warning
+ * - 若 source 中有字面量调用 `f(负数)` 且 f 有 `>0` 约束 → error
+ * - entry 结果 partial/opaque → info
+ *
+ * 默认 Φ（pTrue）走整文件 memo：同 source + deps + loadModule 身份 → O(1)。
+ */
+declare function checkSource(filePath: string, source: string, phi?: Phi, opts?: CheckOptions): CheckReport;
+
+/**
+ * Abs inlay hint：把无损约束内联到源码位置。
+ * 不是 TS 风格 type annotation 复读，而是 term/pred/conf 的计算结果。
+ */
+type AbsInlay = {
+    /** 1-based 行号 */
+    line: number;
+    /** 0-based 列（label 插入点） */
+    character: number;
+    label: string;
+    kind: "type" | "parameter";
+};
+/**
+ * 收集源码中函数签名的 Abs inlay：
+ * - 参数后：前置约束（声明 refine 优先；否则从 if 推）
+ * - `)` 后：返回 shape + term（类型即计算）
+ */
+declare function collectAbsInlays(source: string, refineOpts?: {
+    loadModule?: (spec: string, fromFile: string) => string | undefined;
+    fromFile?: string;
+}): AbsInlay[];
+
+/**
+ * 指称：Abs → 运行时谓词（设计 §2.7）。
+ * - 无 pred：按 shape 检查（typeof / 结构）
+ * - 有 pred：在 `term ↦ v` 下检查可判定的数值比较
+ * - sum：任一成员
+ */
+
+/** Abs 上的运行时守卫表达式（JS boolean 布尔串） */
+declare function denoteGuard(a: Abs, v: string): string;
+
+/**
+ * Abs ⇄ TypeValue 桥。
+ *
+ * 纪律：
+ * - absToTypeValue 有损：丢 term/pred 时 conf 降为 widened，禁止假装 exact
+ * - typeValueToAbs 尽量恢复 term=lit
+ * - 下游（dts/lsp/service）吃 TypeValue；代数运算吃 Abs
+ */
+
+declare function setTvConfidence(tv: TypeValue, conf: Confidence): void;
+declare function getTvConfidence(tv: TypeValue): Confidence | undefined;
+/**
+ * Abs → TypeValue（给下游）。
+ * 有损：非 lit term 丢弃；pred 尽量 encode 成 refined，否则丢。
+ */
+declare function absToTypeValue(a: Abs): TypeValue;
+/**
+ * TypeValue → Abs（给代数运算）。
+ * 置信度：优先读 abs→tv 时挂上的 conf 旁路，避免 #widened 回升 #exact。
+ */
+declare function typeValueToAbs(tv: TypeValue): Abs;
+/**
+ * 有损检查：Abs 转 TypeValue 后是否丢了 term/pred。
+ * 用于金标与调试。
+ */
+declare function bridgeIsLossy(a: Abs): {
+    lossy: boolean;
+    reasons: string[];
+};
+
+export { Abs, type AbsFnImpl, type AbsInlay, AstEnv, type CheckIssue, type CheckJson, type CheckOptions, type CheckReport, type ClassDef, Confidence, type ConstraintBuilder, type Diagnostic, type Environment, type FnAbs, type FnFp, type FormatOptions, type FunctionSignature, HofSite, LeakBudget, type LeqResult, type LiteralValue, type LoadDepsFingerprint, type MethodDef, type MockHelper, type NamedImport, type NudoConstraint, type NudoField, type NudoSig, type ObjShape, Ops, Phi, type PolyFn, Pred, PrimName, type RangeMeta, type RefineEntry, type RefineResolveOpts, type Refinement, RelSource, SELF, Shape, type SigImpl, type Slot, T, type TemplateMeta, Term, type TypeParam, type TypeValue, absFunction, absToTypeValue, add, applyBinaryOp, array, attachFnImpl, awaitAbs, boolean, bridgeIsLossy, buildArgsFromAssume, callAbsMethod, canSkipLiteralCallScan, checkArg, checkCall, checkSource, classFromMethods, cmp, coerceAsyncReturn, collapseLiteralUnion, collapseToOptional, collectAbsInlays, concatString, concatTemplates, constraintToEntryAbs, createEnvironment, createRange, createTemplate, createTemplateAbs, currentPhi, deepCloneTypeValue, defineClass, definitelyNotNullishShape, denoteGuard, describePhi, dispatchBinaryOp, dispatchMethod, dispatchProperty, div, evalArrayStatic, evalBuiltinInstanceMethod, evalBuiltinNew, evalDateCtor, evalDateMethod, evalDateStatic, evalGlobalFn, evalJsonMethod, evalMathMethod, evalNamespaceCall, evalNumberStatic, evalObjectMethod, evalPromiseCtor, evalPromiseStatic, evalRegExpCtor, evalRegExpMethod, evictCheckSourceMemoForPaths, evictGeneralizeMemoForPaths, execNudoModule, extractAllLoadSpecs, extractFn, extractNudoImports, extractRefineReturnFromSource, extractRefinesFromSource, falseConstraint, fnFingerprints, fnOf, formatAbs, formatAbsMultiline, formatCheckReport, formatDiagnostics, formatShape, formatShapeSlot, generalizeAll, generalizeFromAst, generalizeSourceKeyPart, getAbsProperty, getCheckSourceMemoSize, getClass, getClassChain, getFnImpl, getFnNameAndBodies, getFnSig, getGeneralizeMemoSize, getKnownPrefix, getKnownSuffix, getParseSourceCacheSize, getPrimitiveTypeOf, getRangeMeta, getRefinedBase, getTemplateParts, getTerm, getTvConfidence, hashSource, instanceOf, instantiateClass, instantiateConstraint, isFnSig, isNudoConstraint, isNullishLitAbs, isObj, isRange, isSubtypeOf, isTemplate, isTemplateLike, joinAbs, joinFunctions, joinObjects, joinValues, lenTerm, leqAbs, listFunctionNames, loadModuleDepsFingerprint, lookupMethod, lookupMethodWithOwner, lookupSuperMethod, makeSum, mergeObjectProperties, mock, mockHelperToTypeValue, mod, mul, narrowType, negAbs, normPath, notAbs, number, numericBounds, objOf, parseSource, popPhi, projectBrand, pushPhi, refineToIndexedFull, relationFingerprint, relationFn, resetCheckSourceMemo, resetFnFpCache, resetGeneralizeMemo, resetHashSourceCache, resetNudoModuleExecCache, resetParseSourceCache, resetPhi, resolveDepPath, serializeCheckJson, setTvConfidence, shape, shapeOnlyFn, simplifyUnion, spread, spy, stableAnalyzeKeySource, strictEqAbs, string, stripTypes, stub, sub, subtractType, superNameOf, templatePartsOf, trueConstraint, typeValueEquals, typeValueToAbs, typeValueToString, typeofAbs, widenLiteral, withPhiConstraint, wrapPromise };