sapdon 3.0.3 → 3.2.0

package/README.md

@@ -81,8 +81,9 @@ hello_sapdon/
 
 ## 📚 学习资源
 
-- [官方文档](https://docs.sapdon.org)
-- [示例模组仓库](https://github.com/Meteage/sapdon/examples)
+- [官方文档](./doc/)
+- [入门教程](./doc/hello_sapdon)
+- [示例模组仓库](./examples/)
 
 
 ## ❓ 常见问题
@@ -110,4 +111,11 @@ npm update sapdon
 - 官方 QQ 群：`810904181`
 
 ## ts支持
-[quick start](./doc/sapdon-ts.md)
+[quick start](./doc/sapdon-ts.md)
+
+## 编译 Sapdon
+1. 安装依赖：`npm install`
+2. 编译：`npm run build`
+    1. 查看详细输出 `npm run build -- verbose`
+    2. 保存中间文件夹 `dist` `npm run build -- keep`
+    3. 你也可以组合两个参数 `npm run build -- keep verbose`

package/doc/api.md

@@ -41,8 +41,8 @@
 ##### 抛出异常
 - 当 `key` 参数缺失或不是字符串时，抛出 `Error`。
 
-### `toJson()`
-将物品转换为 JSON 格式，以便在游戏中定义物品。
+### `@Serializer` 装饰器
+将物品转换为 Addon JSON 对象，以便在游戏中定义物品。
 
 ##### 返回值
 - `Object`: JSON 格式的物品对象。

package/doc/sapdon-ts.md

@@ -18,11 +18,10 @@ import { ItemAPI } from '@sapdon/core'
 ## 从js迁移到ts
 js 的 `main.mjs` 包含了一些预定义的代码：
 ```js
-import { startDevServer } from '@sapdon/cli'
-import { GRegistry, UISystemRegistry } from '@sapdon/core'
+import { registry } from '@sapdon/core'
 
-// 开启开发服务器, 不开启开发服务器无法使用文件同步和热更新
-startDevServer(GRegistry, UISystemRegistry)
+// 进行注册后需进行一次提交, 通知开发服务器更新文件
+registry.setup()
 ```
 如果需要从js迁移到ts，删除 `startDevServer` 那行即可（不删也没事）
 
@@ -59,4 +58,7 @@ manager.attachComponent(new MyComponent())
 
 你也可以动态增删改查组件! 这很方便!
 
-如果你想看它到底是怎么回事,可以从 `examples/oc-core` 开始了解
+如果你想看它到底是怎么回事,可以从 `examples/oc-core` 开始了解
+
+## [Object - Component](./oc/index.md)
+关于 `@sapdon/oc` 的一切

package/package.json

@@ -1,9 +1,9 @@
 {
     "name": "sapdon",
-    "version": "3.0.3",
+    "version": "3.2.0",
     "scripts": {
-        "build": "rollup -c",
-        "pub": "rollup -c && npm publish"
+        "build": "node scripts/build.cjs",
+        "pub": "npm run build && npm publish"
     },
     "keywords": [
         "bedrock",
@@ -14,39 +14,38 @@
     "license": "ISC",
     "type": "module",
     "bin": {
-        "sapdon": "dist/cli/start.js"
+        "sapdon": "prod/cli/start.js"
     },
     "description": "Sapdon is a Node.js toolkit designed for building Bedrock Edition Minecraft addon packs.",
     "devDependencies": {
         "@minecraft/server": "^2.0.0-beta.1.21.80-preview.20",
         "@minecraft/server-ui": "^1.3.0",
+        "@types/lodash": "^4.17.16",
+        "@types/node": "^22.14.0",
+        "tsc-alias": "^1.8.13"
+    },
+    "dependencies": {
         "@rollup/plugin-commonjs": "^28.0.2",
         "@rollup/plugin-json": "^6.1.0",
         "@rollup/plugin-node-resolve": "^16.0.0",
         "@rollup/plugin-terser": "^0.4.4",
         "@rollup/plugin-typescript": "^12.1.2",
-        "@types/lodash": "^4.17.16",
-        "@types/node": "^22.13.8",
-        "rollup": "^4.30.1",
-        "rollup-plugin-dts": "^6.1.1",
-        "rollup-plugin-typescript-paths": "^1.5.0",
-        "rollup-plugin-typescript2": "^0.36.0",
-        "rollup-plugin-visualizer": "^5.14.0",
-        "ts-node": "^10.9.2",
-        "tsconfig-paths": "^4.2.0",
-        "tslib": "^2.8.1",
-        "typescript": "^5.7.3"
-    },
-    "dependencies": {
         "chalk": "^5.4.1",
         "commander": "^13.0.0",
         "download-git-repo": "^3.0.2",
         "inquirer": "^12.3.1",
         "lodash": "^4.17.21",
-        "ora": "^8.1.1"
+        "ora": "^8.1.1",
+        "rollup": "^4.39.0",
+        "rollup-plugin-dts": "^6.2.1",
+        "rollup-plugin-typescript-paths": "^1.5.0",
+        "rollup-plugin-visualizer": "^5.14.0",
+        "tsconfig-paths": "^4.2.0",
+        "tslib": "^2.8.1",
+        "typescript": "^5.8.2"
     },
     "files": [
-        "dist/**/*",
+        "prod/**/*",
         "doc/**/*"
     ]
 }

package/{dist/cli/dev-server/server.d.ts → prod/cli/index.d.ts}

@@ -1,5 +1,6 @@
 import http from 'http';
-type ServerHandler = (...args: Transferable[]) => void;
+
+type ServerHandler = (...args: any[]) => void | Promise<void>;
 type HandlerInterceptor = (handler: ServerHandler) => ServerHandler;
 declare class DevelopmentServer {
     readonly cliServerHandlers: Map<string, ServerHandler>;
@@ -10,5 +11,10 @@ declare class DevelopmentServer {
     getHandler(url: string): ServerHandler | undefined;
     interceptHandler(url: string, interceptor: HandlerInterceptor): ServerHandler;
 }
-export declare const server: DevelopmentServer;
-export {};
+declare const server: DevelopmentServer;
+
+declare namespace client {
+    function call(name: any, ...args: any[]): Promise<void>;
+}
+
+export { client, server as devServer };

package/prod/cli/index.js

@@ -0,0 +1 @@
+import e from"http";Symbol.metadata||(Symbol.metadata=Symbol("[[metadata]]"));const t=Symbol("isRawJSON");const r=["boolean","number"],n=["string","undefined"];function o(e,o){const i=typeof o;if(null===i)return null;if(n.includes(i))return o;if(r.includes(i))return JSON.rawJSON(o);if("object"===i)return JSON.isRawJSON(o)?o:function(e){return!0===e?.[t]}(o)?JSON.rawJSON(o.rawJSON):o;if("bigint"===i)return JSON.rawJSON(o.toString());throw new Error("Unexpected value")}const i={encode:e=>JSON.stringify(e,o),decode:JSON.parse};function s(e,t=i){return t.encode(e)}const a={port:49037},{port:c}=a;const{port:l}=a;const d=new class{cliServerHandlers=new Map;listening=!1;isListening(){return this.listening}bootstrap(){this.listening=!0;const t=e.createServer((async(e,t)=>{const r=this.cliServerHandlers.get((e.url??"/").slice(1));if(r){try{const{promise:t,resolve:n,reject:o}=Promise.withResolvers();let s=Buffer.alloc(0);e.on("data",(e=>s=Buffer.concat([s,e]))),e.on("end",(()=>{try{n(function(e,t=i){return t.decode(e)}(s))}catch(e){o(e)}})),await r(...await t)}catch(e){return console.error(e),t.writeHead(500),void t.end()}t.writeHead(200),t.end()}else t.writeHead(404),t.end()})).listen(l,(()=>console.log(`Dev Server listening on port ${l}`)));return t.on("error",(()=>this.listening=!1)),t}handle(e,t){this.cliServerHandlers.set(e,t)}getHandler(e){return this.cliServerHandlers.get(e)}interceptHandler(e,t){const r=t(this.getHandler(e)??Function.prototype);return this.cliServerHandlers.set(e,r),r}},u={call:async(e,...t)=>await async function(e,...t){try{await fetch(`http://localhost:${c}/${e}`,{method:"POST",headers:{"Content-Type":"application/json"},body:s(t)})}catch(e){console.error(e),console.error("尝试在构建脚本中使用 server.startDevServer() 启动开发服务器")}}(e,...t)};export{u as client,d as devServer};