@gct-paas/cli 0.0.1-dev.9 → 0.0.1

package/es/core/handlebars/handlebars-engine.d.ts

@@ -0,0 +1,74 @@
+import Handlebars from 'handlebars';
+import { IObject } from '../interface';
+/**
+ * 生成器
+ *
+ * @export
+ * @class HandlebarsEngine
+ */
+export declare class HandlebarsEngine {
+    /**
+     * 编译参数
+     *
+     * @protected
+     * @type {CompileOptions}
+     */
+    protected compileOpt: CompileOptions;
+    /**
+     * Handlebars 运行时参数
+     *
+     * @protected
+     * @type {Handlebars.RuntimeOptions}
+     */
+    protected runtimeOpt: Handlebars.RuntimeOptions;
+    /**
+     * 忽略编译的上下文标签规则
+     *
+     * @protected
+     */
+    protected tagReg: RegExp;
+    /**
+     * 模板映射内容
+     *
+     * @type {Map<string, string>} Map<模板路径, 模板内容>
+     */
+    readonly temps: Map<string, string>;
+    constructor();
+    /**
+     * 注册宏
+     *
+     * @param {string} key 宏标识
+     * @param {string} template 宏模板内容
+     */
+    registerMacro(key: string, template: string): void;
+    /**
+     * 注册模板
+     *
+     * @param {string} key
+     * @param {string} template
+     */
+    registerTemp(key: string, template: string): void;
+    /**
+     * 编译模板获取所有使用到的上下文级参数标识
+     *
+     * @param {string} template
+     * @return {*}  {string[]}
+     */
+    parseContextTags(template: string): string[];
+    /**
+     * 计算编译模板中的参数标签
+     *
+     * @protected
+     * @param {Set<string>} set
+     * @param {Record<string, any>[]} tags
+     */
+    protected calcTemplateTags(set: Set<string>, tags: Record<string, any>[]): void;
+    /**
+     * 直接工具模板和数据编译
+     *
+     * @param {string} template
+     * @param {IObject} data
+     * @return {*}  {string}
+     */
+    render(template: string, data: IObject): string;
+}

package/es/core/handlebars/handlebars-engine.mjs

@@ -0,0 +1,122 @@
+import Handlebars from "handlebars";
+import { installHelpers } from "./helpers/index.mjs";
+import { HelperUtil, winToUnixPath } from "./utils/index.mjs";
+import { TEMP_EXTENSION } from "./constant/index.mjs";
+export class HandlebarsEngine {
+  /**
+   * 编译参数
+   *
+   * @protected
+   * @type {CompileOptions}
+   */
+  compileOpt = { compat: true, noEscape: true };
+  /**
+   * Handlebars 运行时参数
+   *
+   * @protected
+   * @type {Handlebars.RuntimeOptions}
+   */
+  runtimeOpt = {
+    allowProtoPropertiesByDefault: true
+  };
+  /**
+   * 忽略编译的上下文标签规则
+   *
+   * @protected
+   */
+  tagReg = /^[a-zA-Z0-9:_-]+$/;
+  /**
+   * 模板映射内容
+   *
+   * @type {Map<string, string>} Map<模板路径, 模板内容>
+   */
+  temps = /* @__PURE__ */ new Map();
+  constructor() {
+    installHelpers();
+  }
+  /**
+   * 注册宏
+   *
+   * @param {string} key 宏标识
+   * @param {string} template 宏模板内容
+   */
+  registerMacro(key, template) {
+    key = winToUnixPath(key);
+    if (key.endsWith(TEMP_EXTENSION)) {
+      key = key.replace(TEMP_EXTENSION, "");
+      Handlebars.registerPartial(key, template);
+    } else {
+      Handlebars.registerPartial(key, template);
+    }
+  }
+  /**
+   * 注册模板
+   *
+   * @param {string} key
+   * @param {string} template
+   */
+  registerTemp(key, template) {
+    key = winToUnixPath(key);
+    if (key.endsWith(TEMP_EXTENSION)) {
+      key = key.replace(TEMP_EXTENSION, "");
+      this.temps.set(key, template);
+    } else {
+      this.temps.set(key, template);
+    }
+  }
+  /**
+   * 编译模板获取所有使用到的上下文级参数标识
+   *
+   * @param {string} template
+   * @return {*}  {string[]}
+   */
+  parseContextTags(template) {
+    const program = Handlebars.parse(template);
+    const set = /* @__PURE__ */ new Set();
+    this.calcTemplateTags(set, program.body);
+    return Array.from(set);
+  }
+  /**
+   * 计算编译模板中的参数标签
+   *
+   * @protected
+   * @param {Set<string>} set
+   * @param {Record<string, any>[]} tags
+   */
+  calcTemplateTags(set, tags) {
+    tags.forEach((item) => {
+      switch (item.type) {
+        case "SubExpression":
+          if (item.params?.length > 0) {
+            this.calcTemplateTags(set, item.params);
+          }
+          return;
+        case "MustacheStatement":
+        case "PathExpression": {
+          const tag = item.path ? item.path.original : item.original;
+          if (HelperUtil.isHelperName(tag)) {
+            if (item.params?.length > 0) {
+              this.calcTemplateTags(set, item.params);
+            }
+            return;
+          }
+          if (this.tagReg.test(tag)) {
+            set.add(tag);
+          }
+          break;
+        }
+        default:
+      }
+    });
+  }
+  /**
+   * 直接工具模板和数据编译
+   *
+   * @param {string} template
+   * @param {IObject} data
+   * @return {*}  {string}
+   */
+  render(template, data) {
+    return Handlebars.compile(template, this.compileOpt)(data, this.runtimeOpt);
+  }
+}

package/es/core/handlebars/helpers/and/and.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 并且条件模式
+ *
+ * @description 判断: word wor2 word3 必须在判断中必须全部为 true, 用法: {{#and word word2 word3}}xxx{{else}}yyy{{/and}}、{{and word word2 word3}} 返回值为 boolean 类型
+ * @export
+ * @class HelperAnd
+ * @extends {HelperBase}
+ */
+export declare class HelperAnd extends HelperBase {
+    constructor();
+    onExecute(...args: unknown[] | Handlebars.HelperOptions[]): string | boolean;
+}

package/es/core/handlebars/helpers/and/and.mjs

@@ -0,0 +1,14 @@
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperAnd extends HelperBase {
+  constructor() {
+    super("and");
+  }
+  onExecute(...args) {
+    const options = args[args.length - 1];
+    args.pop();
+    const arr = args.filter((item) => !!item);
+    const bol = arr.length === args.length;
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/camel-case/camel-case.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 转驼峰
+ *
+ * @description 用法 {{camelCase xxx}}，效果: this-is-my-name => thisIsMyName
+ * @export
+ * @class HelperCamelCase
+ * @extends {HelperBase}
+ */
+export declare class HelperCamelCase extends HelperBase {
+    constructor();
+    onExecute(param: string): string;
+}

package/es/core/handlebars/helpers/camel-case/camel-case.mjs

@@ -0,0 +1,13 @@
+import { camelCase } from "lodash-es";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperCamelCase extends HelperBase {
+  constructor() {
+    super("camelCase");
+  }
+  onExecute(param) {
+    if (!param) {
+      return "";
+    }
+    return camelCase(param);
+  }
+}

package/es/core/handlebars/helpers/concat/concat.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 字符串拼接
+ *
+ * @description 用法：{{concat string1 string2 string3}} 返回值为 string 类型
+ * @export
+ * @class HelperConcat
+ * @extends {HelperBase}
+ */
+export declare class HelperConcat extends HelperBase {
+    constructor();
+    onExecute(...args: string[]): string;
+}

package/es/core/handlebars/helpers/concat/concat.mjs

@@ -0,0 +1,10 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperConcat extends HelperBase {
+  constructor() {
+    super("concat");
+  }
+  onExecute(...args) {
+    args.pop();
+    return args.join("");
+  }
+}

package/es/core/handlebars/helpers/eq/eq.d.ts

@@ -0,0 +1,14 @@
+import * as Handlebars from 'handlebars';
+import { HelperBase } from '../helper-base';
+/**
+ * 等于
+ *
+ * @description 判断: word === word2, 用法: {{#eq word word2}}xxx{{else}}yyy{{/eq}}、{{eq word 'xxx'}} 返回值为 boolean 类型
+ * @export
+ * @class HelperEq
+ * @extends {HelperBase}
+ */
+export declare class HelperEq extends HelperBase {
+    constructor();
+    onExecute(param: unknown, param2: unknown, options: Handlebars.HelperOptions): string | boolean;
+}

package/es/core/handlebars/helpers/eq/eq.mjs

@@ -0,0 +1,12 @@
+import { eq } from "lodash-es";
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperEq extends HelperBase {
+  constructor() {
+    super("eq");
+  }
+  onExecute(param, param2, options) {
+    const bol = eq(param, param2);
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/format-import/format-import.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 格式化导入
+ *
+ * @description 专门格式化导入的 response 对象，效果: ResponseEntity«List«TraceSettingResponse»» => TraceSettingResponse
+ * @export
+ * @class HelperFormatImport
+ * @extends {HelperBase}
+ */
+export declare class HelperFormatImport extends HelperBase {
+    constructor();
+    onExecute(param: string[]): string;
+}

package/es/core/handlebars/helpers/format-import/format-import.mjs

@@ -0,0 +1,34 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperFormatImport extends HelperBase {
+  constructor() {
+    super("formatImport");
+  }
+  onExecute(param) {
+    if (!param || param.length === 0) {
+      return "";
+    }
+    const items = param.map((item) => {
+      if (item.indexOf("\xAB") > -1) {
+        const arr = item.split("\xAB");
+        return arr[arr.length - 1].split("\xBB")[0];
+      }
+      return item;
+    }).filter((item) => {
+      const keys = item.split(",");
+      const tag = keys[0];
+      switch (tag) {
+        case "string":
+        case "object":
+        case "void":
+        case "integer":
+        case "int":
+        case "long":
+        case "Map":
+          return false;
+        default:
+          return true;
+      }
+    });
+    return Array.from(new Set(items)).join(",");
+  }
+}

package/es/core/handlebars/helpers/format-import-item/format-import-item.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 格式化导入
+ *
+ * @description 专门格式化导入的 response 对象，效果: ResponseEntity«List«TraceSettingResponse»» => TraceSettingResponse
+ * @export
+ * @class HelperFormatImportItem
+ * @extends {HelperBase}
+ */
+export declare class HelperFormatImportItem extends HelperBase {
+    constructor();
+    onExecute(param: string): string;
+}

package/es/core/handlebars/helpers/format-import-item/format-import-item.mjs

@@ -0,0 +1,33 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperFormatImportItem extends HelperBase {
+  constructor() {
+    super("formatImportItem");
+  }
+  onExecute(param) {
+    if (!param) {
+      return "";
+    }
+    if (param.indexOf("\xAB") > -1) {
+      const arr = param.split("\xAB");
+      const text = arr[arr.length - 1].split("\xBB")[0];
+      let keys = text.split(",");
+      if (keys.length > 1) {
+        return "IObject";
+      }
+      keys = keys.map((key) => {
+        if (key === "Void") {
+          return "void";
+        }
+        if (key === "int" || key === "long") {
+          return "number";
+        }
+        if (key === "Map") {
+          return "IObject";
+        }
+        return key;
+      });
+      return keys.join(",");
+    }
+    return param;
+  }
+}

package/es/core/handlebars/helpers/format-js-type/format-js-type.d.ts

@@ -0,0 +1,14 @@
+import { IObject } from '../../../interface';
+import { HelperBase } from '../helper-base';
+/**
+ * 格式化导入
+ *
+ * @description 针对后台的 swagger 生成的 js 类型，进行对 js 的类型转换
+ * @export
+ * @class HelperFormatJsType
+ * @extends {HelperBase}
+ */
+export declare class HelperFormatJsType extends HelperBase {
+    constructor();
+    onExecute(param: string, cfg?: IObject): string;
+}

package/es/core/handlebars/helpers/format-js-type/format-js-type.mjs

@@ -0,0 +1,34 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperFormatJsType extends HelperBase {
+  constructor() {
+    super("formatJsType");
+  }
+  onExecute(param, cfg) {
+    if (!param) {
+      return "unknown";
+    }
+    if (param === "array") {
+      if (cfg) {
+        let type = cfg.type || cfg.originalRef;
+        if (type) {
+          if (type === "integer") {
+            type = "number";
+          } else if (type.startsWith("Triple\xAB")) {
+            type = "unknown";
+          }
+        } else {
+          type = "unknown";
+        }
+        return type + "[]";
+      }
+      return "unknown[]";
+    }
+    if (param === "integer") {
+      return "number";
+    }
+    if (param === "object") {
+      return "Record<string, unknown>";
+    }
+    return param;
+  }
+}

package/es/core/handlebars/helpers/gt/gt.d.ts

@@ -0,0 +1,14 @@
+import * as Handlebars from 'handlebars';
+import { HelperBase } from '../helper-base';
+/**
+ * 大于
+ *
+ * @description 判断: word > word2, 用法: {{#gt word word2}}xxx{{else}}yyy{{/gt}}、{{gt word word2}} 返回值为 boolean 类型
+ * @export
+ * @class HelperGt
+ * @extends {HelperBase}
+ */
+export declare class HelperGt extends HelperBase {
+    constructor();
+    onExecute(param: unknown, param2: unknown, options: Handlebars.HelperOptions): string | boolean;
+}

package/es/core/handlebars/helpers/gt/gt.mjs

@@ -0,0 +1,12 @@
+import { gt } from "lodash-es";
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperGt extends HelperBase {
+  constructor() {
+    super("gt");
+  }
+  onExecute(param, param2, options) {
+    const bol = gt(param, param2);
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/gte/gte.d.ts

@@ -0,0 +1,14 @@
+import * as Handlebars from 'handlebars';
+import { HelperBase } from '../helper-base';
+/**
+ * 大于等于
+ *
+ * @description 判断: word >= word2, 用法 {{#gte word word2}}xxx{{else}}yyy{{/gte}}、{{gte word word2}} 返回值为 boolean 类型
+ * @export
+ * @class HelperGte
+ * @extends {HelperBase}
+ */
+export declare class HelperGte extends HelperBase {
+    constructor();
+    onExecute(param: unknown, param2: unknown, options: Handlebars.HelperOptions): string | boolean;
+}

package/es/core/handlebars/helpers/gte/gte.mjs

@@ -0,0 +1,12 @@
+import { gte } from "lodash-es";
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperGte extends HelperBase {
+  constructor() {
+    super("gte");
+  }
+  onExecute(param, param2, options) {
+    const bol = gte(param, param2);
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/helper-base.d.ts

@@ -0,0 +1,22 @@
+/**
+ * helper 基类
+ *
+ * @export
+ * @class HelperBase
+ */
+export declare abstract class HelperBase {
+    /**
+     * Creates an instance of HelperBase.
+     *
+     * @param {string} tag 助手标识
+     */
+    constructor(tag: string);
+    /**
+     * 助手执行
+     *
+     * @abstract
+     * @param {...unknown[]} args
+     * @return {*}  {(string | boolean)}
+     */
+    abstract onExecute(...args: unknown[]): string | boolean;
+}

package/es/core/handlebars/helpers/helper-base.mjs

@@ -0,0 +1,11 @@
+import Handlebars from "handlebars";
+export class HelperBase {
+  /**
+   * Creates an instance of HelperBase.
+   *
+   * @param {string} tag 助手标识
+   */
+  constructor(tag) {
+    Handlebars.registerHelper(tag, this.onExecute);
+  }
+}

package/es/core/handlebars/helpers/includes/includes.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 字符串包含内容
+ *
+ * @description 判断: 'test'.includes('t'), 用法: {{#includes word word2}}xxx{{else}}yyy{{/includes}}、{{includes word word2}} 返回值为 boolean 类型
+ * @export
+ * @class HelperIncludes
+ * @extends {HelperBase}
+ */
+export declare class HelperIncludes extends HelperBase {
+    constructor();
+    onExecute(param: string, param2: string, options: Handlebars.HelperOptions): string | boolean;
+}

package/es/core/handlebars/helpers/includes/includes.mjs

@@ -0,0 +1,11 @@
+import { HelperUtil } from "../../utils/index.mjs";
+import { HelperBase } from "../helper-base.mjs";
+export class HelperIncludes extends HelperBase {
+  constructor() {
+    super("includes");
+  }
+  onExecute(param, param2, options) {
+    const bol = param.includes(param2);
+    return HelperUtil.handleJudgmentExecute(this, bol, options);
+  }
+}

package/es/core/handlebars/helpers/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 安装自定义助手
+ *
+ * @export
+ */
+export declare function installHelpers(): void;

package/es/core/handlebars/helpers/index.mjs

@@ -0,0 +1,46 @@
+import { HelperAnd } from "./and/and.mjs";
+import { HelperCamelCase } from "./camel-case/camel-case.mjs";
+import { HelperConcat } from "./concat/concat.mjs";
+import { HelperEq } from "./eq/eq.mjs";
+import { HelperFormatImport } from "./format-import/format-import.mjs";
+import { HelperFormatImportItem } from "./format-import-item/format-import-item.mjs";
+import { HelperFormatJsType } from "./format-js-type/format-js-type.mjs";
+import { HelperGt } from "./gt/gt.mjs";
+import { HelperGte } from "./gte/gte.mjs";
+import { HelperIncludes } from "./includes/includes.mjs";
+import { HelperJson } from "./json/json.mjs";
+import { HelperLowerCase } from "./lower-case/lower-case.mjs";
+import { HelperLt } from "./lt/lt.mjs";
+import { HelperLte } from "./lte/lte.mjs";
+import { HelperNeq } from "./neq/neq.mjs";
+import { HelperNotIncludes } from "./not-includes/not-includes.mjs";
+import { HelperNot } from "./not/not.mjs";
+import { HelperOr } from "./or/or.mjs";
+import { HelperPascalCase } from "./pascal-case/pascal-case.mjs";
+import { HelperSnakeCase } from "./snake-case/snake-case.mjs";
+import { HelperSpinalCase } from "./spinal-case/spinal-case.mjs";
+import { HelperUpperCase } from "./upper-case/upper-case.mjs";
+export function installHelpers() {
+  new HelperAnd();
+  new HelperCamelCase();
+  new HelperConcat();
+  new HelperEq();
+  new HelperFormatImport();
+  new HelperFormatImportItem();
+  new HelperFormatJsType();
+  new HelperGt();
+  new HelperGte();
+  new HelperIncludes();
+  new HelperJson();
+  new HelperLowerCase();
+  new HelperLt();
+  new HelperLte();
+  new HelperNeq();
+  new HelperNot();
+  new HelperNotIncludes();
+  new HelperOr();
+  new HelperPascalCase();
+  new HelperSnakeCase();
+  new HelperSpinalCase();
+  new HelperUpperCase();
+}

package/es/core/handlebars/helpers/json/json.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * json 转 string
+ *
+ * @description 用法 {{json xxx 2}}，支持第二个参数传递格式化。效果: 将 json 对象转为 json 字符串
+ * @export
+ * @class HelperJson
+ * @extends {HelperBase}
+ */
+export declare class HelperJson extends HelperBase {
+    constructor();
+    onExecute(obj: Record<string, unknown> | unknown[], space: number): string;
+}

package/es/core/handlebars/helpers/json/json.mjs

@@ -0,0 +1,13 @@
+import { HelperBase } from "../helper-base.mjs";
+export class HelperJson extends HelperBase {
+  constructor() {
+    super("jsonStringify");
+  }
+  onExecute(obj, space) {
+    return JSON.stringify(
+      obj,
+      null,
+      typeof space === "number" ? space : void 0
+    );
+  }
+}

package/es/core/handlebars/helpers/lower-case/lower-case.d.ts

@@ -0,0 +1,13 @@
+import { HelperBase } from '../helper-base';
+/**
+ * 字符串转换小写
+ *
+ * @description 用法 {{lowerCase word}}, 效果: MyName => myname
+ * @export
+ * @class HelperLowerCase
+ * @extends {HelperBase}
+ */
+export declare class HelperLowerCase extends HelperBase {
+    constructor();
+    onExecute(param: string): string;
+}