chore: fix build scripts and clean up artifacts

Author: xusd320

packages/pack-cli/package.json

@@ -40,6 +40,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -b",
+    "clean": "rm -rf dist",
     "prepublishOnly": "turbo run build --filter=@utoo/pack-cli"
   },
   "types": "dist/index.d.ts"

packages/pack-shared/package.json

@@ -24,6 +24,7 @@
     "build:cjs": "rm -rf cjs && tsc -p ./tsconfig.json  --module commonjs --outDir cjs",
     "build:esm": "rm -rf esm && tsc -p ./tsconfig.json  --module esnext --outDir esm",
     "build": "npm run build:cjs && npm run build:esm",
+    "clean": "rm -rf cjs esm",
     "prepublishOnly": "turbo run build --filter=@utoo/pack-shared"
   },
   "dependencies": {

packages/pack/package.json

@@ -82,6 +82,7 @@
     "artifacts": "napi artifacts --dir ./src --dist npm",
     "build:binding": "napi build src --platform --release -p pack-napi --cargo-cwd ../../ --cargo-name pack_napi --features plugin --js binding.js --dts binding.d.ts",
     "build:binding:local": "napi build src --platform --profile release-local -p pack-napi --cargo-cwd ../../ --cargo-name pack_napi --features plugin --js binding.js --dts binding.d.ts",
+    "clean": "rm -rf cjs esm",
     "prepublishOnly": "turbo run build:js --filter=@utoo/pack && napi prepublish -t npm --skip-gh-release",
     "version": "napi version",
     "generate-features-list": "node ./scripts/generate-feature-list.js"

packages/pack/tsconfig.json

@@ -8,10 +8,7 @@
     "declaration": true,
     "strict": true,
     "skipLibCheck": true,
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "paths": {
-      "@utoo/pack-shared": ["../pack-shared/src/index.ts"]
-    }
+    "lib": ["dom", "dom.iterable", "esnext"]
   },
   "include": ["src"],
   "exclude": ["es", "cjs"]

packages/utoo-web/API_zh-CN.md

@@ -7,7 +7,7 @@
 1. **Real File System**：项目存在于浏览器的[源私有文件系统（OPFS）](https://developer.mozilla.org/zh-CN/docs/Web/API/File_System_API/Origin_private_file_system)中。`Project` 类提供类似 Node.js `fs` 的接口。
 2. **Project Main Worker**：`Project` 实例运行在 Web Worker 中。主线程对象是代理，保持 UI 响应。
 3. **Thread Worker**：重度任务（打包、编译）在专用的 Web Worker 中运行，由移植的 `tokio` 运行时驱动。
-4. **Loader Worker**：在带有 Node.js polyfills 的专用 Worker 中执行 Webpack loaders。
+4. **Loader Worker**：在带有 Node.js polyfills 的专用 Worker 中执行 webpack loaders。
 5. **Service Worker**：充当本地服务器，拦截请求并提供构建文件以供预览。
 
 ## 文件监听与增量构建
@@ -43,7 +43,7 @@ const project = new UtooProject({
     // 重度任务 Worker 脚本 URL。
     threadWorkerUrl: `${location.origin}/threadWorker.js`,
 
-    // Webpack loaders Worker 脚本 URL。
+    // webpack loaders Worker 脚本 URL。
     loaderWorkerUrl: `${location.origin}/loaderWorker.js`,
 
     // 预览 Service Worker 配置。
@@ -128,7 +128,7 @@ for (const filePath in demoFiles) {
 }
 ```
 
-若要使用 loader，请将其添加至 `package.json` 的 `devDependencies` 中并安装，这与标准 Webpack 项目的依赖管理方式一致。此外，由于 `@utoo/web` 遵循 `loader-runner` 的机制与上下文来执行 loader，您还需要同时安装 `loader-runner`。
+若要使用 loader，请将其添加至 `package.json` 的 `devDependencies` 中并安装，这与标准 webpack 项目的依赖管理方式一致。此外，由于 `@utoo/web` 遵循 `loader-runner` 的机制与上下文来执行 loader，您还需要同时安装 `loader-runner`。
 
 您可以像写入其他源文件一样，将此文件写入真实文件系统：
 
@@ -155,7 +155,7 @@ await project.writeFile('utoopack.json', JSON.stringify(utoopackConfig, null, 2)
 * `serviceWorker` (object, 可选):
   * `url` (string, 必需): Service Worker 脚本的 URL。
   * `scope` (string, 必需): Service Worker 将拦截请求的 URL 范围。这是您预览环境的基路径。
-* `loadersImportMap`（对象，可选）：用于配置 Webpack Loader 的导入映射。这是一个可选的高级配置。通常情况下，您只需在 `package.json` 中声明 loader 依赖并安装，即可让它工作。配置 `loadersImportMap` 允许您直接提供预构建好的、满足 CommonJS 规范的单一文件（作为 URL 字符串或内容字符串）。这样做可以避免 loader 执行过程中因 `require` 操作产生的文件系统 I/O 开销，从而显著提升构建性能。键是 loader 的名称，值是 UMD/CommonJS 模块的 URL 或内容字符串。loader 将在 Web Worker 池中并行执行。
+* `loadersImportMap`（对象，可选）：用于配置 webpack Loader 的导入映射。这是一个可选的高级配置。通常情况下，您只需在 `package.json` 中声明 loader 依赖并安装，即可让它工作。配置 `loadersImportMap` 允许您直接提供预构建好的、满足 CommonJS 规范的单一文件（作为 URL 字符串或内容字符串）。这样做可以避免 loader 执行过程中因 `require` 操作产生的文件系统 I/O 开销，从而显著提升构建性能。键是 loader 的名称，值是 UMD/CommonJS 模块的 URL 或内容字符串。loader 将在 Web Worker 池中并行执行。
 
 ### 文件系统方法
 
@@ -303,7 +303,7 @@ module.exports = {
 
 设置 `@utoo/web` 项目的一个关键部分是创建您传递给 `UtooProject` 构造函数的 Worker 脚本。正如在 `utooweb-demo` 示例中所见，这些文件的内容非常少。它们的目的是简单地从 `@utoo/web` 库本身加载必要的 Worker 逻辑。
 
-您需要在项目的源代码中创建三个文件，然后由您的打包器（例如 Webpack、Vite）编译成最终传递给构造函数的 URL。
+您需要在项目的源代码中创建三个文件，然后由您的打包器（例如 webpack、Vite）编译成最终传递给构造函数的 URL。
 
 #### 1. 项目主 Worker (`worker.ts`)
 

packages/utoo-web/package.json

@@ -14,12 +14,15 @@
     "bindgen-build": "wasm-bindgen ../../target/wasm32-unknown-unknown/release/utoo_wasm.wasm --out-dir src/utoo --out-name index --target web",
     "bindgen-build:local": "wasm-bindgen ../../target/wasm32-unknown-unknown/release-local/utoo_wasm.wasm --out-dir src/utoo --out-name index --target web",
     "tsc": "rm -rf esm && tsc -p ./tsconfig.build.json",
-    "dev": "npm run build-wasm -- --profile wasm-dev && npm run bindgen-dev && npx turbo run tsc --filter=@utoo/web  && npm run build-loaderWorker && cp src/utoo/index_bg.wasm esm/utoo",
-    "dev:pm": "npm run build-wasm:pm -- --profile wasm-dev && npm run bindgen-dev && npm run tsc && cp src/utoo/index_bg.wasm esm/utoo",
+    "copy-wasm": "cp src/utoo/index_bg.wasm esm/utoo",
+    "build:shared": "npx turbo run build --filter=@utoo/pack-shared",
+    "dev": "npm run build-wasm -- --profile wasm-dev && npm run bindgen-dev && npx turbo run tsc --filter=@utoo/web  && npm run build-loaderWorker && npm run copy-wasm",
+    "dev:pm": "npm run build-wasm:pm -- --profile wasm-dev && npm run bindgen-dev && npm run tsc && npm run copy-wasm",
     "wasm-opt": "wasm-opt src/utoo/index_bg.wasm -o esm/utoo/index_bg.wasm --enable-threads --enable-bulk-memory --enable-nontrapping-float-to-int -Oz",
     "build": "npm run build-wasm -- --release && npm run bindgen-build && npm run tsc && npm run build-loaderWorker && npm run wasm-opt",
-    "build:local": "npm run build-wasm -- --profile release-local && npm run bindgen-build:local && npm run tsc && npm run build-loaderWorker && cp src/utoo/index_bg.wasm esm/utoo",
+    "build:local": "npm run build-wasm -- --profile release-local && npm run bindgen-build:local && npm run build:shared && npm run tsc && npm run build-loaderWorker && npm run copy-wasm",
     "build-loaderWorker": "node cli/umd.js -e ./src/webpackLoaders/worker.ts -o ./esm/loaderWorker.js -t webworker",
+    "clean": "rm -rf esm src/utoo",
     "prepublishOnly": "turbo run build --filter=@utoo/web"
   },
   "dependencies": {

packages/utoo-web/src/utoo/index.d.ts

@@ -175,11 +175,11 @@ export interface InitOutput {
   readonly __wbindgen_export_7: WebAssembly.Table;
   readonly __externref_drop_slice: (a: number, b: number) => void;
   readonly __externref_table_dealloc: (a: number) => void;
-  readonly closure115147_externref_shim: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__heac94dfe74335608: (a: number, b: number) => void;
   readonly closure96_externref_shim: (a: number, b: number, c: any) => void;
-  readonly closure115144_externref_shim: (a: number, b: number, c: any) => void;
   readonly wasm_bindgen__convert__closures_____invoke__h2ce973260553dde0: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__heac94dfe74335608: (a: number, b: number) => void;
+  readonly closure115144_externref_shim: (a: number, b: number, c: any) => void;
+  readonly closure115147_externref_shim: (a: number, b: number, c: any) => void;
   readonly closure117696_externref_shim: (a: number, b: number, c: any) => void;
   readonly closure117826_externref_shim: (a: number, b: number, c: any, d: any) => void;
   readonly __wbindgen_thread_destroy: (a?: number, b?: number, c?: number) => void;