Что это?

Этот пакет предоставляет TypeScript типы для SSJS платформы WebSoft (WebTutor), а также набор трансформеров для конфигурации транспилированного JavaScript.

Установка

Чтобы установить пакет, выполните следующую команду:

npm i @globexit/websoft-types -D

Подключение типов

Для добавления типов необходимо настроить typeRoots в вашем tsconfig.json:

"typeRoots": [
    "../node_modules/@globexit/websoft-types/lib/web-soft/types",
    "../node_modules/@globexit/websoft-types/lib/web-soft/types/xml"
]

Настройка Gulp

В вашей конфигурации Gulp необходимо подключить трансформеры и менеджер импортов:

import { TransformerConfigurator } from "@globexit/websoft-types/lib/common/transformers/transformer-configurator";
import { ImportManager } from "@globexit/websoft-types/lib/common/utils/import-manager";

const transformerConfigurator = new TransformerConfigurator();
const importManager = new ImportManager();

Далее добавьте функции для обработки импортов в цепочку конфигурации:

export const transformTS = (path) => {
    return src(path, { base: SRC_PATH })
        .pipe(change(importManager.addFuncImports))
        .pipe(change(importManager.replaceImports));
};

Создание проекта цепочки преобразования в Gulp

Создайте или подключите в существующий createProject трансформеры для преобразования JS:

const tsProject = createProject(TS_CONFIG_PATH, {
    typescript: transformerConfigurator.ts,
    getCustomTransformers: () => ({
        before: transformerConfigurator.getTransformers()
    })
});

Полная конфигурация

Объедините все части конфигурации в одну цепочку:

export const transformTS = (path) => {
    return src(path, { base: SRC_PATH })
        .pipe(change(importManager.addFuncImports))
        .pipe(change(importManager.replaceImports))
        .pipe(include({
            extensions: 'ts',
            hardFail: true,
            separateInputs: true,
            includePaths: [
                __dirname + "../../node_modules"
            ]
        }))
        .pipe(tsProject());
};

Обработка импортов

Не забудьте дать доступ трансформерам к node_modules добавив в include:

.pipe(include({
    extensions: 'ts',
    hardFail: true,
    separateInputs: true,
    includePaths: [
        __dirname + "../../node_modules"
    ]
}))

Описание трансформеров

Данный пакет предоставляет следующие трансформеры:

• Преобразование for...of в for...in:

  TypeScript:

  for (const item of [1, 2, 3]) { }

  SSJS:

  for (item in [1, 2, 3]) { }

• Удаление объявления переменных из циклов:

  TypeScript:

  let sum = 0;
  for (const item of [1, 2, 3]) {
      sum += item;
    
      const num = 1;
      sum += num;
  }

  SSJS:

  var sum = 0;
  for (item in [1, 2, 3]) {
      sum += item;
  
      num = 1;
      sum += num;
  }

• Преобразование лямбд:

  TypeScript:

  let sum = (a: number, b: number) => a + b;

  SSJS:

  var sum = function _1(a, b) { return a + b; };

• Рабочий импорт через комментарий:

  TypeScript:

  import { sum } from './sum'; //.
  
  let a = 2;
  let b = 3;
    
  let num = sum(a, b);

  SSJS:

  function sum(a, b) {
      return a + b;
  }
  
  var a = 2;
  var b = 3;
  var num = sum(a, b);

• Поддержка методов JS для работы с массивами: В данный момент поддерживаются: map, filter, some, any, reduce, includes, find, pop:

  TypeScript:

  let array = [2, 4, 6, 3, 7, 4, 7];
  
  let res1 = array.map(i => i * 2);
  let res2 = array.filter(i => i > 3);
  let res3 = array.find(i => i === 4);

  SSJS:

  function find(array, predicate, thisArg) {
      if (array == null)
          throw new Error('"this" is null or undefined');
      var len = ArrayCount(array);
      for (k = 0; k < len; k++) {
          value = array[k];
          if (predicate(value, k, array, thisArg))
              return value;
      }
      return undefined;
  }
    
  function filter(array, predicate) {
      var result = [];
      for (i = 0; i < ArrayCount(array); i++) {
          if (predicate(array[i], i, array)) {
              result.push(array[i]);
          }
      }
      return result;
  }
    
  function map(array, callback) {
      var result = [];
      for (i = 0; i < ArrayCount(array); i++) {
          result.push(callback(array[i], i, array));
      }
      return result;
  }
    
  var array = [2, 4, 6, 3, 7, 4, 7];
  var res1 = map(array, function _1(i) { return i * 2; });
  var res2 = filter(array, function _2(i) { return i > 3; });
  var res3 = find(array, function _3(i) { return i === 4; });

Заключение

Пакет @globexit/websoft-types предоставляет необходимые инструменты для работы с SSJS через TS, а также значительно упрощает процесс разработки с использованием трансформеров для обработки кода.