@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Build/BuildFunctional.ts

@@ -1,54 +0,0 @@
-import * as functional from '@dxtmisha/functional'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import { UI_DIRS_LIBRARY } from '../../config'
-
-/**
- * A class for building the functional library exports.
- *
- * Класс для сборки экспортов функциональной библиотеки.
- */
-export class BuildFunctional {
-  constructor() {
-  }
-
-  /**
-   * Generates the functional.ts file by re-exporting all members from @dxtmisha/functional.
-   *
-   * Генерирует файл functional.ts, повторно экспортируя все элементы из @dxtmisha/functional.
-   */
-  make(): void {
-    console.log('Build functional...')
-
-    const list = this.getList()
-    const code: string[] = [
-      'export type * from \'@dxtmisha/functional\'',
-      ''
-    ]
-
-    list.sort()
-    list.forEach((item) => {
-      console.log(`-- ${item}`)
-
-      code.push(`export { ${item} } from '@dxtmisha/functional'`)
-    })
-
-    code.push('')
-    PropertiesFile.writeByPath(
-      [...UI_DIRS_LIBRARY, 'functional.ts'],
-      code.join('\n')
-    )
-
-    console.log('...end')
-  }
-
-  /**
-   * Returns a list of all exported members from the @dxtmisha/functional package.
-   *
-   * Возвращает список всех экспортируемых элементов из пакета @dxtmisha/functional.
-   */
-  getList(): string[] {
-    return Object.keys(functional)
-  }
-}

package/src/classes/Build/BuildPackages.ts

@@ -1,137 +0,0 @@
-import { run } from '../../functions/run'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { PackageFile } from '../Package/PackageFile'
-
-import { UI_DIR_PACKAGES } from '../../config'
-
-const UI_BUILD_LOG_FILE = ['.', 'logs', 'ui-build.log.json']
-
-/**
- * Class for building all packages in the project.
- *
- * Класс для сборки всех пакетов в проекте.
- */
-export class BuildPackages {
-  protected readonly log: Record<string, string>
-
-  /**
-   * Constructor
-   * @param path packages directory path / путь к директории пакетов
-   */
-  constructor(
-    protected readonly path: string = UI_DIR_PACKAGES
-  ) {
-    this.log = PropertiesFile.readFile(UI_BUILD_LOG_FILE) ?? {}
-  }
-
-  /**
-   * Scans the packages directory and builds each package that contains a package.json.
-   *
-   * Сканирует директорию пакетов и собирает каждый пакет, содержащий package.json.
-   */
-  async make(): Promise<void> {
-    const list = this.getList()
-    let changed = 0
-
-    console.info(`Build packages(${list.length})...`)
-
-    for (const packageFile of list) {
-      if (
-        this.isUpdate(packageFile)
-        && await this.build(packageFile)
-      ) {
-        this.updateLog(packageFile)
-        changed++
-      }
-    }
-
-    if (changed > 0) {
-      this.saveLog()
-      console.info(`Build packages changed: ${changed}`)
-    } else {
-      console.info('Build packages - no changes')
-    }
-  }
-
-  protected async build(packageFile: PackageFile): Promise<boolean> {
-    const code = packageFile.getCodeBuildOrRecovery()
-
-    if (code) {
-      return await run(packageFile, `npm run ${code}`)
-    }
-
-    return false
-  }
-
-  /**
-   * Checks if the package needs to be updated.
-   *
-   * Проверяет, нужно ли обновлять пакет.
-   * @param packageFile package file object / объект файла пакета
-   */
-  protected isUpdate(packageFile: PackageFile): boolean {
-    return !packageFile.isVersionConsistency(
-      this.getVersionLog(packageFile.getName())
-    )
-  }
-
-  /**
-   * Scans the packages directory and returns a list of packages sorted by the ui-priority property in package.json.
-   * If a package does not have a priority, it defaults to 500.
-   *
-   * Сканирует директорию пакетов и возвращает список пакетов, отсортированный по свойству ui-priority в package.json.
-   * Если у пакета нет приоритета, по умолчанию устанавливается значение 500.
-   * @returns sorted list of package files / отсортированный список файлов пакетов
-   */
-  private getList(): PackageFile[] {
-    const list = PropertiesFile.readDir(this.path)
-    const packages: PackageFile[] = []
-
-    for (const folder of list) {
-      const packageFile = new PackageFile([this.path, folder])
-
-      if (
-        packageFile.is()
-        && !packageFile.isTest()
-      ) {
-        packages.push(packageFile)
-      }
-    }
-
-    return packages.sort((a, b) => {
-      const priorityA = a.get()?.['ui-priority'] ?? 500
-      const priorityB = b.get()?.['ui-priority'] ?? 500
-      return priorityA - priorityB
-    })
-  }
-
-  /**
-   * Returns the cached version of the package from the build log.
-   *
-   * Возвращает кэшированную версию пакета из лога сборки.
-   * @param name package name / имя пакета
-   */
-  protected getVersionLog(name: string): string {
-    return this.log?.[name] ?? '0.0.0'
-  }
-
-  /**
-   * Updates the build log with the current package version in memory.
-   *
-   * Обновляет лог сборки текущей версией пакета в памяти.
-   * @param packageFile package file object / объект файла пакета
-   */
-  protected updateLog(packageFile: PackageFile): void {
-    this.log[packageFile.getName()] = packageFile.getVersion()
-  }
-
-  /**
-   * Saves the build log to a file.
-   *
-   * Сохраняет лог сборки в файл.
-   */
-  protected saveLog(): void {
-    PropertiesFile.writeByPath(UI_BUILD_LOG_FILE, this.log)
-  }
-}

package/src/classes/Build/BuildPublishPackages.ts

@@ -1,105 +0,0 @@
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { PackageFile } from '../Package/PackageFile'
-import { run } from '../../functions/run'
-import { UI_DIR_PACKAGES } from '../../config'
-
-const UI_PUBLISH_LOG_FILE = ['.', 'logs', 'ui-publish.log.json']
-
-/**
- * Class for publishing all packages in the project.
- *
- * Класс для публикации всех пакетов в проекте.
- */
-export class BuildPublishPackages {
-  protected readonly log: Record<string, string>
-
-  /**
-   * Constructor
-   * @param path packages directory path / путь к директории пакетов
-   */
-  constructor(
-    protected readonly path: string = UI_DIR_PACKAGES
-  ) {
-    this.log = PropertiesFile.readFile(UI_PUBLISH_LOG_FILE) ?? {}
-  }
-
-  /**
-   * Scans the packages directory and publishes each package that has a new version.
-   *
-   * Сканирует директорию пакетов и публикует каждый пакет с новой версией.
-   */
-  async make(): Promise<void> {
-    const list = PropertiesFile.readDir(this.path)
-    let changed = 0
-
-    console.info(`Publish packages(${list.length})...`)
-
-    for (const folder of list) {
-      const packageFile = new PackageFile([this.path, folder])
-
-      if (
-        packageFile.is()
-        && !packageFile.isNoPublish()
-      ) {
-        if (
-          this.log[packageFile.getName()] === undefined
-          || (
-            this.isUpdate(packageFile)
-            && await run(packageFile, packageFile.getCodePublish(), true, true)
-          )
-        ) {
-          this.updateLog(packageFile)
-          changed++
-        }
-      }
-    }
-
-    if (changed > 0) {
-      this.saveLog()
-      console.info(`Publish packages changed: ${changed}`)
-    } else {
-      console.info('Publish packages - no changes')
-    }
-  }
-
-  /**
-   * Checks if the package needs to be published.
-   *
-   * Проверяет, нужно ли публиковать пакет.
-   * @param packageFile package file object / объект файла пакета
-   */
-  protected isUpdate(packageFile: PackageFile): boolean {
-    return !packageFile.isVersionConsistency(
-      this.getVersionLog(packageFile.getName())
-    )
-  }
-
-  /**
-   * Returns the cached version of the package from the publish log.
-   *
-   * Возвращает кэшированную версию пакета из лога публикации.
-   * @param name package name / имя пакета
-   */
-  protected getVersionLog(name: string): string {
-    return this.log?.[name] ?? '0.0.0'
-  }
-
-  /**
-   * Updates the publish log with the current package version in memory.
-   *
-   * Обновляет лог публикации текущей версией пакета в памяти.
-   * @param packageFile package file object / объект файла пакета
-   */
-  protected updateLog(packageFile: PackageFile): void {
-    this.log[packageFile.getName()] = packageFile.getVersion()
-  }
-
-  /**
-   * Saves the publish log to a file.
-   *
-   * Сохраняет лог публикации в файл.
-   */
-  protected saveLog(): void {
-    PropertiesFile.writeByPath(UI_PUBLISH_LOG_FILE, this.log)
-  }
-}

package/src/classes/BuildItem.ts

@@ -1,187 +0,0 @@
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { promisify } from 'node:util'
-import { exec } from 'node:child_process'
-import { hasNativeDirname } from '../functions/hasNativeDirname'
-
-import { PropertiesFile } from './Properties/PropertiesFile'
-import { ComponentWikiFile } from './Component/ComponentWikiFile'
-
-import { UI_DIR_DIST_TEMPORARY, UI_FILE_NAME_VITE, UI_FILE_NAME_VITE_WORKERS } from '../config'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-/** Template vite config file path / Путь к файлу шаблона vite-конфига */
-const FILE_VITE_SAMPLE = [dirnamePath, '..', 'media', 'templates', 'viteComponentTemplateConfig.ts']
-
-/** Async exec wrapper / Обёртка для асинхронного exec */
-const execAsync = promisify(exec)
-
-/**
- * Builds a component using a temporary Vite config.
- *
- * Билдит компонент с использованием временного Vite-конфига.
- */
-export class BuildItem {
-  /** Template vite config file / Файл шаблона vite-конфига */
-  protected readonly viteSample: ComponentWikiFile
-
-  /** Aggregated built code file / Файл агрегированного собранного кода */
-  protected readonly codeFile: ComponentWikiFile
-
-  /**
-   * Constructor
-   * @param path component path / путь к компоненту
-   */
-  constructor(
-    protected readonly path: string
-  ) {
-    this.viteSample = new ComponentWikiFile(FILE_VITE_SAMPLE)
-
-    this.codeFile = new ComponentWikiFile([
-      ...this.getPathTemporaryDist(),
-      'code.txt'
-    ])
-  }
-
-  /**
-   * Returns distribution temp directory path segments.
-   *
-   * Возвращает сегменты пути дистрибутива (temp).
-   */
-  getPathTemporaryDist(): string[] {
-    return [
-      UI_DIR_DIST_TEMPORARY
-    ]
-  }
-
-  /**
-   * Returns aggregated built code content.
-   *
-   * Возвращает содержимое агрегированного собранного кода.
-   */
-  getCode(): string {
-    return this.codeFile.read()
-  }
-
-  /**
-   * Removes temporary distribution directory.
-   *
-   * Удаляет временную директорию дистрибутива.
-   */
-  removeDir(): void {
-    PropertiesFile.removeDir(this.getPathTemporaryDist())
-  }
-
-  /**
-   * Prepares temporary vite config, triggers build, then restores original.
-   *
-   * Готовит временный vite-конфиг, запускает билд, затем восстанавливает оригинал.
-   */
-  async make(): Promise<boolean> {
-    this.saveViteConfig()
-
-    const vite = this.viteSample
-      .read()
-      .replace('[path]', this.path)
-
-    PropertiesFile.writeByPath(UI_FILE_NAME_VITE, vite)
-
-    const status = await this.run()
-
-    this.resetViteConfig()
-    this.readAndWriteALlFiles()
-
-    if (!status) {
-      process.exit(601)
-    }
-
-    return status
-  }
-
-  /**
-   * Saves existing vite config aside (rename) before custom build.
-   *
-   * Сохраняет существующий vite-конфиг (переименовывает) перед кастомным билдом.
-   */
-  protected saveViteConfig() {
-    if (!PropertiesFile.is(UI_FILE_NAME_VITE_WORKERS)) {
-      PropertiesFile.rename(
-        UI_FILE_NAME_VITE,
-        UI_FILE_NAME_VITE_WORKERS
-      )
-    }
-  }
-
-  /**
-   * Restores original vite config after build.
-   *
-   * Восстанавливает оригинальный vite-конфиг после билда.
-   */
-  protected resetViteConfig() {
-    if (PropertiesFile.is(UI_FILE_NAME_VITE_WORKERS)) {
-      PropertiesFile.removeFile(UI_FILE_NAME_VITE)
-      PropertiesFile.rename(
-        UI_FILE_NAME_VITE_WORKERS,
-        UI_FILE_NAME_VITE
-      )
-    }
-  }
-
-  /**
-   * Reads built file content and wraps with header comment (file name).
-   *
-   * Читает содержимое собранного файла и оборачивает заголовком с именем файла.
-   * @param path relative built file path / относительный путь собранного файла
-   */
-  protected readFile(path: string): string {
-    const pathFull = PropertiesFile.joinPath([...this.getPathTemporaryDist(), path])
-    const content = PropertiesFile.readFileOnly(pathFull)
-
-    return `
-// File: ${path}
-${content}
-    `.trim()
-  }
-
-  /**
-   * Aggregates all built files into a single code snapshot file.
-   *
-   * Агрегирует все собранные файлы в единый снимок кода.
-   */
-  protected readAndWriteALlFiles(): void {
-    const list = PropertiesFile.readDirRecursive(this.getPathTemporaryDist())
-    const content: string[] = []
-
-    list.forEach((file) => {
-      content.push(this.readFile(file))
-    })
-
-    this.codeFile.write(content.join('\r\n'))
-  }
-
-  /**
-   * Runs build command (npm run build) capturing stdout/stderr.
-   *
-   * Запускает команду билда (npm run build), перехватывая stdout/stderr.
-   */
-  protected async run(): Promise<boolean> {
-    try {
-      const { stdout, stderr } = await execAsync('npm run build')
-
-      console.info(stdout)
-
-      if (stderr) {
-        console.error('STD error', stderr)
-      }
-
-      return true
-    } catch (error) {
-      console.error('Error', error)
-    }
-
-    return false
-  }
-}

package/src/classes/Component/ComponentCreator.ts

@@ -1,45 +0,0 @@
-// export:none
-
-import { getComponentPaths } from '../../functions/getComponentPaths'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { ComponentItem } from './ComponentItem'
-
-import { UI_DIRS_COMPONENTS } from '../../config'
-
-/**
- * Class for scaffolding components in empty directories.
- *
- * Класс для создания заготовок компонентов в пустых директориях.
- */
-export class ComponentCreator {
-  /**
-   * Constructor
-   */
-  constructor() {
-  }
-
-  /**
-   * Scans directories and scaffolds component templates.
-   *
-   * Сканирует директории и создает шаблоны компонентов.
-   */
-  make(): void {
-    this
-      .getDirs()
-      .forEach(path => new ComponentItem(path).make())
-  }
-
-  /**
-   * Collects only empty component directories.
-   *
-   * Собирает только пустые директории компонентов.
-   * @protected
-   */
-  protected getDirs(): string[] {
-    return PropertiesFile.readDirOnlyRecursive(UI_DIRS_COMPONENTS)
-      .filter(
-        path => PropertiesFile.readDir(getComponentPaths(path)).length === 0
-      )
-  }
-}

package/src/classes/Component/ComponentItem.ts

@@ -1,161 +0,0 @@
-// export:none
-
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { toKebabCase } from '@dxtmisha/functional-basic'
-import { getComponentPaths } from '../../functions/getComponentPaths'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import { UI_FILE_PACKAGE } from '../../config'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-const DIR_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates', 'componentDoc']
-
-/**
- * Class for creating component files from templates.
- *
- * Класс для создания файлов компонента из шаблонов.
- */
-export class ComponentItem {
-  /**
-   * Constructor
-   * @param path component directory path/ путь к директории компонента
-   */
-  constructor(
-    protected readonly path: string
-  ) {
-  }
-
-  /**
-   * Generates component files from template.
-   *
-   * Генерирует файлы компонента из шаблона.
-   */
-  make(): void {
-    console.info('Component create:', this.getName())
-    console.info('path:', this.path)
-
-    this
-      .getFilesSample()
-      .forEach((path) => {
-        this.writeFile(
-          path,
-          this.replacement(this.readFile(path))
-        )
-      })
-
-    console.info('end')
-  }
-
-  /**
-   * Gets component name from directory path.
-   *
-   * Получает имя компонента из пути директории.
-   * @protected
-   */
-  protected getName(): string {
-    const parts = PropertiesFile.splitForDir(this.path)
-    return String(parts[parts.length - 1])
-  }
-
-  /**
-   * Reads project name from package.json.
-   *
-   * Читает имя проекта из package.json.
-   * @protected
-   */
-  protected getProjectName(): string {
-    return this.readPackage()?.name ?? 'Project'
-  }
-
-  /**
-   * Builds destination file path for output.
-   *
-   * Строит путь назначения для выходного файла.
-   * @param path filename/ имя файла
-   * @protected
-   */
-  protected getFilePath(path: string): string[] {
-    return [
-      ...getComponentPaths(this.path),
-      this.replacement(path)
-    ]
-  }
-
-  /**
-   * Builds template file path for reading.
-   *
-   * Строит путь к файлу шаблона для чтения.
-   * @param path filename/ имя файла
-   * @protected
-   */
-  protected getSamplePath(path: string): string[] {
-    return [...DIR_SAMPLE, path]
-  }
-
-  /**
-   * Lists all template files recursively.
-   *
-   * Получает список всех файлов шаблонов рекурсивно.
-   * @protected
-   */
-  protected getFilesSample(): string[] {
-    return PropertiesFile.readDirRecursive(DIR_SAMPLE)
-  }
-
-  /**
-   * Reads template file content as string.
-   *
-   * Читает содержимое файла шаблона как строку.
-   * @param path filename/ имя файла
-   * @protected
-   */
-  protected readFile(path: string): string {
-    return String(PropertiesFile.readFile(this.getSamplePath(path)))
-  }
-
-  /**
-   * Reads package.json data or returns empty object.
-   *
-   * Читает данные package.json или возвращает пустой объект.
-   * @protected
-   */
-  protected readPackage(): Record<string, any> {
-    return PropertiesFile.readFile(UI_FILE_PACKAGE) ?? {}
-  }
-
-  /**
-   * Writes generated file to destination.
-   *
-   * Записывает сгенерированный файл в место назначения.
-   * @param path filename/ имя файла
-   * @param content file content/ содержимое файла
-   * @protected
-   */
-  protected writeFile(path: string, content: string): void {
-    const paths = this.getFilePath(path)
-
-    PropertiesFile.writeByPath(paths, content)
-    PropertiesFile.chmod(paths)
-  }
-
-  /**
-   * Replaces template placeholders with actual values.
-   *
-   * Заменяет плейсхолдеры шаблона реальными значениями.
-   * @param contentOrPath content or path/ содержимое или путь
-   * @protected
-   */
-  protected replacement(contentOrPath: string): string {
-    return contentOrPath
-      .replace(/ComponentDoc/g, this.getName())
-      .replace(/component-doc/g, toKebabCase(this.getName()))
-      .replace(/\[project]/g, this.getProjectName())
-      .replace(/\[path]/g, PropertiesFile.splitForDir(this.path).join('/'))
-  }
-}