morghulis 4.3.3 → 4.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +21 -0
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -81,6 +81,27 @@ npm pack # 自动构建并生成 npm 安装包
81
81
 
82
82
  新增组件时,在 `morghulis/components/index.ts` 导出,然后运行 `npm run generate:components`。开发启动、构建和类型检查前也会自动更新声明。
83
83
 
84
+ ## 发布到 npm
85
+
86
+ 修改并保存代码后,在项目根目录执行:
87
+
88
+ ```bash
89
+ npm run release
90
+ ```
91
+
92
+ 脚本先确认 npm 登录状态,执行类型检查、库构建和包测试;全部通过后,自动递增补丁版本(例如 `4.3.3` → `4.3.4`),同步更新 `package.json` 与 `package-lock.json`,打包并发布刚生成的 `.tgz` 到 npm。任一步失败都会停止。版本升级不会自动创建 Git 提交或标签。npm 若提示登录或二次验证,按终端提示完成即可。
93
+
94
+ 其他用法:
95
+
96
+ ```bash
97
+ npm run release -- --dry-run # 检查、构建、打包并预演当前版本,不改版本号、不上传
98
+ npm run release -- minor # 递增次版本,例如 4.3.3 → 4.4.0
99
+ npm run release -- major # 递增主版本,例如 4.3.3 → 5.0.0
100
+ npm run release -- current # 使用已经手动升级的当前版本,或重试尚未成功的发布
101
+ ```
102
+
103
+ 如果发布阶段失败,脚本会保留已升级的版本号和安装包。先确认该版本是否已经发布成功;尚未发布时,用 `current` 重试即可。其他项目使用终端输出的安装命令更新依赖。
104
+
84
105
  ## 开发记录
85
106
 
86
107
  ### 扩展功能
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "morghulis",
3
- "version": "4.3.3",
3
+ "version": "4.3.4",
4
4
  "description": "TypeScript and Vue 3 components for data management",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -35,6 +35,7 @@
35
35
  "registry": "https://registry.npmjs.org/"
36
36
  },
37
37
  "scripts": {
38
+ "release": "node scripts/release.mjs",
38
39
  "generate:components": "node scripts/generate-global-components.mjs",
39
40
  "predev": "npm run generate:components",
40
41
  "dev": "vite",
@@ -44,7 +45,7 @@
44
45
  "prebuild-only": "npm run generate:components",
45
46
  "build-only": "vite build",
46
47
  "build:lib": "npm run generate:components && vite build --config vite.lib.config.ts && vue-tsc -p tsconfig.lib.json && node scripts/finalize-types.mjs",
47
- "test:package": "npm run build:lib && node --test tests/package-exports.test.mjs tests/socket-url.test.mjs tests/file-url.test.mjs",
48
+ "test:package": "npm run build:lib && node --test tests/package-exports.test.mjs tests/socket-url.test.mjs tests/file-url.test.mjs tests/release.test.mjs",
48
49
  "prepack": "npm run test:package",
49
50
  "pretype-check": "npm run generate:components",
50
51
  "type-check": "vue-tsc --build"