pangu-chart-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 樱花下的市丸银
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,549 @@
+# pangu-chart-cli
+
+一个专注于 Vue 3 可视化组件库打包的 Vite 配置生成器。
+
+## 简介
+
+`pangu-chart-cli` 是一个专为 Vue 3 chart/可视化组件库设计的打包工具。它简化了 Vite 配置流程,自动处理 Element Plus namespace、banner 注入、CSS 代码分割等复杂配置,让开发者专注于组件开发本身。
+
+**核心特性**:
+
+- 自动生成 Vite 配置(UMD + ES 双格式输出)
+- Element Plus CSS namespace 自定义(避免样式冲突)
+- 自动添加 banner(包含 name/version/author/时间戳)
+- 开发服务自动检测 `example` 目录
+- CSS 代码分割 + Gzip 压缩
+- TypeScript 类型支持
+
+**适用场景**:
+
+- Vue 3 组件库开发
+- 可视化图表库打包
+- Element Plus 二次封装组件库
+
+## 安装
+
+### 全局安装
+
+```bash
+npm install -g pangu-chart-cli
+# 或
+pnpm add -g pangu-chart-cli
+```
+
+### 项目依赖
+
+```bash
+npm install --save-dev pangu-chart-cli
+# 或
+pnpm add -D pangu-chart-cli
+```
+
+## CLI 命令
+
+CLI 工具提供两个命令别名:`vcc` 和 `vis-chart-cli`,以下以 `vcc` 为例。
+
+### vcc dev / vcc d
+
+启动 Vite 开发服务。
+
+**执行逻辑**:
+
+1. 检测项目根目录下的 `example/package.json` 是否存在
+2. 若存在,进入 `example` 目录执行开发服务
+3. 若不存在,在项目根目录执行开发服务
+4. 若目标目录无 `vite.config.js` 或 `vite.config.ts`,使用内置默认配置
+5. 服务监听 `0.0.0.0`(局域网可访问)
+
+**使用示例**:
+
+```bash
+vcc dev
+# 或
+vcc d
+```
+
+### vcc build / vcc b
+
+执行 Vite 打包。
+
+**执行逻辑**:
+
+1. 在项目根目录查找 `vite.config.js` 或 `vite.config.ts`
+2. 若无配置文件,使用内置默认配置
+3. 输出 UMD + ES 双格式
+4. 自动添加 banner(包含组件名称、版本、作者、构建时间)
+5. 清理隐藏文件(`._*`、`.DS_Store`)
+
+**使用示例**:
+
+```bash
+vcc build
+# 或
+vcc b
+```
+
+### vcc -v
+
+查看当前版本号。
+
+```bash
+vcc -v
+```
+
+## API 文档
+
+本工具提供三个核心 API 函数,用于在 `vite.config.js` 中生成配置。
+
+### getConfig(config)
+
+生成完整的 Vite UserConfig 配置对象。
+
+**参数**:
+
+| 参数名          | 类型                | 必填 | 说明                        |
+| --------------- | ------------------- | ---- | --------------------------- |
+| `name`          | `string`            | ✓    | package.json 中的组件名称   |
+| `version`       | `string`            | ✓    | package.json 中的版本号     |
+| `author`        | `string`            | -    | 作者信息,用于 banner        |
+| `elementConfig` | `boolean \| object` | -    | Element Plus namespace 配置 |
+
+**返回值结构**:
+
+```javascript
+{
+  // 全局变量定义
+  define: {
+    'process.env': process.env || {}
+  },
+
+  // 插件列表
+  plugins: [
+    // 若启用 elementConfig,包含 elementNamespacePlugin
+    vue({ isProduction: true }),
+    compression({ ext: '.gz', deleteOriginFile: false }),
+    banner({
+      outDir: '<输出目录路径>',
+      content: '<组件名> v<版本号> Author: <作者> Date: <时间戳>'
+    })
+  ],
+
+  // 开发服务器配置
+  server: {
+    host: '0.0.0.0'  // 局域网可访问
+  },
+
+  // CSS 预处理器配置(若启用 elementConfig)
+  css: {
+    preprocessorOptions: {
+      scss: {
+        additionalData: "@forward '<config.scss路径>' with (\n  $namespace: '<namespace名称>'\n);"
+      }
+    }
+  },
+
+  // 构建配置
+  build: {
+    target: ['chrome94', 'edge94', 'firefox92'],  // 浏览器兼容目标
+    reportCompressedSize: false,                  // 不报告压缩大小
+    emptyOutDir: true,                            // 清空输出目录
+    outDir: '<组件名>_v<版本号>',                  // 输出目录名
+    cssCodeSplit: true,                           // CSS 代码分割
+
+    // 库模式配置
+    lib: {
+      entry: './index.js',                        // 入口文件
+      formats: ['umd', 'es'],                     // 输出格式
+      name: '<大写组件名>_v<版本号>',               // UMD 全局变量名
+      fileName: (format) => format === 'es' ? 'es/index.js' : 'index.js'
+    },
+
+    // Rollup 配置
+    rollupOptions: {
+      external: ['vue'],                          // 外部化依赖
+      output: {
+        globals: { vue: 'Vue' },                  // UMD 全局变量映射
+        chunkFileNames: 'es/js/[name]-[hash].js', // chunk 文件名格式
+        assetFileNames: (assetInfo) => {          // 资源文件名格式
+          if (assetInfo.name?.endsWith('.css')) {
+            return 'es/style.css'
+          }
+          return 'es/assets/[name]-[hash][extname]'
+        }
+      }
+    }
+  }
+}
+```
+
+**使用示例**:
+
+```javascript
+import { getConfig } from 'pangu-chart-cli';
+
+export default getConfig({
+  name: 'my-chart',
+  version: '1.0.0',
+  author: 'Your Name',
+  elementConfig: {
+    enable: true,
+    entryFile: 'src/index.vue',
+    configSrc: 'element-plus/theme-chalk/src/mixins/config.scss',
+    namespace: 'MyChart'
+  }
+});
+```
+
+### getBaseConfig(config)
+
+生成基础的 build 配置对象(不含 plugins),用于自定义扩展。
+
+**参数**:
+
+| 参数名    | 类型     | 必填 | 说明                      |
+| --------- | -------- | ---- | ------------------------- |
+| `name`    | `string` | ✓    | package.json 中的组件名称 |
+| `version` | `string` | ✓    | package.json 中的版本号   |
+
+**返回值结构**:
+
+```javascript
+{
+  build: {
+    target: ['chrome94', 'edge94', 'firefox92'],
+    reportCompressedSize: false,
+    emptyOutDir: true,
+    outDir: '<组件名>_v<版本号>',
+    cssCodeSplit: true,
+
+    lib: {
+      entry: './index.js',
+      formats: ['umd', 'es'],
+      name: '<大写组件名>_v<版本号>',
+      fileName: (format) => format === 'es' ? 'es/index.js' : 'index.js'
+    },
+
+    rollupOptions: {
+      external: ['vue'],
+      output: {
+        globals: { vue: 'Vue' },
+        chunkFileNames: 'es/js/[name]-[hash].js',
+        assetFileNames: (assetInfo) => {
+          if (assetInfo.name?.endsWith('.css')) {
+            return 'es/style.css'
+          }
+          return 'es/assets/[name]-[hash][extname]'
+        }
+      }
+    }
+  }
+}
+```
+
+**使用示例**:
+
+```javascript
+import { getBaseConfig } from 'pangu-chart-cli';
+
+const baseConfig = getBaseConfig({
+  name: 'my-chart',
+  version: '1.0.0'
+});
+
+// 自定义扩展
+export default {
+  ...baseConfig,
+  plugins: [
+    /* 自定义插件列表 */
+  ]
+};
+```
+
+### getPackageInfo(config)
+
+获取打包信息(输出目录、UMD name、elementConfig)。
+
+**参数**:
+
+| 参数名          | 类型                | 必填 | 说明                        |
+| --------------- | ------------------- | ---- | --------------------------- |
+| `name`          | `string`            | ✓    | package.json 中的组件名称   |
+| `version`       | `string`            | ✓    | package.json 中的版本号     |
+| `elementConfig` | `boolean \| object` | -    | Element Plus namespace 配置 |
+
+**返回值结构**:
+
+```javascript
+{
+  name: '<大写组件名>_v<版本号>',     // UMD 全局变量名(首字母大写,版本号用_分隔)
+  outDir: '<组件名>_v<版本号>',      // 输出目录名
+  elementConfig: <原始值>            // 传入的 elementConfig 值
+}
+```
+
+**说明**:
+
+- `name` 格式:组件名首字母大写 + `_v` + 版本号(`.` 替换为 `_`)
+  - 例如:`my-chart` v1.0.0 → `My-chart_v1_0_0`
+- `outDir` 格式:组件名 + `_v` + 版本号
+  - 例如:`my-chart` v1.0.0 → `my-chart_v1.0.0`
+
+**使用示例**:
+
+```javascript
+import { getPackageInfo } from 'pangu-chart-cli';
+
+const info = getPackageInfo({
+  name: 'my-chart',
+  version: '1.0.0'
+});
+
+console.log(info);
+// 输出: { name: 'My-chart_v1_0_0', outDir: 'my-chart_v1.0.0', elementConfig: undefined }
+```
+
+## elementConfig 配置详解
+
+`elementConfig` 用于自定义 Element Plus CSS namespace,避免样式冲突。支持三种形态:
+
+### 形态一:false / 不传
+
+**含义**:不启用 namespace 功能。
+
+**默认值**:无(不处理 Element Plus namespace)
+
+**使用场景**:不需要隔离 Element Plus 样式,或组件库不依赖 Element Plus。
+
+```javascript
+getConfig({
+  name: 'my-chart',
+  version: '1.0.0',
+  elementConfig: false
+});
+```
+
+### 形态二:true
+
+**含义**:启用 namespace 功能,使用默认配置。
+
+**默认值**:
+
+| 参数        | 默认值                                              | 说明                               |
+| ----------- | --------------------------------------------------- | ---------------------------------- |
+| `enable`    | `true`                                              | 启用功能                           |
+| `entryFile` | `'src/index.vue'`                                   | Vue 入口文件路径(相对于项目根目录) |
+| `configSrc` | `'element-plus/theme-chalk/src/mixins/config.scss'` | Element Plus SCSS config 文件路径  |
+| `namespace` | `<大写组件名>`                                      | 自动生成(组件名首字母大写)         |
+
+**使用场景**:快速启用 namespace,无需自定义参数。
+
+```javascript
+getConfig({
+  name: 'my-chart',
+  version: '1.0.0',
+  elementConfig: true
+});
+
+// 实际配置:
+// {
+//   enable: true,
+//   entryFile: 'src/index.vue',
+//   configSrc: 'element-plus/theme-chalk/src/mixins/config.scss',
+//   namespace: 'My-chart'
+// }
+```
+
+### 形态三:object(自定义配置)
+
+**含义**:启用 namespace 功能,自定义参数。
+
+**参数说明**:
+
+| 参数        | 类型      | 必填 | 说明                                |
+| ----------- | --------- | ---- | ----------------------------------- |
+| `enable`    | `boolean` | -    | 是否启用(默认:`true`)               |
+| `entryFile` | `string`  | -    | Vue 入口文件路径(支持相对/绝对路径) |
+| `configSrc` | `string`  | -    | Element Plus SCSS config 文件路径   |
+| `namespace` | `string`  | -    | 自定义 namespace 名称               |
+
+**默认值**(未指定参数时):
+
+- `enable`: `true`
+- `entryFile`: `'src/index.vue'`
+- `configSrc`: `'element-plus/theme-chalk/src/mixins/config.scss'`
+- `namespace`: `<大写组件名>`(组件名首字母大写)
+
+**使用场景**:需要自定义入口文件、namespace 名称等参数。
+
+```javascript
+getConfig({
+  name: 'my-chart',
+  version: '1.0.0',
+  elementConfig: {
+    enable: true,
+    entryFile: 'src/components/Chart.vue',
+    configSrc: 'element-plus/theme-chalk/src/mixins/config.scss',
+    namespace: 'MyCustomChart'
+  }
+});
+```
+
+### elementConfig 工作原理
+
+启用 `elementConfig` 后,工具会执行以下操作:
+
+1. **SCSS namespace 注入**:在 Vite 配置中添加 SCSS 预处理器配置,自动注入 `@forward` 语句修改 Element Plus namespace:
+
+   ```scss
+   @forward 'element-plus/theme-chalk/src/mixins/config.scss' with (
+     $namespace: 'MyChart'
+   );
+   ```
+
+2. **Vue 模板包装**:通过 `elementNamespacePlugin` 在入口 Vue 文件的 `<template>` 中自动包装 `<el-config-provider namespace="MyChart">`:
+
+   ```vue
+   <template>
+     <el-config-provider namespace="MyChart">
+       <!-- 原模板内容 -->
+     </el-config-provider>
+   </template>
+
+   <script setup>
+   import { ElConfigProvider } from 'element-plus';
+   </script>
+   ```
+
+3. **避免样式冲突**:所有 Element Plus 组件样式都会使用自定义 namespace,避免与其他 Element Plus 组件库产生样式冲突。
+
+## 项目结构
+
+```
+pangu-chart-cli/
+├── bin/
+│   └── index.js                 # CLI 入口(指向 dist/index.js)
+├── core/
+│   ├── index.js                 # 命令注册(commander)
+│   ├── dev/
+│   │   └── index.js             # dev 命令逻辑
+│   └── build/
+│       └── index.js             # build 命令逻辑
+├── viteConfig/
+│   ├── index.js                 # getConfig API 实现
+│   ├── base.js                  # getBaseConfig/getPackageInfo 实现
+│   ├── default.js               # 默认 Vite 配置模板
+│   └── vite-plugin-element-namespace.js  # Element namespace 插件
+├── index.d.ts                   # TypeScript 类型定义
+├── package.json
+├── rollup.config.js             # Rollup 打包配置
+└── dist/                        # 打包输出目录
+```
+
+## 开发指南
+
+### 本地构建
+
+使用 bun + rollup 进行本地构建:
+
+```bash
+pnpm build
+```
+
+构建流程:
+
+1. `bun ./build/index.js` - 预处理
+2. `rollup --config` - 打包生成 `dist/` 目录
+
+### 发布流程
+
+使用 `standard-version` 管理版本和生成 CHANGELOG:
+
+```bash
+# Patch 版本(1.0.0 -> 1.0.1)
+pnpm release:patch
+
+# Minor 版本(1.0.0 -> 1.1.0)
+pnpm release:minor
+
+# Major 版本(1.0.0 -> 2.0.0)
+pnpm release:major
+
+# Beta 版本(1.0.0 -> 1.0.1-beta.0)
+pnpm release:beta
+```
+
+发布到 npm:
+
+```bash
+npm publish
+```
+
+### 依赖说明
+
+**运行时依赖**:
+
+- `commander` - CLI 框架
+- `chalk` - 终端颜色输出
+- `ora` - 终端加载动画
+- `cross-spawn` - 跨平台进程执行
+- `dayjs` - 时间处理
+- `await-to-js` - 异步错误处理
+- `yann-fs` - 文件系统工具
+
+**开发依赖**:
+
+- `rollup` - 打包工具
+- `vite` - 构建核心(用户项目运行时依赖)
+- `standard-version` - 版本管理
+
+**用户项目需要安装**:
+
+- `vite` - 构建工具
+- `element-plus` - Element Plus 组件库(若使用 elementConfig)
+- `@vitejs/plugin-vue` - Vue 插件
+
+### 常见问题
+
+**Q: Element Plus 未安装时使用 elementConfig 会报错吗?**
+
+A: 会报错。使用 elementConfig 前需确保项目已安装 Element Plus:
+
+```bash
+npm install element-plus
+```
+
+**Q: 开发服务启动后局域网无法访问?**
+
+A: 工具默认监听 `0.0.0.0`,局域网应可访问。请检查防火墙设置或使用 `--host` 参数指定 IP。
+
+**Q: 打包输出目录命名规则?**
+
+A: 输出目录格式为 `<组件名>_v<版本号>`,例如 `my-chart_v1.0.0`。
+
+**Q: UMD 全局变量名命名规则?**
+
+A: UMD name 格式为 `<大写组件名>_v<版本号>`(`.` 替换为 `_`),例如 `My-chart_v1_0_0`。
+
+## License
+
+MIT License
+
+Copyright (c) 2024 Yann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/index.js

@@ -0,0 +1,3 @@
+#! /usr/bin/env node
+
+require('../dist/index.js');

package/dist/build/index.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+"use strict";const t=require("yann-fs").default,i=require("fs").promises,e=require("path"),{getCurrentDir:s,runCommandAsync:a,initEnv:n}=require("../utils"),r=async(t=process.cwd())=>{const s=await i.readdir(t);for(const a of s){const s=e.join(t,a);(await i.stat(s)).isDirectory()?await r(s):(/^\._/.test(a)||/^\.DS/.test(a))&&await i.unlink(s)}};module.exports=async function(){const i=s();await n(i);const o=e.resolve(i,"vite.config.js"),c=e.resolve(i,"vite.config.ts");await t.exists(o)||await t.exists(c)?await a(["build"],{cwd:i}):await a(["build","-c",e.resolve(__dirname,"../viteConfig/default.js")],{cwd:i}),await r(i)};

package/dist/dev/index.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+"use strict";const e=require("path"),s=require("yann-fs").default,{getCurrentDir:i,runDevSpawn:t,initEnv:a}=require("../utils"),n=["dev","--host","0.0.0.0"];module.exports=async function(){const o=i();await a(o);const r=e.resolve(o,"example"),c=e.resolve(r,"package.json");if(await s.exists(c)){const i=e.resolve(r,"vite.config.js"),a=e.resolve(r,"vite.config.ts");await s.exists(i)||await s.exists(a)||n.push("--config",e.resolve(__dirname,"../viteConfig/default.js")),await t(n,{cwd:r})}else{const i=e.resolve(o,"vite.config.js"),a=e.resolve(o,"vite.config.ts");await s.exists(i)||await s.exists(a)||n.push("--config",e.resolve(__dirname,"../viteConfig/default.js")),await t(n,{cwd:o})}};

package/dist/index.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+"use strict";const{program:e}=require("commander"),{version:r}=require("../package.json"),s=require("chalk");e.command("build").alias("b").description("打包").action((async()=>{await require("./build/index.js")()})),e.command("dev").alias("d").description("启动服务").action((async()=>{await require("./dev/index.js")()})),"-v"===process.argv[2]&&(console.log(r),process.exit(1)),e.version(r).parse(process.argv),process.on("uncaughtException",(function(e){console.log(s.bold.red("err："),s.bold.red(e?.message||"异常错误！")),process.exit(1)}));

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+"use strict";const e=require("yann-fs").default,s=require("path"),n=require("dayjs"),o=()=>{let e=process.cwd();for(;e.includes("example");)e=s.resolve(e,"..");return e},r=(e,s=[],n={})=>new Promise((o=>{const r="win32"===process.platform,{enableSudo:t=!1,disableColor:a=!1,cwd:i=process.cwd(),stdio:c="inherit",shell:l=!1,..._}=n;let u=e,E=[...s];a&&r&&!E.includes("--no-color")&&E.push("--no-color"),!r&&t&&(u="sudo",E=[e,...E]);const T={cwd:i,stdio:c,shell:l,..._},p=require("cross-spawn")(u,E,T),d=[],R=[];p.stdout?.on("data",(e=>{d.push(e.toString())})),p.stderr?.on("data",(e=>{R.push(e.toString())})),p.on("error",(s=>{const n=s.message||"命令启动失败";let t="";t="ENOENT"===s.code?`未找到命令 "${e}"，请先安装 ${e}`:"EACCES"===s.code?r?"权限不足！请以管理员身份运行终端":"权限不足！请确认当前用户有执行权限（可尝试 sudo）":`命令启动失败：${n}`,log.err(t),o({success:!1,stdout:"",stderr:n,status:null,message:t,error:s.stack||n})})),p.on("close",(s=>{const n=d.join("").trim(),t=R.join("").trim(),a=0===s;let i="";a?i=`命令执行成功：${e} ${E.join(" ")}`:(i=t.includes("not found")||t.includes("Package")?`未找到目标资源：${t.split("\n")[0]}`:t.includes("EAI_AGAIN")||t.includes("network")||t.includes("ENOTFOUND")?"网络错误：无法连接到服务或镜像源，请检查网络配置":t.includes("EACCES")?r?"权限不足！请以管理员身份运行终端":"权限不足！可尝试启用 sudo":`命令执行失败（退出码：${s}）：${t||"无详细错误信息"}`,log.err(i)),o({success:a,stdout:n,stderr:t,status:s,message:i,error:a?null:t||`退出码：${s}`})}))}));const t=async n=>{const o=s.resolve(n,"public","base.json"),[r,t]=await e.readJson(o);if(r)throw new Error("执行失败，当前图表找不到 base.json 文件");const a=t.version,i=s.resolve(n,"package.json"),[c,l]=await e.readJson(i);if(c)throw new Error("执行失败，当前图表找不到 package.json 文件");const _=l.version,u=function(e,s){0===e.indexOf("v")&&(e=e.slice(1)),0===s.indexOf("v")&&(s=s.slice(1)),e=e.split("."),s=s.split(".");const n=Math.max(e.length,s.length);for(;e.length<n;)e.push("0");for(;s.length<n;)s.push("0");for(let o=0;o<n;o++){const n=parseInt(e[o]),r=parseInt(s[o]);if(n>r)return 1;if(n<r)return-1}return 0}(a,_);let E=a;return 1===u?(E=a,l.version=E,await e.outputJson(i,l,{spaces:2,EOL:"\n"})):-1===u&&(E=_,t.version=E,await e.outputJson(o,t,{spaces:2,EOL:"\n"})),{name:t.name,version:E}};module.exports={getCurrentDir:o,runCommandAsync:async(e,s)=>{await r("vite",e,s)},initEnv:async r=>{r=r||o(),await t(r);const a=s.resolve(r,"package.json"),[i,c]=await e.readJson(a);if(i)throw new Error("执行失败，当前图表找不到 package.json 文件");process.env.VITE_CURRENT_CHART_NAME=c.name,process.env.VITE_CURRENT_CHART_VERSION=c.version,process.env.VITE_CURRENT_CHART_AUTHOR=c.author,process.env.VITE_CURRENT_CHART_ELEMENT_CONFIG="elementConfig"in c?JSON.stringify(c.elementConfig):"false",process.env.VITE_BUILD_CHART_DIR=r,process.env.VITE_BUILD_CHART_TIME=n().format("YYYY-MM-DD HH:mm");const{VITE_CURRENT_BUILD_CHART_NAME_OUT_DIR:l,VITE_CURRENT_BUILD_CHART_NAME:_}=(()=>{const e=c.name.split("/").at(-1);return{VITE_CURRENT_BUILD_CHART_NAME:e.replace(/^\S/,(e=>e.toUpperCase()))+"_v"+c.version.replaceAll(".","_"),VITE_CURRENT_BUILD_CHART_NAME_OUT_DIR:`${e}_v${c.version}`}})();process.env.VITE_CURRENT_BUILD_CHART_NAME=_,process.env.VITE_CURRENT_BUILD_CHART_NAME_OUT_DIR=l},runDevSpawn:async(e,s)=>{await r("vite",e,s)},versionHandle:t};

package/dist/viteConfig/base.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+import e from"@vitejs/plugin-vue";import n from"vite-plugin-compression";import r from"vite-plugin-banner";import{getBaseConfig as o,getPackageInfo as i}from"./index.js";import s from"./vite-plugin-element-namespace.js";import t from"node:path";import"@vue/compiler-sfc";const c=e=>e.replace(/\\/g,"/"),a=()=>{let e=process.cwd();for(;e.includes("example");)e=t.resolve(e,"..");return e},p=(e,n)=>{const r="object"==typeof e&&!Array.isArray(e),o=r&&"enable"in e?e.enable:!!e;if(!o)return{enable:o};const i="src/index.vue",s="element-plus/theme-chalk/src/mixins/config.scss";return{enable:o,entryFile:(e=>t.isAbsolute(e)?c(t.normalize(e)):c(t.resolve(a(),e)))(r&&e?.entryFile||i),configSrc:r&&e?.configSrc||s,namespace:r&&e?.namespace||n}},l=t=>{const c=o(t),{elementConfig:l,name:m}=i(t),u=a(),f=u?u+"/":"",{enable:v,entryFile:d,configSrc:g,namespace:b}=p(l,m),h=[],y={};return v&&(h.push(s({entryFile:d,namespace:b})),y.css={preprocessorOptions:{scss:{additionalData:`@forward '${g}' with (\n  $namespace: '${b}'\n);`}}}),{define:{"process.env":process.env||{}},plugins:[...h,e({isProduction:!0}),n({ext:".gz",deleteOriginFile:!1}),r({outDir:f+c.build.outDir,content:`${t.name} v${t.version} ${t.author?"Author: "+t.author:""} Date: ${process.env.VITE_BUILD_CHART_TIME?process.env.VITE_BUILD_CHART_TIME:Date.now()}`})],server:{host:"0.0.0.0"},...y,build:c.build}};export{l as getConfig};

package/dist/viteConfig/default.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+import{defineConfig as e}from"vite";import{getConfig as i}from"./base.js";import"@vitejs/plugin-vue";import"vite-plugin-compression";import"vite-plugin-banner";import"./index.js";import"./vite-plugin-element-namespace.js";import"@vue/compiler-sfc";import"node:path";var o=e(i({name:process.env.VITE_CURRENT_CHART_NAME,version:process.env.VITE_CURRENT_CHART_VERSION,author:process.env.VITE_CURRENT_CHART_AUTHOR,elementConfig:JSON.parse(process.env.VITE_CURRENT_CHART_ELEMENT_CONFIG)}));export{o as default};

package/dist/viteConfig/entry.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+export{getConfig}from"./base.js";export{getBaseConfig,getPackageInfo}from"./index.js";import"@vitejs/plugin-vue";import"vite-plugin-compression";import"vite-plugin-banner";import"./vite-plugin-element-namespace.js";import"@vue/compiler-sfc";import"node:path";

package/dist/viteConfig/index.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+const e=e=>{const s=e.name.split("/").at(-1);return{name:s.replace(/^\S/,(e=>e.toUpperCase()))+"_v"+e.version.replaceAll(".","_"),outDir:`${s}_v${e.version}`,elementConfig:e.elementConfig}},s=s=>{const{name:t,outDir:n}=e(s);return{build:{target:["chrome94","edge94","firefox92"],reportCompressedSize:!1,emptyOutDir:!0,outDir:n,cssCodeSplit:!0,lib:{entry:"./index.js",formats:["umd","es"],name:t,fileName:e=>"es"===e?"es/index.js":"index.js"},rollupOptions:{external:["vue"],output:{globals:{vue:"Vue"},chunkFileNames:"es/js/[name]-[hash].js",assetFileNames:e=>e.name?.endsWith(".css")?"es/style.css":"es/assets/[name]-[hash][extname]"}}}}};export{s as getBaseConfig,e as getPackageInfo};

package/dist/viteConfig/vite-plugin-element-namespace.js

@@ -0,0 +1,2 @@
+// pangu-chart-cli v1.0.0 by Jaxon
+import{parse as e}from"@vue/compiler-sfc";function t(t){const{entryFile:n,namespace:r}=t;return n&&r?{name:"element-namespace-plugin",transform(t,i){if(i!==n)return t;try{const{descriptor:n}=e(t,{filename:i});if(!n.template)return t;const{newTemplateContent:s,templateModified:o}=function(e,t){const n=/<(el-config-provider|ElConfigProvider)([^>]*?)>/i,r=n.test(e);let i=e,s=!1;if(r){const r=e.match(n),o=r[1],c=r[2];if(!/namespace\s*=\s*["'].*?["']/i.test(c)){const r=c.trim(),l=r?`${r} namespace="${t}"`:`namespace="${t}"`;i=e.replace(n,`<${o} ${l}>`),s=!0}}else i=`\n      <el-config-provider namespace="${t}">\n        ${e}\n      </el-config-provider>\n    `.trim(),s=!0;return{newTemplateContent:i,templateModified:s}}(n.template.content,r);let c=t;return o&&(c=function(e,t){let n=function(e,t){const n=/(<script[\s\S]*?>[\s\S]*?<\/script>)/gi,r=[];let i=e;i=i.replace(n,(e=>(r.push(e),`__SCRIPT_PLACEHOLDER_${r.length-1}__`)));const s=/(<template>)([\s\S]*)(<\/template>)/,o=i.replace(s,`$1\n${t}\n$3`);let c=o;return r.forEach(((e,t)=>{c=c.replace(`__SCRIPT_PLACEHOLDER_${t}__`,e)})),c}(e,t);const r=/import\s+.*?(ElConfigProvider).*?\s+from\s+['"]element-plus['"]/i.test(n);if(r)return n;const i=/<script([^>]*?)>/i,s=n.match(i),o="import { ElConfigProvider } from 'element-plus';\n";if(s){const e=s.index+s[0].length;n=n.substring(0,e)+"\n"+o+n.substring(e)}else n+=`\n\n<script setup>\n${o}<\/script>`;return n}(c,s)),c}catch(e){return console.error("处理命名空间和导入时出错:",e),t}}}:(console.warn("请提供入口文件路径和目标命名空间"),{name:"element-namespace-plugin"})}export{t as default};

package/index.d.ts

@@ -0,0 +1,53 @@
+import type {UserConfig} from "vite";
+
+
+export interface ElementConfigObject {
+    enable?: boolean;
+    entryFile?: string;
+    configSrc?: string;
+    namespace?: string;
+}
+
+export interface BaseConfig{
+    name: string;
+    version: string;
+    author?: string;
+    elementConfig?: boolean | ElementConfigObject;
+}
+
+export interface Result {
+    build: {
+        reportCompressedSize: false,
+        emptyOutDir: true,
+        outDir:string,
+        cssCodeSplit: true,
+        lib: {
+            entry: string, // 设置入口文件
+            formats: string[],
+            name: string, // 起个名字，安装、引入用
+            fileName: ()=>string
+        },
+        },
+        rollupOptions: {
+            // 确保外部化处理那些你不想打包进库的依赖
+            external: string[],
+            output: {
+                // 在 UMD 构建模式下为这些外部化的依赖提供一个全局变量
+                globals: Record<string, string>
+            }
+        }
+}
+
+declare function getBaseConfig(config: BaseConfig): Result;
+declare function getPackageInfo(config: {
+    name: string;
+    version: string;
+    elementConfig?: boolean | ElementConfigObject;
+}) : {
+    name: string;
+    outDir: string;
+    elementConfig?: boolean | ElementConfigObject;
+}
+
+
+declare function getConfig(config: BaseConfig):UserConfig

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "pangu-chart-cli",
+  "version": "1.0.0",
+  "description": "pangu-chart-cli",
+  "bin": {
+    "vcc": "bin/index.js",
+    "vis-chart-cli": "bin/index.js"
+  },
+  "scripts": {
+    "build": "bun ./build/index.js && rollup --config",
+    "release": "standard-version",
+    "release:patch": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:beta": "standard-version --prerelease beta"
+  },
+  "main": "./dist/viteConfig/entry.js",
+  "module": "./dist/viteConfig/entry.js",
+  "types": "./index.d.ts",
+  "dependencies": {
+    "await-to-js": "^3.0.0",
+    "chalk": "^4.1.2",
+    "commander": "^10.0.1",
+    "cross-spawn": "^7.0.6",
+    "dayjs": "^1.11.11",
+    "ora": "^5.4.1",
+    "yann-fs": "^1.6.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^18.1.0",
+    "@rollup/plugin-json": "^6.1.0",
+    "prettier": "^3.6.2",
+    "rollup": "^2.79.1",
+    "rollup-plugin-babel": "^4.4.0",
+    "rollup-plugin-banner": "^0.2.1",
+    "rollup-plugin-node-resolve": "^5.2.0",
+    "rollup-plugin-terser": "^7.0.2",
+    "standard-version": "^9.5.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "pangu-chart-cli",
+    "vcc",
+    "vis-chart-cli"
+  ],
+  "author": "Jaxon",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "bin",
+    "index.d.ts"
+  ]
+}