用途:ts-core 介绍如何用受限 TypeScript 子集编写 Native SDK 应用的应用核(逻辑层)。应用核以 src/core.ts 为入口,包含 Model(应用状态)、Msg(可发生事件的判别联合)、update(model, msg) 唯一纯同步转移函数,以及它们调用的纯辅助函数;导入图在构建期由 @native-sdk/core 转译器编译为 Zig,程序通过子集检查后编译为原生,否则给出带规则、修复与原因的提示错误。
主要能力:整应用为三份真值文件、零 Zig——src/core.ts、src/app.native(标记视图)、app.zon(窗口、身份、权限)。构建自动检测 src/core.ts,若同时存在 src/main.zig 则报错。常用命令:native dev --core 以 node 虚拟宿主运行核心并观察模型与效果记录;native dev 构建运行真实应用;native check 校验子集与标记;native build 产出 ReleaseFast 二进制;native test 运行测试。
使用方式:导出 Model 接口(只读字段)、至少两个分支的 Msg、initialModel、update。update 可返回 Model 或 [Model, Cmd<Msg>] 以触发效果;启动效果由 initialModel 返回同形式,周期定时器导出 subscriptions(model): Sub<Msg>。接受单一 Model 参数的导出辅助函数会同时成为标记可绑定的派生值。
适用场景:需要确定性、无分配、可重放的原生应用逻辑,例如音板示例所示目录表、音频播放、定时播放时钟、文本编辑、滚动、资产、自适应网格、剪贴板与上下文菜单。
限制:子集排除 npm 包、Node/DOM API、正则、JSON、Promise、生成器等生态能力,以及破坏纯度与确定性的写法(共享数据变更、模块级 let、环境时间/随机/IO 等);对象形状、文本表示、函数与泛型也有专门规则,越界会以教学错误提示。帧与堆容量默认各 1 MiB,构建期固定,运行时不会增长。