@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Properties/PropertiesScss.ts

@@ -1,261 +0,0 @@
-// export:none
-
-import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
-
-import { PropertiesItems } from './PropertiesItems'
-import { PropertiesPalette } from './PropertiesPalette'
-
-import {
-  PropertyCategory,
-  type PropertyItem,
-  PropertyKey, PropertyType
-} from '../../types/propertyTypes'
-
-const NAME_DESIGNS = 'setDesignsDesigns'
-const NAME_ROOT = 'setDesignsRoot'
-const NAME_MEDIA = 'setDesignsMedia'
-const NAME_CLASSES = 'setDesignsClasses'
-const NAME_PALETTE = 'setDesignsPalette'
-const NAME_SHADE = 'setDesignShade'
-const NAME_PROPERTIES = 'setDesignsProperties'
-
-/**
- * Class for generating SCSS structures from design tokens.
- *
- * Класс для генерации структур SCSS из токенов дизайна.
- */
-export class PropertiesScss {
-  /**
-   * Constructor for initializing the SCSS generator.
-   *
-   * Конструктор для инициализации генератора SCSS.
-   * @param items property management instance / экземпляр управления свойствами
-   */
-  constructor(private items: PropertiesItems) {
-  }
-
-  /**
-   * Returns a complete SCSS formatted string containing all configuration mixins.
-   *
-   * Возвращает полную отформатированную строку SCSS, содержащую все миксины конфигурации.
-   */
-  get() {
-    let data = '@use "@dxtmisha/styles" as variables;\r\n\r\n'
-
-    data += `${this.getDesigns()}\r\n`
-    data += `${this.getRoot()}\r\n`
-    data += `${this.getMedia()}\r\n`
-    data += `${this.getClasses()}\r\n`
-    data += `${this.getPalette()}\r\n`
-    data += `${this.getShade()}\r\n`
-    data += `${this.getProperties()}\r\n`
-
-    return data
-  }
-
-  /**
-   * Returns a list of connected designs.
-   *
-   * Возвращает список подключенных дизайнов.
-   */
-  protected getDesigns(): string {
-    const designs = forEach(this.items.getDesigns(), design => `\r\n  '${design}',`)
-    return this.getPropertiesValue(NAME_DESIGNS, designs.join(''))
-  }
-
-  /**
-   * Returns a list of properties for the root.
-   *
-   * Возвращает список свойств для root.
-   */
-  protected getRoot(): string {
-    return this.getPropertiesValue(NAME_ROOT, this.getByCategory(PropertyCategory.root))
-  }
-
-  /**
-   * Returns a list of device sizes.
-   *
-   * Возвращает список размеров устройства.
-   */
-  protected getMedia(): string {
-    let data = ''
-
-    forEach(this.items.getMedia(), (
-      values,
-      design
-    ) => {
-      if (isObjectNotArray(values)) {
-        forEach(values, (
-          item,
-          name
-        ) => {
-          data += `\r\n  '${design}-${name}': ${this.getValueItem(item)},`
-        })
-      }
-    })
-
-    return this.getPropertiesValue(NAME_MEDIA, data)
-  }
-
-  /**
-   * Returns a list of all classes for generation.
-   *
-   * Возвращает список всех классов для генерации.
-   */
-  protected getClasses(): string {
-    return this.getPropertiesValue(NAME_CLASSES, this.getByCategory(['class', 'theme']))
-  }
-
-  /**
-   * Returns a list of colors.
-   *
-   * Возвращает список цветов.
-   */
-  protected getPalette(): string {
-    let data = ''
-
-    new PropertiesPalette(this.items)
-      .getUsed()
-      .forEach(({
-        name,
-        value
-      }) => {
-        data += `\r\n  '${name}': ('${value.join('\', \'')}'),`
-      })
-
-    return this.getPropertiesValue(NAME_PALETTE, data)
-  }
-
-  /**
-   * Returns a list of color saturation codes.
-   *
-   * Возвращает список кодов насыщенности цветов.
-   */
-  protected getShade(): string {
-    let data = ''
-
-    new PropertiesPalette(this.items)
-      .getShade()
-      .forEach(({
-        design,
-        value
-      }) => {
-        data += `\r\n  '${design}': (${value.join(',')}),`
-      })
-
-    return this.getPropertiesValue(NAME_SHADE, data)
-  }
-
-  /**
-   * Generates a SCSS map structure for all identified properties.
-   *
-   * Генерирует структуру карты SCSS для всех определенных свойств.
-   */
-  getProperties(): string {
-    return this.getPropertiesValue(NAME_PROPERTIES, this.to())
-  }
-
-  /**
-   * Returns a list of all records with the selected type.
-   *
-   * Возвращает список всех записей с выбранным типом.
-   * @param category category names/ названия категорий
-   */
-  private getByCategory(category: string | string[]): string {
-    const data: string[] = []
-
-    this.items.findCategory(category)
-      .forEach(property => data.push(`\r\n  '${property.index}',`))
-
-    return data.join('')
-  }
-
-  /**
-   * Returns the property value.
-   *
-   * Возвращает значение свойства.
-   * @param property property value/ значение свойства
-   * @param space пробелы
-   */
-  private getValue(property: PropertyItem, space: string) {
-    if (isObjectNotArray(property.value)) {
-      return `value: (${this.to(property.value, `${space}    `)}\r\n${space}  ),`
-    } else if (Array.isArray(property.value)) {
-      return `value: (${property.value.join(', ')}),`
-    }
-
-    return `value: ${this.getValueItem(property)},`
-  }
-
-  /**
-   * Returns the value of a property.
-   *
-   * Возвращает значение свойства.
-   * @param item property value/ значение свойства
-   */
-  private getValueItem(item: PropertyItem): string {
-    const value = item?.[PropertyKey.css] || item.value
-
-    if (typeof value === 'string') {
-      if (
-        value.match(/^#[a-zA-Z0-9]+$/)
-        || value.match(/^([0-9]+|([0-9]+\.[0-9]+))(px|em|rem|vw|vh|%|)$/)
-      ) {
-        return `${value}`
-      }
-
-      return `'${value}'`
-    }
-
-    return ''
-  }
-
-  private getPropertiesValue(name: string, data: string) {
-    return `@include variables.${name}((${data}));`
-  }
-
-  /**
-   * Method for iterating over all properties and converting them to a SCSS structure.
-   *
-   * Метод для обхода всех свойств и преобразования их в структуру SCSS.
-   * @param properties list of properties/ свойств
-   * @param space пробелы
-   */
-  private to(
-    properties = this.items.get(),
-    space = '  '
-  ) {
-    let data = ''
-
-    forEach(properties, (property, name) => {
-      if (
-        property?.value
-        && property?.[PropertyKey.variable] !== 'none'
-      ) {
-        data += `\r\n${space}'${name}':(`
-        data += `\r\n${space}  index: '${name}',`
-        data += `\r\n${space}  name: '${property?.[PropertyKey.name] || name}',`
-        data += `\r\n${space}  type: '${property?.[PropertyKey.variable]}',`
-
-        if (
-          property?.[PropertyKey.category]
-          || property?.[PropertyKey.variable] !== PropertyType.component
-        ) {
-          data += `\r\n${space}  ${this.getValue(property, space)}`
-        }
-
-        if (property?.[PropertyKey.modification] === false) {
-          data += `\r\n${space}  modification: false,`
-        }
-
-        if (property?.[PropertyKey.varKey] === true) {
-          data += `\r\n${space}  var: true,`
-        }
-
-        data += `\r\n${space}),`
-      }
-    })
-
-    return data
-  }
-}

package/src/classes/Properties/PropertiesSeparator.ts

@@ -1,118 +0,0 @@
-// export:none
-
-import { forEach, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional-basic'
-
-import { PropertiesConfig } from './PropertiesConfig'
-import { PropertiesKeys } from './PropertiesKeys'
-
-import {
-  type PropertyItem,
-  PropertyKey,
-  type PropertyList
-} from '../../types/propertyTypes'
-
-/**
- * Class for handling the splitting of property names with separators into nested sub-properties.
- *
- * Класс для работы с разделением названий свойств с разделителями на вложенные под-свойства.
- */
-export class PropertiesSeparator {
-  /**
-   * Checks if the property list contains any keys that require splitting (contain separators).
-   *
-   * Проверяет, содержит ли список свойств ключи, требующие разделения (содержащие разделители).
-   * @param properties list of properties to check / список свойств для проверки
-   * @param limit maximum recursion depth for verification / максимальная глубина рекурсии для проверки
-   */
-  static is(
-    properties: PropertyList,
-    limit = PropertiesConfig.getSeparatorLimit()
-  ): boolean {
-    if (limit > 0) {
-      for (const index in properties) {
-        if (PropertiesKeys.isSeparator(index)) {
-          return true
-        }
-
-        const value = properties?.[index]?.value
-
-        if (
-          value
-          && isObjectNotArray(value)
-          && this.is(value, limit - 1)
-        ) {
-          return true
-        }
-      }
-    }
-
-    return false
-  }
-
-  /**
-   * Transforms properties with separator-containing keys into a nested object structure.
-   *
-   * Преобразует свойства с ключами, содержащими разделители, во вложенную структуру объектов.
-   * @param properties the property list to transform / список свойств для преобразования
-   */
-  static to(properties: PropertyList): PropertyList {
-    let data: PropertyList = {}
-
-    forEach(properties, (item, name) => {
-      const newItem: PropertyItem = {
-        ...item,
-        value: isObjectNotArray(item.value) ? this.to(item.value) : item.value
-      }
-
-      if (PropertiesKeys.isSeparator(name)) {
-        data = replaceRecursive(data, this.wrap(newItem, this.removeBasicName(name)))
-      } else {
-        data = replaceRecursive(data, { [name]: newItem })
-      }
-    })
-
-    return data
-  }
-
-  /**
-   * Removing unnecessary characters from the name.
-   *
-   * Удаление лишних символов из названия.
-   * @param name property names/ названия свойств
-   */
-  private static removeBasicName(name: string): string[] {
-    const separator = PropertiesConfig.getSeparator()
-    const basicName = PropertiesConfig.getSeparatorBasicName()
-
-    return name
-      .replace(new RegExp(`${separator}${basicName}`, 'g'), '')
-      .replace(new RegExp(`${separator}$`), '')
-      .split(separator)
-  }
-
-  /**
-   * Packs a property into objects by an array of titles.
-   *
-   * Упаковывает свойство в объекты по массиву названий.
-   * @param item property values/ значения свойств
-   * @param list array of titles/ массив названий
-   */
-  private static wrap(item: PropertyItem, list: string[]): PropertyList {
-    let data = item;
-
-    [...list]
-      .reverse()
-      .forEach((name) => {
-        data = {
-          value: {
-            [name]: {
-              ...data,
-              [PropertyKey.wrap]: true
-            }
-          }
-        }
-      })
-
-    return data.value as PropertyList
-  }
-}

package/src/classes/Properties/PropertiesSettings.ts

@@ -1,104 +0,0 @@
-// export:none
-
-import { isFilled, replaceRecursive, toKebabCase } from '@dxtmisha/functional-basic'
-import { getConstructorProperties } from '../../functions/getConstructorProperties'
-
-import { PropertiesConfig } from './PropertiesConfig'
-import { PropertiesFile } from './PropertiesFile'
-import { PropertiesPath } from './PropertiesPath'
-import { PropertiesStandard } from './PropertiesStandard'
-import { PropertiesTool } from './PropertiesTool'
-
-import { type PropertyList } from '../../types/propertyTypes'
-
-import { UI_DIRS_COMPONENTS, UI_DIRS_CONSTRUCTOR, UI_KEY_CONSTRUCTOR } from '../../config'
-
-const DIR_NAME = 'settings'
-
-/**
- * Class for searching and loading global component settings.
- *
- * Класс для поиска и загрузки глобальных настроек компонентов.
- */
-export class PropertiesSettings {
-  /**
-   * Constructor for initializing the settings resolver.
-   *
-   * Конструктор для инициализации резолвера настроек.
-   * @param path path handler instance / экземпляр обработчика путей
-   */
-  constructor(
-    private readonly path: PropertiesPath
-  ) {
-  }
-
-  /**
-   * Returns a unified list of settings for all identified components and constructors.
-   *
-   * Возвращает унифицированный список настроек для всех определенных компонентов и конструкторов.
-   */
-  get(): PropertyList {
-    return {
-      ...this.getComponents(),
-      ...this.getConstructors()
-    }
-  }
-
-  /**
-   * Returns a list of available components.
-   *
-   * Возвращает список доступных компонентов.
-   */
-  protected getComponentList(): string[] {
-    const list: string[] = []
-    let paths: string[] = [
-      ...UI_DIRS_COMPONENTS,
-      PropertiesConfig.getProjectName()
-    ]
-
-    if (this.path.isConstructor()) {
-      paths = [...UI_DIRS_CONSTRUCTOR]
-    }
-
-    PropertiesFile.readDir(paths).forEach(dir => list.push(dir))
-
-    return list
-  }
-
-  /**
-   * Returns a list of design system components.
-   *
-   * Возвращает список компонентов дизайн-системы.
-   */
-  protected getComponents(): PropertyList {
-    return this.path.toAll(DIR_NAME, (
-      _,
-      path,
-      design
-    ) => {
-      let data: PropertyList = {}
-
-      if (path) {
-        PropertiesFile.readDir(path).forEach((dir) => {
-          const properties = PropertiesTool.readFile(design, [...path, dir])
-
-          if (isFilled(properties)) {
-            data = replaceRecursive(data, PropertiesStandard.to({
-              [design]: {
-                [toKebabCase(dir)]: properties
-              }
-            }))
-          }
-        })
-      }
-
-      return data
-    }) as PropertyList
-  }
-
-  protected getConstructors(): PropertyList {
-    return PropertiesStandard.to({
-      [UI_KEY_CONSTRUCTOR]: getConstructorProperties(this.getComponentList())
-    }) as any as PropertyList
-  }
-}

package/src/classes/Properties/PropertiesStandard.ts

@@ -1,180 +0,0 @@
-// export:none
-
-import { forEach, isFilled, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional-basic'
-
-import { PropertiesKeys } from './PropertiesKeys'
-import { PropertiesTypes } from './PropertiesTypes'
-import { PropertiesValues } from './PropertiesValues'
-
-import {
-  type PropertyItem,
-  type PropertyItemInput,
-  type PropertyItemPartial,
-  PropertyKey,
-  type PropertyList,
-  type PropertyListOrData
-} from '../../types/propertyTypes'
-
-/**
- * Class for transforming raw property data into a standardized structure for internal processing.
- *
- * Класс для преобразования сырых данных свойств в стандартизированную структуру для внутренней обработки.
- */
-export class PropertiesStandard {
-  /**
-   * Transforms a property list or raw data into a standardized PropertyList structure.
-   *
-   * Преобразует список свойств или сырые данные в стандартизированную структуру PropertyList.
-   * @param properties the property list or data to transform / список свойств или данные для преобразования
-   */
-  static to(properties: PropertyListOrData): PropertyList {
-    const data: PropertyList = {}
-
-    forEach(properties, (item, index) => {
-      const newItem = this.getItem(index, item)
-      const key = PropertiesKeys.reKey(index, newItem?.[PropertyKey.type])
-
-      if (isObjectNotArray(newItem.value)) {
-        newItem.value = this.to(newItem.value)
-      }
-
-      this.addValue(newItem)
-
-      newItem[PropertyKey.index] = index.replace(/^=/, '')
-
-      if (key in newItem) {
-        data[key] = replaceRecursive(data[key] ?? {}, newItem) as PropertyItem
-      } else {
-        data[key] = newItem
-      }
-    })
-
-    return data
-  }
-
-  /**
-   * We get the values that have been updated.
-   *
-   * Получаем доработанные значения.
-   * @param name key name/ название ключа
-   * @param item values for conversion/ значения для преобразования
-   */
-  private static getItem(
-    name: string,
-    item: PropertyItemInput
-  ): PropertyItem {
-    const newItem = this.toItem(item)
-
-    this.addType(name, newItem)
-    this.addFull(name, newItem)
-
-    return newItem as PropertyItem
-  }
-
-  /**
-   * Separate a special property from regular values.
-   *
-   * Разделить специальное свойство от обычных значений.
-   * @param property an array that needs to be transformed/
-   * массив, который нужно преобразовать
-   */
-  private static getValueAndSpecial(property: PropertyItemInput): PropertyItemPartial {
-    const data: Record<string, any> = {
-      value: property?.value || {}
-    }
-
-    forEach(property, (item, name) => {
-      if (PropertiesKeys.isSpecialKey(name)) {
-        data[name] = item
-      } else {
-        data.value[name] = item as PropertyItemPartial['value']
-      }
-    })
-
-    return data
-  }
-
-  /**
-   * Adds the type if it exists.
-   *
-   * Добавляет тип, если есть.
-   * @param name key name/ название ключа
-   * @param item values for conversion/ значения для преобразования
-   */
-  private static addType(
-    name: string,
-    item: PropertyItemPartial
-  ): void {
-    if (!(PropertyKey.type in item)) {
-      const type = PropertiesTypes.getTypeInName(name)
-
-      if (type) {
-        item[PropertyKey.type] = type
-      }
-    }
-  }
-
-  /**
-   * Adds a label that the property name is the final version and does not require additional processing.
-   *
-   * Добавляет метку, что имя свойства является финальной версией и не требует дополнительной обработки.
-   * @param name key name/ название ключа
-   * @param item values for conversion/ значения для преобразования
-   */
-  private static addFull(
-    name: string,
-    item: PropertyItemPartial
-  ): void {
-    if (PropertiesKeys.isFull(name)) {
-      item[PropertyKey.fullName] = true
-    }
-
-    if (
-      typeof item.value === 'string' && (
-        PropertiesValues.isFull(item.value)
-        || name.match(/aspect/i)
-      )
-    ) {
-      item[PropertyKey.fullValue] = true
-    }
-  }
-
-  /**
-   * Converts values to string, if they are of type number.
-   *
-   * Преобразовывает значения в строку, если являются типом число.
-   * @param item values for conversion/ значения для преобразования
-   * @private
-   */
-  private static addValue(item: PropertyItemPartial): void {
-    item.value = PropertiesValues.reValue(item.value)
-  }
-
-  /**
-   * Transform the property value into the required format.
-   *
-   * Преобразовать значение свойства в необходимый формат.
-   * @param value values for conversion/ значения для преобразования
-   */
-  private static toItem(value: PropertyItemPartial['value']): PropertyItemPartial {
-    if (
-      typeof value !== 'object'
-      || Array.isArray(value)
-    ) {
-      return { value } as PropertyItemPartial
-    }
-
-    if (isFilled(value)) {
-      if (
-        !('value' in value)
-        || isObjectNotArray(value.value)
-      ) {
-        return this.getValueAndSpecial(value)
-      }
-
-      return value
-    }
-
-    return { value: {} }
-  }
-}