@galcraft/dsl

中文文档
0.1.0发布于 2026/11/01MPL-2.0TypeScriptES Module

@galcraft/dsl/parser 公开 parse 及其 CST 类型,供需要读取 GalCraft 语句的作者插件使用。插件使用公开包出口,构建时将解析依赖打入自己的产物;宿主继续负责作品读写、编译与语义服务。解析结果不能代替 M02 事务校验或正式编译结论。

中文使用文档

GalCraft DSL 配套 SDK

@galcraft/dsl/parser 公开 parse 及其 CST 类型,供需要读取 GalCraft 语句的作者插件使用。插件使用公开包出口,构建时将解析依赖打入自己的产物;宿主继续负责作品读写、编译与语义服务。解析结果不能代替 M02 事务校验或正式编译结论。

需要解析能力的独立插件执行 npm install @galcraft/[email protected] @galcraft/[email protected] @galcraft/[email protected],或安装 SDK 分发中的对应 tarball,并从 @galcraft/dsl/parser 导入 parse。构建器将解析依赖纳入插件产物;普通插件按自己的实际能力选择依赖。源码开发者在仓库根执行 pnpm --filter @galcraft/dsl build 和 pnpm --filter @galcraft/dsl test,分别构建包和检查解析、编译行为。

GalCraft DSL 代码使用 MPL-2.0。SDK tarball 随包提供 LICENSE,并在 dist/licenses/project/ 保留许可范围、第三方声明和 LICENSES/SOURCE-CODE.md 源码取得说明。维护者在公开发行时提供匹配版本的源码;插件作者在分发包含 DSL 实现的产物时保留相应许可和源码取得说明。

版本与发布记录

@galcraft/dsl 共发布 2 个版本,首次发布于 2026/11/01;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.1.0latest2026/11/012 天前
0.0.0-stage2026/11/012 天前

关于 @galcraft/dsl 的常见问题

@galcraft/dsl 是什么?

@galcraft/dsl/parser 公开 parse 及其 CST 类型,供需要读取 GalCraft 语句的作者插件使用。插件使用公开包出口,构建时将解析依赖打入自己的产物;宿主继续负责作品读写、编译与语义服务。解析结果不能代替 M02 事务校验或正式编译结论。

如何安装 @galcraft/dsl?

在项目目录运行 npm install @galcraft/dsl,或使用 pnpm add / yarn add / bun add。

@galcraft/dsl 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@galcraft/dsl 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@galcraft/dsl 可以商用吗?

@galcraft/dsl 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@galcraft/dsl 还在维护吗?

最新版本 0.1.0 发布于 2026/11/01(2 天前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。