customforge 0.1.0-alpha.0 → 0.1.0-alpha.1

package/README.md

@@ -32,15 +32,15 @@ CustomForge connects a familiar 2D design surface to a UV-mapped 3D model:
 - Preview every canvas change on a 3D product in real time
 - Load remote GLB/GLTF models and optional base textures
 - Select the customizable surface by mesh name
-- Rotate and zoom the 3D preview with OrbitControls
-- Export the composed texture as a PNG
-- Save and restore editable objects through versioned Design JSON
+- Rotate and zoom the 3D preview with OrbitControls
+- Export the composed texture as a PNG
+- Save and restore editable objects through versioned Design JSON
 
 The included workbench starts with a procedural cup, so the project works immediately without external assets
 
-## Repository Development
-
-Requirements: Node.js 22+ and pnpm 11+
+## Repository Development
+
+Requirements: Node.js 22+ and pnpm 11+
 
 ```bash
 pnpm install
@@ -49,39 +49,55 @@ pnpm dev
 
 Open the URL printed by Vite
 
-The built-in demo appears with a UV workspace on the left and a live 3D preview on the right
-
-## npm Alpha Package
-
-CustomForge is prepared for public alpha releases under the `alpha` dist-tag. The API and Design JSON Schema may change between alpha versions
+The built-in demo appears with a UV workspace on the left and a live 3D preview on the right
+
+## npm Alpha Package
+
+CustomForge is available from the npm Registry under the `alpha` dist-tag and the API and Design JSON Schema may change between alpha versions
 
-After the first release is published, install the current alpha and its peer dependencies with:
+Install the current public alpha with:
 
 ```powershell
 pnpm add customforge@alpha
-pnpm add fabric three
 ```
 
-For repository-independent verification before publishing, build and create the local package from the repository root:
+Fabric.js and Three.js are installed automatically as transitive dependencies
 
-```powershell
-pnpm pack:local
-```
+pnpm may report that the optional native `canvas` build script was ignored
+
+CustomForge runs in the browser and does not use Node native canvas, so `pnpm approve-builds` is not required
 
-The command builds JavaScript, TypeScript declarations, and core styles, checks the npm file list, and creates:
+Consumer projects can explicitly acknowledge this browser-only choice in `package.json`:
 
-```text
-customforge-0.1.0-alpha.0.tgz
+```json
+{
+  "pnpm": {
+    "ignoredBuiltDependencies": ["canvas"]
+  }
+}
+```
+
+Package page: [npmjs.com/package/customforge](https://www.npmjs.com/package/customforge)
+
+For repository-independent verification before publishing, build and create the local package from the repository root:
+
+```powershell
+pnpm pack:local
+```
+
+The command builds JavaScript, TypeScript declarations, and core styles, checks the npm file list, and creates:
+
+```text
+customforge-0.1.0-alpha.1.tgz
 ```
 
-Install that local package and its peer dependencies in an independent Vite TypeScript project:
+Install that local package in an independent Vite TypeScript project:
 
 ```powershell
-pnpm add D:\project\CustomForge\CustomForge\customforge-0.1.0-alpha.0.tgz
-pnpm add fabric three
+pnpm add D:\projects\3DRendering\core_code\customforge-0.1.0-alpha.1.tgz
 ```
-
-The checked-in `examples/npm-consumer` project imports CustomForge only through this `.tgz`. Run `pnpm install --ignore-workspace` in that directory so pnpm installs it independently from the parent workspace
+
+The checked-in `examples/npm-consumer` project imports CustomForge only through this `.tgz`. Run `pnpm install --ignore-workspace` in that directory so pnpm installs it independently from the parent workspace
 
 ## Load Your Product
 
@@ -103,22 +119,22 @@ The optional texture image is the visual base layer, not a replacement for model
 >
 > A blocked or canvas-tainting resource may fail to load and can prevent PNG export
 
-## Basic Usage
-
-The framework-independent Library entry can be mounted into any two DOM containers:
-
-CustomForge is browser-only and must be initialized after its DOM containers are available
-
-The editor and viewer require two different containers; call `destroy()` when the page, host component, or instance is no longer in use to release Fabric, WebGL, observer, and event resources
+## Basic Usage
+
+The framework-independent Library entry can be mounted into any two DOM containers:
+
+CustomForge is browser-only and must be initialized after its DOM containers are available
+
+The editor and viewer require two different containers; call `destroy()` when the page, host component, or instance is no longer in use to release Fabric, WebGL, observer, and event resources
 
 ```html
 <div id="texture-editor"></div>
 <div id="product-viewer"></div>
 ```
 
-```ts
-import { createCustomizer } from 'customforge'
-import 'customforge/style.css'
+```ts
+import { createCustomizer } from 'customforge'
+import 'customforge/style.css'
 
 const customizer = await createCustomizer({
   editor: '#texture-editor',
@@ -141,64 +157,64 @@ customizer.addText({
   color: '#172126',
 })
 
-await customizer.addImage({
-  src: 'https://example.com/logo.png',
-  x: 720,
-  y: 240,
-  width: 220,
-})
-
-window.addEventListener('beforeunload', () => customizer.destroy(), {
-  once: true,
-})
-```
-
-The public package uses the same root and style imports as the local `.tgz`; pin an exact alpha version when reproducible installs are required
-
-## Design JSON
-
-`saveDesign()` returns a Library-owned, JSON-safe document instead of exposing Fabric.js serialization. `loadDesign()` validates unknown input and restores the editable object stack asynchronously:
-
-```ts
-const design = customizer.saveDesign()
-localStorage.setItem('customforge-design', JSON.stringify(design))
-
-const savedDesign = localStorage.getItem('customforge-design')
-if (savedDesign) {
-  await customizer.loadDesign(JSON.parse(savedDesign))
-}
-```
-
-The current Schema version is `1`. It stores the logical canvas size and the text and image objects in back-to-front render order, including stable object IDs and center-based transforms
-
-Design JSON intentionally excludes the product model, target mesh, and base texture. A document can only be loaded into an editor with exactly the same logical width and height
-
-Loading is transactional: the current design remains unchanged unless the document validates and every referenced image loads successfully. Blob URL images are converted to Data URLs when added; remote image URLs remain URLs and must continue to satisfy browser CORS requirements when restored
-
-The Schema is still an alpha contract and may change in later alpha versions
-
-## Instance API
+await customizer.addImage({
+  src: 'https://example.com/logo.png',
+  x: 720,
+  y: 240,
+  width: 220,
+})
+
+window.addEventListener('beforeunload', () => customizer.destroy(), {
+  once: true,
+})
+```
+
+The public package uses the same root and style imports as the local `.tgz`; pin an exact alpha version when reproducible installs are required
+
+## Design JSON
+
+`saveDesign()` returns a Library-owned, JSON-safe document instead of exposing Fabric.js serialization. `loadDesign()` validates unknown input and restores the editable object stack asynchronously:
+
+```ts
+const design = customizer.saveDesign()
+localStorage.setItem('customforge-design', JSON.stringify(design))
+
+const savedDesign = localStorage.getItem('customforge-design')
+if (savedDesign) {
+  await customizer.loadDesign(JSON.parse(savedDesign))
+}
+```
+
+The current Schema version is `1`. It stores the logical canvas size and the text and image objects in back-to-front render order, including stable object IDs and center-based transforms
+
+Design JSON intentionally excludes the product model, target mesh, and base texture. A document can only be loaded into an editor with exactly the same logical width and height
+
+Loading is transactional: the current design remains unchanged unless the document validates and every referenced image loads successfully. Blob URL images are converted to Data URLs when added; remote image URLs remain URLs and must continue to satisfy browser CORS requirements when restored
+
+The Schema is still an alpha contract and may change in later alpha versions
+
+## Instance API
 
 | Method | Description |
 | --- | --- |
-| `addText(options)` | Add and select editable text, constrained to the canvas |
-| `addImage(options)` | Load and select an image, constrained to the canvas |
-| `deleteSelected()` | Remove the active object or selection |
-| `saveDesign()` | Return the current versioned Design JSON document |
-| `loadDesign(value)` | Validate and transactionally restore Design JSON |
-| `loadProduct(product)` | Replace the model, base texture, and target mesh |
+| `addText(options)` | Add and select editable text, constrained to the canvas |
+| `addImage(options)` | Load and select an image, constrained to the canvas |
+| `deleteSelected()` | Remove the active object or selection |
+| `saveDesign()` | Return the current versioned Design JSON document |
+| `loadDesign(value)` | Validate and transactionally restore Design JSON |
+| `loadProduct(product)` | Replace the model, base texture, and target mesh |
 | `exportTexture(filename?)` | Download the composed texture as PNG |
 | `resetView()` | Restore the default 3D camera position |
 | `on(event, listener)` | Subscribe to instance events; returns an unsubscribe function |
 | `destroy()` | Release DOM events, Fabric state, and WebGL resources |
 
-Available events are `ready`, `change`, `selectionchange`, `status`, and `error`
-
-The initial alpha stability boundary is limited to the methods above, `createCustomizer`, `ProductCustomizer`, and the configuration, event, and Design JSON types exported from the package root
-
-`ProductCustomizer` does not expose its Fabric.js editor or Three.js viewer instances; consumers interact through the facade API
-
-Imports from `core`, `editor`, `viewer`, `bridge`, or any other undeclared package subpath are unsupported
+Available events are `ready`, `change`, `selectionchange`, `status`, and `error`
+
+The initial alpha stability boundary is limited to the methods above, `createCustomizer`, `ProductCustomizer`, and the configuration, event, and Design JSON types exported from the package root
+
+`ProductCustomizer` does not expose its Fabric.js editor or Three.js viewer instances; consumers interact through the facade API
+
+Imports from `core`, `editor`, `viewer`, `bridge`, or any other undeclared package subpath are unsupported
 
 ## Architecture
 
@@ -240,36 +256,36 @@ The built-in demo follows the same `PrintArea` mesh convention
 ## Project Structure
 
 ```text
-src/
-|-- bridge/           Canvas and Three.js texture synchronization
-|-- core/             Public types, configuration, and DOM helpers
-|-- customizer/       Public instance orchestration
-|-- demo/             Runnable workbench UI
-|-- editor/           Fabric.js design surface
-|-- style.css         Public Library style entry
-|-- styles/           Library core styles
-|-- viewer/           Three.js product preview
-`-- index.ts          Framework-independent source entry
-
-examples/
-`-- npm-consumer/     Independent local .tgz consumer
-
-scripts/
-`-- verify-package.mjs  npm file and artifact boundary checks
-```
+src/
+|-- bridge/           Canvas and Three.js texture synchronization
+|-- core/             Public types, configuration, and DOM helpers
+|-- customizer/       Public instance orchestration
+|-- demo/             Runnable workbench UI
+|-- editor/           Fabric.js design surface
+|-- style.css         Public Library style entry
+|-- styles/           Library core styles
+|-- viewer/           Three.js product preview
+`-- index.ts          Framework-independent source entry
+
+examples/
+`-- npm-consumer/     Independent local .tgz consumer
+
+scripts/
+`-- verify-package.mjs  npm file and artifact boundary checks
+```
 
 ## Development Commands
 
 ```bash
-pnpm check       # TypeScript project check
-pnpm test        # Unit tests
-pnpm build       # Type-check and production build
-pnpm build:lib   # Build ESM, declarations, and core styles
-pnpm verify:package # Check dist and the npm file list
-pnpm pack:local  # Build, verify, and create the local .tgz
-pnpm release:check # Run checks, tests, package build, verification, and local pack
-pnpm preview     # Preview the production build
-```
+pnpm check       # TypeScript project check
+pnpm test        # Unit tests
+pnpm build       # Type-check and production build
+pnpm build:lib   # Build ESM, declarations, and core styles
+pnpm verify:package # Check dist and the npm file list
+pnpm pack:local  # Build, verify, and create the local .tgz
+pnpm release:check # Run checks, tests, package build, verification, and local pack
+pnpm preview     # Preview the production build
+```
 
 ## Current Scope
 
@@ -277,11 +293,11 @@ This is an early technical prototype
 
 The public API and design document format are not stable yet
 
-The current milestone intentionally focuses on one texture and one customizable mesh
-
-Public npm releases use the `alpha` dist-tag until the API and Design JSON contract are ready for a more stable channel
-
-Multi-surface products, undo/redo, and framework adapters are not implemented yet. Undo/redo is the next planned milestone and will build on the Design JSON snapshot contract
+The current milestone intentionally focuses on one texture and one customizable mesh
+
+Public npm releases use the `alpha` dist-tag until the API and Design JSON contract are ready for a more stable channel
+
+Multi-surface products, undo/redo, and framework adapters are not implemented yet. Undo/redo is the next planned milestone and will build on the Design JSON snapshot contract
 
 ## Technology
 

package/README.zh-CN.md

@@ -32,15 +32,15 @@ CustomForge 将常见的二维设计界面与带 UV 的三维模型连接起来
 - 将画布的每次变化实时呈现在三维产品上
 - 加载远程 GLB/GLTF 模型和可选的基础纹理
 - 通过 Mesh 名称指定可定制表面
-- 使用 OrbitControls 旋转和缩放三维预览
-- 将合成后的纹理导出为 PNG
-- 通过版本化 Design JSON 保存和恢复可编辑对象
+- 使用 OrbitControls 旋转和缩放三维预览
+- 将合成后的纹理导出为 PNG
+- 通过版本化 Design JSON 保存和恢复可编辑对象
 
 工作台内置了一个程序生成的杯子，无需准备外部资源即可直接运行
 
-## 仓库开发
-
-环境要求：Node.js 22+ 和 pnpm 11+
+## 仓库开发
+
+环境要求：Node.js 22+ 和 pnpm 11+
 
 ```bash
 pnpm install
@@ -49,39 +49,53 @@ pnpm dev
 
 打开 Vite 输出的地址
 
-内置演示的左侧是 UV 编辑区，右侧是实时三维预览
-
-## npm Alpha 制品
-
-CustomForge 已准备通过 `alpha` dist-tag 公开发布。不同 alpha 版本之间的 API 和 Design JSON Schema 可能发生变化
+内置演示的左侧是 UV 编辑区，右侧是实时三维预览
+
+## npm Alpha 制品
+
+CustomForge 已通过 `alpha` dist-tag 发布到 npm Registry，不同 alpha 版本之间的 API 和 Design JSON Schema 可能发生变化
 
-首次发布完成后，使用以下命令安装当前 alpha 及其 peer dependencies：
+使用以下命令安装当前公开 alpha：
 
 ```powershell
 pnpm add customforge@alpha
-pnpm add fabric three
 ```
 
-发布前如需进行独立于仓库源码的验证，可在仓库根目录构建并生成本地包：
+Fabric.js 和 Three.js 会作为传递依赖自动安装
 
-```powershell
-pnpm pack:local
-```
+pnpm 可能提示可选的原生 `canvas` 构建脚本已被忽略，CustomForge 运行在浏览器中，不使用 Node 原生 canvas，因此不需要执行 `pnpm approve-builds`
 
-命令依次生成 JavaScript、TypeScript 声明、核心样式，检查 npm 文件清单，并创建：
+消费项目可以在 `package.json` 中明确记录这一浏览器端选择：
 
-```text
-customforge-0.1.0-alpha.0.tgz
+```json
+{
+  "pnpm": {
+    "ignoredBuiltDependencies": ["canvas"]
+  }
+}
+```
+
+包页面：[npmjs.com/package/customforge](https://www.npmjs.com/package/customforge)
+
+发布前如需进行独立于仓库源码的验证，可在仓库根目录构建并生成本地包：
+
+```powershell
+pnpm pack:local
+```
+
+命令依次生成 JavaScript、TypeScript 声明、核心样式，检查 npm 文件清单，并创建：
+
+```text
+customforge-0.1.0-alpha.1.tgz
 ```
 
-在独立 Vite TypeScript 项目中安装该本地制品及其 peer dependencies：
+在独立 Vite TypeScript 项目中安装该本地制品：
 
 ```powershell
-pnpm add D:\project\CustomForge\CustomForge\customforge-0.1.0-alpha.0.tgz
-pnpm add fabric three
+pnpm add D:\projects\3DRendering\core_code\customforge-0.1.0-alpha.1.tgz
 ```
-
-仓库中的 `examples/npm-consumer` 提供了一个只通过该 `.tgz` 导入的消费示例。在该目录中使用 `pnpm install --ignore-workspace`，确保 pnpm 将其作为独立于父级 workspace 的项目安装
+
+仓库中的 `examples/npm-consumer` 提供了一个只通过该 `.tgz` 导入的消费示例。在该目录中使用 `pnpm install --ignore-workspace`，确保 pnpm 将其作为独立于父级 workspace 的项目安装
 
 ## 加载你的产品
 
@@ -103,22 +117,22 @@ UV 坐标应当保存在三维模型中
 >
 > 被浏览器阻止或污染 Canvas 的资源可能无法加载，也会导致 PNG 导出失败
 
-## 基本用法
-
-与框架无关的 Library 入口可以挂载到任意两个 DOM 容器中：
-
-CustomForge 仅支持浏览器环境，应在 DOM 挂载容器可用后创建实例
-
-编辑器和查看器必须使用两个不同的容器；页面卸载、组件卸载或不再使用实例时必须调用 `destroy()` 释放 Fabric、WebGL、观察器和事件资源
+## 基本用法
+
+与框架无关的 Library 入口可以挂载到任意两个 DOM 容器中：
+
+CustomForge 仅支持浏览器环境，应在 DOM 挂载容器可用后创建实例
+
+编辑器和查看器必须使用两个不同的容器；页面卸载、组件卸载或不再使用实例时必须调用 `destroy()` 释放 Fabric、WebGL、观察器和事件资源
 
 ```html
 <div id="texture-editor"></div>
 <div id="product-viewer"></div>
 ```
 
-```ts
-import { createCustomizer } from 'customforge'
-import 'customforge/style.css'
+```ts
+import { createCustomizer } from 'customforge'
+import 'customforge/style.css'
 
 const customizer = await createCustomizer({
   editor: '#texture-editor',
@@ -141,64 +155,64 @@ customizer.addText({
   color: '#172126',
 })
 
-await customizer.addImage({
-  src: 'https://example.com/logo.png',
-  x: 720,
-  y: 240,
-  width: 220,
-})
-
-window.addEventListener('beforeunload', () => customizer.destroy(), {
-  once: true,
-})
-```
-
-公开包与本地 `.tgz` 使用相同的根入口和样式入口；需要可重复安装时应固定具体 alpha 版本
-
-## Design JSON
-
-`saveDesign()` 返回由 Library 自身定义、可安全写入 JSON 的文档，不暴露 Fabric.js 序列化格式。`loadDesign()` 校验未知输入，并异步恢复可编辑对象栈：
-
-```ts
-const design = customizer.saveDesign()
-localStorage.setItem('customforge-design', JSON.stringify(design))
-
-const savedDesign = localStorage.getItem('customforge-design')
-if (savedDesign) {
-  await customizer.loadDesign(JSON.parse(savedDesign))
-}
-```
-
-当前 Schema 版本为 `1`。文档保存逻辑画布尺寸，并按从后到前的渲染顺序保存文字和图片对象，包括稳定对象 ID 与基于中心点的变换
-
-Design JSON 有意排除产品模型、目标 Mesh 和基础纹理。文档只能加载到逻辑宽高完全相同的编辑器中
-
-加载具有事务性：只有文档校验通过且全部引用图片成功加载后，当前设计才会被替换。Blob URL 图片会在添加时转换为 Data URL；远程图片仍保留 URL，恢复时必须继续满足浏览器 CORS 要求
-
-该 Schema 目前仍属于 alpha 契约，后续 alpha 版本可能调整
-
-## 实例 API
+await customizer.addImage({
+  src: 'https://example.com/logo.png',
+  x: 720,
+  y: 240,
+  width: 220,
+})
+
+window.addEventListener('beforeunload', () => customizer.destroy(), {
+  once: true,
+})
+```
+
+公开包与本地 `.tgz` 使用相同的根入口和样式入口；需要可重复安装时应固定具体 alpha 版本
+
+## Design JSON
+
+`saveDesign()` 返回由 Library 自身定义、可安全写入 JSON 的文档，不暴露 Fabric.js 序列化格式。`loadDesign()` 校验未知输入，并异步恢复可编辑对象栈：
+
+```ts
+const design = customizer.saveDesign()
+localStorage.setItem('customforge-design', JSON.stringify(design))
+
+const savedDesign = localStorage.getItem('customforge-design')
+if (savedDesign) {
+  await customizer.loadDesign(JSON.parse(savedDesign))
+}
+```
+
+当前 Schema 版本为 `1`。文档保存逻辑画布尺寸，并按从后到前的渲染顺序保存文字和图片对象，包括稳定对象 ID 与基于中心点的变换
+
+Design JSON 有意排除产品模型、目标 Mesh 和基础纹理。文档只能加载到逻辑宽高完全相同的编辑器中
+
+加载具有事务性：只有文档校验通过且全部引用图片成功加载后，当前设计才会被替换。Blob URL 图片会在添加时转换为 Data URL；远程图片仍保留 URL，恢复时必须继续满足浏览器 CORS 要求
+
+该 Schema 目前仍属于 alpha 契约，后续 alpha 版本可能调整
+
+## 实例 API
 
 | 方法 | 说明 |
 | --- | --- |
-| `addText(options)` | 添加并选中文字，自动约束在画布内 |
-| `addImage(options)` | 加载并选中图片，自动约束在画布内 |
-| `deleteSelected()` | 删除当前对象或选区 |
-| `saveDesign()` | 返回当前版本化 Design JSON 文档 |
-| `loadDesign(value)` | 校验并以事务方式恢复 Design JSON |
-| `loadProduct(product)` | 更换模型、基础纹理和目标 Mesh |
+| `addText(options)` | 添加并选中文字，自动约束在画布内 |
+| `addImage(options)` | 加载并选中图片，自动约束在画布内 |
+| `deleteSelected()` | 删除当前对象或选区 |
+| `saveDesign()` | 返回当前版本化 Design JSON 文档 |
+| `loadDesign(value)` | 校验并以事务方式恢复 Design JSON |
+| `loadProduct(product)` | 更换模型、基础纹理和目标 Mesh |
 | `exportTexture(filename?)` | 将合成纹理下载为 PNG |
 | `resetView()` | 恢复默认三维相机位置 |
 | `on(event, listener)` | 订阅实例事件，并返回取消订阅函数 |
 | `destroy()` | 释放 DOM 事件、Fabric 状态和 WebGL 资源 |
 
-当前事件包括 `ready`、`change`、`selectionchange`、`status` 和 `error`
-
-首个 alpha 的稳定候选边界只包括上表方法、`createCustomizer`、`ProductCustomizer` 以及从根入口导出的配置、事件和 Design JSON 类型
-
-`ProductCustomizer` 不公开 Fabric.js 编辑器和 Three.js 查看器实例，使用方只通过门面 API 操作定制器
-
-不支持从 `core`、`editor`、`viewer`、`bridge` 或其他未声明的包子路径导入模块
+当前事件包括 `ready`、`change`、`selectionchange`、`status` 和 `error`
+
+首个 alpha 的稳定候选边界只包括上表方法、`createCustomizer`、`ProductCustomizer` 以及从根入口导出的配置、事件和 Design JSON 类型
+
+`ProductCustomizer` 不公开 Fabric.js 编辑器和 Three.js 查看器实例，使用方只通过门面 API 操作定制器
+
+不支持从 `core`、`editor`、`viewer`、`bridge` 或其他未声明的包子路径导入模块
 
 ## 架构
 
@@ -240,36 +254,36 @@ ProductCustomizer
 ## 项目结构
 
 ```text
-src/
-|-- bridge/           Canvas 与 Three.js 纹理同步
-|-- core/             公共类型、配置和 DOM 工具
-|-- customizer/       公共实例编排
-|-- demo/             可运行的工作台界面
-|-- editor/           Fabric.js 设计画布
-|-- style.css         Library 公开样式入口
-|-- styles/           Library 核心样式
-|-- viewer/           Three.js 产品预览
-`-- index.ts          与框架无关的源码入口
-
-examples/
-`-- npm-consumer/     本地 .tgz 独立消费示例
-
-scripts/
-`-- verify-package.mjs  npm 文件和制品边界检查
-```
+src/
+|-- bridge/           Canvas 与 Three.js 纹理同步
+|-- core/             公共类型、配置和 DOM 工具
+|-- customizer/       公共实例编排
+|-- demo/             可运行的工作台界面
+|-- editor/           Fabric.js 设计画布
+|-- style.css         Library 公开样式入口
+|-- styles/           Library 核心样式
+|-- viewer/           Three.js 产品预览
+`-- index.ts          与框架无关的源码入口
+
+examples/
+`-- npm-consumer/     本地 .tgz 独立消费示例
+
+scripts/
+`-- verify-package.mjs  npm 文件和制品边界检查
+```
 
 ## 开发命令
 
 ```bash
-pnpm check       # TypeScript 项目检查
-pnpm test        # 单元测试
-pnpm build       # 类型检查和生产构建
-pnpm build:lib   # 构建 ESM、类型声明和核心样式
-pnpm verify:package # 检查 dist 和 npm 文件清单
-pnpm pack:local  # 构建、检查并生成本地 .tgz
-pnpm release:check # 执行检查、测试、制品构建、校验和本地打包
-pnpm preview     # 预览生产构建
-```
+pnpm check       # TypeScript 项目检查
+pnpm test        # 单元测试
+pnpm build       # 类型检查和生产构建
+pnpm build:lib   # 构建 ESM、类型声明和核心样式
+pnpm verify:package # 检查 dist 和 npm 文件清单
+pnpm pack:local  # 构建、检查并生成本地 .tgz
+pnpm release:check # 执行检查、测试、制品构建、校验和本地打包
+pnpm preview     # 预览生产构建
+```
 
 ## 当前范围
 
@@ -277,11 +291,11 @@ pnpm preview     # 预览生产构建
 
 公共 API 和设计文档格式尚未稳定
 
-当前里程碑有意聚焦于一张纹理和一个可定制 Mesh
-
-在 API 和 Design JSON 契约进入更稳定阶段前，公开 npm 版本统一使用 `alpha` dist-tag
-
-多定制面、撤销与重做和框架适配器仍未实现。撤销与重做是下一阶段计划，并将复用 Design JSON 快照契约
+当前里程碑有意聚焦于一张纹理和一个可定制 Mesh
+
+在 API 和 Design JSON 契约进入更稳定阶段前，公开 npm 版本统一使用 `alpha` dist-tag
+
+多定制面、撤销与重做和框架适配器仍未实现。撤销与重做是下一阶段计划，并将复用 Design JSON 快照契约
 
 ## 技术栈