← 都来码← 文档索引TypeScript原文English

TypeScript

类型注解会先擦掉、再交给 JavaScript 后端 —— 写法是 JavaScript 子集 + 类型外壳。

在手机上怎么跑

vml run examples/typescript/school/binary_search.ts

编译要等一会儿(C 那种要一两分钟,脚本类语言几秒)。程序跑起来后屏幕底部就是手柄,方向键 + 四个动作键都在;点右上角返回可以回到命令行。

写法要点

示例

文件演示什么

同目录还有:school/NOTICE.md、school/README.md、school/binary_search.ts、school/bubble_sort.ts、school/class_demo.ts、school/fibonacci.ts、school/fizzbuzz.ts、school/hanoi.ts、school/palindrome.ts、school/types_demo.ts


下面的内容是从 VML 源码里直接带的(third_party/vml/VMLPrepares/TypeScriptCompiler/): README 讲这个前端支持什么、怎么编;语言规范 讲语法本身。上游一改,这里重新生成就是最新的。

语言规范

TypeScript 语言支持规范(VML 前端)

版本:v1.66.470 起前端:VMLPrepares/TypeScriptCompiler/ 后端:VMLPrepares/JavaScriptCompiler/(类型擦除后复用)

1. 架构

.ts 源码
   │  TypeScriptCleaner(逐 token 擦除类型层,等长替换、保留换行)
   ▼
JS 子集源码 + TypeHints(形参类型 / 返回类型 / interface 布局)
   │  JavaScriptCompiler(带类型提示)
   ▼
VML 汇编
1.1 类型提示
提示用途
TypeHintParams形参声明类型;string ⇒ 字符串拼接与打印;number ⇒ 整数模型
TypeHintReturns返回值类型;string ⇒ 调用点按字符串打印
TypeHintShapesinterface 属性顺序与类型;对象字面量布局与 obj.prop 偏移
TypeHintFields类实例字段类型(注解/参数属性);p.name / this.name 的打印与拼接

number 不映射为 F32:JS 后端的整数字面量生成 MOVE @R0 #25,按浮点打印会得到 0。小数仍由字面量自身的 F32 推断负责。

1.2 行号保持

擦除是"等长空白替换",只替换 token 文本、不删换行。因此链接/解析错误报出的 <input>:行号 与 .ts 源文件一致。

2. 语法覆盖

2.1 类型层(全部擦除)
2.2 有运行时语义的翻译
2.3 复用 JavaScript 运行语义

函数、控制流、数组、对象字面量、类(构造函数 + 方法 + 继承)、模板字符串、 for...of、字符串方法、console.log / print、共享标准库 —— 全部由 JavaScript 后端提供。TypeScript 特有的 interface 只影响编译期布局,不产生运行时对象。

3. 明确不支持(编译期报错)

构造报错文本要点
a?.b `?.` 暂不支持
a ?? b / a ??= b?? 暂不支持(null 与 0 不可区分)
namespace / module命名空间暂不支持
@Decorator装饰器暂不支持
const C = class { … }类表达式暂不支持
static x = …(非字面量)静态字段初始化暂不支持
get/set 访问器访问器暂不支持
async/awaitMCU 模式跳过 async/await
yield / function*生成器不在 MCU 子集内
with (o) { … }with 暂不支持
基类方法内调用抽象/被覆写方法需要运行时虚分派,暂不支持
#x in obj仅支持成员声明与 this.#x 访问

依据项目原则:宁可在编译期响亮失败,也不产出静默错值。

4. 与 JavaScript 前端的差异

4.5 标准库

Lib/typescript/ 与 JavaScript 标准库同源(71 个模块包装器)。此外 JavaScriptCompiler/JsStdlibApi.cs 提供 27 个语言惯用名到已有包装器/共享库标签的映射,按 native(__stdcall)约定调用,且不覆盖用户同名函数:

类别惯用名
时间/随机sleepMs delayMs millis timestamp randomInt setSeed nowDate nowTime
运行环境configValue keyPressed setRTC speakerBeep
EEPROMeepromRead eepromWrite
文件fileOpen fileClose fileRead fileWrite fileSeek fileTell fileSize fileTruncate
文件系统fs_mkdir fs_remove fs_rename fs_readdir fs_stat

C 标准库族(abort/fprintf/fgetc/clock/gmtime/cstd_file_* …)经 SharedExactSymbolMap 自动链接 Lib/shared/cstdlib.vml。

5. 测试

编译器 README

TypeScript 编译器

路径: VMLPrepares/TypeScriptCompiler/ 后端: 类型擦除后复用 JavaScript 后端(JavaScriptCompiler) 标准库: Lib/typescript/(与 Lib/javascript/ 一一对应,由 GenLib 生成)

实现方式

TypeScript 的类型层(interface / type 别名 / 泛型 / 类型注解 / as / !)由 TypeScriptCleaner 按字符位置擦除 —— 替换成等长空白、换行原样保留,因此编译错误里的行号与用户源码一致。擦除后的代码交给 JavaScript 前端编译。

注解不是完全丢弃:string / number 等形参与返回类型会作为类型提示传给 JS 后端(TypeHintParams / TypeHintReturns / TypeHintShapes)。没有这层提示,function greet(name: string): string { return name + punct; } 里的 + 会被当成整数相加(输出指针和)、返回值按整数打印(输出 65570)。

interface 的属性顺序与类型也会传给 JS 后端(TypeHintShapes),对象字面量因此按静态布局 [count, v0, v1, …] 分配,p.x 按偏移读取。

支持的特性

特性处理
let/const x: T 注解擦除类型,保留初始化表达式
interface / type 别名整体擦除;interface 属性布局作为运行时提示
enum(数字/字符串/自动递增/引用前一成员)改写为 var E = { A: 0, … };
泛型函数/类声明与调用(pick<T> / pick<number>(…))声明处擦除 <T>,调用处擦除 <…>
as T / satisfies T擦除
x! 非空断言擦除
可选形参 b? / 可选属性 x?擦除 ?
class 成员修饰符 public/private/protected/readonly/override/abstract/declare擦除
class 实例字段初始化 x: number = 5;注入到构造函数开头(无构造函数则创建)
import / export 各种形式整条擦除
declare 声明整条擦除
catch (e: T)擦除注解
constructor 参数读取参数顺序/类型提示(v1.66.470)
构造函数参数属性 constructor(public x: T)擦修饰符 + 注入 this.x = x;(v1.66.471)
#private 字段/方法按类作用域改名为 __priv_<类>_<名>(v1.66.471)
类字段类型注解TypeHintFields:p.name 按字符串打印/拼接(v1.66.471)
模板字符串 `hi ${x}` 插值转换成字符串后拼接
for (const x of arr)数组遍历;字符串按 strlen 逐字符;支持 break/continue
for (const k in obj)静态布局对象编译期展开;o[k] 读已知槽位
解构(数组/对象、{ k: v })复用 JS 后端(v1.66.470 修复)
类继承 extends / super() / super.m()复用 JS 后端;隐式构造函数按父类形参转发
label: / break label / continue labelv1.66.471
debugger按空语句(MCU 无调试器)
尾随逗号 [a, b,] / f(x,) / {a:1,}v1.66.472 支持的清单语法
全部运算符含 «bold»、>>>、`= <<= >>= >>>= &== ^=、void、delete、in、instanceof`

标准库

Lib/typescript/ 与 JS 标准库同源,另加 27 个语言惯用名别名(sleepMs / millis / randomInt / nowDate / keyPressed / fileOpen… / fs_* …),由 JavaScriptCompiler/JsStdlibApi.cs 映射到已有包装器标签。 81 个面向用户函数与 1383 个 native 绑定均有穷举链接探针。

明确不支持(响亮报错,不静默降级)

使用

dotnet run --project VMLTool -- input.ts -o output.vml
dotnet run --project VMLEmulators/ConsoleEmulator -- -r output.vml

VMLTool 会自动把 .ts 映射到 typescript 语言目录;也可显式 -x typescript。保存中间 JS 便于排查:VML_TS_DUMP=/tmp/x.js。

测试