@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Properties/PropertiesTool.ts

@@ -1,80 +0,0 @@
-// export:none
-
-import { copyObject, toCamelCase } from '@dxtmisha/functional-basic'
-
-import { PropertiesConfig } from './PropertiesConfig'
-import { PropertiesCache } from './PropertiesCache'
-
-import type { PropertyList } from '../../types/propertyTypes'
-
-import basicProperties from '../../media/properties.json'
-
-import { UI_KEY_CONSTRUCTOR, UI_FILE_PROPERTY } from '../../config'
-
-/**
- * Utility class for naming components and reading design system property files.
- *
- * Утилитарный класс для именования компонентов и чтения файлов свойств дизайн-системы.
- */
-export class PropertiesTool {
-  /**
-   * Checks if the design name identifies as a constructor.
-   *
-   * Проверяет, идентифицирует ли название дизайна конструктор.
-   * @param design design name / название дизайна
-   */
-  static isConstructor(design: string): boolean {
-    return design === UI_KEY_CONSTRUCTOR
-  }
-
-  /**
-   * This method returns the names of designs from the environment variable (env).
-   *
-   * Данный метод возвращает названия дизайнов из переменной окружения (env)
-   */
-  static getDesigns(): string[] {
-    return [UI_KEY_CONSTRUCTOR, PropertiesConfig.getDesignName()]
-  }
-
-  /**
-   * Generates a camelCase component name string based on design and component name.
-   *
-   * Генерирует строку названия компонента в стиле camelCase на основе дизайна и названия компонента.
-   * @param design design name / название дизайна
-   * @param component component name / название компонента
-   */
-  static getComponentName(design: string, component?: string): string {
-    return `${design}${component ? `-${toCamelCase(component)}` : ''}`
-  }
-
-  /**
-   * Getting the component name.
-   *
-   * Получения названия компонента.
-   * @param design design name/ название дизайна
-   * @param component component name/ название компонента
-   */
-  static getClassName(design: string, component?: string): string {
-    return `.${this.getComponentName(design, component)}`
-  }
-
-  /**
-   * Reads a property list from a specified path, with special handling for constructors.
-   *
-   * Считывает список свойств по указанному пути с особой обработкой для конструкторов.
-   * @param design design name / название дизайна
-   * @param path array representing the directory path / массив, представляющий путь к директории
-   */
-  static readFile(
-    design: string,
-    path: string[] | undefined
-  ): PropertyList | undefined {
-    if (PropertiesTool.isConstructor(design)) {
-      return copyObject(basicProperties) as any as PropertyList
-    }
-
-    if (path) {
-      return PropertiesCache.read<PropertyList>([...path, UI_FILE_PROPERTY])
-    }
-  }
-}

package/src/classes/Properties/PropertiesTypes.ts

@@ -1,147 +0,0 @@
-// export:none
-
-import { isFilled, isSelected, toKebabCase } from '@dxtmisha/functional-basic'
-
-import {
-  type PropertyItem,
-  PropertyType
-} from '../../types/propertyTypes'
-
-/**
- * Utility class for identifying and managing property types based on naming conventions and symbols.
- *
- * Утилитарный класс для идентификации и управления типами свойств на основе соглашений об именовании и символов.
- */
-export class PropertiesTypes {
-  private static readonly SYMBOLS: Record<string, string> = {
-    '$': PropertyType.var,
-    '::': PropertyType.virtual,
-    ':': PropertyType.selector,
-    '~': PropertyType.state,
-    '#': PropertyType.subclass,
-    '@@': PropertyType.linkClass,
-    '@': PropertyType.link,
-    '&&': PropertyType.root,
-    '&': PropertyType.scss,
-    '--': PropertyType.none
-  }
-
-  /**
-   * Checks if the property type matches the specified list of allowed types.
-   *
-   * Проверяет, соответствует ли тип свойства указанному списку разрешенных типов.
-   * @param type current property type / текущий тип свойства
-   * @param name list of allowed types / список разрешенных типов
-   */
-  static isInType(
-    type?: PropertyItem['_type'],
-    name?: PropertyType[]
-  ): boolean {
-    if (
-      isFilled(type)
-      && isFilled(name)
-    ) {
-      return Boolean(isSelected(type, name))
-    }
-
-    return false
-  }
-
-  /**
-   * Determines if the property name contains a type-identifying symbol or specific prefix.
-   *
-   * Определяет, содержит ли название свойства символ-идентификатор типа или специфический префикс.
-   * @param name property key name / название ключа свойства
-   */
-  static isTypeInName(name: string): boolean {
-    return Boolean(name.match(this.getExpSymbols()))
-  }
-
-  /**
-   * Checks if it is a media type.
-   *
-   * Проверяет, если в тип медиа.
-   * @param type list of types/ список типы
-   */
-  static isMedia(type: PropertyItem['_type']): boolean {
-    return this.isInType(type, [PropertyType.media, PropertyType.mediaMax])
-  }
-
-  /**
-   * Checks if it is a container type.
-   *
-   * Проверяет, если в тип контейнера.
-   * @param type list of types/ список типы
-   */
-  static isContainer(type: PropertyItem['_type']): boolean {
-    return this.isInType(type, [PropertyType.container, PropertyType.containerMax])
-  }
-
-  /**
-   * Is the property a SCSS selector.
-   *
-   * Является ли свойство выборки SCSS.
-   * @param name key name/ название ключа
-   */
-  static isScss(name: string): boolean {
-    return name === PropertyType.scss || Boolean(name.match(/^&(?!&)/))
-  }
-
-  /**
-   * Is the property extraction SCSS for @at-root.
-   *
-   * Является ли свойство выборки SCSS для @at-root.
-   * @param name key name/ название ключа
-   */
-  static isRoot(name: string): boolean {
-    return name === PropertyType.root || Boolean(name.match(/^&&/))
-  }
-
-  /**
-   * Extracts and returns the property type identifier from its name string.
-   *
-   * Извлекает и возвращает идентификатор типа свойства из строки его названия.
-   * @param name property key name / название ключа свойства
-   */
-  static getTypeInName(name: string): PropertyItem['_type'] {
-    if (this.isTypeInName(name)) {
-      const type = name.replace(this.getExpSymbols(), '$1')
-
-      if (type in this.SYMBOLS) {
-        return this.SYMBOLS[type] as PropertyType
-      }
-
-      return toKebabCase(type) as PropertyType
-    }
-
-    return null
-  }
-
-  /**
-   * Returns the name of the property by its symbol.
-   *
-   * Возвращает название свойства по его символу.
-   * @param name type names/ названия типа
-   */
-  static getBySymbol(name: string): string | undefined {
-    return this.SYMBOLS?.[name]
-  }
-
-  /**
-   * Returns a regular expression for searching symbols in names.
-   *
-   * Возвращает регулярное выражение для поиска символов в названиях.
-   */
-  static getExpSymbols(): RegExp {
-    return new RegExp(`^(${this.symbolsToString()}|[\\w-]+(?=[|]))(.*?)$`)
-  }
-
-  /**
-   * Converting symbol keys to strings.
-   *
-   * Преобразование ключей-символов в строки.
-   */
-  private static symbolsToString(): string {
-    return Object.keys(this.SYMBOLS).join('|')
-  }
-}

package/src/classes/Properties/PropertiesValues.ts

@@ -1,75 +0,0 @@
-// export:none
-
-import { type PropertyItemPartial } from '../../types/propertyTypes'
-
-/**
- * Utility class for validating and normalizing design system property values.
- *
- * Утилитарный класс для валидации и нормализации значений свойств дизайн-системы.
- */
-export class PropertiesValues {
-  /**
-   * Checks if the value is marked as "full" (starting with `=`), meaning it doesn't require further processing.
-   *
-   * Проверяет, помечено ли значение как «полное» (начинается с `=`), что означает отсутствие необходимости дальнейшей обработки.
-   * @param value property value / значение свойства
-   */
-  static isFull(value: PropertyItemPartial['value']): value is string {
-    return typeof value === 'string' && Boolean(value.match(this.getExpFull()))
-  }
-
-  /**
-   * Identifies if the value is a hex color string.
-   *
-   * Определяет, является ли значение строкой цвета в формате HEX.
-   * @param value property value / значение свойства
-   */
-  static isColor(value: PropertyItemPartial['__c']): boolean {
-    return Boolean(
-      typeof value === 'string' && (
-        value.match(/^#/i)
-      )
-    )
-  }
-
-  /**
-   * Identifies if the value is a hex color string with an alpha channel (opacity).
-   *
-   * Определяет, является ли значение строкой цвета HEX с альфа-каналом (прозрачностью).
-   * @param value property value / значение свойства
-   */
-  static isColorWithOpacity(value: PropertyItemPartial['__c']): boolean {
-    return Boolean(
-      typeof value === 'string' && (
-        value.match(/^#[a-z0-9]{8}/i)
-      )
-    )
-  }
-
-  /**
-   * Cleans up the value by removing the "full" marker or converting numeric values to strings.
-   *
-   * Очищает значение, удаляя маркер «полноты» или преобразовывая числовые значения в строки.
-   * @param value property value / значение свойства
-   */
-  static reValue(value: PropertyItemPartial['value']): PropertyItemPartial['value'] {
-    if (this.isFull(value)) {
-      return value.replace(this.getExpFull(), '')
-    }
-
-    if (typeof value === 'number') {
-      return value.toString()
-    }
-
-    return value
-  }
-
-  /**
-   * Returns a regular expression for validating the format of a value.
-   *
-   * Возвращает регулярное выражение для проверки полного формата значения.
-   */
-  static getExpFull(): RegExp {
-    return /^=/
-  }
-}

package/src/classes/Properties/PropertiesWrap.ts

@@ -1,187 +0,0 @@
-// export:none
-
-import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
-
-import {
-  PropertyKey,
-  type PropertyList,
-  type PropertyWrapFocus,
-  type PropertyWrapItem,
-  type PropertyWrapList
-} from '../../types/propertyTypes'
-
-/**
- * Utility class for optimizing the property structure by moving duplicated data to a higher level.
- *
- * Утилитарный класс для оптимизации структуры свойств путем переноса дублирующихся данных на более высокий уровень.
- */
-export class PropertiesWrap {
-  /**
-   * Analyzes the property list and moves duplicate properties to the parent level to reduce redundancy.
-   *
-   * Анализирует список свойств и переносит дублирующиеся свойства на родительский уровень для уменьшения избыточности.
-   * @param properties property list to transform / список свойств для преобразования
-   */
-  static to(properties: PropertyList): void {
-    forEach(properties, (item) => {
-      if (isObjectNotArray(item.value)) {
-        this.to(item.value)
-
-        if (item?.[PropertyKey.wrap]) {
-          const value = item.value
-          const selectors = this.getSelectors(value)
-
-          if (selectors.quantity > 1) {
-            forEach(selectors.properties, (property, name) => {
-              if (name in value) {
-                const valueName = value[name]?.value
-
-                if (typeof valueName === 'string') {
-                  this.removeProperties(name, property?.values?.[valueName])
-                }
-              } else if (property.quantity === selectors.quantity) {
-                const repeat = this.getMaxRepeat(property.values)
-
-                if (repeat) {
-                  value[name] = {
-                    ...repeat.item[0]?.[name],
-                    value: repeat.value
-                  }
-
-                  this.removeProperties(name, repeat.item)
-                }
-              }
-            })
-          }
-
-          delete item[PropertyKey.wrap]
-        }
-      }
-    })
-  }
-
-  /**
-   * Adds a new property if it does not exist and returns an object to work with this property.
-   *
-   * Добавляет новое свойство, если его нет, и возвращает объект для работы с этим свойством.
-   * @param data object with all the collected data/ объект со всеми собранными данными
-   * @param name the name of the property/ название свойства
-   */
-  private static getSelector(
-    data: PropertyWrapList['properties'],
-    name: string
-  ): PropertyWrapItem {
-    if (!(name in data)) {
-      data[name] = {
-        values: {},
-        quantity: 0
-      }
-    }
-
-    return data[name] as PropertyWrapItem
-  }
-
-  /**
-   * The method processes the properties and returns all the names of the property and its values.
-   *
-   * Метод обрабатывает свойства и возвращает все названия свойства и его значения.
-   * @param properties an array that needs to be transformed/
-   * массив, который нужно преобразовать
-   */
-  private static getSelectors(properties: PropertyList): PropertyWrapList {
-    const data: PropertyWrapList = {
-      properties: {},
-      quantity: 0
-    }
-
-    forEach(properties, (item) => {
-      if (isObjectNotArray(item.value)) {
-        data.quantity++
-        this.addItem(data.properties, item.value)
-      }
-    })
-
-    return data
-  }
-
-  /**
-   * Returns values with maximum repetitions.
-   *
-   * Возвращает значения с максимальными повторами.
-   * @param properties values for verification/ значения для проверки
-   */
-  private static getMaxRepeat(properties: PropertyWrapItem['values']): PropertyWrapFocus | undefined {
-    let max = 0
-    let focus: PropertyWrapFocus | undefined
-
-    forEach(properties, (item, value) => {
-      if (
-        item.length > 1 && (
-          item.length > max
-          || focus === undefined
-        )
-      ) {
-        max = item.length
-        focus = {
-          value,
-          item
-        }
-      }
-    })
-
-    return focus
-  }
-
-  /**
-   * Adds values to the current property and returns an array for adding a data source.
-   *
-   * Добавляет значения к текущему свойству и возвращает массив для добавления источника данных.
-   * @param selector an object to work with the current property/ объект для работы с текущим свойством
-   * @param value the value of the property/ значение свойства
-   */
-  private static getValue(
-    selector: PropertyWrapItem,
-    value: string
-  ): PropertyList[] {
-    if (!(value in selector.values)) {
-      selector.values[value] = []
-    }
-
-    return selector.values[value] as PropertyList[]
-  }
-
-  /**
-   * Adding information about the property and its values.
-   *
-   * Добавления информация об свойство и его значения.
-   * @param data object with all the collected data/ объект со всеми собранными данными
-   * @param properties list of properties/ свойств
-   */
-  private static addItem(
-    data: PropertyWrapList['properties'],
-    properties: PropertyList
-  ): void {
-    forEach(properties, (item, name) => {
-      const selector = this.getSelector(data, name)
-      const values = this.getValue(selector, item.value as string)
-
-      selector.quantity++
-      values.push(properties)
-    })
-  }
-
-  /**
-   * Deletes all records with the property that was moved up the tree.
-   *
-   * Удаляет все записи с свойством, которое было перенесено выше по дереву.
-   * @param name the name of the property for deletion/ название свойства для удаления
-   * @param properties an array with properties by the same values/
-   * массив со свойствами по одинаковым значениям
-   */
-  private static removeProperties(
-    name: string,
-    properties?: PropertyList[]
-  ): void {
-    properties?.forEach(item => delete item[name])
-  }
-}

package/src/classes/Properties/convector/convectorColor.ts

@@ -1,27 +0,0 @@
-// export:none
-
-import {
-  type PropertyItemInput,
-  PropertyKey
-} from '../../../types/propertyTypes'
-
-/**
- * Convector for transforming design token color metadata into internal property structures.
- * Supports opacity modification based on 'studio.tokens' extensions.
- *
- * Конвектор для преобразования метаданных цвета токенов дизайна во внутренние структуры свойств.
- * Поддерживает модификацию прозрачности на основе расширений 'studio.tokens'.
- * @param item property input object for conversion / входной объект свойства для преобразования
- */
-export function convectorColor(item: PropertyItemInput): void {
-  const type: string | undefined = item?.$extensions?.['studio.tokens']?.modify?.type
-  const value: string | undefined = item?.$extensions?.['studio.tokens']?.modify?.value
-
-  if (type) {
-    switch (type) {
-      case 'alpha':
-        item[PropertyKey.cssColorOpacity] = value?.toString() ?? '1'
-        break
-    }
-  }
-}

package/src/classes/Properties/convector/convectorFontFamilies.ts

@@ -1,18 +0,0 @@
-// export:none
-
-import { type PropertyItemInput } from '../../../types/propertyTypes'
-
-/**
- * Data conversion to standard fonts.
- *
- * Преобразование данных в соответствие стандартным шрифтам.
- * @param item values for conversion/ значения для преобразования
- */
-export function convectorFontFamilies(item: PropertyItemInput): void {
-  if (
-    typeof item?.value === 'string'
-    && !item.value.match(/[{}]/)
-  ) {
-    item.value = `'${item.value}', sans-serif`
-  }
-}

package/src/classes/Properties/convector/convectorShadow.ts

@@ -1,61 +0,0 @@
-// export:none
-
-import { isObject, toArray } from '@dxtmisha/functional-basic'
-
-import { type PropertyItemInput } from '../../../types/propertyTypes'
-
-export type ConvectorShadowItem = {
-  type: string
-  color: string
-  x: string
-  y: string
-  blur: string
-  spread: string
-}
-
-/**
- * Transforming data into shadow.
- *
- * Преобразование данных в тень.
- * @param item values for conversion/ значения для преобразования
- */
-export function convectorShadow(item: PropertyItemInput): void {
-  const data: string | ConvectorShadowItem | ConvectorShadowItem[] = item?.value
-
-  if (isObject(data)) {
-    const shadows: string[] = []
-
-    toArray(data)
-      .forEach((item) => {
-        const shadow: string[] = []
-        const {
-          type,
-          color,
-          x,
-          y,
-          blur,
-          spread
-        } = item
-
-        const colorValue = color.match(/^{/)
-          ? `@ui.toCustomVarRgb(${color})`
-          : color
-
-        if (type === 'innerShadow') {
-          shadow.push('inset')
-        }
-
-        shadow.push(
-          x && x !== '0' && x.match(/^[0-9]+$/) ? `${x}px` : x ?? '0',
-          y && y !== '0' && y.match(/^[0-9]+$/) ? `${y}px` : y ?? '0',
-          blur && blur !== '0' && blur.match(/^[0-9]+$/) ? `${blur}px` : blur ?? '0',
-          spread && spread !== '0' && spread.match(/^-?[0-9]+$/) ? `${spread}px` : spread ?? '0',
-          colorValue ?? 'rgba(0, 0, 0, 1)'
-        )
-
-        shadows.push(shadow.join(' ').trim())
-      })
-
-    item.value = shadows.join(', ')
-  }
-}

package/src/classes/Properties/convector/convectorTypography.ts

@@ -1,19 +0,0 @@
-// export:none
-
-import { isString } from '@dxtmisha/functional-basic'
-
-import { type PropertyItemInput } from '../../../types/propertyTypes'
-
-/**
- * Conversion for working with the typography type.
- *
- * Конвертация для работы с типом типография.
- * @param item values for conversion/ значения для преобразования
- */
-export function convectorTypography(item: PropertyItemInput): void {
-  if (isString(item?.value)) {
-    item.value = {
-      basic: item.value
-    }
-  }
-}

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

@@ -1,51 +0,0 @@
-// export:none
-
-import { PropertiesItems } from '../PropertiesItems'
-
-/**
- * Abstract base class for data transformation processes.
- * Provides the core orchestration for initializing and writing transformed property data.
- *
- * Абстрактный базовый класс для процессов преобразования данных.
- * Обеспечивает основную оркестровку инициализации и записи преобразованных данных свойств.
- */
-export abstract class PropertiesToAbstract {
-  /**
-   * Abstract property defining the cache file path for the specific transformation.
-   *
-   * Абстрактное свойство, определяющее путь к файлу кэша для конкретного преобразования.
-   */
-  protected readonly abstract FILE_CACHE: string
-
-  /**
-   * Constructor that initializes the transformation with a set of property items.
-   *
-   * Конструктор, который инициализирует преобразование набором элементов свойств.
-   * @param items data for processing / данные для обработки
-   */
-  constructor(
-    protected items: PropertiesItems
-  ) {
-  }
-
-  /**
-   * Executes the full transformation pipeline: initialization followed by writing the output.
-   *
-   * Выполняет полный конвейер преобразования: инициализацию с последующей записью результата.
-   */
-  to(): void {
-    this.init()
-    this.write()
-  }
-
-  protected abstract init(): void
-
-  /**
-   * Saves intermediate data.
-   *
-   * Сохраняет промежуточные данные.
-   */
-  protected write(): void {
-    this.items.write(this.FILE_CACHE)
-  }
-}