@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Package/PackageInit.ts

@@ -1,54 +0,0 @@
-// export:none
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { PackageInitItem } from './PackageItem'
-
-import { UI_DIR_PACKAGES } from '../../config'
-
-/**
- * Class for initializing the package structure and development environment based on templates.
- *
- * Класс для инициализации структуры пакета и среды разработки на основе шаблонов.
- */
-export class PackageInit {
-  /**
-   * Constructor for PackageInit.
-   *
-   * Конструктор для PackageInit.
-   * @param type package type identifier / идентификатор типа пакета
-   * @param templates optional list of templates to apply / необязательный список шаблонов для применения
-   * @param dir base directory for packages / базовая директория для пакетов
-   */
-  constructor(
-    protected readonly type: string,
-    protected readonly templates?: string,
-    protected readonly dir: string = UI_DIR_PACKAGES
-  ) {
-  }
-
-  /**
-   * Triggers the package creation process and initializes required files.
-   *
-   * Запускает процесс создания пакета и инициализирует необходимые файлы.
-   */
-  make() {
-    console.log(`Initializing package of type: ${this.type} with templates: ${this.templates}`)
-
-    this.getDirs()
-      .forEach((dir) => {
-        new PackageInitItem(dir, [this.dir, dir], this.type, this.templates).make()
-      })
-  }
-
-  /**
-   * Returns an array of directory names for package initialization.
-   *
-   * Возвращает массив имен директорий для инициализации пакета.
-   */
-  protected getDirs(): string[] {
-    return PropertiesFile.readDir(this.dir)
-      .filter(
-        path => PropertiesFile.readDir([this.dir, path]).length === 0
-      )
-  }
-}

package/src/classes/Package/PackageItem.ts

@@ -1,329 +0,0 @@
-// export:none
-
-import requirePath from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { isFilled } from '@dxtmisha/functional-basic'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-import { UI_DIR_PACKAGES, UI_DIRS_LIBRARY, UI_FILE_PACKAGE } from '../../config'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : requirePath.dirname(fileURLToPath(import.meta.url))
-
-const DIR_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates', 'packages']
-const DIR_STORYBOOK = [
-  UI_DIR_PACKAGES,
-  'storybook',
-  '.storybook',
-  'main.ts'
-]
-
-type PackageInitItemFile = {
-  file: string
-  path: string
-  content: string
-}
-
-/**
- * Class for initializing a single package component, managing its files, dependencies, and integration.
- *
- * Класс для инициализации отдельного компонента пакета, управления его файлами, зависимостями и интеграцией.
- */
-export class PackageInitItem {
-  /**
-   * Constructor for PackageInitItem.
-   *
-   * Конструктор для PackageInitItem.
-   * @param name unique name of the component / уникальное имя компонента
-   * @param dir path to the component directory / путь к директории компонента
-   * @param type package type identifier / идентификатор типа пакета
-   * @param templates optional list of templates to apply / необязательный список шаблонов для применения
-   */
-  constructor(
-    protected readonly name: string,
-    protected readonly dir: string[],
-    protected readonly type: string,
-    protected readonly templates?: string
-  ) {
-  }
-
-  /**
-   * Performs the full initialization cycle for the package item, including file creation and integration updates.
-   *
-   * Выполняет полный цикл инициализации элемента пакета, включая создание файлов и обновление интеграций.
-   */
-  make() {
-    console.log('Package init in:', this.dir)
-
-    ;[
-      ...this.getSample(),
-      ...this.getTemplates()
-    ]
-      .forEach((item) => {
-        this.writeFile(
-          this.getFileName(item.file),
-          item.content
-        )
-
-        if (item.path.endsWith('library.ts')) {
-          this.makeLibrary()
-            .makePackage()
-            .makeStorybook()
-        }
-      })
-  }
-
-  /**
-   * Gets the original file name by replacing placeholders.
-   *
-   * Получает оригинальное имя файла, заменяя заполнители.
-   * @param filePath file path with placeholders / путь к файлу с заполнителями
-   */
-  protected getFileName(filePath: string): string {
-    return filePath.replace('_.gitignore.txt', '.gitignore')
-  }
-
-  /**
-   * Gets sample files for the specified package type.
-   *
-   * Получает файлы-образцы для указанного типа пакета.
-   */
-  protected getSample(): PackageInitItemFile[] {
-    return this.getFileByList([...DIR_SAMPLE, this.type])
-  }
-
-  /**
-   * Gets template files if templates path is specified.
-   *
-   * Получает файлы шаблонов, если указан путь к шаблонам.
-   */
-  protected getTemplates(): PackageInitItemFile[] {
-    if (isFilled(this.templates)) {
-      return this.getFileByList([this.templates])
-    }
-
-    return []
-  }
-
-  /**
-   * Creates a package file object with content from the specified path.
-   *
-   * Создает объект файла пакета с содержимым из указанного пути.
-   * @param file file name / имя файла
-   * @param path file path array / массив пути к файлу
-   */
-  protected getFile(
-    file: string,
-    path: string[]
-  ): PackageInitItemFile {
-    return {
-      file: PropertiesFile.joinPath([...this.dir, file]),
-      path: PropertiesFile.joinPath(path),
-      content: String(PropertiesFile.readFileOnly(path))
-    }
-  }
-
-  /**
-   * Gets all files from directory and converts them to PackageInitItemFile objects.
-   *
-   * Получает все файлы из директории и преобразует их в объекты PackageInitItemFile.
-   * @param dir directory path array / массив пути к директории
-   */
-  protected getFileByList(dir: string[]): PackageInitItemFile[] {
-    const list = PropertiesFile.readDirRecursive(dir)
-
-    const data: PackageInitItemFile[] = []
-
-    list.forEach((item) => {
-      data.push(this.getFile(item, [...dir, item]))
-    })
-
-    return data
-  }
-
-  /**
-   * Gets normalized package name by replacing path separators.
-   *
-   * Получает нормализованное имя пакета, заменяя разделители путей.
-   */
-  protected getName(): string {
-    return this.name.replace(requirePath.sep, '/')
-  }
-
-  /**
-   * Gets package code by replacing path separators with hyphens.
-   *
-   * Получает код пакета, заменяя разделители путей на дефисы.
-   */
-  protected getCode(): string {
-    return this.getName().replace('/', '-')
-  }
-
-  /**
-   * Reads project name from package.json.
-   *
-   * Читает имя проекта из package.json.
-   */
-  protected getProjectName(): string {
-    const name = this.getName()
-    const packagePrefix = PropertiesConfig.getPackagePrefix()
-
-    if (packagePrefix) {
-      return `${packagePrefix}/${name}`
-    }
-
-    const mainName = String(this.readPackage()?.name)
-    const code = mainName.split('/')?.[0] ?? mainName
-
-    return `${code}/${name}`
-  }
-
-  /**
-   * Reads package.json data or returns empty object.
-   *
-   * Читает данные package.json или возвращает пустой объект.
-   */
-  protected readPackage(): Record<string, any> {
-    return PropertiesFile.readFile(UI_FILE_PACKAGE) ?? {}
-  }
-
-  /**
-   * Writes file with content replacement and sets permissions.
-   *
-   * Записывает файл с заменой содержимого и устанавливает права доступа.
-   * @param path file path / путь к файлу
-   * @param content file content / содержимое файла
-   */
-  protected writeFile(path: string, content: string): void {
-    const contentEdit = content
-      .replace(/@packages\/library/g, this.getProjectName())
-      .replace(/\[name]/g, this.getName())
-
-    PropertiesFile.writeByPath(path, contentEdit)
-    PropertiesFile.chmod(path)
-  }
-
-  /**
-   * Generates a library file for the package.
-   *
-   * Генерирует файл библиотеки для пакета.
-   */
-  protected makeLibrary(): this {
-    const name = this.getCode() + '.ts'
-    const path: string[] = [...UI_DIRS_LIBRARY, name]
-
-    if (
-      PropertiesFile.is(UI_DIRS_LIBRARY)
-      && !PropertiesFile.is(path)
-    ) {
-      console.log('Generate library...')
-
-      PropertiesFile.writeByPath(path, `import '${this.getProjectName()}/style.css'
-export * from '${this.getProjectName()}'
-`
-      )
-    }
-
-    return this
-  }
-
-  /**
-   * Updates package.json to include the new package.
-   *
-   * Обновляет package.json для включения нового пакета.
-   */
-  protected makePackage(): this {
-    let packageFile = PropertiesFile.readFileOnly(UI_FILE_PACKAGE)
-    const name = this.getCode()
-
-    if (
-      packageFile
-      && !packageFile.match(new RegExp(`["']${this.getProjectName()}["']`))
-    ) {
-      let edit = false
-
-      if (
-        packageFile.match(/["']dependencies["']/)
-      ) {
-        console.log('Update package.json: dependencies...')
-
-        edit = true
-        packageFile = packageFile.replace(
-          /(["']dependencies["']:[^{]+{)/,
-          `$1
-    "${this.getProjectName()}": "workspace:*",`
-        )
-      }
-
-      if (
-        packageFile.match(/["']exports["']/)
-      ) {
-        console.log('Update package.json: exports...')
-
-        edit = true
-        packageFile = packageFile.replace(
-          /(["']exports["']:[^{]+{)/,
-          `$1
-    "./${name}": {
-      "import": "./dist/${name}.js",
-      "types": "./dist/${name}.d.ts"
-    },`
-        )
-      }
-
-      if (
-        packageFile.match(/["']files["']/)
-      ) {
-        console.log('Update package.json: files...')
-
-        edit = true
-        packageFile = packageFile.replace(
-          /(["']files["']:[^[]+\[)/,
-          `$1
-    "packages/${name}/dist",
-    "packages/${name}/package.json",`
-        )
-      }
-
-      if (edit) {
-        PropertiesFile.writeByPath(UI_FILE_PACKAGE, packageFile)
-      }
-    }
-
-    return this
-  }
-
-  /**
-   * Updates Storybook configuration to include the new package stories.
-   *
-   * Обновляет конфигурацию Storybook для включения историй нового пакета.
-   */
-  makeStorybook(): this {
-    if (PropertiesFile.is(DIR_STORYBOOK)) {
-      let storybook = PropertiesFile.readFileOnly(DIR_STORYBOOK)
-      const name = this.getCode()
-
-      if (
-        storybook
-        && !storybook.match(`/${name}/src/`)
-      ) {
-        console.log('Update storybook...')
-
-        storybook = storybook.replace(
-          /(stories: \[)/,
-          `$1
-    '../../${name}/src/**/*.mdx',
-    '../../${name}/src/**/*.stories.@(js|jsx|mjs|ts|tsx)',`
-        )
-
-        PropertiesFile.writeByPath(DIR_STORYBOOK, storybook)
-      }
-    }
-
-    return this
-  }
-}

package/src/classes/Properties/Properties.ts

@@ -1,175 +0,0 @@
-// export:none
-
-import { replaceRecursive } from '@dxtmisha/functional-basic'
-
-import { PropertiesCache } from './PropertiesCache'
-import { PropertiesPath } from './PropertiesPath'
-import { PropertiesTool } from './PropertiesTool'
-import { PropertiesItems } from './PropertiesItems'
-
-import { PropertiesSettings } from './PropertiesSettings'
-import { PropertiesMain } from './PropertiesMain'
-
-import { PropertiesToReplace } from './to/PropertiesToReplace'
-import { PropertiesToPalette } from './to/PropertiesToPalette'
-import { PropertiesToLink } from './to/PropertiesToLink'
-import { PropertiesToSub } from './to/PropertiesToSub'
-import { PropertiesToClone } from './to/PropertiesToClone'
-import { PropertiesToDrag } from './to/PropertiesToDrag'
-import { PropertiesToRemove } from './to/PropertiesToRemove'
-import { PropertiesToVariable } from './to/PropertiesToVariable'
-
-import { PropertiesToSimilar } from './to/PropertiesToSimilar'
-import { PropertiesToMulti } from './to/PropertiesToMulti'
-import { PropertiesToStyle } from './to/PropertiesToStyle'
-
-import { PropertiesToFull } from './to/PropertiesToFull'
-import { PropertiesToVar } from './to/PropertiesToVar'
-import { PropertiesToProperty } from './to/PropertiesToProperty'
-import { PropertiesToComponent } from './to/PropertiesToComponent'
-import { PropertiesToClass } from './to/PropertiesToClass'
-import { PropertiesToState } from './to/PropertiesToState'
-import { PropertiesToSubclass } from './to/PropertiesToSubclass'
-import { PropertiesToRoot } from './to/PropertiesToRoot'
-import { PropertiesToMedia } from './to/PropertiesToMedia'
-import { PropertiesToAnimate } from './to/PropertiesToAnimate'
-
-import { PropertiesToSort } from './to/PropertiesToSort'
-import { PropertiesToNone } from './to/PropertiesToNone'
-import { PropertiesToDuplicate } from './to/PropertiesToDuplicate'
-
-import { PropertiesScss } from './PropertiesScss'
-
-import { type PropertyList } from '../../types/propertyTypes'
-
-const FILE_CACHE = 'properties'
-
-/**
- * Central orchestrator for the design system's token management.
- * Responsible for loading, merging, and executing a multi-stage transformation pipeline to convert raw property definitions into structured, resolved data for various output formats.
- *
- * Центральный оркестратор для управления токенами дизайн-системы.
- * Отвечает за загрузку, слияние и выполнение многоэтапного конвейера преобразований для конвертации необработанных определений свойств в структурированные, разрешенные данные для различных выходных форматов.
- */
-export class Properties {
-  private readonly designs: string[]
-  private readonly items: PropertiesItems
-
-  /**
-   * Constructor for Properties.
-   * Initializes the list of designs and triggers the token processing pipeline.
-   *
-   * Конструктор для Properties.
-   * Инициализирует список дизайнов и запускает конвейер обработки токенов.
-   */
-  constructor() {
-    this.designs = PropertiesTool.getDesigns()
-    this.items = new PropertiesItems(this.read())
-  }
-
-  /**
-   * Returns the processed collection of design tokens.
-   *
-   * Возвращает обработанную коллекцию токенов дизайна.
-   */
-  get() {
-    return this.items
-  }
-
-  /**
-   * Getting structured data for use in an SCSS file.
-   *
-   * Получение структурированных данных для работы в SCSS файле.
-   */
-  getScss(): string {
-    return PropertiesCache.get([], this.getPathName(), () => {
-      const properties = new PropertiesScss(this.items).get()
-
-      console.info('[Scss]', 'init')
-
-      return properties
-    }, 'scss')
-  }
-
-  /**
-   * Processing of basic data.
-   *
-   * Обработка базовых данных.
-   */
-  protected read(): PropertyList {
-    return PropertiesCache.get<PropertyList>([], this.getPathName(), () => {
-      console.info('[Properties]', 'start')
-
-      const properties = this.readFiles()
-
-      this.toBasic(properties)
-
-      new PropertiesToSimilar(properties).to()
-      new PropertiesToMulti(properties).to()
-      new PropertiesToStyle(properties).to()
-
-      new PropertiesToFull(properties).to()
-      new PropertiesToVar(properties).to()
-      new PropertiesToProperty(properties).to()
-      new PropertiesToComponent(properties).to()
-      new PropertiesToClass(properties).to()
-      new PropertiesToState(properties).to()
-      new PropertiesToSubclass(properties).to()
-      new PropertiesToRoot(properties).to()
-      new PropertiesToMedia(properties).to()
-      new PropertiesToAnimate(properties).to()
-
-      new PropertiesToSort(properties).to()
-      new PropertiesToNone(properties).to()
-      new PropertiesToDuplicate(properties).to()
-
-      console.info('[Properties]', 'init')
-
-      return properties.get()
-    })
-  }
-
-  /**
-   * Returns the name of the cache file. It contains all processed properties.
-   *
-   * Возвращает название файла для кэша.
-   * Это полный массив со всеми обработанными свойствами.
-   */
-  private getPathName(): string {
-    return `${this.designs.join('-')}-${FILE_CACHE}`
-  }
-
-  /**
-   * Reads the content from the file and merges all records into a single object.
-   *
-   * Читает содержимое из файла и объединяет все записи в один объект.
-   */
-  private readFiles(): PropertiesItems {
-    const path = new PropertiesPath(this.designs)
-    const settings = new PropertiesSettings(path).get()
-
-    return new PropertiesItems(
-      replaceRecursive(
-        settings,
-        new PropertiesMain(path).getBySettings(settings)
-      )
-    )
-  }
-
-  /**
-   * Basic transformations.
-   *
-   * Базовые преобразования.
-   * @param properties a class that contains all data/ класс со всеми данными
-   */
-  private toBasic(properties: PropertiesItems) {
-    new PropertiesToReplace(properties).to()
-    new PropertiesToPalette(properties).to()
-    new PropertiesToLink(properties).to()
-    new PropertiesToSub(properties).to()
-    new PropertiesToClone(properties).to()
-    new PropertiesToRemove(properties).to()
-    new PropertiesToDrag(properties).to()
-    new PropertiesToVariable(properties).to()
-  }
-}