@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Design/DesignScreenshot.ts

@@ -1,133 +0,0 @@
-import { spawn } from 'node:child_process'
-import { ServerStorage } from '@dxtmisha/functional-basic'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { BrowserItem } from '../BrowserItem'
-
-/**
- * Class for automatic capturing of screenshots by running dev server.
- *
- * Класс для автоматического захвата скриншотов путем запуска сервера разработки.
- */
-export class DesignScreenshot {
-  /** indicates if screenshot process is running / указывает, запущен ли процесс создания скриншота */
-  protected isReading: boolean = false
-
-  /** server url / URL сервера */
-  protected url?: string
-
-  /**
-   * Constructor
-   * @param file output path / путь к файлу
-   */
-  constructor(
-    protected readonly file: string = './ai-screenshot/screenshot'
-  ) {
-    ServerStorage.setErrorStatus(true)
-  }
-
-  /**
-   * starts the screenshot process.
-   *
-   * Запускает процесс создания скриншота.
-   */
-  async make() {
-    console.info('Screenshot')
-
-    PropertiesFile.createDir(PropertiesFile.getPathDir(this.file + '.file'))
-    this.makeServer()
-  }
-
-  /**
-   * screenshot trigger listener.
-   *
-   * Слушатель триггера для создания скриншота.
-   * @returns capture success status / статус успешного захвата
-   */
-  protected readonly listener = async (): Promise<boolean> => {
-    if (
-      this.url
-      && !this.isReading
-    ) {
-      this.isReading = true
-
-      console.info('URL', this.url)
-
-      const browser = new BrowserItem(this.url, { height: 1024 * 12 })
-      await browser.screenshot(this.file)
-
-      PropertiesFile.writeByPath(
-        `${this.file}-code.html`,
-        await browser.getBody()
-      )
-      PropertiesFile.writeByPath(
-        `${this.file}-styles.css`,
-        await browser.getStyles()
-      )
-
-      return true
-    }
-
-    return false
-  }
-
-  /**
-   * spawns development server.
-   *
-   * Запускает сервер разработки.
-   * @returns this instance / этот экземпляр
-   */
-  protected makeServer(): this {
-    const server = spawn(
-      'npm',
-      ['run', 'dev'],
-      {
-        shell: true,
-        stdio: 'pipe'
-      }
-    )
-
-    server.stdout?.on('data', (data) => {
-      console.log('Server', 'start')
-
-      const dataString = data.toString()
-      this.makeUrl(dataString)
-
-      if (this.url) {
-        console.info('Server', 'init')
-
-        this.listener()
-          .then((success: boolean) => {
-            if (success) {
-              server.kill()
-
-              console.info('Server', 'kill')
-            }
-          })
-      }
-    })
-
-    server.stderr?.on('data', (data) => {
-      console.error(`Server Error: ${data.toString()}`)
-    })
-
-    return this
-  }
-
-  /**
-   * extracts server url from console output.
-   *
-   * Извлекает URL сервера из консольного вывода.
-   * @param data command output / вывод команды
-   * @returns this instance / этот экземпляр
-   */
-  makeUrl(data: string): this {
-    const match = data.match(/(https?:\/\/localhost\S+)/)
-
-    if (match) {
-      this.url = match[1]
-    }
-
-    return this
-  }
-}

package/src/classes/Design/DesignStructure.ts

@@ -1,201 +0,0 @@
-// export:none
-
-import { toCamelCase, toCamelCaseFirst } from '@dxtmisha/functional-basic'
-
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { PropertiesCache } from '../Properties/PropertiesCache'
-import { DesignStructureRead } from './DesignStructureRead'
-import { DesignStructureClasses } from './DesignStructureClasses'
-import { DesignStructureStyles } from './DesignStructureStyles'
-
-import type {
-  DesignStructureClassesList,
-  DesignStructureList
-} from '../../types/designTypes'
-
-import {
-  UI_DIR_STRUCTURE,
-  UI_STRUCTURE_CLASSES
-} from '../../config'
-
-/**
- * Class for managing and resolving the data structure of a design system component.
- * It serves as a central hub for reading component metadata, generating class mappings, and resolving style tokens.
- *
- * Класс для управления и разрешения структуры данных компонента дизайн-системы.
- * Служит центральным узлом для чтения метаданных компонента, генерации маппингов классов и разрешения стилевых токенов.
- */
-export class DesignStructure {
-  protected readonly component: string
-
-  protected items?: DesignStructureList
-  protected itemsClasses?: DesignStructureClassesList
-  protected itemsStyles?: string[]
-
-  /**
-   * Constructor for DesignStructure.
-   *
-   * Конструктор для DesignStructure.
-   * @param component component name or identifier / название или идентификатор компонента
-   */
-  constructor(
-    component?: string
-  ) {
-    this.component = toCamelCase(component ?? 'component')
-  }
-
-  /**
-   * Getting all data from the structure.
-   *
-   * Получение всех данных из структуры.
-   */
-  get(): DesignStructureList {
-    if (this.items === undefined) {
-      this.items = this.make()
-    }
-
-    return this.items
-  }
-
-  /**
-   * Obtaining a list of subclasses from a structure.
-   *
-   * Получение списка подклассов из структуры.
-   */
-  getClasses(): DesignStructureClassesList {
-    if (this.itemsClasses === undefined) {
-      this.itemsClasses = this.makeClasses()
-    }
-
-    return this.itemsClasses
-  }
-
-  /**
-   * Returns all styles from tokens.
-   *
-   * Возвращает все стили из токенов.
-   */
-  getStyles(): string[] {
-    if (this.itemsStyles === undefined) {
-      this.itemsStyles = this.makeStyles()
-    }
-
-    return this.itemsStyles
-  }
-
-  /**
-   * Returns the name of the design.
-   *
-   * Возвращает название дизайна.
-   */
-  getDesign(): string {
-    return PropertiesConfig.getDesignName()
-  }
-
-  /**
-   * Returns the name of the design with a capital letter.
-   *
-   * Возвращает название дизайна с заглавной буквы.
-   */
-  getDesignFirst(): string {
-    return toCamelCaseFirst(PropertiesConfig.getDesignName())
-  }
-
-  /**
-   * Returns the name of the component.
-   *
-   * Возвращает название компонента.
-   */
-  getComponentName(): string {
-    return this.component
-  }
-
-  /**
-   * Returns the name of the component with a capital letter.
-   *
-   * Возвращает название компонента с заглавной буквой.
-   */
-  getComponentNameFirst(): string {
-    return toCamelCaseFirst(this.component)
-  }
-
-  /**
-   * Returns the full name of the component, including design and component name.
-   *
-   * Возвращает полное название компонента, включая название дизайна и компонента.
-   */
-  getFullComponentName(): string {
-    const design = this.getDesignFirst()
-    const component = this.getComponentNameFirst()
-
-    return `${design}${component}`
-  }
-
-  /**
-   * Returns the names of component files.
-   *
-   * Возвращает названия файлов компонентов.
-   */
-  getFileName(): string {
-    return toCamelCaseFirst(this.getPathName())
-  }
-
-  /**
-   * Returns the name of the cache file.
-   * It contains all processed properties.
-   *
-   * Возвращает название файла для кэша.
-   * Это полный массив со всеми обработанными свойствами.
-   */
-  getPathName(): string {
-    return `${PropertiesConfig.getDesignName()}-${this.component}`
-  }
-
-  /**
-   * Returns the name of the file with data about the subclass.
-   *
-   * Возвращает название файла с данными о подклассе.
-   */
-  protected getPathClasses(): string {
-    return `${this.getPathName()}-${UI_STRUCTURE_CLASSES}`
-  }
-
-  /**
-   * Data generation.
-   *
-   * Генерация данных.
-   */
-  protected make(): DesignStructureList {
-    return PropertiesCache.get<DesignStructureList>(
-      [UI_DIR_STRUCTURE],
-      this.getPathName(),
-      () => {
-        return new DesignStructureRead(this.component).get()
-      }
-    )
-  }
-
-  /**
-   * Generation of data for the subclass.
-   *
-   * Генерация данных для подкласса.
-   */
-  protected makeClasses(): DesignStructureClassesList {
-    return PropertiesCache.get<DesignStructureClassesList>(
-      [UI_DIR_STRUCTURE],
-      this.getPathClasses(),
-      () => {
-        return new DesignStructureClasses(this.component).get()
-      }
-    )
-  }
-
-  /**
-   * Performing transformation of tokens into styles for the component.
-   *
-   * Выполнение преобразования токенов в стили для компонента.
-   */
-  protected makeStyles(): string[] {
-    return new DesignStructureStyles(this.component).get()
-  }
-}

package/src/classes/Design/DesignStructureClasses.ts

@@ -1,105 +0,0 @@
-// export:none
-
-import { forEach, isFilled, isObjectNotArray, toCamelCase } from '@dxtmisha/functional-basic'
-
-import { DesignStructureItemAbstract } from './DesignStructureItemAbstract'
-
-import {
-  type PropertyItem,
-  PropertyKey,
-  PropertyType
-} from '../../types/propertyTypes'
-import {
-  type DesignStructureClassesList
-} from '../../types/designTypes'
-
-/**
- * Class for resolving and generating a hierarchical list of CSS classes for a component.
- * It recursively parses component properties to identify subclasses and build BEM-compliant class names.
- *
- * Класс для разрешения и генерации иерархического списка CSS-классов для компонента.
- * Рекурсивно анализирует свойства компонента для идентификации подклассов и построения имен классов, соответствующих BEM.
- */
-export class DesignStructureClasses extends DesignStructureItemAbstract<DesignStructureClassesList> {
-  protected data: DesignStructureClassesList = []
-
-  /**
-   * Constructor for DesignStructureClasses.
-   *
-   * Конструктор для DesignStructureClasses.
-   * @param component component name used as the base for class generation / имя компонента, используемое в качестве базы для генерации классов
-   */
-  constructor(
-    component: string
-  ) {
-    super(component)
-    this.data = this.make(this.items?.value)
-  }
-
-  /**
-   * Returns records that meet state conditions.
-   *
-   * Возвращает записи, удовлетворяющие условиям состояния.
-   * @param properties input data/ входной данный
-   * @param parent ancestor name/ название предка
-   */
-  protected make(
-    properties?: PropertyItem['value'],
-    parent: string[] = []
-  ): DesignStructureClassesList {
-    const list: DesignStructureClassesList = []
-    if (
-      isFilled(properties)
-      && isObjectNotArray(properties)
-    ) {
-      forEach(properties, (item) => {
-        if (this.isClasses(item)) {
-          const names = this.getNames(item, parent)
-
-          list.push(
-            {
-              index: toCamelCase(names.join('-')),
-              full: item?.[PropertyKey.fullName] ?? false,
-              className: names.join('__')
-            },
-            ...this.make(item?.value, names)
-          )
-        }
-      })
-    }
-
-    return list
-  }
-
-  /**
-   * Does this property belong to the class.
-   *
-   * Является ли это свойство частью класса.
-   * @param item object for checking/ объект для проверки
-   */
-  protected isClasses(item: PropertyItem): boolean {
-    return Boolean(
-      item?.[PropertyKey.variable] === PropertyType.subclass || item?.[PropertyKey.subclass]
-    )
-  }
-
-  /**
-   * Obtaining the name of the class.
-   *
-   * Получение имени класса.
-   * @param item object for checking/ объект для проверки
-   * @param parent list of names of ancestors/ список имен предков
-   */
-  protected getNames(
-    item: PropertyItem,
-    parent: string[]
-  ): string[] {
-    const name = item?.[PropertyKey.nameIndex] ?? item?.[PropertyKey.index] ?? ''
-
-    if (item?.[PropertyKey.fullName]) {
-      return [name]
-    }
-
-    return [...parent, name]
-  }
-}

package/src/classes/Design/DesignStructureItemAbstract.ts

@@ -1,52 +0,0 @@
-// export:none
-
-import { Properties } from '../Properties/Properties'
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-
-import type { PropertyItemsItem } from '../../types/propertyTypes'
-
-/**
- * Base abstract class for structural component items.
- * It provides the foundation for resolving component properties and metadata from the design system's central storage.
- *
- * Базовый абстрактный класс для структурных элементов компонента.
- * Предоставляет основу для разрешения свойств и метаданных компонента из центрального хранилища дизайн-системы.
- */
-export abstract class DesignStructureItemAbstract<D> {
-  protected properties: Properties
-  protected items?: PropertyItemsItem
-
-  protected abstract data: D
-
-  /**
-   * Constructor for DesignStructureItemAbstract.
-   *
-   * Конструктор для DesignStructureItemAbstract.
-   * @param component component name for which the structure is being resolved / имя компонента, для которого разрешается структура
-   */
-  protected constructor(
-    protected readonly component: string
-  ) {
-    this.properties = new Properties()
-    this.items = this.properties.get().getInfo(this.getLink())
-  }
-
-  /**
-   * Getting all data about dependencies of the current component.
-   *
-   * Получение всех данных об зависимостях у текущего компонента.
-   */
-  get(): D {
-    return this.data
-  }
-
-  /**
-   * Returns a reference to the component.
-   *
-   * Возвращает ссылку на компонент.
-   * Это полный массив со всеми обработанными свойствами.
-   */
-  protected getLink(): string {
-    return `{${PropertiesConfig.getDesignName()}.${this.component}}`
-  }
-}