@dxtmisha/scripts 0.4.5 → 0.5.0

package/src/classes/Ai/AiGoogleCliLite.ts

@@ -0,0 +1,144 @@
+import { exec } from 'node:child_process'
+import { AiAbstract } from './AiAbstract'
+import { PropertiesFile } from '../Properties/PropertiesFile.ts'
+import { forEach } from '@dxtmisha/functional-basic'
+
+const TEMPORARY_DIR = './ai-tmp'
+
+/**
+ * Google AI (Gemini) implementation via CLI.
+ * Uses system shell to execute Gemini CLI commands.
+ *
+ * Реализация Google AI (Gemini) через CLI.
+ * Использует системную оболочку для выполнения команд Gemini CLI.
+ *
+ * Responsibilities / Ответственности:
+ * - Construct CLI command / Сформировать CLI команду
+ * - Execute command via shell / Выполнить команду через оболочку
+ * - Return stdout as result / Вернуть stdout как результат
+ *
+ * Notes / Примечания:
+ * - Requires 'gemini' CLI tool installed / Требует установленной утилиты 'gemini'
+ * - API key is passed via environment variable or config / API ключ передается через переменную окружения или конфиг
+ */
+export class AiGoogleCliLite extends AiAbstract<{}> {
+  /**
+   * Counter for generating unique temporary file names/
+   * Счетчик для генерации уникальных имен временных файлов
+   */
+  protected idFile = 1
+
+  /**
+   * Generates a unique file path for the temporary prompt.
+   *
+   * Генерирует уникальный путь к файлу для временного промпта.
+   */
+  protected getFileName(): string {
+    return `${TEMPORARY_DIR}/Prompt-${this.idFile++}.txt`
+  }
+
+  /**
+   * Initializes the "client".
+   * For CLI, we just mark it as initialized.
+   *
+   * Инициализирует "клиента".
+   * Для CLI мы просто помечаем его как инициализированный.
+   */
+  protected init(): void {
+    this.ai = {}
+  }
+
+  /**
+   * Implementation hook: convert accumulated images to model-specific format.
+   * CLI implementation currently ignores images.
+   *
+   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+   * Реализация CLI в настоящее время игнорирует изображения.
+   */
+  protected toImages(): any {
+    return []
+  }
+
+  /**
+   * Implementation hook: convert accumulated contents to model-specific format.
+   * Returns array of strings.
+   *
+   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+   * Возвращает массив строк.
+   */
+  protected toContents(): any {
+    return forEach(
+      this.contents,
+      content => this.createFile(content)
+    )
+  }
+
+  /**
+   * Performs content generation request via CLI and returns textual result.
+   *
+   * Выполняет запрос генерации контента через CLI и возвращает текстовый результат.
+   * @param model Model identifier / Идентификатор модели
+   * @param contents Composed contents for generation / Собранный контент для генерации
+   */
+  protected async response(
+    model: string,
+    contents: string
+  ): Promise<string> {
+    return new Promise((resolve) => {
+      const fullPrompt = [
+        ...this.toContents(),
+        this.createFile(contents)
+      ].join('\n\n##################\n\n')
+
+      const escapedPrompt = fullPrompt.replace(/"/g, '\\"')
+      const modelFlag = model ? ` --model "${model}"` : ''
+      const command = `gemini "${escapedPrompt}" Output strictly the code/answer. No preamble, no chatter, no reasoning ${modelFlag} --yolo`
+
+      exec(
+        command,
+        {
+          encoding: 'utf8',
+          env: {
+            ...process.env,
+            GEMINI_API_KEY: this.key
+          }
+        },
+        (error, stdout, stderr) => {
+          if (error) {
+            console.error('Error executing Gemini CLI:', stderr || error.message)
+            resolve('')
+          } else {
+            resolve(stdout.trim())
+          }
+        }
+      )
+
+      this.removeFile()
+    })
+  }
+
+  /**
+   * Creates a temporary file with the prompt content and returns the path formatted for the CLI.
+   *
+   * Создает временный файл с содержимым промпта и возвращает путь, отформатированный для CLI.
+   * @param content Prompt content / Содержимое промпта
+   * @returns Formatted file path (e.g., @./ai-tmp/Prompt-1.txt) / Отформатированный путь к файлу
+   */
+  protected createFile(content: string): string {
+    const name = this.getFileName()
+
+    PropertiesFile.writeByPath(name, content)
+
+    return `Please read the following file as it contains the prompt instructions: @${name}`
+  }
+
+  /**
+   * Cleans up temporary files and directories.
+   *
+   * Очищает временные файлы и директории.
+   * @protected
+   */
+  protected removeFile(): void {
+    PropertiesFile.removeDir(TEMPORARY_DIR)
+  }
+}

package/src/classes/Ai/AiGoogleLite.ts

@@ -0,0 +1,77 @@
+import { forEach } from '@dxtmisha/functional-basic'
+import { AiAbstract } from './AiAbstract'
+import { GoogleGenAI } from '@google/genai'
+
+/**
+ * Google AI (Gemini) implementation of AiAbstract.
+ * Initializes GoogleGenAI client and performs text generation requests.
+ *
+ * Реализация Google AI (Gemini) поверх AiAbstract.
+ * Инициализирует клиент GoogleGenAI и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize low-level client / Инициализировать низкоуровневый клиент
+ * - Call generateContent and extract plain text / Вызвать generateContent и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export class AiGoogleLite extends AiAbstract<GoogleGenAI> {
+  /**
+   * Initializes GoogleGenAI client instance.
+   *
+   * Инициализирует экземпляр клиента GoogleGenAI.
+   */
+  protected init(): void {
+    this.ai = new GoogleGenAI({ apiKey: this.key })
+  }
+
+  /**
+   * Implementation hook: convert accumulated images to model-specific format.
+   *
+   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+   */
+  protected toImages(): any {
+    return forEach(this.images, image => ({
+      inlineData: {
+        mimeType: image.mime,
+        data: image.base64
+      }
+    }))
+  }
+
+  protected toContents(): any {
+    return forEach(this.contents, content => ({
+      text: content
+    }))
+  }
+
+  /**
+   * Performs content generation request and returns textual result.
+   *
+   * Выполняет запрос генерации контента и возвращает текстовый результат.
+   * @param model Model identifier / Идентификатор модели
+   * @param contents Composed contents for generation / Собранный контент для генерации
+   */
+  protected async response(
+    model: string,
+    contents: string
+  ): Promise<string> {
+    const response = await this.ai?.models.generateContent({
+      model,
+      contents: [
+        ...this.toImages(),
+        {
+          parts: [
+            ...this.toContents(),
+            { text: contents }
+          ]
+        }
+      ]
+    })
+
+    return response?.text ?? ''
+  }
+}

package/src/classes/BuildItem.ts

@@ -0,0 +1,176 @@
+import { promisify } from 'node:util'
+import { exec } from 'node:child_process'
+
+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'
+
+/** Template vite config file path / Путь к файлу шаблона vite-конфига */
+const FILE_VITE_SAMPLE = [__dirname, '..', '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()
+
+    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,3 +1,5 @@
+// export:none
+
 import { getComponentPaths } from '../../functions/getComponentPaths'
 
 import { PropertiesFile } from '../Properties/PropertiesFile'

package/src/classes/Component/ComponentItem.ts

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