zero-ai 0.3.25

package/src/epic/ai.unified.fn.fn.error.code.js

@@ -0,0 +1,114 @@
+/**
+ * ## `Ec.E`
+ *
+ * ### 1. 基本介绍
+ *
+ * 该类为错误信息定义专用类，方法名采用`fn<Code>`的方式执行最终输出的错误信息内容。通常使用下边代码：
+ *
+ * ```js
+ * // 第一种调用方法：第一参直接是错误代码
+ * Ec.fxError(10001, arg1, arg2);
+ *
+ * // 第二种调用方法：第一参是Boolean值，true就输出，第二参是错误代码
+ * const checked = true;
+ * Ec.fxError(checked, 10001, arg1, arg2);
+ *
+ * // 第三种调用方法：第一参是Function，执行后结果为true就输出，第二参是错误代码
+ * const fnChecked = () => true;
+ * Ec.fxError(fnChecked, 10001, arg1, arg2);
+ * ```
+ *
+ * ### 2. 错误代码表
+ *
+ * |代码|参数表|含义|
+ * |---|---|:---|
+ * |10001|`arg,type`|输入参数类型不匹配。|
+ * |10002|`arg,type,expected`|「带期望」输入参数和期望参数不匹配。|
+ * |10003|`fileType`|文件类型无法被解析。|
+ * |10004|`command`|无法识别命令名，不在可解析的命令中。|
+ * |10005|`command,expected`|「带期望」输入的命令不在期望的命令列表中。|
+ * |10006|`arg`|命令执行中丢失了必须的参数。|
+ * |10007|`path`|输入的目录不存在，或者输入路径并不是一个目录。|
+ * |10008|`path`|目录不存在，或输入路径是一个文件。|
+ * |10009|`path`|路径直接不存在，不论目录还是文件都不存在。|
+ * |10010|`projects`|系统检测到两个或两个以上的项目目录，系统无法定位操作项目环境。|
+ * |10011|`config`|「后端」配置数据中丢失了`api`属性值。|
+ * |10012|`member,clazz`|「后端」在查找的`clazz`类名中无法找到（成员变量/成员函数）`member`。|
+ * |10013|`lineType`|工具无法分析行类型，输入的文件内容不符合Zero Ai的基本规范，无法解析源代码。|
+ * |10014|`pkg`|「后端」系统找到了超过两个以上的`package`语句，这个在定义过程中是非法的，不可连续执行。|
+ * |10015|`method,clazz`|「后端」在查找的`clazz`类名中找到了重复的（成员函数/成员变量）`method`，所以非法。|
+ * |10016|`command`|「前端」Zero UI规范错误，不可执行当前命令。|
+ * |10017|`root`|「前端」Zero项目的目录并非一个合法的项目目录，请定位到合法的项目目录中。|
+ * |10018|`resource`|「前端」资源文件绑定过程中出现了资源错误，请检查环境或执行命令。|
+ * |10019|`root`|「前端」当前命令只能在项目根目录中执行（带有package.json文件），其他目录不可执行该方法。|
+ * |10020|`menuData`|「前端」当前菜单数据必须是一个合法的Array类型，当前类型不对。|
+ * |10021|`field,value`|条件`field=value`引起了重复数据记录，导致不匹配UK规范，检查重复数据专用错误。|
+ * |10022|`root`|「前端/后端」无法定位项目的根目录，不可执行项目专用类命令。|
+ * |10023|`folder`|「前端」初始化项目时检测到输入的文件路径是一个非空目录，不可执行Zero AI的初始化。|
+ * |10024|`path`|当前操作和输入的路径冲突，不可在路径中执行操作指令。|
+ * |10025|`configKey`|「前端」配置项主键丢失了核心配置，在生成前端Web组件时出现了规范冲突。|
+ * |10026|`path`|「前端」输入路径非法，不在支持的Zero Ui专用路径规范中。|
+ * |10027|`modulePath`|「前端」输入路径必须是`<module>/<page>`格式，当前路径并非该格式，和规范冲突。|
+ * |10028|`arg`|「前端」模块参数不在枚举值中，必须是四者之一：`FORM, FILTER, HALF, EDIT`。|
+ * |10029|`zt`|「带期望」环境变量缺失或者格式不对，必须是`<module>/<page>`格式。|
+ * |10030|`arg, key`|「开发专用」方法要求资源文件中必须包含`key`属性，当前`key`属性值不对。|
+ * |10031|`id`|「开发专用」当前HTML按钮元素要求`btn`前缀，输入前缀不合法。|
+ * |10032|`platform`|操作系统不支持当前命令，或者该操作系统平台中还未实现该命令的执行逻辑。|
+ * |10033|`path`|当前路径不符合Zero专用规范（基础Java/Maven规范）。|
+ * |10034|`path`|当前路径不符合Ox平台专用规范。|
+ *
+ * ### 3. 规范
+ *
+ * #### 3.1. Zero规范
+ *
+ * #### 3.2. Ox规范
+ *
+ * @class E
+ */
+module.exports = {
+    // 基础
+    fn10001: (arg, type) => `[AI-10001] Argument must be '${type}', but now it's '${arg}'`,
+    fn10002: (arg, type, expected) => `[AI-10002] Argument must be in (${expected}), but now it's '${arg}' of '${type}'`,
+
+    // 命令
+    fn10003: (fileType) => `[AI-10003] The fileType='${fileType}' is unknown and could not found parser`,
+    fn10004: (command) => `[AI-10004] The executor of command '${command}' could not be found`,
+    fn10005: (command = "未输入", expected) => `[AI-10005] The command '${command}' could not be found, expected '${expected}'`,
+    fn10006: (arg) => `[AI-10006] The command missed required arguments: '${arg}'`,
+
+    // 路径
+    fn10007: (path) => `[AI-10007] The file '${path}' does not exist or it's a directory.`,
+    fn10008: (path) => `[AI-10008] The directory '${path}' does not exist or it's a file.`,
+    fn10009: (path) => `[AI-10009] The path '${path}' does not exist.`,
+
+    // 后端
+    fn10010: (projects = []) => `[AI-10010] The tool detect more than one project folders, found '${projects.length}', please switch.`,
+    fn10011: (config) => `[AI-10011] 'api' attribute has been missed in current config ${JSON.stringify(config)}`,
+    fn10012: (member, clazz) => `[AI-10012] Duplicated member '${member}' found in class '${clazz}', please check.`,
+    fn10013: (lineType) => `[AI-10013] Zero system could not analyze the code line type, type = ${lineType} is Unknown`,
+    fn10014: (pkg) => `[AI-10014] More than one 'package' sentence found.${JSON.stringify(pkg)}`,
+    fn10015: (method, clazz) => `[AI-10015] Duplicated method '${method}' found in class '${clazz}', please check.`,
+
+    // 前端
+    fn10016: (command) => `[AI-10016] Zero UI specification wrong, you could not execute in '${command}'`,
+    fn10017: (root) => `[AI-10017] Current folder '${root}' is not project folder, please switch to project root directory`,
+    fn10018: (resource) => `[AI-10018] Zero Resource config file missing '${resource}', please check.`,
+    fn10019: (root) => `[AI-10019] This command could run in project root folder only, current folder = ${root}`,
+    fn10020: (menuData) => `[AI-10020] The menu data file must be json format with 'data' (Array) node, current = ${menuData}`,
+    fn10021: (field, value) => `[AI-10021] The condition '${field} = ${value}' hit duplicated record in your file.`,
+    fn10022: (root) => `[AI-10022] Could not find root folder of current project. ${root}`,
+    fn10023: (folder) => `[AI-10023] Initialized folder must be empty, current ${folder} is invalid`,
+    fn10024: (path) => `[AI-10024] This operation is not allowed for current path ${path}`,
+    fn10025: (configKey) => `[AI-10025] Web control initialized require "actual.data" must be string, current:${configKey}`,
+    fn10026: (path) => `[AI-10026] The path is invalid, ${path}, system support one of ".", "src/components/xxx", "xxx".`,
+    fn10027: (modulePath) => `[AI-10027] The path must be formatted with "<module>/<page>", could not be others, current = ${modulePath}`,
+    fn10028: (arg) => `[AI-10028] The "module" parameter must be one of "FORM", "FILTER", "HALF", "EDIT" values. current = ${arg}`,
+    fn10029: (zt, name) => `[AI-10029] [DEV] You'll use development command, please set "${name}" environment first, current = ${zt}. React format = "<module>/<page>", Java for other.`,
+    fn10030: (arg, key) => `[AI-10030] [DEV] This method require "${key}" in your resource file, but current "${key}" = ${arg}`,
+    fn10031: (id) => `[AI-10031] [DEV] Button key must start with "btn", current ${id}`,
+    fn10032: (platform) => `[AI-10032] This api is not implemented in current platform os.platform() -> '${platform}'`,
+    fn10033: (path) => `[AI-10033] (Zero) Current path '${path}' is not correct Zero work folder under specification`,
+    fn10034: (path) => `[AI-10034] (Ox) Current path '${path}' is not correct Ox work folder`,
+    fn10035: (path) => `[AI-10035] (Mod) The "initialize.json" configuration file has been missed in '${path}'`,
+    fn10036: (mode) => `[AI-10036] (Mod) The mode must be in "REPLACE, APPEND", could not been parsed: ${mode}`,
+};

package/src/epic/ai.unified.fn.is.decision.js

@@ -0,0 +1,20 @@
+const fs = require('fs');
+const U = require("underscore");
+const isFile = (path) => {
+    if (fs.existsSync(path)) {
+        return fs.statSync(path).isFile();
+    }
+};
+const isDirectory = (path) => {
+    if (fs.existsSync(path)) {
+        return fs.statSync(path).isDirectory();
+    }
+};
+const isExist = (path) => fs.existsSync(path);
+
+module.exports = {
+    isExist,
+    isFile,
+    isDirectory,
+    isFunction: (input) => U.isFunction(input),
+}

package/src/epic/ai.unified.fn.sorter.element.js

@@ -0,0 +1,26 @@
+const sortString = (left = "", right = "", asc = true) => {
+    const minLen = Math.max(left.length, right.length);
+    let order = 0;
+    for (let idx = 0; idx < minLen; idx++) {
+        let leftCode = left.charCodeAt(idx);
+        let rightCode = right.charCodeAt(idx);
+        // 空白的处理
+        if (leftCode !== rightCode) {
+            // 修正长度不等的时候的基础算法
+            if (isNaN(leftCode)) leftCode = 0;
+            if (isNaN(rightCode)) rightCode = 0;
+            if (asc) {
+                order = leftCode - rightCode;
+            } else {
+                order = rightCode - leftCode;
+            }
+            break;
+        }
+    }
+    return order;
+};
+
+module.exports = {
+    sorterSAsc: (left, right) => sortString(left, right, true),
+    sorterSDesc: (left, right) => sortString(left, right, false),
+}

package/src/epic/index.js

@@ -0,0 +1,216 @@
+const func_interface_io = require('./ai.export.interface.io');
+const func_interface_util = require("./ai.export.interface.util");
+const func_interface_string = require('./ai.export.interface.fn.string');
+
+const func_impl_parse = require('./ai.export.impl.fn.parse');
+const func_impl_seek = require("./ai.export.impl.fn.seek");
+
+const func_impl_excel = require('./ai.economy.impl.fn.excel');
+const func_impl_plugin = require('./ai.economy.impl.fn.plugin');
+const func_impl_react = require('./ai.economy.impl.fn.react');
+const func_impl_java = require('./ai.economy.impl.fn.java');
+const func_impl_execute = require('./ai.economy.impl.fn.execute');
+const func_impl_json = require('./ai.economy.impl.fn.json');
+
+const exported = {
+    ...func_interface_io,
+    ...func_interface_util,
+    ...func_interface_string,
+
+    ...func_impl_parse,
+    ...func_impl_seek,
+
+    ...func_impl_execute,
+    ...func_impl_excel,
+    ...func_impl_react,
+    ...func_impl_plugin,
+    ...func_impl_java,
+    ...func_impl_json,
+};
+/**
+ * @overview
+ *
+ * # Zero Ai研发文档
+ *
+ * 该文档提供给研发人员直接研发下列工具专用，最新版本`0.3.2`。
+ *
+ * ## 1. 命令清单
+ *
+ * * `ai xxx`：基础命令工具。
+ * * `aj xxx`：界面工具集。
+ *
+ * ## 2. Epic使用方法
+ *
+ * ```js
+ * const Ec = require('./epic');
+ * // Ec.xxx 调用全程Api
+ * ```
+ *
+ * ## 3. 命令表
+ *
+ * ### 3.1. 标准命令
+ *
+ * |命令执行|含义|
+ * |---|:---|
+ * |ai csv|读取数据文件中的Array数组数据转换成csv的文件格式并输出。|
+ * |ai data|专用数据生成器，可生成`Object/Array`两种数据格式。|
+ * |ai key|为输入数据中的Array或Object追加`UUID`格式的字段，字段可配置，默认为`field = key`属性。|
+ * |ai uk|检查输入数据中是否包含了`field1,field2,field3`属性中的重复数据，直接输出结果。|
+ * |ai uuid|随机生成一定数量的UUID字符串，并且拷贝到剪切板中（MacOs）。|
+ * |ai init|「前端」生成项目的初始化代码骨架。|
+ *
+ * ### 3.2. Zero命令
+ *
+ * |命令执行|含义|
+ * |---|:---|
+ * |aj icomplex|「模块」生成`ExListComplex`专用模块。|
+ * |aj iform|「组件」生成`ExForm`专用组件。|
+ * |aj jperm|「后端」生成权限专用的Excel数据文件。|
+ * |aj jplugin|「后端」针对新建的Maven项目执行Ox中集成项目的初始化代码骨架。|
+ * |aj jinit|「后端」生成项目的初始化代码骨架。|
+ *
+ */
+/**
+ * ## ai命令
+ *
+ * ### 1. 基本使用
+ *
+ * ai命令的专用语法如下：
+ *
+ * ```shell
+ * ai <command> [options1|options2|options3...]
+ * ```
+ *
+ * ### 2. 命令列表
+ *
+ * |命令执行|含义|
+ * |---|:---|
+ * |ai csv|读取数据文件中的Array数组数据转换成csv的文件格式并输出。|
+ * |ai data|专用数据生成器，可生成`Object/Array`两种数据格式。|
+ * |ai key|为输入数据中的Array或Object追加`UUID`格式的字段，字段可配置，默认为`field = key`属性。|
+ * |ai uk|检查输入数据中是否包含了`field1,field2,field3`属性中的重复数据，直接输出结果。|
+ * |ai uuid|随机生成一定数量的UUID字符串，并且拷贝到剪切板中（MacOs）。|
+ *
+ * ### 3. 数据通用格式
+ *
+ * **带data节点**
+ *
+ * ```json
+ * {
+ *     "data": [
+ *          {
+ *              "name": "Lang1",
+ *              "email": "lang.yu1@hpe.com"
+ *          },
+ *          {
+ *              "name": "Lang2",
+ *              "email": "lang.yu2@hpe.com"
+ *          }
+ *     ]
+ * }
+ * ```
+ *
+ * **直接格式**
+ *
+ * ```json
+ * [
+ *      {
+ *          "name": "Lang1",
+ *          "email": "lang.yu1@hpe.com"
+ *      },
+ *      {
+ *          "name": "Lang2",
+ *          "email": "lang.yu2@hpe.com"
+ *      }
+ * ]
+ * ```
+ *
+ * @module ai
+ */
+/**
+ * ## aj命令
+ *
+ * ### 1. 基本使用
+ *
+ * aj命令的专用语法如下：
+ *
+ * ```shell
+ * aj <command> [options1|options2|options3...]
+ * ```
+ *
+ * ### 2. 命令列表
+ *
+ * |命令执行|含义|
+ * |---|:---|
+ * |aj icomplex|「模块」生成`ExListComplex`专用模块。|
+ * |aj iform|「组件」生成`ExForm`专用组件。|
+ * |aj jperm|「后端」生成权限专用的Excel数据文件。|
+ *
+ * ### 3. 标准化配置
+ *
+ * ```js
+ * {
+ *      module: 'ZT环境变量设置的模块',
+ *      language: 'Z_LANGUAGE语言环境变量设置，默认「cn」',
+ *      pathRoot: '系统根据执行目录计算的当前项目根目录',
+ *      pathResource: '资源目录',
+ *      pathUi: '生成代码目录',
+ *      namespace: 'Cab.json中所需的名空间值',
+ *      input: {
+ *          params: {
+ *              MODULE: '当前模块的文字描述名称',
+ *              API: '构造标准接口`/api/xxx`的RESTful接口专用路径替换部分。',
+ *              IDENTIFIER: '模型的统一标识符，最终会绑定到identifier中。'
+ *          },
+ *          tpl: {
+ *              type: '使用的模板tpl文件目录，cab/下的目录名',
+ *              source: '「单文件」单文件的拷贝源',
+ *              target: '「单文件」单文件的目标拷贝文件'
+ *          }
+ *      },
+ *      runtime: {
+ *          namespaceFile: 'Cab.json文件生成路径',
+ *          resource: '资源文件的根目录',
+ *          resourceFiles: {
+ *              'fileName1': '资源文件地址，json后缀，模板则是fileName1.tpl文件',
+ *              'fileName2': '......'
+ *          },
+ *          ui: '代码文件根目录',
+ *          uiFiles: {
+ *              'fileName1': '代码文件地址，js后缀，模板则是fileName1.tpl文件',
+ *              'fileName2': '......'
+ *          }
+ *      }
+ * }
+ * ```
+ *
+ *
+ * ### 4. 标准化模板参数
+ *
+ * > `tpl`文件中替换的部分会使用配置文件中的参数来替换。
+ *
+ * |参数|替换部分|含义|
+ * |:---|---|:---|
+ * |MODULE|`#MODULE#`|当前模块的文字描述名称。|
+ * |API|`#API#`|构造标准接口`/api/xxx`的RESTful接口专用路径替换部分。|
+ * |IDENTIFIER|`#IDENTIFIER#`|模型的统一标识符，最终会绑定到identifier中。|
+ * |NAME|`#NAME#`|绑定文件设定，直接赋值`input.params.NAME = tpl.target`生成单文件专用。|
+ * |SIGMA|`#SIGMA`|SIGMA统一标识符，用于标识租户、应用。|
+ * |ROLE_ID|`#ROLE_ID#`|操作的角色ID。|
+ * |PREFIX|无|生成文件专用参数，不在模板中。|
+ * |SHEET|无|工作专用的Sheet名，不在模板中。|
+ *
+ *
+ * @module aj
+ */
+/**
+ * ## 调试专用
+ *
+ * @module _debug
+ */
+/**
+ * ## 研发专用
+ *
+ * @module _epic
+ */
+module.exports = exported;

package/src/epic/zero.__.fn.find.util.js

@@ -0,0 +1,37 @@
+const os = require("os");
+const _V = require('./zero.__.v.constant');
+
+const findTrace = (path = "") => {
+    const folderTrace = path.split(_V.FILE_DELIMITER).filter(each => '' !== each);
+    const folderInfo = [];
+    folderTrace.forEach((trace, index) => {
+        const formatted = `${_V.FILE_DELIMITER}${trace}`;
+        const previous = folderInfo[index - 1];
+        let item = null;
+        if (previous) {
+            item = `${previous}${formatted}`;
+        } else {
+            if (os.platform() === 'win32') {
+                item = `${trace}`
+            } else {
+                item = `${formatted}`;
+            }
+        }
+        folderInfo.push(item);
+    });
+    return folderInfo
+};
+const findMaxFields = (array = []) => {
+    let keys = {};
+    for (let idx = 0; idx < array.length; idx++) {
+        const length = Object.keys(array[idx]).length;
+        if (length > Object.keys(keys).length) {
+            keys = array[idx];
+        }
+    }
+    return Object.keys(keys);
+};
+module.exports = {
+    findTrace,
+    findMaxFields,
+}

package/src/epic/zero.__.v.constant.js

@@ -0,0 +1,5 @@
+const path = require('path');
+
+module.exports = {
+    FILE_DELIMITER: path.sep,
+}

package/test/csv.json

@@ -0,0 +1,12 @@
+{
+    "data": [
+        {
+            "name": "Lang1",
+            "email": "lang.yu1@hpe.com"
+        },
+        {
+            "name": "Lang2",
+            "email": "lang.yu2@hpe.com"
+        }
+    ]
+}

package/test/csv.zero

@@ -0,0 +1,2 @@
+KV;
+name=Name,email=Email

package/test/data.zero

@@ -0,0 +1,56 @@
+P;
+key=Guid
+noArray=["A","B","C"]
+noFixed=$FIXED:测试值
+code=Code
+headCount=HeadCount
+mobile=Mobile
+phone=Phone
+http=Http
+https=Https
+ftp=Ftp
+domain=Domain
+protocol=Protocol
+ip=IP
+bool=Bool
+color=Color
+version=Version
+percent=Percent
+zip=Zip
+email=Email
+region=Region
+province=Province
+city=City
+city2=CityFull
+county=County
+countyFull=CountyFull
+tld=Tld
+cnName=CnName
+cnFirst=CnFirst
+cnCompany=CnCompany
+cnDept=CnDept
+cnSection=CnSection
+cnScope=CnScope
+cnAddress=CnAddress
+cnText=CnText
+cnSentence=CnSentence
+cnTitle=CnTitle
+cnGender=CnGender
+enName=EnName
+enFirst=EnFirst
+enLast=EnLast
+enCompany=EnCompany
+enDept=EnDept
+enSection=EnSection
+enScope=EnScope
+enAddress=EnAddress
+enText=EnText
+enSentence=EnSentence
+enTitle=EnTitle
+enGender=EnGender
+iso=Iso
+now=Now
+date=Date
+datetime=DateTime
+time=Time
+

package/test/key/key1.json

@@ -0,0 +1,15 @@
+{
+    "data": [
+        {
+            "name": "Lang1",
+            "email": "lang.yu1@hpe.com",
+            "key": "d0ebdb57-fa80-43ac-962e-8b2904cd44f0"
+        },
+        {
+            "name": "Lang2",
+            "email": "lang.yu2@hpe.com",
+            "key": "557ce6cf-e753-44df-9087-a7abc02355fe"
+        }
+    ],
+    "key": "403275c9-d768-4e34-abfa-db91bc388bea"
+}

package/test/key/key2.json

@@ -0,0 +1,12 @@
+[
+    {
+        "name": "Lang1",
+        "email": "lang.yu1@hpe.com",
+        "key": "6f1d918c-bf1e-4dd5-8e5b-968c988e56b5"
+    },
+    {
+        "name": "Lang2",
+        "email": "lang.yu2@hpe.com",
+        "key": "1b41e068-18ad-4041-95dd-a548bcc91bbf"
+    }
+]

package/test/key/key3.json

@@ -0,0 +1,5 @@
+{
+    "name": "Lang1",
+    "email": "lang.yu1@hpe.com",
+    "key": "2fde8d5f-5a29-49ff-a549-11a9c97ecd72"
+}

package/test/key.json

@@ -0,0 +1,12 @@
+{
+    "data": [
+        {
+            "name": "Lang1",
+            "email": "lang.yu1@hpe.com"
+        },
+        {
+            "name": "Lang2",
+            "email": "lang.yu2@hpe.com"
+        }
+    ]
+}

package/test/uk.json

@@ -0,0 +1,19 @@
+{
+    "data": [
+        {
+            "name": "Lang1",
+            "email": "lang.yu1@hpe.com",
+            "age": 17
+        },
+        {
+            "name": "Lang2",
+            "email": "lang.yu2@hpe.com",
+            "age": 17
+        },
+        {
+            "name": "Lang2",
+            "email": "lang.yu3@hpe.com",
+            "age": 19
+        }
+    ]
+}