@cicctencent/tars2node-cli 0.0.1

package/lib/generator/printer.js

@@ -0,0 +1,116 @@
+'use strict';
+
+class Printer {
+  constructor() {
+    /** @type {string[]} */
+    this._buf = [];
+    /** @type {number} */
+    this._indent = 0;
+  }
+
+  resetIndent() {
+    this._indent = 0;
+  }
+
+  print() {
+    const buf = this._buf.join('');
+    this._buf = [];
+
+    return buf;
+  }
+
+  indent() {
+    this._indent++;
+    return this;
+  }
+
+  dedent() {
+    this._indent--;
+    return this;
+  }
+
+  semicolon() {
+    this._buf.push(';');
+    return this;
+  }
+
+  /**
+   * 添加n个空格
+   * @param {number} n
+   * @return {this}
+   */
+  space(n) {
+    for (let i = 0; i < n; i++) {
+      this._buf.push(' ');
+    }
+    return this;
+  }
+
+  /**
+   * 添加一个字符串，并根据第二个参数判断是否需要左右空格
+   * @param {string} str
+   * @param {'NO'|'R'|'L'|'LR'} [needSpace = 'NO']
+   * @return {this}
+   */
+  word(str, needSpace = 'NO') {
+    switch (needSpace) {
+      case 'L':
+        this.space(1);
+        this._buf.push(str);
+        break;
+      case 'R':
+        this._buf.push(str);
+        this.space(1);
+        break;
+      case 'LR':
+        this.space(1);
+        this._buf.push(str);
+        this.space(1);
+        break;
+      default:
+        this._buf.push(str);
+    }
+    return this;
+  }
+
+  /**
+   * 添加一个新行，并根据第二个参数判断是否需要行后的空行
+   * @param {string} str
+   * @param {boolean} [afterSpace = false]
+   * @return {this}
+   */
+  line(str, afterSpace = false) {
+    this.newline().word(str);
+    if (afterSpace) this.newline();
+
+    return this;
+  }
+
+  /**
+   * 添加一个空行
+   * @param {boolean} [needSpace = true] - 是否需要按照当前缩进缩进
+   * @return {this}
+   */
+  newline(needSpace = true) {
+    this._buf.push('\n');
+    if (needSpace) this.space(this._indent * 2);
+    return this;
+  }
+
+  /**
+   * @param {() => void} callback
+   * @param {boolean} [inline = false]
+   * @return {this}
+   */
+  scope(callback, inline = false) {
+    this.word('{');
+    if (!inline) this.indent();
+    callback();
+    if (!inline) this.dedent().newline();
+    this.word('}');
+
+    return this;
+  }
+}
+
+module.exports = Printer;

package/lib/generator/ts/def/base.js

@@ -0,0 +1,55 @@
+'use strict';
+
+class BaseDef {
+  /**
+   *
+   * 工具类类型
+   * @typedef {import("../printer")} Printer
+   * @typedef {import("../typing")} Typing
+   *
+   * @typedef {object} CompilerOptions
+   * @property {'all'|'client'|'service'} mode
+   * @property {'string'|'number'|'bigint'} long
+   * @property {boolean} withReturn
+   * @property {boolean} gather
+   * @property {boolean} interface
+   * @property {string} [output]
+   *
+   * 创建Const解析实例
+   * @constructor
+   * @param {string} moduleName - 当前Const所属模块
+   * @param {Printer} printer - print类实例
+   * @param {Typing} typing - Typing类实例
+   * @param {CompilerOptions} options - 编译配置选项
+   */
+  constructor(moduleName, printer, typing, options) {
+    this._moduleName = moduleName;
+    this._options = options;
+    this._printer = printer;
+    this._typing = typing;
+  }
+
+  /**
+   * @return {undefined | 2 | true}
+   */
+  generateLastParamForLong() {
+    switch (this._options.long) {
+      case 'bigint':
+        return 2;
+      case 'string':
+        return true;
+      case 'number':
+      default:
+        return undefined;
+    }
+  }
+
+  /**
+   * @param {string} name
+   */
+  setModuleName(name) {
+    this._moduleName = name;
+  }
+}
+
+module.exports = BaseDef;

package/lib/generator/ts/def/const.js

@@ -0,0 +1,108 @@
+'use strict';
+
+const BaseDef = require('./base');
+
+class ConstDef extends BaseDef {
+  /**
+   *
+   * 声明JCE-Struct节点类型
+   * @typedef { refType | vecType | string | mapType } tarsType
+   *
+   * @typedef {object} refType
+   * @property {string} target
+   * @property {string[]} nested
+   *
+   * @typedef {object} vecType
+   * @property {'vector'} type
+   * @property {tarsType} target
+   *
+   * @typedef {object} mapType
+   * @property {'map'} type
+   * @property {tarsType} key
+   * @property {tarsType} value
+   *
+   * @typedef {object} constValue
+   * @property {tarsType} type
+   * @property {*} init
+   *
+   * @typedef {object} TarsConstNode
+   * @property {string} id
+   * @property {'const'} type
+   * @property {constValue} value
+   *
+   * 工具类类型
+   * @typedef {import("../printer")} Printer
+   * @typedef {import("../typing")} Typing
+   *
+   * @typedef {object} CompilerOptions
+   * @property {'all'|'client'|'service'} mode
+   * @property {'string'|'number'|'bigint'} long
+   * @property {boolean} withReturn
+   * @property {boolean} gather
+   * @property {boolean} interface
+   * @property {string} [output]
+   *
+   * 创建Const解析实例
+   * @constructor
+   * @param {Printer} printer - print类实例
+   * @param {Typing} typing - Typing类实例
+   * @param {CompilerOptions} options - 编译配置选项
+   */
+  constructor(printer, typing, options) {
+    super('', printer, typing, options);
+    /** @type {string} */
+    this._id = '';
+    /** @type {constValue} */
+    this._value = { type: 'string', init: null };
+    this._beforeComment = '';
+  }
+
+  build() {
+    if (typeof this._value.type === 'string') {
+      this._handleBase();
+    } else {
+      this._handleEnum();
+    }
+  }
+
+  /**
+   * @param {string} name
+   * @param {TarsConstNode} node
+   */
+  reset(name, node) {
+    this.setModuleName(name);
+    this.setNode(node);
+
+    return this;
+  }
+
+  /** @param {TarsConstNode} node */
+  setNode({ id, value, beforeComment = '' }) {
+    this._id = id;
+    this._value = value;
+    this._beforeComment = beforeComment;
+  }
+
+  _handleBase() {
+    this._printer
+      .word(this._beforeComment)
+      .newline()
+      .line(`export const ${this._id} = ${this._value.init};`);
+  }
+
+  _handleEnum() {
+    const father = this._value.type;
+    const chainName = this._typing.toTarsStreamType(
+      father,
+      this._moduleName
+    ).tafType;
+    const target = `${chainName}.${this._value.init.target}`;
+
+    this._printer
+      .word(this._beforeComment)
+      .newline()
+      .line(`const ${this._id} = ${target};`);
+  }
+}
+
+module.exports = ConstDef;

package/lib/generator/ts/def/enum.js

@@ -0,0 +1,144 @@
+'use strict';
+
+const BaseDef = require('./base');
+const util = require('../util');
+
+const WRITE_SIGNATURE = 'export function _write(os: TarsStream.TarsOutputStream, tag: number, val: any){ return os.writeInt32(tag, val); };';
+const READ_SIGNATURE = 'export function _read(is: TarsStream.TarsInputStream, tag: number, def?: any){ return is.readInt32(tag, true, def); };';
+
+class EnumDef extends BaseDef {
+  /**
+   *
+   * 声明JCE-Struct节点类型
+   * @typedef { refType | vecType | string | mapType } tarsType
+   *
+   * @typedef {object} refType
+   * @property {string} target
+   * @property {string[]} nested
+   *
+   * @typedef {object} vecType
+   * @property {'vector'} type
+   * @property {tarsType} target
+   *
+   * @typedef {object} mapType
+   * @property {'map'} type
+   * @property {tarsType} key
+   * @property {tarsType} value
+   *
+   * @typedef {object} enumValue
+   * @property {string} id
+   * @property {number} value
+   *
+   * @typedef {object} TarsEnumNode
+   * @property {string} id
+   * @property {'enum'} type
+   * @property {enumValue[]} value
+   *
+   * 工具类类型
+   * @typedef {import("../printer")} Printer
+   * @typedef {import("../typing")} Typing
+   *
+   * @typedef {object} CompilerOptions
+   * @property {'all'|'client'|'service'} mode
+   * @property {'string'|'number'|'bigint'} long
+   * @property {boolean} withReturn
+   * @property {boolean} gather
+   * @property {boolean} interface
+   * @property {string} [output]
+   *
+   * 创建Struct解析实例
+   * @constructor
+   * @param {Printer} printer - print类实例
+   * @param {Typing} typing - Typing类实例
+   * @param {CompilerOptions} options - 编译配置选项
+   */
+  constructor(printer, typing, options) {
+    super('', printer, typing, options);
+    this._id = '';
+    this._chainName = '';
+    /** @type {enumValue[]} */
+    this._value = [];
+    /** @type {number} */
+    this._latestValue = 0;
+    this._beforeComment = '';
+  }
+
+  /**
+   * @param {string} name
+   * @param {TarsEnumNode} node
+   */
+  reset(name, node) {
+    this.setModuleName(name);
+    this.setNode(node);
+    this.resetLatestValue();
+
+    return this;
+  }
+
+  /**
+   * @param {string} name
+   */
+  setModuleName(name) {
+    super.setModuleName(name);
+    this._chainName = `${this._moduleName}.${this._id}`;
+  }
+
+  /**
+   * @param {TarsEnumNode} node
+   */
+  setNode({ id, value, beforeComment = '' }) {
+    this._id = id;
+    this._value = value;
+    this._chainName = `${this._moduleName}.${id}`;
+    this._beforeComment = beforeComment;
+  }
+
+  resetLatestValue() {
+    this._latestValue = 0;
+  }
+
+  build() {
+    this._enum();
+    if (this._options.mode !== 'web') {
+      this._namespace();
+    }
+  }
+
+  _enum() {
+    this._printer
+      .word(this._beforeComment)
+      .newline()
+      .word('export', 'R')
+      .word('enum', 'R')
+      .word(this._id, 'R')
+      .word('{')
+      .indent();
+    this._value.forEach(this._enumMember.bind(this));
+    this._printer.dedent().line('}');
+  }
+
+  _namespace() {
+    this._printer
+      .line(`export namespace ${this._id} {`)
+      .indent()
+      .line(`export const _classname = "${this._chainName}";`)
+      .line(WRITE_SIGNATURE)
+      .line(READ_SIGNATURE)
+      .dedent()
+      .line('}');
+  }
+
+  /**
+   * @param {enumValue} value
+   */
+  _enumMember({ id, value, comment = '' }) {
+    let result = value;
+    if (typeof result === "undefined") {
+      result = this._latestValue;
+      this._latestValue = result + 1;
+    } 
+    this._printer.line(`${util.toMultilineComment(comment)}${id} = ${result},`);
+  }
+}
+
+module.exports = EnumDef;