ArenaLess 0.2.0

新的介绍内容：

ArenaLess：VSCode与TypeScript的神岛游戏制作插件，告别繁琐，拥抱高效

ArenaLess是一款非官方出品的神岛游戏制作插件，专为游戏开发者设计，旨在通过无缝集成VSCode本地版、VSCode在线版与神岛Arena编辑器，为游戏开发带来前所未有的便捷与效率。本插件不仅解决了Arena编辑器功能单一、开发体验不佳的问题，还引入了TypeScript支持，为游戏开发提供更丰富的功能和体验。

文档

想了解使用方法、特性以及如何使用npm包等？请查看以下文档：

岛研所ArenaLess文档

快速上手

基础操作几乎与ArenaPro一致。

创建项目

通过Ctrl+Shift+P打开命令面板，输入并选中以下命令：

ArenaLess: 创建ArenaLess项目

创建完项目后，如果左侧文件夹列表没有更新，请点击刷新按钮（vscode.dev的文件更新可能不灵敏）。

项目编写

教程直接使用ArenaPro的教程：你的一个程序。

登录、打包上传

如果没有出现AL按钮，请使用命令ArenaLess: 激活ArenaLess扩展（WEB版可能不能自动激活）。

1. 创建完项目后，您可能会注意到状态栏有一个AL按钮，点击它，选择登录神岛账号，根据提示进行登录（请注意：token内容不可以给别人看）。
2. 点击AL按钮，选择链接扩展地图，选择您要链接到的地图。
3. 点击AL按钮，选择构建并上传。

常见问题

我想用npm的包，怎么办？

由于ArenaLess是为了兼容vscode web版(vscode.dev)设计的，在这种环境里，npm是无法使用的。所以ArenaLess引入了一种新的方法：支持从网络引入库，支持npm前缀。

// 网络引用库
import ... from 'https://xxxxx/xxxx';

// 使用npm前缀
import ... from "npm:xxx"
import ... from "npm:xxx@1.0.0" // 版本号
import ... from "npm:yyy/路径"

// esm.sh 是一个将npm/jsr/gh上的包转换为es格式的cdn服务
import ... from "https://esm.sh/npm的包名";
import ... from "https://esm.sh/npm的包名(@版本号)"; // https://esm.sh/PKG@SEMVER[/PATH]
import ... from "https://esm.sh/gh/OWNER/REPO[@TAG]/PATH" // github的也可以
import ... from "https://esm.sh/jsr/OWNER/REPO[@TAG]/PATH" // jsr.io的也可以

// 示例：使用JSON5解析带注释的JSON文件
import JSON5 from "https://esm.sh/json5";
import JSON5 from "npm:json5"; // 也可以
const json = JSON5.parse(`{
    "foo":"bar" // 注释在这里
}`);

请注意，目前此操作可能存在不稳定性。

为什么编辑器提示红色了？

因为TypeScript语言支持并不支持网络导入，但ArenaLess修改了打包器的逻辑实现了此功能。如果您不喜欢红色提示，可以在导入语句上方添加// @ts-ignore。

// @ts-ignore
import JSON5 from "https://esm.sh/json5";

网络导入/前缀导入没法兼容ArenaPro怎么办？

细心的用户可以发现，根目录下有一个importMap.arenaless.jsonc文件，用于指定ArenaLess专属导入库的别名。通过它我们可以实现兼容。

{
    "imports":{
        "包名":"导入的地址/带前缀符号的包",
        // 例子
        "json5":"npm:json5"
    }
}

// 例子
import JSON5 from "json5"; // 由于您指定了json5的别名，所以可以直接使用json5
// 在桌面环境下使用npm install json5 --save安装json5，然后代码在ArenaPro中也能运行。

这样指定后，ArenaLess中就可以直接写import ... from "包名"，您可以更改package.json，使用npm install xxx安装相应的包。

前缀列表

1. npm:xxx -> https://esm.sh/xxx
2. jsr:xxx -> https://esm.sh/jsr/xxx

其他说明

1. ArenaLess并非官方出品。
2. ArenaLess的API请求会经过ArenaLess-Server服务器进行中转（原API在web存在cors跨域问题，只好使用中转）。ArenaLess-Server是一个神岛API的简单封装，由岛研所托管。我们不会收集用户数据，仅包含API封装。

鸣谢

• 感谢@冷鱼闲风大佬的指点。
• 感谢原ArenaPro项目。
• 感谢神岛实验室。
• 感谢神奇代码岛。
• 感谢岛研所。

以下项目对本项目的实现有很大帮助

• @rollup/browser及其virtual,alias插件。这是本插件打包器的实现。
• esbuild-wasm用于压缩js代码（已改用terser）。
• terser用于压缩js代码。
• pako用来解压缩gzip（模板是gzip压缩过的）。
• esm.sh AL使用它来获取npm,jsr,gh模块。
• hono API中转服务器。