@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Design/DesignConstructor.ts

@@ -1,222 +0,0 @@
-// export:none
-
-import { toCamelCase, toCamelCaseFirst } from '@dxtmisha/functional-basic'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import { DesignCommand } from './DesignCommand'
-
-import { UI_DIR_IN, UI_DIR_CONSTRUCTOR, UI_DIRS_LIBRARY } from '../../config'
-
-const FILE_PROPERTIES = 'properties.json'
-const FILE_PROPS = 'props.ts'
-const FILE_TYPES = 'types.ts'
-const FILE_TYPES_BASIC = 'basicTypes.ts'
-const FILE_STYLE = 'style.scss'
-const FILE_CODE = 'Constructors.ts'
-const FILE_CLASS = 'ConstructorsDesign.tsx'
-const FILE_INDEX = 'index.ts'
-
-/**
- * Class for generating files and configurations based on a component's constructor.
- * It automates the creation of property definitions, type files, styles, and integration logic for constructors.
- *
- * Класс для генерации файлов и конфигураций на основе конструктора компонента.
- * Автоматизирует создание определений свойств, файлов типов, стилей и логики интеграции для конструкторов.
- */
-export class DesignConstructor extends DesignCommand {
-  protected DIR_SAMPLE: string = UI_DIR_CONSTRUCTOR
-  protected dir: string[]
-
-  /**
-   * Constructor for DesignConstructor.
-   *
-   * Конструктор для DesignConstructor.
-   * @param command component name or command identifier / название компонента или идентификатор команды
-   * @param options additional key-value parameters / дополнительные параметры ключ-значение
-   */
-  constructor(
-    command: string,
-    options: Record<string, string> = {}
-  ) {
-    super(command, options)
-
-    this.dir = [
-      PropertiesFile.getRoot(),
-      UI_DIR_IN,
-      this.DIR_SAMPLE,
-      this.getStructure().getComponentNameFirst()
-    ]
-  }
-
-  /**
-   * Initializes the creation of all files for the current team.
-   *
-   * Инициализирует создание всех файлов для текущей команды.
-   */
-  protected initMain(): void {
-    this
-      .makeProperties()
-      .makeProps()
-      .makeTypes()
-      .makeTypesBasic()
-      .makeStyle()
-      .makeCode()
-      .makeMain()
-      .makeIndex()
-      .makeFilePackage()
-      .makeLibrary()
-  }
-
-  /**
-   * This code generates the properties.json.
-   *
-   * Генерация файла properties.json.
-   */
-  protected makeProperties(): this {
-    const file = FILE_PROPERTIES
-
-    if (!this.isFile(file)) {
-      this.write(file, '{\r\n}\r\n')
-    }
-
-    return this
-  }
-
-  /**
-   * This code generates the props.ts.
-   *
-   * Генерация файла props.ts.
-   */
-  protected makeProps(): this {
-    const file = FILE_PROPS
-    const sample = this.readDefinable(file)
-
-    sample
-      .replaceType()
-      .replaceDefault()
-      .replaceProps()
-
-    this.write(file, sample.get())
-    return this
-  }
-
-  /**
-   * This code generates the types.ts.
-   *
-   * Генерация файла types.ts.
-   */
-  protected makeTypes(): this {
-    const file = FILE_TYPES
-    const sample = this.readDefinable(file)
-
-    sample.replaceClasses()
-
-    this.write(file, sample.get())
-    return this
-  }
-
-  /**
-   * This code generates the basicTypes.ts.
-   *
-   * Генерация файла basicTypes.ts.
-   */
-  protected makeTypesBasic(): this {
-    return this.makeFileStandard(FILE_TYPES_BASIC)
-  }
-
-  /**
-   * This code generates the style.scss.
-   *
-   * Генерация файла style.scss.
-   */
-  protected makeStyle(): this {
-    const file = FILE_STYLE
-
-    if (!this.isFile(file)) {
-      const sample = this.readDefinable(file)
-      this.write(file, sample.get())
-    }
-
-    return this
-  }
-
-  /**
-   * This code generates the Constructors.ts.
-   *
-   * Генерация файла Constructors.ts.
-   */
-  protected makeCode(): this {
-    return this.makeFileStandard(FILE_CODE)
-  }
-
-  /**
-   * This code generates the ConstructorsDesign.tsx.
-   *
-   * Генерация файла ConstructorsDesign.tsx.
-   */
-  protected makeMain(): this {
-    return this.makeFileStandard(FILE_CLASS)
-  }
-
-  /**
-   * This code generates the index.ts.
-   *
-   * Генерация файла index.ts.
-   */
-  protected makeIndex(): this {
-    return this.makeFileStandard(FILE_INDEX)
-  }
-
-  /**
-   * Generates a standard file based on a template.
-   *
-   * Генерирует стандартный файл на основе шаблона.
-   * @param file file name/ имя файла
-   */
-  protected makeFileStandard(file: string): this {
-    const sample = this.readDefinable(file)
-
-    sample.replaceConstructorClasses()
-
-    this.write(sample.getNameFile(file), sample.get())
-    return this
-  }
-
-  /**
-   * Updates the package.json file.
-   *
-   * Обновляет файл package.json.
-   */
-  protected makeFilePackage(): this {
-    const command = this.getName()
-    const name = `./${command}`
-
-    this.updatePackage(
-      `exports|${name}`,
-      {
-        types: `./dist/constructors/${command}/index.d.ts`,
-        default: `./dist/${this.getNameMin()}.js`
-      }
-    )
-
-    return this
-  }
-
-  /**
-   * Generates a library file.
-   *
-   * Генерирует файл библиотеки.
-   */
-  protected makeLibrary(): this {
-    const name = toCamelCase(this.getCommand())
-
-    PropertiesFile.writeByPath(
-      [...UI_DIRS_LIBRARY, `${name}.ts`],
-      `export * from '../${UI_DIR_CONSTRUCTOR}/${toCamelCaseFirst(this.getCommand())}/index'
-`
-    )
-
-    return this
-  }
-}

package/src/classes/Design/DesignConstructors.ts

@@ -1,101 +0,0 @@
-// export:none
-
-import { isFilled, toCamelCaseFirst } from '@dxtmisha/functional-basic'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { PropertiesCache } from '../Properties/PropertiesCache'
-import { DesignConstructor } from './DesignConstructor'
-
-import { UI_DIR_CONSTRUCTOR, UI_DIR_IN, UI_DIRS_LIBRARY, UI_FILE_STYLE_SCSS } from '../../config'
-
-/**
- * Class for orchestrating the generation and update of multiple design constructors.
- * It manages the collective lifecycle of component constructors, including bulk updates and shared style generation.
- *
- * Класс для управления генерацией и обновлением нескольких конструкторов дизайна.
- * Управляет коллективным жизненным циклом конструкторов компонентов, включая массовые обновления и генерацию общих стилей.
- */
-export class DesignConstructors {
-  /**
-   * Constructor for DesignConstructors.
-   *
-   * Конструктор для DesignConstructors.
-   * @param name optional specific component name to process / необязательное имя конкретного компонента для обработки
-   */
-  constructor(
-    protected readonly name?: string
-  ) {
-  }
-
-  /**
-   * Starts the process of creating or updating constructors.
-   *
-   * Запускает процесс создания или обновления конструкторов.
-   */
-  make(): void {
-    PropertiesCache.clear()
-
-    if (isFilled(this.name)) {
-      new DesignConstructor(this.name).make()
-    } else {
-      this.getComponents()
-        .forEach((component) => {
-          console.log(`Constructor update: ${component}`)
-          new DesignConstructor(component).make()
-        })
-    }
-
-    this.makeStyle()
-  }
-
-  /**
-   * Returns a list of components.
-   *
-   * Возвращает список компонентов.
-   */
-  getComponents(): string[] {
-    return PropertiesFile.readDir(this.getDir())
-  }
-
-  /**
-   * Returns a list of component styles.
-   *
-   * Возвращает список стилей компонентов.
-   */
-  getComponentsStyle(): string[] {
-    const list: string[] = []
-
-    this.getComponents()
-      .forEach((component) => {
-        const name = toCamelCaseFirst(component)
-        list.push(`@forward "../constructors/${name}/style";`)
-      })
-
-    return list
-  }
-
-  /**
-   * Returns the directory path for constructors.
-   *
-   * Возвращает путь к директории конструкторов.
-   */
-  protected getDir(): string[] {
-    return [
-      PropertiesFile.getRoot(),
-      UI_DIR_IN,
-      UI_DIR_CONSTRUCTOR
-    ]
-  }
-
-  /**
-   * Generates a common style file.
-   *
-   * Генерирует общий файл стилей.
-   */
-  protected makeStyle(): void {
-    const path: string[] = [...UI_DIRS_LIBRARY, UI_FILE_STYLE_SCSS]
-    const styles = this.getComponentsStyle()
-
-    PropertiesFile.writeByPath(path, styles.join('\r\n'))
-  }
-}

package/src/classes/Design/DesignFigma.ts

@@ -1,61 +0,0 @@
-import { FigmaApi } from '../FigmaApi'
-import { PropertiesConfig } from '../Properties/PropertiesConfig.ts'
-
-/**
- * Class for downloading and processing design assets from Figma API.
- * Serves as an abstraction for initializing SVG graphics and frame exports from specified Figma files.
- *
- * Класс для скачивания и обработки дизайн-ассетов из Figma API.
- * Служит абстракцией для инициализации SVG-графики и экспорта кадров из указанных файлов Figma.
- */
-export class DesignFigma {
-  /** Figma REST API client instance / Экземпляр клиента REST API Figma */
-  protected readonly api: FigmaApi
-
-  /**
-   * Creates an instance of DesignFigma.
-   *
-   * Создает экземпляр DesignFigma.
-   * @param fileKey unique Figma file identifier / уникальный идентификатор файла Figma
-   * @param nodeId target node or frame identifier in Figma file / идентификатор целевого узла или кадра в файле Figma
-   * @param token Figma API access token / токен доступа к API Figma
-   */
-  constructor(
-    protected readonly fileKey: string,
-    protected readonly nodeId?: string,
-    protected readonly token: string = PropertiesConfig.getFigmaToken()
-  ) {
-    this.api = new FigmaApi(token, fileKey, nodeId)
-  }
-
-  /**
-   * Executes the main workflow for retrieving and logging Figma design image assets.
-   *
-   * Выполняет основной процесс получения и логирования графических ассетов дизайна Figma.
-   */
-  async make(): Promise<void> {
-    console.log('Design Figma', await this.initImage())
-  }
-
-  /**
-   * Requests SVG image export URLs for the specified node from Figma API.
-   *
-   * Запрашивает URL-адреса экспорта SVG-изображений для указанного узла через API Figma.
-   * @returns map of node IDs to SVG image URLs, or undefined on error / карта ID узлов к URL SVG-изображений или undefined в случае ошибки
-   */
-  async initImage(): Promise<Record<string, string> | undefined> {
-    const image = await this.api.fileImages({
-      ids: this.nodeId as string,
-      format: 'svg',
-      svg_outline_text: false,
-      svg_include_id: true,
-      svg_include_node_id: true
-    })
-
-    if (image?.err) {
-      return undefined
-    }
-
-    return image?.images
-  }
-}

package/src/classes/Design/DesignFlags.ts

@@ -1,215 +0,0 @@
-// export:none
-
-import { Canvas, createCanvas, loadImage, type SKRSContext2D } from '@napi-rs/canvas'
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import type { DesignFlagsItem, DesignFlagsList } from '../../types/designTypes'
-
-import { UI_DIR_IN } from '../../config'
-
-const DESIGN_FLAGS_FACTOR = 2
-const DESIGN_FLAGS_MIME = 'image/webp'
-const DESIGN_FLAGS_FILE_NAME_ITEM = 'flags.webp'
-const DESIGN_FLAGS_FILE_NAME = [UI_DIR_IN, 'assets', DESIGN_FLAGS_FILE_NAME_ITEM]
-const DESIGN_FLAGS_FILE_PATH = ['.', '..', 'assets', DESIGN_FLAGS_FILE_NAME_ITEM]
-const DESIGN_FLAGS_FILE_STYLE_NAME = [UI_DIR_IN, 'styles', 'flags.css']
-const DESIGN_FLAGS_CLASS_NAME = '.ui-sys-flags'
-
-/**
- * Class for generating a sprite image and CSS mapping from a directory of flag icons.
- * It automates the creation of a combined webp image and a CSS file with specific background-position utility classes.
- *
- * Класс для генерации спрайта и CSS-маппинга из директории иконок флагов.
- * Автоматизирует создание комбинированного изображения webp и CSS-файла с утилитарными классами для позиционирования фона.
- */
-export class DesignFlags {
-  protected list: string[]
-  protected data: DesignFlagsList = []
-
-  protected x: number = 0
-  protected y: number = 0
-
-  protected square: number
-  protected top: number
-  protected left: number
-
-  protected readonly canvas: Canvas
-  protected readonly context: SKRSContext2D
-
-  /**
-   * Constructor for DesignFlags.
-   *
-   * Конструктор для DesignFlags.
-   * @param dir path to the directory containing SVG icons / путь к директории с SVG-иконками
-   * @param width width of a single flag in the sprite / ширина одного флага в спрайте
-   * @param height height of a single flag in the sprite / высота одного флага в спрайте
-   * @param columns number of columns in the sprite grid / количество колонок в сетке спрайта
-   */
-  constructor(
-    protected readonly dir: string = 'src/assets/flags',
-    protected readonly width: number = 96,
-    protected readonly height: number = 72,
-    protected readonly columns: number = 12
-  ) {
-    this.list = this.initList()
-    this.square = this.initSquare()
-    this.top = this.initTop()
-    this.left = this.initLeft()
-
-    this.canvas = this.initCanvas()
-    this.context = this.initContext()
-  }
-
-  async make() {
-    for (const file of this.list) {
-      await this.addImage(file)
-
-      this.data.push(this.addData(file))
-      this.next()
-    }
-
-    this.save()
-    this.saveStyle()
-  }
-
-  getLines(): number {
-    return Math.ceil(this.list.length / this.columns)
-  }
-
-  /**
-   * Returns the maximum width of the canvas.
-   *
-   * Возвращает максимальную ширину холста.
-   */
-  protected getCanvasWidth(): number {
-    return this.columns * this.square
-  }
-
-  /**
-   * Returns the maximum height of the canvas.
-   *
-   * Возвращает максимальную высоту холста.
-   */
-  protected getCanvasHeight(): number {
-    return this.getLines() * this.square
-  }
-
-  protected getDx() {
-    return (this.x * this.square) + this.left
-  }
-
-  protected getDy() {
-    return (this.y * this.square) + this.top
-  }
-
-  protected getStyle(): string {
-    const backgroundSizeColumns = this.columns * (this.square / this.width)
-    const backgroundSizeLines = this.getLines() * (this.square / this.height)
-
-    let style: string = `
-${DESIGN_FLAGS_CLASS_NAME} {
-  --sys-flags-width: ${this.width}px;
-  --sys-flags-height: ${this.height}px;
-  --sys-flags-top: ${this.top}px;
-  --sys-flags-left: ${this.left}px;
-  --sys-flags-lines: ${this.getLines()};
-
-  background-image: url("${DESIGN_FLAGS_FILE_PATH.join('/')}");
-  background-size: calc(100% * ${backgroundSizeColumns}) calc(100% * ${backgroundSizeLines});
-}
-`.trim()
-
-    const x = 100 / (this.getCanvasWidth() - this.width)
-    const y = 100 / (this.getCanvasHeight() - this.height)
-
-    this.data.forEach((item) => {
-      style += `
-${DESIGN_FLAGS_CLASS_NAME}--${item.name} {
-  background-position: ${item.x * x}% ${item.y * y}%;
-}`
-    })
-
-    return style
-  }
-
-  protected async addImage(file: string): Promise<void> {
-    const path = PropertiesFile.joinPath([this.dir, file])
-    const image = await loadImage(path)
-
-    this.context.drawImage(
-      image,
-      this.getDx(),
-      this.getDy(),
-      this.width,
-      this.height
-    )
-  }
-
-  protected addData(file: string): DesignFlagsItem {
-    return {
-      name: file.replace(/\.[^.]+$/, ''),
-      x: this.getDx(),
-      y: this.getDy()
-    }
-  }
-
-  protected next(): void {
-    this.x++
-
-    if (this.x >= this.columns) {
-      this.x = 0
-      this.y++
-    }
-  }
-
-  protected save(): void {
-    const buffer = this.canvas.toBuffer(DESIGN_FLAGS_MIME, 64)
-
-    if (buffer) {
-      PropertiesFile.writeByPath(
-        DESIGN_FLAGS_FILE_NAME,
-        buffer,
-        false
-      )
-    }
-  }
-
-  protected saveStyle(): void {
-    PropertiesFile.writeByPath(
-      DESIGN_FLAGS_FILE_STYLE_NAME,
-      this.getStyle()
-    )
-  }
-
-  protected initCanvas(): Canvas {
-    return createCanvas(
-      this.getCanvasWidth(),
-      this.getCanvasHeight()
-    )
-  }
-
-  protected initContext(): SKRSContext2D {
-    return this.canvas.getContext('2d', { alpha: true })
-  }
-
-  protected initLeft(): number {
-    return (this.square / 2) - (this.width / 2)
-  }
-
-  protected initList(): string[] {
-    return PropertiesFile.readDir(this.dir)
-      .filter(dir => dir.endsWith('.svg'))
-  }
-
-  protected initSquare(): number {
-    if (this.width >= this.height) {
-      return this.width * DESIGN_FLAGS_FACTOR
-    }
-
-    return this.height * DESIGN_FLAGS_FACTOR
-  }
-
-  protected initTop(): number {
-    return (this.square / 2) - (this.height / 2)
-  }
-}