@dxtmisha/scripts 0.11.8 → 1.1.0

package/src/classes/Ai/AiDocItem.ts

@@ -1,27 +0,0 @@
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-import { AiDocItemAbstract } from './AiDocItemAbstract'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-/** Sample prompt template path / Путь к шаблону промпта */
-const FILE_PROMPT_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates', 'prompts']
-
-/** Sample prompt template path for functions / Путь к шаблону промпта для функций */
-const FILE_PROMPT_SAMPLE_ITEM = [...FILE_PROMPT_SAMPLE, 'aiDocFunctionPrompt.en.txt']
-
-/** Sample demo file path for functions / Путь к демо файлу для функций */
-const FILE_DEMO_SAMPLE_ITEM = [...FILE_PROMPT_SAMPLE, 'demoDocEn.mdx']
-
-/**
- * Class for generating documentation for Functions.
- *
- * Класс для генерации документации для Функций.
- */
-export class AiDocItem extends AiDocItemAbstract {
-  protected pathDemo: string[] = FILE_DEMO_SAMPLE_ITEM
-  protected pathPrompt: string[] = FILE_PROMPT_SAMPLE_ITEM
-}

package/src/classes/Ai/AiDocItemAbstract.ts

@@ -1,209 +0,0 @@
-import { Datetime, removeCommonPrefix } from '@dxtmisha/functional-basic'
-import { useAi } from '../../composables/useAi'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { GitRead } from '../Git/GitRead'
-import { BuildItem } from '../BuildItem'
-import { ComponentWikiFile } from '../Component/ComponentWikiFile'
-
-import type { AiAbstract } from './AiAbstract'
-import type { GitFileItem } from '../../types/gitTypes'
-
-import { UI_DIR_IN, UI_FILE_PACKAGE } from '../../config'
-
-export abstract class AiDocItemAbstract {
-  /** Demo file path / Путь к файлу демо */
-  protected abstract pathDemo: string[]
-  /** Prompt template path / Путь к шаблону промпта */
-  protected abstract pathPrompt: string[]
-
-  /** Build item / Элемент сборки */
-  protected readonly build: BuildItem
-
-  /** Markdown file / Файл в формате Markdown */
-  protected readonly mdFile: ComponentWikiFile
-
-  /** Code file / Файл с кодом */
-  protected readonly code: ComponentWikiFile
-
-  /** Property file data / Данные из файла свойств */
-  protected readonly projectName: string
-
-  /** AI instance / Экземпляр ИИ */
-  protected readonly ai?: AiAbstract
-
-  /** Description from AI / Описание от ИИ */
-  protected description?: string
-
-  /**
-   * Constructor
-   * @param path source file path / путь к исходному файлу
-   * @param item git file item / элемент файла git
-   */
-  constructor(
-    protected readonly path: string,
-    protected readonly item: GitFileItem
-  ) {
-    this.build = new BuildItem(this.item.path)
-    this.mdFile = new ComponentWikiFile(this.getPathWiki(), true, false)
-    this.code = new ComponentWikiFile(this.item.pathByOS, false, false)
-    this.projectName = PropertiesFile.readFile<Record<string, any>>(UI_FILE_PACKAGE)?.name ?? 'Library'
-    this.ai = useAi()
-  }
-
-  /**
-   * Generates documentation using AI.
-   *
-   * Генерирует документацию с использованием ИИ.
-   */
-  async make() {
-    const date = this.mdFile.getDate()
-
-    if (
-      this.ai
-      && this.getItemDate() > date.getDate()
-    ) {
-      console.log(
-        `${this.projectName}/File:`,
-        this.item.path,
-        PropertiesConfig.getWikiLanguage()
-      )
-
-      const status = this.isBuildDisabled() || await this.build.make()
-
-      if (status) {
-        this.makeAi()
-
-        const generate = await this.ai.generate(
-          this.readPrompt()
-        )
-
-        if (generate) {
-          const read = generate.split('#########')
-
-          if (read?.[0]) {
-            this.description = read[0].trim()
-          }
-
-          if (
-            read?.[1]
-            && !read[1].match('--FULL--')
-          ) {
-            this.code.write(read[1])
-          }
-
-          if (read?.[2]) {
-            this.mdFile.write(this.initName(read[2]))
-          }
-        }
-      }
-
-      this.build.removeDir()
-    } else if (!this.ai) {
-      console.error('AI is not configured.')
-    }
-  }
-
-  /**
-   * Checks if the item is marked as not to be built.
-   *
-   * Проверяет, помечен ли элемент как не подлежащий сборке.
-   */
-  isBuildDisabled(): boolean {
-    return Boolean(
-      this.code.read().match('// wiki:build-none')
-    )
-  }
-
-  /**
-   * Returns the path to the Wiki file.
-   *
-   * Возвращает путь к Wiki файлу.
-   */
-  protected getPathWiki(): string[] {
-    const fileName = removeCommonPrefix(this.item.path, this.path)
-      .replace(/\.ts$/, '')
-
-    return [
-      ...GitRead.splitPath(this.path),
-      ...GitRead.splitPath(`${fileName}.mdx`)
-    ]
-  }
-
-  /**
-   * Returns the file modification date.
-   *
-   * Возвращает дату изменения файла.
-   */
-  protected getItemDate(): Date {
-    return new Datetime(this.item.date).getDate()
-  }
-
-  /**
-   * Returns the title for the documentation.
-   *
-   * Возвращает заголовок для документации.
-   */
-  protected getTitle() {
-    let title = this.projectName
-      + '/'
-      + this.item.path
-        .replace(UI_DIR_IN + '/', '')
-        .replace(/\.ts$/, '')
-
-    if (this.description) {
-      title += ` - ${this.description}`
-    }
-
-    return title
-  }
-
-  /**
-   * Reads the demo file content.
-   *
-   * Читает содержимое демо-файла.
-   */
-  protected readDemo(): string {
-    return new ComponentWikiFile(this.pathDemo).read()
-  }
-
-  /**
-   * Reads the prompt template.
-   *
-   * Читает шаблон промпта.
-   */
-  protected readPrompt(): string {
-    return new ComponentWikiFile(this.pathPrompt)
-      .read()
-      .replace(/\[wikiLanguage]/g, PropertiesConfig.getWikiLanguage())
-  }
-
-  /**
-   * Prepares context for AI.
-   *
-   * Подготавливает контекст для ИИ.
-   */
-  protected makeAi(): void {
-    if (this.ai) {
-      this.ai.addContent(`Code: ${this.build.getCode()}`)
-      this.ai.addContent(`Original code: ${this.code.read()}`)
-      this.ai.addContent(`Demo (only for template analysis, all data is fake): ${this.readDemo()}`)
-      this.ai.addContent(`Original MDX: ${this.mdFile.read()}`)
-    }
-  }
-
-  /**
-   * Initializes the title in the content.
-   *
-   * Инициализирует заголовок в контенте.
-   * @param content content / контент
-   */
-  protected initName(content: string): string {
-    if (content.match('[title]')) {
-      return content.replace('[title]', this.getTitle())
-    }
-
-    return content
-  }
-}

package/src/classes/Ai/AiDocItemClasses.ts

@@ -1,27 +0,0 @@
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-import { AiDocItemAbstract } from './AiDocItemAbstract'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-/** Sample prompt template path / Путь к шаблону промпта */
-const FILE_PROMPT_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates', 'prompts']
-
-/** Sample prompt template for classes / Шаблон промпта для классов */
-const FILE_PROMPT_SAMPLE_CLASS = [...FILE_PROMPT_SAMPLE, 'aiDocClassPrompt.en.txt']
-
-/** Sample demo file for classes / Пример демонстрационного файла для классов */
-const FILE_DEMO_SAMPLE_CLASS = [...FILE_PROMPT_SAMPLE, 'demoClassEn.mdx']
-
-/**
- * AI Documentation Item for Classes.
- *
- * Элемент документации AI для классов.
- */
-export class AiDocItemClasses extends AiDocItemAbstract {
-  protected pathDemo: string[] = FILE_DEMO_SAMPLE_CLASS
-  protected pathPrompt: string[] = FILE_PROMPT_SAMPLE_CLASS
-}

package/src/classes/Ai/AiDocItemComposables.ts

@@ -1,20 +0,0 @@
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-import { AiDocItemAbstract } from './AiDocItemAbstract'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-/** Sample prompt template path / Путь к шаблону промпта */
-const FILE_PROMPT_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates', 'prompts']
-
-const FILE_PROMPT_SAMPLE_COMPOSABLE = [...FILE_PROMPT_SAMPLE, 'aiDocComposablePrompt.en.txt']
-
-const FILE_DEMO_SAMPLE_COMPOSABLE = [...FILE_PROMPT_SAMPLE, 'demoComposableEn.mdx']
-
-export class AiDocItemComposables extends AiDocItemAbstract {
-  protected pathDemo: string[] = FILE_DEMO_SAMPLE_COMPOSABLE
-  protected pathPrompt: string[] = FILE_PROMPT_SAMPLE_COMPOSABLE
-}

package/src/classes/Ai/AiDocType.ts

@@ -1,45 +0,0 @@
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-
-import type { AiDocTypeItem } from '../../types/aiTypes'
-import type { GitFileItem } from '../../types/gitTypes'
-
-import { aiDocTypes } from '../../media/ai/ai-doc-types'
-
-/**
- * Class for managing AI documentation types.
- *
- * Класс для управления типами документации ИИ.
- */
-export class AiDocType {
-  /** List of available documentation types / Список доступных типов документации */
-  protected static types = [...aiDocTypes]
-
-  /**
-   * Adds a new documentation type to the list.
-   *
-   * Добавляет новый тип документации в список.
-   * @param type documentation type item / элемент типа документации
-   */
-  static add(type: AiDocTypeItem) {
-    this.types.unshift(type)
-  }
-
-  /**
-   * Generates documentation for a file item.
-   *
-   * Генерирует документацию для элемента файла.
-   * @param item git file item / элемент файла git
-   */
-  static async make(item: GitFileItem) {
-    const path = PropertiesConfig.getAiDocStorybookPath()
-
-    for (const docType of aiDocTypes) {
-      if (docType.check(item)) {
-        const docItem = new docType.item(path, item)
-        await docItem.make()
-
-        break
-      }
-    }
-  }
-}

package/src/classes/Ai/AiGoogle.ts

@@ -1,26 +0,0 @@
-import { getConfigAi } from '../../functions/getConfigAi'
-import { AiGoogleLite } from './AiGoogleLite'
-
-/**
- * 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 AiGoogle extends AiGoogleLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}

package/src/classes/Ai/AiGoogleCli.ts

@@ -1,24 +0,0 @@
-import { getConfigAi } from '../../functions/getConfigAi'
-import { AiGoogleCliLite } from './AiGoogleCliLite'
-
-/**
- * Google AI (Gemini) implementation via CLI.
- * Extends AiGoogleCliLite and provides configuration from the project environment.
- *
- * Реализация Google AI (Gemini) через CLI.
- * Расширяет AiGoogleCliLite и предоставляет конфигурацию из окружения проекта.
- *
- * Responsibilities / Ответственности:
- * - Provide API key and model from config / Предоставить API ключ и модель из конфигурации
- * - Initialize CLI wrapper / Инициализировать обертку CLI
- *
- * Notes / Примечания:
- * - Uses getConfigAi() to retrieve credentials / Использует getConfigAi() для получения учетных данных
- */
-export class AiGoogleCli extends AiGoogleCliLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}

package/src/classes/Ai/AiGoogleCliLite.ts

@@ -1,108 +0,0 @@
-import { forEach } from '@dxtmisha/functional-basic'
-import { exec } from 'node:child_process'
-
-import { AiAbstract } from './AiAbstract'
-import { ApiTmp } from './ApiTmp'
-
-/**
- * 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<{}> {
-  protected readonly tmp = new ApiTmp()
-
-  /**
-   * 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.tmp.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.tmp.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`
-
-      try {
-        exec(
-          command,
-          {
-            encoding: 'utf8',
-            env: {
-              ...process.env
-            }
-          },
-          (error, stdout, stderr) => {
-            if (error) {
-              console.error('Error executing Gemini CLI:', stderr || error.message)
-              resolve('')
-            } else {
-              resolve(stdout.trim())
-            }
-
-            this.tmp.removeFile()
-          }
-        )
-      } catch (_) {
-        this.tmp.removeFile()
-      }
-    })
-  }
-}

package/src/classes/Ai/AiGoogleLite.ts

@@ -1,78 +0,0 @@
-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 }
-          ]
-        }
-      ],
-      config: this.config
-    })
-
-    return response?.text ?? ''
-  }
-}

package/src/classes/Ai/AiOpenAi.ts

@@ -1,26 +0,0 @@
-import { AiOpenAiLite } from './AiOpenAiLite'
-import { getConfigAi } from '../../functions/getConfigAi'
-
-/**
- * OpenAI implementation of AiAbstract.
- * Initializes OpenAI client and performs text generation requests.
- *
- * Реализация OpenAI поверх AiAbstract.
- * Инициализирует клиент OpenAI и выполняет запросы генерации текста.
- *
- * Responsibilities / Ответственности:
- * - Provide API key / Предоставить API ключ
- * - Initialize low-level client / Инициализировать низкоуровневый клиент
- * - Call chat.completions.create and extract plain text / Вызвать chat.completions.create и извлечь текст
- *
- * Notes / Примечания:
- * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
- * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
- */
-export class AiOpenAi extends AiOpenAiLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}