@dxtmisha/scripts 0.5.10 → 0.5.13

package/bin/design-types.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env vite-node
+
+import { DesignTypes } from '../src/classes/Design/DesignTypes'
+
+const dir: string = process.argv?.[2] ?? 'dist'
+
+new DesignTypes(dir).make()

package/bin/design-ui.ts

@@ -2,6 +2,6 @@
 
 import { DesignUi } from '../src/classes/Design/DesignUi'
 
-const name: string = process.argv?.[2] ?? ''
+const name: string | undefined = process.argv?.[2] ?? undefined
 
 new DesignUi(name).make()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.5.10",
+  "version": "0.5.13",
   "type": "module",
   "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
   "keywords": [
@@ -46,6 +46,7 @@
     "dxt-constructor": "bin/design-constructor.ts",
     "dxt-library": "bin/design-library.ts",
     "dxt-package": "bin/design-package.ts",
+    "dxt-types": "bin/design-types.ts",
     "dxt-ui": "bin/design-ui.ts"
   },
   "exports": {

package/src/classes/Ai/AiGoogleCliLite.ts

@@ -1,7 +1,8 @@
+import { forEach } from '@dxtmisha/functional-basic'
 import { exec } from 'node:child_process'
+
+import { PropertiesFile } from '../Properties/PropertiesFile'
 import { AiAbstract } from './AiAbstract'
-import { PropertiesFile } from '../Properties/PropertiesFile.ts'
-import { forEach } from '@dxtmisha/functional-basic'
 
 const TEMPORARY_DIR = './ai-tmp'
 

package/src/classes/Design/DesignTypes.ts

@@ -0,0 +1,196 @@
+import { forEach } from '@dxtmisha/functional-basic'
+import { useAi } from '../../composables/useAi'
+
+import { PropertiesFile } from '../Properties/PropertiesFile'
+
+import type { DesignTypesList } from '../../types/designTypes'
+
+import { UI_FILE_AI_TYPES } from '../../config'
+
+/**
+ * Class for generating AI-optimized type definitions.
+ *
+ * Класс для генерации оптимизированных ИИ определений типов.
+ */
+export class DesignTypes {
+  /**
+   * Array of directory path segments.
+   *
+   * Массив сегментов пути директории.
+   */
+  protected readonly dirArray: string[]
+
+  /**
+   * Constructor
+   * @param dir directory path / путь к директории
+   */
+  constructor(
+    protected readonly dir: string = 'dist'
+  ) {
+    this.dirArray = this.dir.split('/')
+  }
+
+  /**
+   * Main method to execute the type generation process.
+   *
+   * Основной метод для выполнения процесса генерации типов.
+   */
+  make() {
+    console.log('DesignTypes: making AI types...')
+
+    const files = this.getListByFilter()
+    const fullContent = this.toOneFile(files)
+
+    this.toAiEdit(fullContent).then(
+      (aiContent) => {
+        this.save(aiContent)
+
+        console.log('DesignTypes: AI types saved.')
+      }
+    )
+  }
+
+  /**
+   * Checks if the file is a valid declaration file.
+   *
+   * Проверяет, является ли файл валидным файлом декларации.
+   * @param file file name / имя файла
+   */
+  protected isFile(file: string): boolean {
+    return file.endsWith('.d.ts')
+      && (
+        !file.includes('constructors/')
+        || (
+          !file.endsWith('/props.d.ts')
+          && !file.endsWith('/types.d.ts')
+        )
+      )
+  }
+
+  /**
+   * Checks if the content contains type definitions.
+   *
+   * Проверяет, содержит ли контент определения типов.
+   * @param content file content / содержимое файла
+   */
+  protected isContent(content?: string): content is string {
+    return Boolean(
+      content && (
+        content.includes('export interface')
+        || content.includes('export type')
+        || content.includes('export enum')
+      ))
+  }
+
+  /**
+   * Returns the full path segments for a file.
+   *
+   * Возвращает сегменты полного пути для файла.
+   * @param file file name / имя файла
+   */
+  protected getPath(file: string): string[] {
+    return [...this.dirArray, file]
+  }
+
+  /**
+   * Reads the directory recursively.
+   *
+   * Читает директорию рекурсивно.
+   */
+  protected getList() {
+    return PropertiesFile.readDirRecursive(this.dirArray)
+  }
+
+  /**
+   * Gets a list of files filtered by criteria.
+   *
+   * Получает список файлов, отфильтрованный по критериям.
+   */
+  protected getListByFilter(): DesignTypesList {
+    return forEach(
+      this.getList(),
+      (file) => {
+        if (this.isFile(file)) {
+          const content = this.readFile(file)
+
+          if (this.isContent(content)) {
+            return {
+              path: file,
+              content
+            }
+          }
+        }
+
+        return undefined
+      }
+    ) as DesignTypesList
+  }
+
+  /**
+   * Reads the content of a file.
+   *
+   * Читает содержимое файла.
+   * @param path file path / путь к файлу
+   */
+  protected readFile(path: string): string | undefined {
+    return PropertiesFile.readFileOnly(this.getPath(path))
+  }
+
+  /**
+   * Saves the generated content to a file.
+   *
+   * Сохраняет сгенерированный контент в файл.
+   * @param content content to save / контент для сохранения
+   */
+  protected save(content: string) {
+    PropertiesFile.writeByPath(
+      UI_FILE_AI_TYPES,
+      content
+    )
+  }
+
+  /**
+   * Combines a list of files into a single string.
+   *
+   * Объединяет список файлов в одну строку.
+   * @param list list of files / список файлов
+   */
+  protected toOneFile(list: DesignTypesList): string {
+    return forEach(
+      list,
+      item => `// File: ${item.path}\n${item.content}`
+    )
+      .join('\n\n')
+  }
+
+  /**
+   * Sends content to AI for optimization.
+   *
+   * Отправляет контент ИИ для оптимизации.
+   * @param content content to optimize / контент для оптимизации
+   */
+  protected async toAiEdit(content: string): Promise<string> {
+    const ai = useAi()
+
+    if (ai) {
+      ai.addPrompt(`File Content: ${content}`)
+
+      const generate = await ai.generate(
+        'Remove all Russian comments from this code. '
+        + 'Remove comments if the property name makes its purpose obvious. '
+        + 'Remove all imports. '
+        + 'Remove empty lines. '
+        + 'Remove the "export" keyword if possible. '
+        + 'Keep only "type", "interface" and "enum" definitions, remove everything else. '
+        + 'Minimize the content as much as possible without losing any data or logic. '
+        + 'Return only the corrected code without any additional text or explanations.'
+      )
+
+      if (generate) {
+        return generate
+      }
+    }
+
+    return content
+  }
+}

package/src/classes/Package/PackageItem.ts

@@ -1,10 +1,10 @@
 // export:none
 
 import requirePath from 'path'
+import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'
 
 import { UI_DIR_PACKAGES, UI_DIRS_LIBRARY, UI_FILE_PACKAGE } from '../../config'
-import { PropertiesConfig } from '../Properties/PropertiesConfig.ts'
 
 const DIR_SAMPLE = [__dirname, '..', '..', 'media', 'templates', 'packages']
 const DIR_STORYBOOK = [

package/src/classes/Properties/PropertiesFile.ts

@@ -1,4 +1,4 @@
-import { Datetime, toArray, toKebabCase, transformation } from '@dxtmisha/functional-basic'
+import { Datetime, forEach, toArray, toKebabCase, transformation } from '@dxtmisha/functional-basic'
 
 import requireFs from 'fs'
 import requirePath from 'path'
@@ -64,7 +64,12 @@ export class PropertiesFile {
    * @param path a sequence of path segments/ последовательность сегментов пути
    */
   static joinPath(path: PropertiesFilePath): string {
-    return requirePath.join(...toArray(path))
+    const pathArray = forEach(
+      toArray(path),
+      item => this.toSep(item)
+    ) as string[]
+
+    return requirePath.join(...pathArray)
   }
 
   /**
@@ -226,6 +231,23 @@ export class PropertiesFile {
     return new Datetime(this.stat(path)?.mtimeMs, 'full').standard()
   }
 
+  /**
+   * Converts the path to use the current OS separator.
+   *
+   * Преобразует путь для использования текущего разделителя ОС.
+   * @param path path to the directory/ путь к директории
+   */
+  static toSep(path: PropertiesFilePath): PropertiesFilePath {
+    const sep = this.sep()
+
+    if (sep === '/') {
+      return path
+    }
+
+    return this.joinPath(path)
+      .replace('/', this.sep())
+  }
+
   /**
    * Reads the contents of the directory.
    *

package/src/config.ts

@@ -83,6 +83,8 @@ export const UI_FILE_NAME_VITE_WORKERS = 'vite-workers.config.ts'
 
 export const UI_FILE_INDEX = 'index.ts'
 
+export const UI_FILE_AI_TYPES = 'ai-types.txt'
+
 /** SCSS file extension/ Расширение файлов SCSS */
 export const UI_EXTENSION_STYLE = 'scss'
 

package/src/functions/getPackageJson.ts

@@ -0,0 +1,11 @@
+import { PropertiesFile } from '../classes/Properties/PropertiesFile'
+import { UI_FILE_PACKAGE } from '../config'
+
+/**
+ * Returns the package.json file content.
+ *
+ * Возвращает содержимое файла package.json.
+ */
+export function getPackageJson(): Record<string, any> | undefined {
+  return PropertiesFile.readFile<Record<string, any>>(UI_FILE_PACKAGE)
+}

package/src/library.ts

@@ -11,6 +11,7 @@ export * from './classes/Ai/AiGoogleCli'
 export * from './classes/Ai/AiGoogleCliLite'
 export * from './classes/Ai/AiGoogleLite'
 export * from './classes/BuildItem'
+export * from './classes/Design/DesignTypes'
 export * from './classes/Design/DesignTypescript'
 export * from './classes/Git/GitRead'
 export * from './classes/Properties/PropertiesFile'
@@ -20,6 +21,7 @@ export * from './composables/useAi'
 
 // Functions
 export * from './functions/getConfigAi'
+export * from './functions/getPackageJson'
 
 // Types
 export * from './types/aiTypes'

package/src/media/templates/componentDoc/wiki/run.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env vite-node
+/// <reference types="node" />
 
 import { spawn } from 'node:child_process'
 

package/src/types/designTypes.ts

@@ -94,3 +94,10 @@ export type DesignTypescriptItem = {
 
 /** List of TypeScript items / Список TypeScript элементов */
 export type DesignTypescriptList = DesignTypescriptItem[]
+
+export type DesignTypesItem = {
+  path: string
+  content: string
+}
+
+export type DesignTypesList = DesignTypesItem[]