@dxtmisha/scripts 0.11.8 → 1.0.0

package/src/classes/FigmaApi.ts

@@ -1,190 +0,0 @@
-import {
-  FIGMA_API_URL,
-  FigmaApiEndpoint,
-  type FigmaFileImagesParams,
-  type FigmaFileImagesResult,
-  type FigmaFileNodesParams,
-  type FigmaFileNodesResult,
-  type FigmaFilesParams,
-  type FigmaFilesResult,
-  type FigmaFileStylesResult,
-  type FigmaStylesResult
-} from '../types/figmaApiTypes'
-
-/**
- * Class for interacting with the Figma REST API.
- *
- * Класс для взаимодействия с Figma REST API.
- */
-export class FigmaApi {
-  constructor(
-    protected token: string,
-    protected fileKey: string,
-    protected nodeId?: string
-  ) {
-  }
-
-  /**
-   * Retrieves file content via the files endpoint.
-   *
-   * Получает содержимое файла через эндпоинт files.
-   * @param parameters query parameters / параметры запроса
-   * @returns file content or undefined / содержимое файла или undefined
-   */
-  async files(parameters: FigmaFilesParams = {}): Promise<FigmaFilesResult | undefined> {
-    return await this.fetch(FigmaApiEndpoint.files, parameters)
-  }
-
-  /**
-   * Retrieves specific nodes from the file via the fileNodes endpoint.
-   *
-   * Получает конкретные узлы из файла через эндпоинт fileNodes.
-   * @param parameters query parameters / параметры запроса
-   * @returns node data or undefined / данные узлов или undefined
-   */
-  async fileNodes(parameters: FigmaFileNodesParams): Promise<FigmaFileNodesResult | undefined> {
-    return await this.fetch(FigmaApiEndpoint.fileNodes, parameters)
-  }
-
-  /**
-   * Retrieves images for the file.
-   *
-   * Получает изображения для файла.
-   * @param parameters query parameters / параметры запроса
-   * @returns image data or undefined / данные изображения или undefined
-   */
-  async fileImages(parameters: FigmaFileImagesParams): Promise<FigmaFileImagesResult | undefined> {
-    return await this.fetch(FigmaApiEndpoint.fileImages, parameters)
-  }
-
-  /**
-   * Retrieves specific nodes from the file via the fileStyles endpoint.
-   *
-   * Получает конкретные узлы из файла через эндпоинт fileStyles.
-   * @returns file styles data or undefined / данные стилей файла или undefined
-   */
-  async fileStyles(): Promise<FigmaFileStylesResult | undefined> {
-    return await this.fetch(FigmaApiEndpoint.fileStyles)
-  }
-
-  /**
-   * Retrieves specific style by key via the styles endpoint.
-   *
-   * Получает конкретный стиль по ключу через эндпоинт styles.
-   * @param key the style key / ключ стиля
-   * @returns style data or undefined / данные стиля или undefined
-   */
-  async styles(key: string): Promise<FigmaStylesResult | undefined> {
-    return await this.fetch(FigmaApiEndpoint.styles, undefined, key)
-  }
-
-  /**
-   * Sets the API token.
-   *
-   * Устанавливает токен API.
-   * @param token the API token / токен API
-   * @returns this instance for chaining / этот экземпляр для цепочки вызовов
-   */
-  setToken(token: string): this {
-    this.token = token
-    return this
-  }
-
-  /**
-   * Sets the file key.
-   *
-   * Устанавливает ключ файла.
-   * @param fileKey the file key / ключ файла
-   * @returns this instance for chaining / этот экземпляр для цепочки вызовов
-   */
-  setFileKey(fileKey: string): this {
-    this.fileKey = fileKey
-    return this
-  }
-
-  /**
-   * Sets the node ID.
-   *
-   * Устанавливает ID узла.
-   * @param nodeId the node ID (optional) / ID узла (необязательно)
-   * @returns this instance for chaining / этот экземпляр для цепочки вызовов
-   */
-  setNodeId(nodeId?: string): this {
-    this.nodeId = nodeId
-    return this
-  }
-
-  /**
-   * Constructs the request URL for the Figma API.
-   *
-   * Конструирует URL-адрес запроса для Figma API.
-   * @param method the API endpoint method / метод конечной точки API
-   * @param parameters additional parameters for the request / дополнительные параметры для запроса
-   * @param key the key for specific endpoints (e.g., styles) / ключ для конкретных эндпоинтов (например, styles)
-   * @returns the constructed URL / сконструированный URL
-   */
-  getUrl(
-    method: FigmaApiEndpoint,
-    parameters?: Record<string, any>,
-    key?: string
-  ) {
-    const request = {}
-    const endpoint = method
-      .replace(':file_key', this.fileKey)
-      .replace(':key', key ?? '')
-
-    if (this.nodeId) {
-      Object.assign(request, { 'node-id': this.nodeId })
-    }
-
-    if (parameters) {
-      Object.assign(request, parameters)
-    }
-
-    console.log('request', request, Object.keys(request).length)
-
-    const queryParams = Object.keys(request).length > 0
-      ? `?${new URLSearchParams(request).toString()}`
-      : ''
-
-    return `${FIGMA_API_URL}${endpoint}${queryParams}`
-  }
-
-  /**
-   * Generic fetch method for making API requests.
-   *
-   * Общий метод fetch для выполнения запросов к API.
-   * @param method the API endpoint method / метод конечной точки API
-   * @param parameters parameters for the request / параметры запроса
-   * @param key the key for specific endpoints (e.g., styles) / ключ для конкретных эндпоинтов (например, styles)
-   * @returns the response data or undefined / данные ответа или undefined
-   */
-  protected async fetch(
-    method: FigmaApiEndpoint,
-    parameters: Record<string, any> = {},
-    key?: string
-  ): Promise<any> {
-    const url = this.getUrl(method, parameters, key)
-    const headers = {
-      'X-Figma-Token': this.token,
-      'Content-Type': 'application/json'
-    }
-
-    console.log('url', url)
-
-    const response = await fetch(url, {
-      method: 'GET',
-      headers
-    })
-
-    console.log('response', response.ok)
-
-    if (response.ok) {
-      return response.json()
-    }
-
-    console.error(`Error fetching Figma API: ${response.status} ${response.statusText}`)
-
-    return undefined
-  }
-}

package/src/classes/Git/GitRead.ts

@@ -1,261 +0,0 @@
-import { execSync } from 'node:child_process'
-import { Datetime, forEach, removeCommonPrefix } from '@dxtmisha/functional-basic'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import { type GitFileList, GitStatus } from '../../types/gitTypes'
-
-/**
- * Class for reading information from Git repository.
- *
- * Класс для чтения информации из Git репозитория.
- */
-export class GitRead {
-  /**
-   * Gets list of files with their metadata.
-   *
-   * Получает список файлов с их метаданными.
-   * @param filter - file filter function / функция фильтрации файлов
-   */
-  static getList(
-    filter?: (file: string) => boolean
-  ): GitFileList {
-    const dir = this.getDirPrefix()
-
-    return forEach(
-      this.getFilesPath(),
-      (file) => {
-        if (
-          filter
-          && !filter(file)
-        ) {
-          return
-        }
-
-        const date = this.getDate(this.getFileDate(file))
-
-        return {
-          path: file,
-          pathByOS: this.splitPath(file),
-          pathFull: `${dir}${file}`,
-          date,
-          status: undefined
-        }
-      }
-    ) as GitFileList
-  }
-
-  /**
-   * Gets list of files in porcelain format with their metadata.
-   *
-   * Получает список файлов в формате porcelain с их метаданными.
-   * @param filter - file filter function / функция фильтрации файлов
-   */
-  static getListPorcelain(
-    filter?: (file: string) => boolean
-  ): GitFileList {
-    const date = this.getDate()
-    const prefix = this.getDirPrefix()
-
-    return forEach(
-      this.getFilesPorcelain(),
-      (file) => {
-        const data = file
-          .replace(/ {2,}/, ' ')
-          .split(' ', 2)
-
-        const status = data[0] as GitStatus
-        const path: string = data[1] ?? ''
-
-        if (
-          filter
-          && !filter(path)
-        ) {
-          return
-        }
-
-        const pathCommonPrefix = removeCommonPrefix(path, prefix)
-        const pathByOS = this.splitPath(pathCommonPrefix)
-        const fileDate = PropertiesFile.getTime(pathByOS)
-
-        return {
-          path: pathCommonPrefix,
-          pathByOS,
-          pathFull: path,
-          date: fileDate ?? date,
-          status
-        }
-      }
-    ) as GitFileList
-  }
-
-  /**
-   * Gets unique list of files from both standard and porcelain lists.
-   *
-   * Получает уникальный список файлов из обоих стандартных и porcelain списков.
-   * @param filter - file filter function / функция фильтрации файлов
-   */
-  static getListUnique(
-    filter: (file: string) => boolean
-  ): GitFileList {
-    return this.mergeUnique(
-      this.getListPorcelain(filter),
-      this.getList(filter)
-    )
-  }
-
-  /**
-   * Gets list of files by directory with .ts extension, excluding test files.
-   *
-   * Получает список файлов по директории с расширением .ts, исключая тестовые файлы.
-   * @param directory - directory path or regex / путь к директории или регулярное выражение
-   */
-  static getListByDirectory(
-    directory: string | RegExp
-  ) {
-    return this.getListUnique(
-      (file: string) => Boolean(
-        file.match(directory)
-        && file.endsWith('.ts')
-        && !file.endsWith('.test.ts')
-      )
-    )
-  }
-
-  /**
-   * Gets list of class files (*.ts in /classes/ directory).
-   *
-   * Получает список файлов классов (*.ts в директории /classes/).
-   */
-  static getClassesList(): GitFileList {
-    return this.getListByDirectory('/classes/')
-  }
-
-  /**
-   * Gets list of class files (*.ts in /classes/ directory).
-   *
-   * Получает список файлов классов (*.ts в директории /classes/).
-   */
-  static getFunctionsList(): GitFileList {
-    return this.getListByDirectory('/functions/')
-  }
-
-  /**
-   * Gets list of all file paths in repository.
-   *
-   * Получает список всех путей файлов в репозитории.
-   */
-  static getFilesPath(): string[] {
-    return forEach(
-      this.exec('git ls-tree -r --name-only HEAD').split('\n'),
-      file => file.trim()
-    )
-  }
-
-  /**
-   * Gets list of files in porcelain format.
-   *
-   * Получает список файлов в формате porcelain.
-   */
-  static getFilesPorcelain(): string[] {
-    return forEach(
-      this.exec('git status --porcelain').split('\n'),
-      file => file.trim()
-    )
-  }
-
-  /**
-   * Gets the date of the last commit for a file.
-   *
-   * Получает дату последнего коммита для файла.
-   * @param filePath - path to file / путь к файлу
-   */
-  static getFileDate(filePath: string): string {
-    return this.exec(`git log -1 --format="%ci" -- "${filePath}"`)
-  }
-
-  /**
-   * Gets the directory prefix of the current Git repository.
-   *
-   * Получает префикс директории текущего Git репозитория.
-   */
-  static getDirPrefix(): string {
-    return this.exec('git rev-parse --show-prefix')
-  }
-
-  /**
-   * Formats a date string to standard full format.
-   *
-   * Форматирует строку даты в стандартный полный формат.
-   * @param date - date string / строка даты
-   */
-  static getDate(date?: string): string {
-    return new Datetime(date)
-      .setType('full')
-      .standard()
-  }
-
-  /**
-   * Filters a list of Git files by the current directory prefix.
-   *
-   * Фильтрует список файлов Git по префиксу текущей директории.
-   * @param list - list of Git files / список файлов Git
-   */
-  static filterByDirectory(
-    list: GitFileList
-  ): GitFileList {
-    const dir = this.getDirPrefix()
-
-    return list.filter(item => item.pathFull.startsWith(dir))
-  }
-
-  /**
-   * Merges two lists of Git files, ensuring uniqueness by file path.
-   *
-   * Объединяет два списка файлов Git, обеспечивая уникальность по пути файла.
-   * @param listA - first list to merge / первый список для объединения
-   * @param listB - lists to merge / списки для объединения
-   */
-  static mergeUnique(
-    listA: GitFileList,
-    listB: GitFileList
-  ): GitFileList {
-    const list: GitFileList = [...listA]
-
-    forEach(
-      listB,
-      (itemB) => {
-        const exists = list.find(
-          itemA => itemA.pathFull === itemB.pathFull
-        )
-
-        if (!exists) {
-          list.push(itemB)
-        }
-      }
-    )
-
-    return list
-  }
-
-  /**
-   * Splits a file path into its components.
-   *
-   * Разбивает путь файла на его компоненты.
-   * @param path - file path / путь к файлу
-   */
-  static splitPath(path: string): string[] {
-    return path.split('/').filter(part => part.length > 0)
-  }
-
-  /**
-   * Executes Git command and returns result.
-   *
-   * Выполняет Git команду и возвращает результат.
-   * @param command - command to execute / команда для выполнения
-   * @protected
-   */
-  protected static exec(command: string): string {
-    return execSync(command, { encoding: 'utf8' }).trim()
-  }
-}

package/src/classes/Library/LibraryAiMcpItem.ts

@@ -1,67 +0,0 @@
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import {
-  UI_FILE_AI_MCP
-} from '../../config'
-
-/**
- * Class representing an MCP item in the AI prompt generation process.
- * Handles reading `ai-mcp-resources.json` configuration files for a package directory.
- *
- * Класс, представляющий элемент MCP в процессе создания промпта для ИИ.
- * Управляет чтением конфигурационных файлов `ai-mcp-resources.json` для директории пакета.
- */
-export class LibraryAiMcpItem {
-  /**
-   * Constructor for LibraryAiMcpItem.
-   *
-   * Конструктор для LibraryAiMcpItem.
-   * @param dir Path segments to the directory / Сегменты пути к директории
-   */
-  constructor(
-    protected readonly dir: string[] = []
-  ) { }
-
-  /**
-   * Checks if the ai-mcp-resources.json file exists in the directory.
-   *
-   * Проверяет, существует ли файл ai-mcp-resources.json в директории.
-   * @returns true if ai-mcp-resources.json file exists / true, если файл ai-mcp-resources.json существует
-   */
-  isMcp(): boolean {
-    return PropertiesFile.is(this.getPath(UI_FILE_AI_MCP))
-  }
-
-  /**
-   * Reads and returns the list of MCP resource definitions from ai-mcp-resources.json.
-   *
-   * Читает и возвращает список определений ресурсов MCP из ai-mcp-resources.json.
-   * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
-   */
-  make(): Record<string, any>[] | undefined {
-    if (this.isMcp()) {
-      const data = PropertiesFile.readFile<Record<string, any>[]>(this.getPath(UI_FILE_AI_MCP))
-
-      if (
-        Array.isArray(data)
-        && data.length > 0
-      ) {
-        return data
-      }
-    }
-
-    return undefined
-  }
-
-  /**
-   * Constructs a full path for a file within the item's directory.
-   *
-   * Создает полный путь к файлу внутри директории элемента.
-   * @param dirFile File name / Имя файла
-   * @returns path segments / сегменты пути
-   * @protected
-   */
-  protected getPath(dirFile: string): string[] {
-    return [...this.dir, dirFile]
-  }
-}