@dxtmisha/scripts 0.11.7 → 1.0.0

package/src/classes/Properties/PropertiesCache.ts

@@ -1,248 +0,0 @@
-// export:none
-
-import { toArray } from '@dxtmisha/functional-basic'
-
-import {
-  PropertiesFile,
-  type PropertiesFilePath,
-  type PropertiesFileValue
-} from './PropertiesFile'
-
-const DIR_CACHE = ['.cache']
-const DIR_STEP = ['step']
-const FILE_SYSTEM = 'system'
-
-type PropertiesCacheList = Record<string, string[]>
-type PropertiesCacheSystem = {
-  time: number
-  files: PropertiesCacheList
-  sizes: PropertiesCacheList
-}
-
-/**
- * Static orchestrator for managing persistent file caching in the design system.
- * Provides a structured mechanism for storing transformed tokens, tracking file dependencies, and ensuring incremental build performance by avoiding redundant processing.
- *
- * Статический оркестратор для управления постоянным файловым кэшированием в дизайн-системе.
- * Предоставляет структурированный механизм для хранения трансформированных токенов, отслеживания зависимостей файлов и обеспечения производительности инкрементальной сборки за счет исключения повторной обработки.
- */
-export class PropertiesCache {
-  private static time = 0
-  private static readonly files: PropertiesCacheList = {}
-  private static readonly sizes: PropertiesCacheList = {}
-  private static readonly listenerName: string[] = ['global']
-
-  /**
-   * Retrieves data from the cache or executes the callback to regenerate and store it if the cache is missing or outdated.
-   *
-   * Извлекает данные из кэша или выполняет функцию обратного вызова для регенерации и сохранения данных, если кэш отсутствует или устарел.
-   * @param path the logical path structure for the cache file/ логическая структура пути для файла кэша
-   * @param name the unique identifier for the cache entry/ уникальный идентификатор записи кэша
-   * @param callback the generator function to execute on cache miss/ функция-генератор, выполняемая при отсутствии данных в кэше
-   * @param extension the file extension, typically 'json'/ расширение файла, обычно 'json'
-   */
-  static get<T extends PropertiesFileValue>(
-    path: PropertiesFilePath,
-    name: string,
-    callback: () => T,
-    extension = 'json'
-  ): T {
-    if (
-      this.is(path, name, extension)
-      && this.isBySystem(name)
-    ) {
-      return this.readFile<T>(path, name, extension) as T
-    }
-
-    this.listenerName.push(name)
-
-    const value = callback()
-    this.writeFile(path, name, value, extension)
-
-    this.listenerName.pop()
-    this.writeSystem()
-
-    return value
-  }
-
-  /**
-   * Directly reads a file and registers it as a dependency for the currently active cache listener.
-   *
-   * Напрямую читает файл и регистрирует его как зависимость для текущего активного слушателя кэша.
-   * @param path the path to the file to be read/ путь к считываемому файлу
-   */
-  static read<R>(path: PropertiesFilePath): R | undefined {
-    if (PropertiesFile.is(path)) {
-      const value = PropertiesFile.joinPath(path)
-
-      this.listenerName.forEach((name) => {
-        if (!(name in this.files)) {
-          this.files[name] = [value]
-        } else if (this.files?.[name]?.indexOf(value) === -1) {
-          this.files[name].push(value)
-        }
-      })
-    }
-
-    return PropertiesFile.readFile<R>(path)
-  }
-
-  /**
-   * Persists intermediate results to the temporary step-based cache directory.
-   *
-   * Сохраняет промежуточные результаты во временную директорию пошагового кэша.
-   * @param name the name of the cached step result/ название кэшированного результата шага
-   * @param value the data structure to persist/ структура данных для сохранения
-   */
-  static write<T extends PropertiesFileValue>(name: string, value: T): void {
-    this.writeFile<T>(DIR_STEP, name, value)
-  }
-
-  /**
-   * Recursively removes all cached data from the `.cache` directory.
-   *
-   * Рекурсивно удаляет все кэшированные данные из директории `.cache`.
-   */
-  static clear(): void {
-    PropertiesFile.removeDir(this.getPath([]))
-  }
-
-  /**
-   * Checks if there are files to read
-   *
-   * Проверяет наличие файлов для чтения.
-   * @param path path to the file/ путь к файлу
-   * @param name file name/ название файла
-   * @param extension file extension by default is json/ расширение файла по умолчанию - json
-   */
-  private static is(
-    path: PropertiesFilePath,
-    name: string,
-    extension = 'json'
-  ): boolean {
-    return PropertiesFile.is(this.getPathName(path, name, extension))
-  }
-
-  /**
-   * Checks if there are updated files
-   *
-   * Проверяет, есть ли обновленные файлы.
-   * @param name the name of the cache/ название кэша
-   */
-  private static isBySystem(name = 'global'): boolean {
-    let notUpdate = true
-
-    if (name in this.files) {
-      this.files?.[name]?.forEach((path) => {
-        const stat = PropertiesFile.stat(path)
-
-        if (stat && stat.mtimeMs > this.time) {
-          notUpdate = false
-          this.console(`Modified file: ${name}, ${path}`)
-        }
-      })
-    }
-
-    return notUpdate
-  }
-
-  /**
-   * Returns the path to the file
-   *
-   * Возвращает путь к файлу.
-   * @param path path to the file/ путь к файлу
-   */
-  private static getPath(path: PropertiesFilePath): string[] {
-    return [PropertiesFile.getRoot(), ...DIR_CACHE, ...toArray(path)]
-  }
-
-  /**
-   * Returns the full path to the file
-   *
-   * Возвращает полный путь к файлу.
-   * @param path path to the file/ путь к файлу
-   * @param name file name/ название файла
-   * @param extension file extension by default is json/ расширение файла по умолчанию - json
-   */
-  private static getPathName(
-    path: PropertiesFilePath,
-    name: string,
-    extension = 'json'
-  ): string[] {
-    return PropertiesFile.getPathFile(this.getPath(path), name, extension)
-  }
-
-  /**
-   * Reads the content of the file
-   *
-   * Читает содержимое файла.
-   * @param path path to the file/ путь к файлу
-   * @param name file name/ название файла
-   * @param extension file extension by default is json/ расширение файла по умолчанию - json
-   */
-  private static readFile<R>(
-    path: PropertiesFilePath,
-    name: string,
-    extension = 'json'
-  ): R | undefined {
-    return PropertiesFile.readFile<R>(this.getPathName(path, name, extension))
-  }
-
-  /**
-   * Writing data to a file
-   *
-   * Запись данных в файл.
-   * @param path path to the file/ путь к файлу
-   * @param name file name/ название файла
-   * @param value values for storage/ значения для хранения
-   * @param extension file extension by default is json/ расширение файла по умолчанию - json
-   */
-  private static writeFile<T extends PropertiesFileValue>(
-    path: PropertiesFilePath,
-    name: string,
-    value: T,
-    extension = 'json'
-  ): void {
-    PropertiesFile.write(this.getPath(path), name, value, extension)
-  }
-
-  /**
-   * Updates the system data and writes them. Executes after saving the cache
-   *
-   * Обновляет системные данные и записывает их. Выполняется после сохранения кэша.
-   */
-  private static writeSystem(): void {
-    if (this.listenerName.length < 2) {
-      this.time = new Date().getTime()
-
-      const data: PropertiesCacheSystem = {
-        time: this.time,
-        files: this.files,
-        sizes: this.sizes
-      }
-
-      this.writeFile([], FILE_SYSTEM, data)
-      this.console('Writes the system data')
-    }
-  }
-
-  /**
-   * Adding a new message to the console
-   *
-   * Добавление нового сообщения в консоли.
-   * @param text text of the message/ текст сообщения
-   */
-  private static console(text: string): void {
-    console.info('[Cache]', text)
-  }
-
-  static {
-    const system = this.readFile<PropertiesCacheSystem>([], FILE_SYSTEM)
-
-    if (system) {
-      this.time = system.time
-      Object.assign(this.files, system.files)
-      Object.assign(this.sizes, system.sizes)
-    }
-  }
-}

package/src/classes/Properties/PropertiesConfig.ts

@@ -1,213 +0,0 @@
-// export:none
-
-import { toPathStandardSep } from '../../functions/toPathStandardSep'
-
-import { PropertiesFile } from './PropertiesFile'
-
-import type { AiType, DesignUiConfig } from '../../types/configTypes'
-
-import {
-  UI_AI_DOC_DIRECTORY,
-  UI_AI_DOC_STORYBOOK,
-  UI_CONFIG_FILE
-} from '../../config'
-
-/**
- * Static configuration orchestrator for the design system.
- * Responsible for locating, loading, and merging the `design-ui.json` configuration file, handling recursive extensions, and providing a centralized interface for accessing project-wide settings including naming, separators, and AI integration parameters.
- *
- * Статический оркестратор конфигурации для дизайн-системы.
- * Отвечает за поиск, загрузку и слияние файла конфигурации `design-ui.json`, обработку рекурсивных расширений и предоставление централизованного интерфейса для доступа к общепроектным настройкам, включая именование, разделители и параметры интеграции ИИ.
- */
-export class PropertiesConfig {
-  protected static config: DesignUiConfig
-
-  /**
-   * Retrieves the global project identifier.
-   *
-   * Получает глобальный идентификатор проекта.
-   */
-  static getProjectName(): string {
-    return this.config.project ?? 'ui'
-  }
-
-  /**
-   * Retrieves the primary design system name.
-   *
-   * Получает основное название дизайн-системы.
-   */
-  static getDesignName(): string {
-    return this.config.name ?? 'ui'
-  }
-
-  /**
-   * Returns alternative design system aliases.
-   *
-   * Возвращает альтернативные алиасы дизайн-системы.
-   */
-  static getDesignAlternativeName(): string[] | undefined {
-    return this.config?.alternativeName
-  }
-
-  /**
-   * Returns the token path separator character.
-   *
-   * Возвращает символ-разделитель пути токена.
-   */
-  static getSeparator(): string {
-    return this.config.separator ?? '/'
-  }
-
-  /**
-   * Returns the identifier for the base level separator.
-   *
-   * Возвращает идентификатор для базового разделителя.
-   */
-  static getSeparatorBasicName(): string {
-    return this.config.separatorBasicName ?? 'basic'
-  }
-
-  /**
-   * Returns the maximum depth for token path segments.
-   *
-   * Возвращает максимальную глубину сегментов пути токена.
-   */
-  static getSeparatorLimit(): number {
-    return this.config.separatorLimit ?? 6
-  }
-
-  /**
-   * Returns the primary language for documentation generation.
-   *
-   * Возвращает основной язык для генерации документации.
-   */
-  static getWikiLanguage(): string {
-    return this.config.wikiLanguage ?? 'en'
-  }
-
-  /**
-   * Returns the prefix for generated npm packages.
-   *
-   * Возвращает префикс для генерируемых npm-пакетов.
-   */
-  static getPackagePrefix(): string | undefined {
-    return this.config.packagePrefix ?? undefined
-  }
-
-  /**
-   * Returns the configured AI provider type.
-   *
-   * Возвращает настроенный тип ИИ-провайдера.
-   */
-  static getAiType(): AiType {
-    return this.config.aiType ?? 'gemini'
-  }
-
-  /**
-   * Returns the specific AI model identifier.
-   *
-   * Возвращает конкретный идентификатор модели ИИ.
-   */
-  static getAiModel(): string {
-    return this.config.aiModel ?? ''
-  }
-
-  /**
-   * Returns the secure API key for AI authentication.
-   *
-   * Возвращает безопасный API-ключ для аутентификации ИИ.
-   */
-  static getAiKey(): string {
-    return this.config.aiKey ?? ''
-  }
-
-  /**
-   * Returns the Figma access token.
-   *
-   * Возвращает токен доступа к Figma.
-   */
-  static getFigmaToken(): string {
-    return this.config.figmaToken ?? ''
-  }
-
-  /**
-   * Returns the AI configuration object.
-   *
-   * Возвращает объект конфигурации ИИ.
-   */
-  static getAiConfig(): Record<string, any> {
-    return this.config.aiConfig ?? {}
-  }
-
-  /**
-   * Returns the list of directories targeted for AI-driven documentation.
-   *
-   * Возвращает список директорий, предназначенных для автоматической документации через ИИ.
-   */
-  static getAiDocDirectory(): string[] {
-    return this.config.aiDocDirectory ?? UI_AI_DOC_DIRECTORY
-  }
-
-  /**
-   * Returns the export path for Storybook-compatible AI documentation.
-   *
-   * Возвращает путь экспорта для AI-документации, совместимой со Storybook.
-   */
-  static getAiDocStorybookPath(): string {
-    return this.config.aiDocStorybookPath ?? UI_AI_DOC_STORYBOOK
-  }
-
-  /**
-   * Recursively retrieves and merges extended configuration files.
-   *
-   * Рекурсивно получает и объединяет расширенные файлы конфигурации.
-   * @param file path to the configuration file/ путь к файлу конфигурации
-   * @param dir array of directory paths/ массив путей директорий
-   */
-  protected static getExtends(
-    file: string,
-    dir: string[] = []
-  ): DesignUiConfig {
-    const path = [...dir, toPathStandardSep(file)]
-    const read = PropertiesFile.readFile<DesignUiConfig>(path)
-
-    if (read?.extends) {
-      return {
-        ...this.getExtends(
-          read.extends,
-          [PropertiesFile.getPathDir(path)]
-        ),
-        ...read
-      }
-    }
-
-    return read ?? ({} as DesignUiConfig)
-  }
-
-  static {
-    const paths: string[] = [UI_CONFIG_FILE]
-    this.config = {} as DesignUiConfig
-
-    for (let i = 0; i < 32; i++) {
-      if (PropertiesFile.is(paths)) {
-        let file = PropertiesFile.readFile<DesignUiConfig>(paths)
-
-        if (file) {
-          if (
-            file?.extends
-          ) {
-            file = {
-              ...this.getExtends(file.extends, [PropertiesFile.getPathDir(paths)]),
-              ...file
-            }
-          }
-
-          this.config = file
-          break
-        }
-      }
-
-      paths.unshift('..')
-    }
-  }
-}

package/src/classes/Properties/PropertiesConvector.ts

@@ -1,52 +0,0 @@
-// export:none
-
-import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
-
-import { convectorColor } from './convector/convectorColor'
-import { convectorShadow } from './convector/convectorShadow'
-import { convectorFontFamilies } from './convector/convectorFontFamilies'
-import { convectorTypography } from './convector/convectorTypography'
-
-import type { PropertyItemInput, PropertyListOrData } from '../../types/propertyTypes'
-
-const LIST: Record<string, (item: PropertyItemInput) => void> = {
-  boxShadow: convectorShadow,
-  color: convectorColor,
-  fontFamilies: convectorFontFamilies,
-  typography: convectorTypography
-}
-
-/**
- * Static utility for semantic token transformation.
- * This class orchestrates the conversion of raw property values into specialized design formats (e.g., color processing, typography synthesis, shadow normalization) by dispatching items to specific convectors based on their metadata type.
- *
- * Статическая утилита для семантического преобразования токенов.
- * Этот класс координирует преобразование необработанных значений свойств в специализированные форматы дизайна (например, обработка цвета, синтез типографики, нормализация теней), распределяя элементы по конкретным конвертерам на основе их типа метаданных.
- */
-export class PropertiesConvector {
-  /**
-   * Recursively transforms property lists or individual data structures.
-   * Identifies the property type and applies the corresponding specialized convector if available, or continues recursive traversal for nested objects.
-   *
-   * Рекурсивно преобразует списки свойств или отдельные структуры данных.
-   * Определяет тип свойства и применяет соответствующий специализированный конвертер, если он доступен, или продолжает рекурсивный обход для вложенных объектов.
-   * @param properties the property cluster to be transformed / кластер свойств для преобразования
-   */
-  static to(properties: PropertyListOrData): void {
-    forEach(properties, (item) => {
-      if (
-        item?.type
-        && item.type in LIST
-      ) {
-        LIST[item.type]?.(item)
-      } else if (
-        item?.value
-        && isObjectNotArray(item.value)
-      ) {
-        this.to(item.value)
-      } else if (isObjectNotArray(item)) {
-        this.to(item)
-      }
-    })
-  }
-}