neo-cmp-cli 1.2.9 → 1.2.10

package/README.md

@@ -13,7 +13,10 @@ neo-cmp-cli 是 Neo 自定义组件开发工具，基于 [AKFun](https://github.
 ### 模板类型（neo init 可选）
 - **React 模板**: [react-custom-cmp-template](https://github.com/wibetter/react-custom-cmp-template)
 - **React + TS 模板**: [react-ts-custom-cmp-template](https://github.com/wibetter/react-ts-custom-cmp-template)
-- **Vue2 模板**: [vue2-custom-cmp-template](https://github.com/wibetter/vue2-custom-cmp-template)
+- **Antd 模板**: [antd-custom-cmp-template](https://github.com/wibetter/antd-custom-cmp-template) Antd 自定义组件
+- **Neo 模板**: [neo-custom-cmp-template](https://github.com/wibetter/neo-custom-cmp-template) 支持使用 Neo 实体数据源（内置 Neo Open API 使用示例）
+- **Echarts 模板**: [echarts-custom-cmp-template](https://github.com/wibetter/echarts-custom-cmp-template) Echarts 图表自定义组件
+- **Vue2 模板**: [vue2-custom-cmp-template](https://github.com/wibetter/vue2-custom-cmp-template) Vue2.0 自定义组件
 
 ## 快速开始
 
@@ -68,11 +71,24 @@ npm run publish2oss
 ```
 
 ## 常用命令
-- **neo init**: 交互式创建项目（支持 -t、--name）。
+- **neo init**: 交互式创建自定义组件（支持 -t、--name）。
 - **neo preview**: 本地预览自定义组件内容，默认支持热更新与接口代理。
-- **neo linkDebug**: 外链调试模式，在平台端页面设计器中联调组件。
+- **neo linkDebug**: 外链调试模式，在平台端页面设计器中调试自定义组件。
 - **neo build2lib**: 产出 UMD/ESM 库文件（可配置）。
-- **neo publish2oss**: 构建并上传到对象存储（可自定义配置）。
+- **neo publish2oss**: 构建并上传到对象存储（可自定义配置对象存储）。
+
+## 内置自动识别自定义组件
+- **自动生成入口配置**: 当 `entry` 未配置时，会自动从 `src/components` 扫描并识别自定义组件，`src/components` 下的子目录名称作为自定义组件的 cmpType，并以其目录下的 `.ts/.tsx/.js/.jsx` 结尾的文件作为组件内容文件，model.[tj]s 作为模型内容文件；
+- **自动生成相关注册文件并注入**: 自动生成自定义组件注册文件和模型注册文件，并注入到构建脚本中，无需用户关注 [neo-register](https://www.npmjs.com/package/neo-register)。
+
+## 发布到对象存储（OSS）
+执行 `npm run publish2oss` 即可构建并上传到对象存储。发布前请确保：
+- **package.json 的 name 唯一**
+- **version 不重复**
+- 已按需配置对象存储参数（支持自定义）
+
+支持发布指定自定义组件：
+执行 `npm run publish2oss --cmpType=xxCmp`
 
 ## 配置说明（neo.config.js）
 neo-cmp-cli 默认提供完整配置；如需自定义，使用 `neo config init` 生成 `neo.config.js` 并按需修改。
@@ -222,15 +238,5 @@ module.exports = {
 }
 ```
 
-## 多页面与模板
-- **多页面入口**: 当 `entry` 仅配置一个且对应文件不存在时，会自动从 `src/pages` 扫描以 `.ts/.tsx/.js/.jsx` 结尾的文件作为入口，匹配同名 HTML 作为模板。
-- **模板选择**: 优先使用 `./src/index.html`；不存在时使用内置默认模板。多页面时若存在同名 HTML，将其作为页面模板。
-
-## 发布到对象存储（OSS）
-执行 `npm run publish2oss` 即可构建并上传到对象存储。发布前请确保：
-- **package.json 的 name 唯一**
-- **version 不重复**
-- 已按需配置对象存储参数（支持自定义）
-
 ---
 如需更多细节与高级用法，请参考模板项目与源码注释。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neo-cmp-cli",
-  "version": "1.2.9",
+  "version": "1.2.10",
   "description": "前端脚手架：自定义组件开发工具，支持react 和 vue2.0技术栈。",
   "keywords": [
     "neo-cli",

package/src/cmpUtils/getEntries.js

@@ -8,7 +8,7 @@ const { resolveToCurrentRoot } = require('../utils/pathUtils');
  * @param {*} defaultComponentsDir 默认组件目录
  * @returns 组件入口文件
  */
-module.exports = (defaultComponentsDir = './src/components') => {
+module.exports = (defaultComponentsDir = './src/components', cmpType) => {
   const widgetEntries = {};
   const linkDebugEntries = {
     index: []
@@ -24,7 +24,13 @@ module.exports = (defaultComponentsDir = './src/components') => {
 
   try {
     // 读取指定目录下的所有文件
-    const widgetDirs = fs.readdirSync(componentsBaseDir);
+    let widgetDirs = [];
+    if (cmpType) {
+      // 如果传入了 cmpType，则只读取指定组件目录
+      widgetDirs = [cmpType];
+    } else {
+      widgetDirs = fs.readdirSync(componentsBaseDir);
+    }
 
     // 遍历所有目录
     widgetDirs.forEach((dir) => {

package/src/cmpUtils/getEntriesWithAutoRegister.js

@@ -9,7 +9,7 @@ const getCmpModelRegister = require('./getCmpModelRegister');
  * @param {*} defaultComponentsDir 默认组件目录
  * @returns 组件入口文件
  */
-module.exports = (defaultComponentsDir = './src/components') => {
+module.exports = (defaultComponentsDir = './src/components', cmpType) => {
   const widgetEntries = {};
   const linkDebugEntries = {
     index: []
@@ -31,7 +31,13 @@ module.exports = (defaultComponentsDir = './src/components') => {
 
   try {
     // 读取指定目录下的所有文件
-    const widgetDirs = fs.readdirSync(componentsBaseDir);
+    let widgetDirs = [];
+    if (cmpType) {
+      // 如果传入了 cmpType，则只读取指定组件目录
+      widgetDirs = [cmpType];
+    } else {
+      widgetDirs = fs.readdirSync(componentsBaseDir);
+    }
 
     // 遍历所有目录
     widgetDirs.forEach((dir) => {

package/src/cmpUtils/updatePublishLog.js

@@ -0,0 +1,33 @@
+const fs = require('fs');
+const path = require('path');
+const _ = require('lodash');
+const { resolveToCurrentRoot } = require('../utils/pathUtils');
+const getCmpRegister = require('./getCmpRegister');
+const getCmpModelRegister = require('./getCmpModelRegister');
+/**
+ * 更新发布日志
+ */
+module.exports = (curHistoryData) => {
+  // 创建存放 cli 的临时目录
+  const cliTempDir = resolveToCurrentRoot('./.neo-cli');
+  if (!fs.existsSync(cliTempDir)) {
+    fs.mkdirSync(cliTempDir);
+  }
+
+  const historyFile = `${cliTempDir}/history.json`;
+  let historyData = {};
+  if (fs.existsSync(historyFile)) {
+    // 读取历史文件
+    try {
+      historyData = JSON.parse(fs.readFileSync(historyFile, 'utf8'));
+    } catch (error) {
+      console.error('读取历史文件失败:', error);
+      historyData = {};
+    }
+  }
+  const historyKey = new Date().toString();
+  historyData[historyKey] = curHistoryData;
+
+  // 更新历史文件
+  fs.writeFileSync(historyFile, JSON.stringify(historyData, null, 2));
+};

package/src/module/index.js

@@ -232,16 +232,20 @@ yargs
     }
   )
   .command(
-    'publish2oss',
+    'publish2oss [options]',
     '发布到oss',
     (yargs) => {
       yargs
         .reset()
-        .usage(titleTip('Usage') + ': $0 build2lib')
+        .usage(titleTip('Usage') + ': $0 publish2oss [options]')
+        .option('cmpType', {
+          alias: 't',
+          describe: '自定义组件名称'
+        })
         .alias('h', 'help');
     },
     (argv) => {
-      mainAction.publish2oss(); // 构建并发布脚本到oss
+      mainAction.publish2oss(argv.cmpType); // 构建并发布脚本到oss
     }
   )
   .command(

package/src/module/main.js

@@ -1,5 +1,4 @@
 const akfun = require('akfun');
-const path = require('path');
 const _ = require('lodash');
 const neoInit = require('./neoInit');
 const neoInitByCopy = require('./neoInitByCopy');
@@ -180,7 +179,7 @@ module.exports = {
 
     akfun.build('lib', curConfig, consoleTag);
   }, // 构建脚本：生产环境
-  publish2oss: () => {
+  publish2oss: (cmpType) => {
     // 将 publish2oss 相关配置设置给 build2lib
     const publish2ossConfig = curConfig.publish2oss;
     curConfig.build2lib = Object.assign(curConfig.build2lib, publish2ossConfig);
@@ -193,12 +192,12 @@ module.exports = {
       let entries = {};
       if (curConfig.build2lib.disableAutoRegister) {
         // disableAutoRegister 为 true 时，仅自动生成入口文件（不自动注册）
-        const { widgetEntries, cmpTypes } = getEntries(curConfig.componentsDir);
+        const { widgetEntries, cmpTypes } = getEntries(curConfig.componentsDir, cmpType);
         entries = widgetEntries;
         curCmpTypes = cmpTypes;
       } else {
         // 自动生成入口文件（并自动创建对应的注册文件）
-        const { widgetEntries, cmpTypes } = getEntriesWithAutoRegister(curConfig.componentsDir);
+        const { widgetEntries, cmpTypes } = getEntriesWithAutoRegister(curConfig.componentsDir, cmpType);
         entries = widgetEntries;
         curCmpTypes = cmpTypes;
       }

package/src/oss/publish2oss.js

@@ -3,6 +3,7 @@ const fs = require('fs');
 const path = require('path');
 const { catchCurPackageJson } = require('../utils/pathUtils');
 const getConfigObj = require('../utils/getConfigObj');
+const updatePublishLog = require('../cmpUtils/updatePublishLog');
 
 // 获取当前项目的package文件
 const currentPackageJsonDir = catchCurPackageJson();
@@ -94,6 +95,8 @@ const publish2oss = (ossType, ossConfig, assetsRoot, fileExtensions = ['.js', '.
       const widgetFilesMap = getResultFilesByWidgetName(results);
       if (widgetFilesMap) {
         console.info('上传至 OSS 的文件信息：\n', widgetFilesMap);
+        // 更新发布日志
+        updatePublishLog(widgetFilesMap);
       }
     })
     .catch((error) => {

package/src/template/neo-custom-cmp-template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neo-custom-cmp-template",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "neo自定义组件模板（react&ts技术栈）",
   "keywords": [
     "自定义组件模板",

package/src/template/neo-custom-cmp-template/src/components/contact-form/README.md

@@ -1,6 +1,6 @@
 # 联系人表单组件
-
 基于 Ant Design 的联系人表单组件，支持姓名、所有人、业务类型、所属部门、手机号等字段的输入和提交。
+【备注】使用 cursor 生成的自定义组件。  
 
 ## 功能特性
 

package/src/template/neo-custom-cmp-template/src/components/xobject-table/README.md

@@ -1,11 +1,6 @@
 # XObject 数据表格组件
 基于 XObject 的数据表格组件，支持增删改查操作，表格列根据 `getXObjectDesc` 返回的 fields 动态生成。
 
-- 对应的生成指令
-```
-@utils/ 请根据这里提供的方法，参照 @contact-card-list/ 使用 antd 组件 写一个 表格组件，展示属性配置 xobject 对应的 业务数据列表，支持创建、编辑、删除操作。其中表格展示的列 根据 getXObjectDesc 返回的 fields 生成，表格的 Title 根据 其返回的 label 显示。另外 请使用 propsSchemaCreator 生成自定义组件的属性配置，支持 xobject 选择配置，其中 xobject 的选项 使用 getEntityList获取。
-```
-
 ## 功能特性
 
 - 📊 **动态表格列**：根据 XObject 字段描述自动生成表格列

package/src/template/neo-custom-cmp-template/src/components/xobject-table/index.tsx

@@ -142,6 +142,14 @@ export default class XObjectTable extends React.PureComponent<
       entityTypeList: [],
     };
 
+    if (this.props.xObjectApiKey) {
+      // 初始化字段列表、加载数据和业务类型列表
+      this.loadFieldList().then(() => {
+        this.loadData();
+      });
+      this.getEntityTypeList();
+    }
+
     // 绑定方法上下文
     this.loadData = this.loadData.bind(this);
     this.loadFieldList = this.loadFieldList.bind(this);
@@ -153,18 +161,6 @@ export default class XObjectTable extends React.PureComponent<
     this.handleTableChange = this.handleTableChange.bind(this);
   }
 
-  /**
-   * 组件挂载后执行
-   * 初始化字段列表、加载数据和业务类型列表
-   */
-  async componentDidMount() {
-    if (this.props.xObjectApiKey) {
-      await this.loadFieldList();
-      this.loadData();
-      this.getEntityTypeList();
-    }
-  }
-
   /**
    * 获取业务类型列表
    * 用于下拉选择框的选项数据

package/src/template/neo-custom-cmp-template/src/components/xobject-table-v2/README.md

@@ -1,11 +1,6 @@
 # XObject 数据表格组件
 基于 XObject 的数据表格组件，支持增删改查操作，表格列根据 `getXObjectDesc` 返回的 fields 动态生成。
 
-- 对应的生成指令
-```
-@utils/ 请根据这里提供的方法，参照 @contact-card-list/ 使用 antd 组件 写一个 表格组件，展示属性配置 xobject 对应的 业务数据列表，支持创建、编辑、删除操作。其中表格展示的列 根据 getXObjectDesc 返回的 fields 生成，表格的 Title 根据 其返回的 label 显示。另外 请使用 propsSchemaCreator 生成自定义组件的属性配置，支持 xobject 选择配置，其中 xobject 的选项 使用 getEntityList获取。
-```
-
 ## 功能特性
 
 - 📊 **动态表格列**：根据 XObject 字段描述自动生成表格列

package/src/template/neo-custom-cmp-template/src/components/xobject-table-v2/index.tsx

@@ -136,6 +136,14 @@ export default class XObjectTable extends React.PureComponent<
       entityTypeList: [],
     };
 
+    if (this.props.xObjectApiKey) {
+      // 初始化字段列表、加载数据和业务类型列表
+      this.loadFieldList().then(() => {
+        this.loadData();
+      });
+      this.getEntityTypeList();
+    }
+
     // 绑定方法上下文
     this.loadData = this.loadData.bind(this);
     this.loadFieldList = this.loadFieldList.bind(this);
@@ -147,18 +155,6 @@ export default class XObjectTable extends React.PureComponent<
     this.handleTableChange = this.handleTableChange.bind(this);
   }
 
-  /**
-   * 组件挂载后执行
-   * 初始化字段列表、加载数据和业务类型列表
-   */
-  async componentDidMount() {
-    if (this.props.xObjectApiKey) {
-      await this.loadFieldList();
-      this.loadData();
-      await this.getEntityTypeList();
-    }
-  }
-
   /**
    * 获取业务类型列表
    * 用于下拉选择框的选项数据