@dxtmisha/scripts 0.4.5 → 0.5.0

package/src/classes/Git/GitRead.ts

@@ -0,0 +1,258 @@
+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.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 static exec(command: string): string {
+    return execSync(command, { encoding: 'utf8' }).trim()
+  }
+}

package/src/classes/Library/LibraryExport.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { PropertiesFile } from '../Properties/PropertiesFile'
 
 import type { LibraryFiles } from '../../types/libraryTypes'
@@ -48,7 +50,7 @@ export class LibraryExport {
    * @param path filename/ имя файла
    */
   protected isExport(path: string | string[]): boolean {
-    return !this.getFile(path).match(UI_FLAG_NOT_EXPORT)
+    return !PropertiesFile.joinPath(path).match('.test.') && !this.getFile(path).match(UI_FLAG_NOT_EXPORT)
   }
 
   /**

package/src/classes/Library/LibraryFlags.ts

@@ -1,4 +1,6 @@
-import { forEach, toCamelCaseFirst, toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, toCamelCaseFirst, toKebabCase } from '@dxtmisha/functional-basic'
 import flags from '@dxtmisha/media/flags'
 
 import { LibraryItems } from './LibraryItems'

package/src/classes/Library/LibraryItems.ts

@@ -1,4 +1,6 @@
-import { toCamelCaseFirst, toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { toCamelCaseFirst, toKebabCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'

package/src/classes/Library/LibraryMedia.ts

@@ -1,4 +1,6 @@
-import { toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { toCamelCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'

package/src/classes/Package/PackageInit.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { PropertiesFile } from '../Properties/PropertiesFile'
 import { PackageInitItem } from './PackageItem'
 

package/src/classes/Package/PackageItem.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import requirePath from 'path'
 import { PropertiesFile } from '../Properties/PropertiesFile'
 

package/src/classes/Properties/Properties.ts

@@ -1,4 +1,6 @@
-import { replaceRecursive } from '@dxtmisha/functional'
+// export:none
+
+import { replaceRecursive } from '@dxtmisha/functional-basic'
 
 import { PropertiesCache } from './PropertiesCache'
 import { PropertiesPath } from './PropertiesPath'

package/src/classes/Properties/PropertiesCache.ts

@@ -1,4 +1,6 @@
-import { toArray } from '@dxtmisha/functional'
+// export:none
+
+import { toArray } from '@dxtmisha/functional-basic'
 
 import {
   PropertiesFile,

package/src/classes/Properties/PropertiesConfig.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { toPathStandardSep } from '../../functions/toPathStandardSep'
 
 import { PropertiesFile } from './PropertiesFile'
@@ -5,6 +7,7 @@ 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'
 
@@ -97,6 +100,24 @@ export class PropertiesConfig {
     return this.config.aiKey ?? ''
   }
 
+  /**
+   * Returns the directories for AI documentation generation.
+   *
+   * Возвращает каталоги для генерации AI документации.
+   */
+  static getAiDocDirectory(): string[] {
+    return this.config.aiDocDirectory ?? UI_AI_DOC_DIRECTORY
+  }
+
+  /**
+   * Returns the Storybook path for AI documentation generation.
+   *
+   * Возвращает путь Storybook для генерации AI документации.
+   */
+  static getAiDocStorybookPath(): string {
+    return this.config.aiDocStorybookPath ?? UI_AI_DOC_STORYBOOK
+  }
+
   /**
    * Recursively retrieves and merges extended configuration files.
    *

package/src/classes/Properties/PropertiesConvector.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import { convectorColor } from './convector/convectorColor'
 import { convectorShadow } from './convector/convectorShadow'

package/src/classes/Properties/PropertiesFile.ts

@@ -1,4 +1,4 @@
-import { toArray, toKebabCase, transformation } from '@dxtmisha/functional'
+import { Datetime, toArray, toKebabCase, transformation } from '@dxtmisha/functional-basic'
 
 import requireFs from 'fs'
 import requirePath from 'path'
@@ -216,6 +216,16 @@ export class PropertiesFile {
     return undefined
   }
 
+  /**
+   * Returns the time the file was last modified.
+   *
+   * Возвращает время последнего изменения файла.
+   * @param path path to the file/ путь к файлу
+   */
+  static getTime(path: PropertiesFilePath): string | undefined {
+    return new Datetime(this.stat(path)?.mtimeMs, 'full').standard()
+  }
+
   /**
    * Reads the contents of the directory.
    *

package/src/classes/Properties/PropertiesImport.ts

@@ -1,4 +1,6 @@
-import { forEach, isFilled, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isFilled, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional-basic'
 
 import {
   PropertiesFile,

package/src/classes/Properties/PropertiesItems.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import {
   forEach,
   getColumn,
@@ -5,7 +7,7 @@ import {
   isObjectNotArray,
   isSelected,
   toCamelCase
-} from '@dxtmisha/functional'
+} from '@dxtmisha/functional-basic'
 
 import { PropertiesCache } from './PropertiesCache'
 

package/src/classes/Properties/PropertiesKeys.ts

@@ -1,4 +1,6 @@
-import { toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { toCamelCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from './PropertiesConfig'
 import { PropertiesTypes } from './PropertiesTypes'

package/src/classes/Properties/PropertiesMain.ts

@@ -1,4 +1,6 @@
-import { forEach, isFilled, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isFilled, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import { PropertiesPath } from './PropertiesPath'
 import { PropertiesTool } from './PropertiesTool'

package/src/classes/Properties/PropertiesPalette.ts

@@ -1,4 +1,6 @@
-import { forEach, getColumn, isObjectNotArray, toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, getColumn, isObjectNotArray, toCamelCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesItems } from './PropertiesItems'
 

package/src/classes/Properties/PropertiesPath.ts

@@ -1,4 +1,6 @@
-import { replaceRecursive, toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { replaceRecursive, toKebabCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from './PropertiesConfig'
 import { PropertiesTool } from './PropertiesTool'

package/src/classes/Properties/PropertiesScss.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import { PropertiesItems } from './PropertiesItems'
 import { PropertiesPalette } from './PropertiesPalette'

package/src/classes/Properties/PropertiesSeparator.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from './PropertiesConfig'
 import { PropertiesKeys } from './PropertiesKeys'

package/src/classes/Properties/PropertiesSettings.ts

@@ -1,4 +1,6 @@
-import { isFilled, replaceRecursive, toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { isFilled, replaceRecursive, toKebabCase } from '@dxtmisha/functional-basic'
 import { getConstructorProperties } from '../../functions/getConstructorProperties'
 
 import { PropertiesConfig } from './PropertiesConfig'

package/src/classes/Properties/PropertiesStandard.ts

@@ -1,4 +1,6 @@
-import { forEach, isFilled, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isFilled, isObjectNotArray, replaceRecursive } from '@dxtmisha/functional-basic'
 
 import { PropertiesKeys } from './PropertiesKeys'
 import { PropertiesTypes } from './PropertiesTypes'

package/src/classes/Properties/PropertiesTool.ts

@@ -1,4 +1,6 @@
-import { copyObject, toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { copyObject, toCamelCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from './PropertiesConfig'
 import { PropertiesCache } from './PropertiesCache'

package/src/classes/Properties/PropertiesTypes.ts

@@ -1,4 +1,6 @@
-import { isFilled, isSelected, toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { isFilled, isSelected, toKebabCase } from '@dxtmisha/functional-basic'
 
 import {
   type PropertyItem,

package/src/classes/Properties/PropertiesValues.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { type PropertyItemPartial } from '../../types/propertyTypes'
 
 /**

package/src/classes/Properties/PropertiesWrap.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import {
   PropertyKey,

package/src/classes/Properties/convector/convectorColor.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import {
   type PropertyItemInput,
   PropertyKey

package/src/classes/Properties/convector/convectorFontFamilies.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { type PropertyItemInput } from '../../../types/propertyTypes'
 
 /**

package/src/classes/Properties/convector/convectorShadow.ts

@@ -1,4 +1,6 @@
-import { isObject, toArray } from '@dxtmisha/functional'
+// export:none
+
+import { isObject, toArray } from '@dxtmisha/functional-basic'
 
 import { type PropertyItemInput } from '../../../types/propertyTypes'
 

package/src/classes/Properties/convector/convectorTypography.ts

@@ -1,4 +1,6 @@
-import { isString } from '@dxtmisha/functional'
+// export:none
+
+import { isString } from '@dxtmisha/functional-basic'
 
 import { type PropertyItemInput } from '../../../types/propertyTypes'
 

package/src/classes/Properties/to/PropertiesToAbstract.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { PropertiesItems } from '../PropertiesItems'
 
 /**

package/src/classes/Properties/to/PropertiesToAnimate.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 

package/src/classes/Properties/to/PropertiesToClass.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 
 import {

package/src/classes/Properties/to/PropertiesToClone.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 

package/src/classes/Properties/to/PropertiesToComponent.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 
 import {

package/src/classes/Properties/to/PropertiesToDrag.ts

@@ -1,4 +1,6 @@
-import { forEach, isFilled, isObjectNotArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isFilled, isObjectNotArray } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../PropertiesConfig'
 import { PropertiesToAbstract } from './PropertiesToAbstract'

package/src/classes/Properties/to/PropertiesToDuplicate.ts

@@ -1,4 +1,6 @@
-import { forEach, getColumn, isObjectNotArray, toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, getColumn, isObjectNotArray, toCamelCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../PropertiesConfig'
 import { PropertiesToAbstract } from './PropertiesToAbstract'

package/src/classes/Properties/to/PropertiesToFull.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 
 import { PropertyKey } from '../../../types/propertyTypes'

package/src/classes/Properties/to/PropertiesToLink.ts

@@ -1,4 +1,6 @@
-import { isObjectNotArray, splice } from '@dxtmisha/functional'
+// export:none
+
+import { isObjectNotArray, splice } from '@dxtmisha/functional-basic'
 
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 import { PropertiesTypes } from '../PropertiesTypes'
@@ -114,8 +116,9 @@ export class PropertiesToLink extends PropertiesToAbstract {
             this.addIgnore(data.value)
           }
         } else {
-          expect = true
-          break
+          // TODO: зачем это надо?
+          // expect = true
+          // break
         }
       } else if (
         isObjectNotArray(item.value)

package/src/classes/Properties/to/PropertiesToMedia.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray, toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray, toCamelCase } from '@dxtmisha/functional-basic'
 
 import { PropertiesToAbstract } from './PropertiesToAbstract'
 import { PropertiesItems } from '../PropertiesItems'