@dxtmisha/scripts 0.11.8 → 1.0.0

package/src/classes/Properties/to/PropertiesToPalette.ts

@@ -1,241 +0,0 @@
-// export:none
-
-import { forEach, isFilled, isObject, isObjectNotArray } from '@dxtmisha/functional-basic'
-
-import { PropertiesToAbstract } from './PropertiesToAbstract'
-import { PropertiesItems } from '../PropertiesItems'
-
-import {
-  PropertyCategory,
-  type PropertyItem,
-  type PropertyItemsItem,
-  PropertyKey,
-  type PropertyList,
-  PropertyType
-} from '../../../types/propertyTypes'
-
-const THEME_BASIC = 'basic'
-const KEY_CLASS_NAME = 'palette'
-
-/**
- * Class for working with colors.
- *
- * Класс для работы с цветами.
- */
-export class PropertiesToPalette extends PropertiesToAbstract {
-  protected readonly FILE_CACHE = '002-palette'
-  private palette: PropertyItemsItem[]
-
-  /**
-   * Constructor
-   * @param items data for processing/ данные для обработки
-   */
-  constructor(protected items: PropertiesItems) {
-    super(items)
-    this.palette = this.items.findCategory(PropertyCategory.palette)
-  }
-
-  /**
-   * Adding a class for working with colors.
-   *
-   * Добавление класса для работы со цветами.
-   */
-  protected init(): void {
-    this.read()
-    this.items.findCategory(PropertyCategory.theme)
-      .forEach(({
-        design,
-        name,
-        item
-      }) => item?.value && isObjectNotArray(item.value) && this.read(item.value, name, design))
-  }
-
-  /**
-   * Adding a group of properties based on the design name.
-   *
-   * Добавление группы свойств по названию дизайна.
-   * @param category category names/ названия категорий
-   * @param parent the property object, by which it will be added/ объект свойства, по которому будет добавлять
-   */
-  private getParent(
-    category: PropertyCategory.colors | PropertyCategory.class,
-    parent: PropertyList
-  ): PropertyList {
-    if (!(KEY_CLASS_NAME in parent)) {
-      parent[KEY_CLASS_NAME] = {
-        value: {},
-        [PropertyKey.type]: category === PropertyCategory.colors
-          ? PropertyType.classType
-          : PropertyType.component,
-        [PropertyKey.category]: category
-      }
-    }
-
-    return parent[KEY_CLASS_NAME].value as PropertyList
-  }
-
-  /**
-   * Adding a new class with the name of the color.
-   *
-   * Добавление нового класса по имени цвета.
-   * @param items list of classes/ список классов
-   * @param name class name/ название класса
-   */
-  private getClass(items: PropertyList, name: string): PropertyList {
-    if (!items?.[name]) {
-      items[name] = {
-        value: {},
-        [PropertyKey.type]: PropertyType.state
-      }
-    }
-
-    return items[name].value as PropertyList
-  }
-
-  /**
-   * Returns names for light.
-   *
-   * Возвращает названия для света.
-   * @param theme the name of the theme/ название темы
-   * @param name names of colors/ названия цвета
-   */
-  private getName(theme: string, name: string): string {
-    return `${theme}-${name}`
-  }
-
-  /**
-   * Returns values for color.
-   *
-   * Возвращает значения для цвета.
-   * @param link base link/ базовая ссылка
-   * @param name names of colors/ названия цвета
-   */
-  private getValue(link: string, name: string): string {
-    return `{${link}.${name}}`
-  }
-
-  /**
-   * Checking the default value.
-   *
-   * Проверка значения по умолчанию.
-   * @param item the value to be checked/ проверяемое значение
-   * @param theme the name of the theme/ название темы
-   */
-  private getValueDefault(item: PropertyItem, theme: string): string {
-    const value = item?.[PropertyKey.default]
-
-    if (isFilled(value)) {
-      return isObject(value) ? value?.[theme] : value as string
-    }
-
-    return 'default'
-  }
-
-  /**
-   * Adding a color property by the name of the theme.
-   *
-   * Добавление свойства цвета по названию темы.
-   * @param root the property object, by which it will be added/
-   * объект свойства, по которому будет добавлять
-   * @param theme the name of the theme/ название темы
-   * @param designParent design name/ название дизайна
-   */
-  private read(
-    root?: PropertyList,
-    theme = THEME_BASIC,
-    designParent?: string
-  ) {
-    this.palette.forEach(({
-      design,
-      item,
-      parents,
-      index
-    }) => {
-      if (!designParent || designParent === design) {
-        const themeName = item?.[PropertyKey.theme]
-
-        if (!themeName || themeName === theme) {
-          const list = this.getParent(
-            root ? PropertyCategory.colors : PropertyCategory.class,
-            root ?? (parents?.[0]?.item.value as PropertyList)
-          )
-
-          if (
-            list
-            && isObjectNotArray(item.value)
-          ) {
-            forEach(item.value, (shade, name) => {
-              const parent = this.getClass(list, name)
-
-              if (
-                isObjectNotArray(shade.value)
-                && shade?.[PropertyKey.category] !== PropertyCategory.paletteNone
-              ) {
-                this.addItem(
-                  parent,
-                  `${index}.${name}`,
-                  theme,
-                  shade.value
-                )
-              }
-
-              this.addDefault(parent, theme, item)
-            })
-          }
-        }
-      }
-    })
-  }
-
-  /**
-   * Adding a saturation property.
-   *
-   * Добавление свойства насыщенности.
-   * @param parent list of available values for the class/ список доступных значений у класса
-   * @param link list of classes/ список классов
-   * @param theme the name of the theme/ название темы
-   * @param palette the list of saturation/ список насыщенности
-   * @private
-   */
-  private addItem(
-    parent: PropertyList,
-    link: string,
-    theme: string,
-    palette: PropertyList
-  ): void {
-    forEach(palette, (item, name) => {
-      if (item) {
-        parent[this.getName(theme, name)] = {
-          value: this.getValue(link, name),
-          [PropertyKey.type]: PropertyType.var,
-          [PropertyKey.category]: PropertyCategory.color
-        }
-      }
-    })
-  }
-
-  /**
-   * Adding a default value.
-   *
-   * Добавление значения по умолчанию.
-   * @param parent list of available values for the class/ список доступных значений у класса
-   * @param theme the name of the theme/ название темы
-   * @param palette list of classes/ список классов
-   * @private
-   */
-  private addDefault(
-    parent: PropertyList,
-    theme: string,
-    palette: PropertyItem
-  ): void {
-    const defaultValue = this.getValueDefault(palette, theme)
-    const name = this.getName(theme, defaultValue)
-
-    if (parent?.[name]) {
-      parent['sys-palette'] = {
-        ...parent[name],
-        [PropertyKey.fullName]: true
-      }
-    }
-  }
-}

package/src/classes/Properties/to/PropertiesToProperty.ts

@@ -1,31 +0,0 @@
-// export:none
-
-import { toKebabCase } from '@dxtmisha/functional-basic'
-
-import { PropertiesToVar } from './PropertiesToVar'
-
-import { type PropertyItemsItem, PropertyType } from '../../../types/propertyTypes'
-
-/**
- * Class for working with custom styles in CSS.
- *
- * Класс для работы с пользовательскими стилями в CSS.
- */
-export class PropertiesToProperty extends PropertiesToVar {
-  protected FILE_CACHE = '024-property'
-  protected type = PropertyType.property
-
-  /**
-   * Name transformation for the var type.
-   *
-   * Преобразование имени для типа var.
-   * @param name base property name/ базовое название свойства
-   * @param item current element/ текущий элемент
-   */
-  protected getName({
-    name,
-    item
-  }: PropertyItemsItem) {
-    return toKebabCase(this.items.getReName(name, item))
-  }
-}

package/src/classes/Properties/to/PropertiesToRemove.ts

@@ -1,33 +0,0 @@
-// export:none
-
-import { getColumn, isObjectNotArray } from '@dxtmisha/functional-basic'
-
-import { PropertiesToAbstract } from './PropertiesToAbstract'
-
-import { PropertyKey } from '../../../types/propertyTypes'
-
-/**
- * Class for removing a property.
- *
- * Класс для удаления свойства.
- */
-export class PropertiesToRemove extends PropertiesToAbstract {
-  protected readonly FILE_CACHE = '007-02-remove'
-
-  protected init(): void {
-    this.items.find(({ item }) => item?.[PropertyKey.remove] ?? false)
-      .forEach(({
-        name,
-        parent,
-        parents
-      }) => {
-        if (
-          parent
-          && isObjectNotArray(parent.value)
-        ) {
-          console.warn('[Remove]', `{${getColumn(parents, 'name').join('.')}.${name}}`)
-          delete parent.value[name]
-        }
-      })
-  }
-}

package/src/classes/Properties/to/PropertiesToReplace.ts

@@ -1,77 +0,0 @@
-// export:none
-
-import { PropertiesToAbstract } from './PropertiesToAbstract'
-
-import {
-  PropertyKey,
-  type PropertyReplace
-} from '../../../types/propertyTypes'
-
-export type PropertiesReplaceValue = string | Partial<PropertyReplace>
-
-/**
- * A class for transforming an expression through regular expressions.
- *
- * Класс для преобразования выражения через регулярные выражения.
- */
-export class PropertiesToReplace extends PropertiesToAbstract {
-  protected readonly FILE_CACHE = '001-replace'
-
-  /**
-   * Transforming all of its properties.
-   *
-   * Преобразование всех своих свойств.
-   */
-  protected init(): void {
-    this.items.each(({ item }) => {
-      if (
-        item?.[PropertyKey.replace]
-        && typeof item.value === 'string'
-      ) {
-        item.value = this.getValue(
-          this.getInfo(item[PropertyKey.replace]),
-          item.value
-        )
-
-        delete item[PropertyKey.replace]
-      }
-    })
-  }
-
-  /**
-   * Getting information about the transformation.
-   *
-   * Получение информации о преобразовании.
-   * @param info information for verification/ информация для проверки
-   */
-  private getInfo(info: PropertiesReplaceValue): PropertyReplace {
-    if (typeof info === 'object') {
-      return {
-        pattern: info?.pattern,
-        flags: info?.flags || 'i',
-        replace: info?.replace || '$1'
-      }
-    } else {
-      return {
-        pattern: info || undefined,
-        flags: 'i',
-        replace: '$1'
-      }
-    }
-  }
-
-  /**
-   * Returns the transformed value.
-   *
-   * Возвращает преобразованное значение.
-   * @param info information for verification/ информация для проверки
-   * @param value
-   */
-  private getValue(info: PropertyReplace, value: string): string {
-    if (info?.pattern) {
-      return value.replace(new RegExp(info.pattern, info.flags), info.replace)
-    } else {
-      return value
-    }
-  }
-}

package/src/classes/Properties/to/PropertiesToRoot.ts

@@ -1,40 +0,0 @@
-// export:none
-
-import { PropertiesToAbstract } from './PropertiesToAbstract'
-
-import { PropertyKey, PropertyType } from '../../../types/propertyTypes'
-
-/**
- * A class for transforming class.
- *
- * Класс для преобразования class.
- */
-export class PropertiesToRoot extends PropertiesToAbstract {
-  protected readonly FILE_CACHE = '038-root'
-
-  protected init(): void {
-    this.items.findVariable(PropertyType.root).forEach(({
-      design,
-      component,
-      name,
-      item
-    }) => {
-      if (component) {
-        item[PropertyKey.name] = this.getName(design, component, this.items.getReName(name, item))
-      }
-    })
-  }
-
-  /**
-   * @param design design name/ название дизайна
-   * @param component component name/ название компонента
-   * @param name base property name/ базовое название свойства
-   */
-  private getName(
-    design: string,
-    component: string,
-    name: string
-  ): string {
-    return `${this.items.getLink(design, component, name)} &`
-  }
-}

package/src/classes/Properties/to/PropertiesToSimilar.ts

@@ -1,128 +0,0 @@
-// export:none
-
-import { isObjectNotArray } from '@dxtmisha/functional-basic'
-
-import { PropertiesToAbstract } from './PropertiesToAbstract'
-
-import {
-  type PropertyItem,
-  type PropertyItemsParent,
-  PropertyKey,
-  PropertyType
-} from '../../../types/propertyTypes'
-
-const TYPE = [
-  PropertyType.var,
-  PropertyType.property
-]
-
-const EXCEPTION = [
-  PropertyType.classType,
-  PropertyType.subclass
-]
-
-/**
- * A class for searching for related properties at a higher level to adopt their properties.
- *
- * Класс для поиска родственных свойств на уровне выше для принятия их свойств.
- */
-export class PropertiesToSimilar extends PropertiesToAbstract {
-  protected readonly FILE_CACHE = '010-similar'
-
-  /**
-   * Finding similar data for editing.
-   *
-   * Поиск похожих данных для редактирования.
-   */
-  protected init(): void {
-    this.items.each(({
-      item,
-      name,
-      parents
-    }) => {
-      const similar = this.getParent(name, item, parents)
-
-      if (similar) {
-        item[PropertyKey.rename] = this.items.getReName(name, similar)
-        item[PropertyKey.variable] = similar?.[PropertyKey.variable]
-      }
-    })
-  }
-
-  /**
-   * Returns similar values by its name.
-   *
-   * Возвращает похожие значения по его имени.
-   * @param name name of the name/ название имени
-   * @param item object for checking/ объект для проверки
-   * @param parents array of all ancestor properties along the tree from the top level/
-   * массив со всеми свойствами предков по дереву от верхнего уровня
-   */
-  private getParent(
-    name: string,
-    item: PropertyItem,
-    parents: PropertyItemsParent[]
-  ): PropertyItem | undefined {
-    const list = [...parents].reverse()
-
-    if (
-      !item?.[PropertyKey.type]
-      && !item?.[PropertyKey.rename]
-      && !this.isException(item)
-      && !this.isException(list?.[0]?.item)
-    ) {
-      list.shift()
-
-      for (const { item } of list) {
-        if (isObjectNotArray(item.value)) {
-          const similar = item.value?.[name]
-
-          if (this.isException(item)) {
-            break
-          } else if (
-            similar
-            && this.is(similar) && (
-              similar?.[PropertyKey.type]
-              || similar?.[PropertyKey.rename]
-            )
-          ) {
-            return similar
-          }
-        }
-      }
-    }
-
-    return undefined
-  }
-
-  /**
-   * Checks if the property is available for inheritance.
-   *
-   * Проверяет, доступно ли свойство для наследования.
-   * @param item object for checking/ объект для проверки
-   */
-  private is(item: PropertyItem): boolean {
-    if (item?.[PropertyKey.variable]) {
-      return TYPE.indexOf(item?.[PropertyKey.variable]) !== -1
-    }
-
-    return false
-  }
-
-  /**
-   * Checks if inheriting the property is prohibited.
-   *
-   * Проверяет, запрещено ли наследовать свойство.
-   * @param item object for checking/ объект для проверки
-   */
-  private isException(item?: PropertyItem): boolean {
-    if (
-      item
-      && item?.[PropertyKey.variable]
-    ) {
-      return EXCEPTION.indexOf(item[PropertyKey.variable]) !== -1
-    }
-
-    return false
-  }
-}

package/src/classes/Properties/to/PropertiesToSort.ts

@@ -1,146 +0,0 @@
-// export:none
-
-import { forEach, isObjectNotArray, type Item } from '@dxtmisha/functional-basic'
-
-import { PropertiesToAbstract } from './PropertiesToAbstract'
-
-import {
-  type PropertyItem,
-  type PropertyItemsItem,
-  PropertyKey,
-  type PropertyList,
-  PropertyType
-} from '../../../types/propertyTypes'
-
-import { sortList } from '../../../media/properties/listSort'
-
-type PropertiesSortItem = {
-  name: string
-  item: PropertyItem
-  order: number
-}
-type PropertiesSortList = PropertiesSortItem[]
-
-/**
- * Class for sorting properties.
- *
- * Класс для сортировки свойств.
- */
-export class PropertiesToSort extends PropertiesToAbstract {
-  protected readonly FILE_CACHE = '048-sort'
-
-  protected init(): void {
-    this.read()
-  }
-
-  /**
-   * Sorts all records.
-   *
-   * Сортирует все записи.
-   * @param properties an array that needs to be transformed/
-   * массив, который нужно преобразовать
-   */
-  private read(properties?: PropertyItemsItem): PropertyList {
-    const data: PropertiesSortList = []
-
-    this.items.eachMainOnly((property) => {
-      const {
-        name,
-        value,
-        item
-      } = property
-      const sort = this.getKeys(item)
-
-      if (isObjectNotArray(value)) {
-        item.value = this.read(property)
-      }
-
-      item[PropertyKey.sort] = sort.index
-      data.push({
-        name,
-        item,
-        order: sort.value
-      })
-    }, properties)
-
-    return this.join(data)
-  }
-
-  /**
-   * Getting the category name of an element.
-   *
-   * Получение названия категории у элемента.
-   * @param item current element/ текущий элемент
-   */
-  private getCategoryName(item: PropertyItem): string {
-    return `category-${item?.[PropertyKey.category]}`
-  }
-
-  /**
-   * Getting data about sorting by object.
-   *
-   * Получение данных о сортировке по объекту.
-   * @param item current element/ текущий элемент
-   */
-  private getKeys(item: PropertyItem): Item<number> {
-    const category = this.getCategoryName(item)
-    const variable = item?.[PropertyKey.variable]
-
-    const sortIndex = sortList.findIndex(
-      ({ index }) => index === category || index === variable
-    )
-
-    if (sortIndex !== -1) {
-      const sort = sortList[sortIndex]
-      if (sort) {
-        const order = sort.value.findIndex(names => names.indexOf(item?.[PropertyKey.name] ?? '') !== -1)
-        let value = (sortIndex + 1) * 1_000_000
-
-        if (order !== -1) {
-          const key = sort.value[order]?.findIndex(name => name === item?.[PropertyKey.name]) ?? -1
-
-          value += order * 1_000
-
-          if (key !== -1) {
-            value += key
-          } else {
-            value += 999
-          }
-        } else {
-          value += 999_999
-        }
-
-        return {
-          index: `${sort.index}${order > 0 ? `@${order}` : ''}`,
-          value
-        }
-      }
-    }
-
-    return {
-      index: PropertyType.other,
-      value: 99_999_999
-    }
-  }
-
-  /**
-   * Merging records into a list.
-   *
-   * Соединения записи в список.
-   * @param data given for connection/ данный для соединения
-   */
-  private join(data: PropertiesSortList): PropertyList {
-    const properties: PropertyList = {}
-
-    data.sort((a, b) => a.order - b.order)
-
-    forEach(data, ({
-      name,
-      item
-    }) => {
-      properties[name] = item
-    })
-
-    return properties
-  }
-}