@dxtmisha/scripts 0.7.8 → 0.7.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.7.8",
+  "version": "0.7.9",
   "type": "module",
   "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
   "keywords": [
@@ -63,14 +63,16 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "peerDependencies": {
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.89.0",
     "@dxtmisha/configuration": "*",
-    "@dxtmisha/media": "*",
     "@dxtmisha/functional": "*",
     "@dxtmisha/functional-basic": "*",
+    "@dxtmisha/media": "*",
     "@dxtmisha/wiki": "*",
-    "typescript": "^5.0.0",
-    "vue": "^3.0.0"
-  },
-  "dependencies": {}
+    "@google/genai": "^1.50.1",
+    "puppeteer": "^24.41.0",
+    "typescript": "^6.0.2",
+    "vue": "^3.5.32"
+  }
 }

package/src/classes/Ai/AiClaude.ts

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

package/src/classes/Ai/AiClaudeCli.ts

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

package/src/classes/Ai/AiClaudeCliLite.ts

@@ -0,0 +1,145 @@
+import { forEach } from '@dxtmisha/functional-basic'
+import { exec } from 'node:child_process'
+
+import { PropertiesFile } from '../Properties/PropertiesFile'
+import { AiAbstract } from './AiAbstract'
+
+const TEMPORARY_DIR = './ai-tmp'
+
+/**
+ * Claude AI implementation via CLI.
+ * Uses system shell to execute Claude CLI commands.
+ *
+ * Реализация Claude AI через CLI.
+ * Использует системную оболочку для выполнения команд Claude CLI.
+ *
+ * Responsibilities / Ответственности:
+ * - Construct CLI command / Сформировать CLI команду
+ * - Execute command via shell / Выполнить команду через оболочку
+ * - Return stdout as result / Вернуть stdout как результат
+ *
+ * Notes / Примечания:
+ * - Requires 'claude' CLI tool installed (e.g., claude-cli) / Требует установленной утилиты 'claude'
+ * - API key is passed via environment variable or config / API ключ передается через переменную окружения или конфиг
+ */
+export class AiClaudeCliLite 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 = `claude "${escapedPrompt}" Output strictly the code/answer. No preamble, no chatter, no reasoning ${modelFlag}`
+
+      exec(
+        command,
+        {
+          encoding: 'utf8',
+          env: {
+            ...process.env,
+            ANTHROPIC_API_KEY: this.key
+          }
+        },
+        (error, stdout, stderr) => {
+          if (error) {
+            console.error('Error executing Claude 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/AiClaudeLite.ts

@@ -0,0 +1,100 @@
+import { forEach } from '@dxtmisha/functional-basic'
+import { AiAbstract } from './AiAbstract'
+import { Anthropic } from '@anthropic-ai/sdk'
+
+/**
+ * Claude AI implementation of AiAbstract.
+ * Initializes Anthropic client and performs text generation requests.
+ *
+ * Реализация Claude AI поверх AiAbstract.
+ * Инициализирует клиент Anthropic и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize Anthropic client / Инициализировать клиент Anthropic
+ * - Call messages.create and extract text content / Вызвать messages.create и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export class AiClaudeLite extends AiAbstract<Anthropic> {
+  /**
+   * Initializes Anthropic client instance.
+   *
+   * Инициализирует экземпляр клиента Anthropic.
+   */
+  protected init(): void {
+    this.ai = new Anthropic({
+      apiKey: this.key
+    })
+  }
+
+  /**
+   * Implementation hook: convert accumulated images to model-specific format.
+   * Claude expects images as content blocks with type 'image'.
+   *
+   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+   * Claude ожидает изображения как блоки контента с типом 'image'.
+   */
+  protected toImages(): any {
+    return forEach(this.images, image => ({
+      type: 'image',
+      source: {
+        type: 'base64',
+        media_type: image.mime,
+        data: image.base64
+      }
+    }))
+  }
+
+  /**
+   * Implementation hook: convert accumulated contents to model-specific format.
+   * Claude expects text as content blocks with type 'text'.
+   *
+   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+   * Claude ожидает текст как блоки контента с типом 'text'.
+   */
+  protected toContents(): any {
+    return forEach(this.contents, content => ({
+      type: 'text',
+      text: content
+    }))
+  }
+
+  /**
+   * Performs content generation request and returns textual result.
+   *
+   * Выполняет запрос генерации контента и возвращает текстовый результат.
+   * @param model Model identifier (e.g., 'claude-3-5-sonnet-20241022') / Идентификатор модели
+   * @param contents Composed contents for generation / Собранный контент для генерации
+   */
+  protected async response(
+    model: string,
+    contents: string
+  ): Promise<string> {
+    const message = await this.ai?.messages.create({
+      model,
+      max_tokens: this.config.maxTokens ?? 4096,
+      messages: [
+        {
+          role: 'user',
+          content: [
+            ...this.toImages(),
+            ...this.toContents(),
+            { type: 'text', text: contents }
+          ]
+        }
+      ],
+      ...this.config
+    })
+
+    // Extract text from content blocks
+    const textContent = message?.content
+      ?.filter(block => block.type === 'text')
+      .map(block => 'text' in block ? block.text : '')
+      .join('\n')
+
+    return textContent ?? ''
+  }
+}

package/src/classes/Design/DesignWikiStorm.ts

@@ -1,4 +1,4 @@
-import { toCamelCaseFirst } from '@dxtmisha/functional-basic'
+import { ServerStorage, toCamelCaseFirst } from '@dxtmisha/functional-basic'
 import { getPackageJson } from '../../functions/getPackageJson'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
@@ -27,6 +27,7 @@ export class DesignWikiStorm {
   constructor(
     protected dir: string = 'dist'
   ) {
+    ServerStorage.setErrorStatus(true)
     this.components = new LibraryItems()
   }
 

package/src/functions/takeScreenshot.ts

@@ -0,0 +1,49 @@
+import puppeteer from 'puppeteer'
+import {
+  SCREENSHOT_FORMAT,
+  SCREENSHOT_HEIGHTS,
+  SCREENSHOT_QUALITY,
+  SCREENSHOT_WIDTHS,
+  type ScreenshotOptions
+} from '../types/screenshotTypes'
+
+/**
+ * Takes a screenshot of the given URL.
+ *
+ * Делает скриншот по указанному URL.
+ * @param url URL to capture/URL для захвата
+ * @param outputPath Path to save the screenshot/Путь для сохранения скриншота
+ * @param options Additional options for screenshot/Дополнительные опции для скриншота
+ */
+export async function takeScreenshot(
+  url: string,
+  outputPath: string,
+  options: ScreenshotOptions = {}
+): Promise<void> {
+  const {
+    width = SCREENSHOT_WIDTHS,
+    height = SCREENSHOT_HEIGHTS,
+    format = SCREENSHOT_FORMAT,
+    quality = SCREENSHOT_QUALITY,
+    fullPage = true
+  } = options
+
+  const browser = await puppeteer.launch()
+  const page = await browser.newPage()
+
+  try {
+    await page.setViewport({ width, height })
+    await page.goto(url, { waitUntil: 'networkidle2' })
+
+    await page.screenshot({
+      path: outputPath,
+      fullPage,
+      type: format,
+      quality
+    })
+  } catch (error) {
+    console.error('Error taking screenshot:', error)
+  } finally {
+    await browser.close()
+  }
+}

package/src/library-ai.ts

@@ -1,3 +1,10 @@
 // Classes
 export * from './classes/Ai/AiAbstract'
 export * from './classes/Ai/AiGoogleLite'
+export * from './classes/Ai/AiGoogle'
+export * from './classes/Ai/AiGoogleCliLite'
+export * from './classes/Ai/AiGoogleCli'
+export * from './classes/Ai/AiClaudeLite'
+export * from './classes/Ai/AiClaude'
+export * from './classes/Ai/AiClaudeCliLite'
+export * from './classes/Ai/AiClaudeCli'

package/src/library.ts

@@ -1,5 +1,9 @@
 // Classes
 export * from './classes/Ai/AiAbstract'
+export * from './classes/Ai/AiClaude'
+export * from './classes/Ai/AiClaudeCli'
+export * from './classes/Ai/AiClaudeCliLite'
+export * from './classes/Ai/AiClaudeLite'
 export * from './classes/Ai/AiDoc'
 export * from './classes/Ai/AiDocItem'
 export * from './classes/Ai/AiDocItemAbstract'
@@ -33,6 +37,7 @@ export * from './functions/getConfigAi'
 export * from './functions/getDirname'
 export * from './functions/getPackageJson'
 export * from './functions/hasNativeDirname'
+export * from './functions/takeScreenshot'
 
 // Types
 export * from './types/aiTypes'
@@ -41,4 +46,5 @@ export * from './types/designTypes'
 export * from './types/gitTypes'
 export * from './types/libraryTypes'
 export * from './types/propertyTypes'
+export * from './types/screenshotTypes'
 export * from './types/webTypes'

package/src/types/screenshotTypes.ts

@@ -0,0 +1,25 @@
+/** Options for taking screenshots/ Опции для создания скриншотов */
+export interface ScreenshotOptions {
+  /** Width of the screenshot/ Ширина скриншота */
+  width?: number
+  /** Height of the screenshot/ Высота скриншота */
+  height?: number
+  /** Format of the screenshot/ Формат скриншота */
+  format?: 'png' | 'jpeg' | 'webp'
+  /** Quality of the screenshot/ Качество скриншота */
+  quality?: number
+  /** Whether to take a full page screenshot/ Делать ли скриншот всей страницы */
+  fullPage?: boolean
+}
+
+/** Default screenshot widths/ Стандартные ширины скриншотов */
+export const SCREENSHOT_WIDTHS = 1920
+
+/** Default screenshot heights/ Стандартные высоты скриншотов */
+export const SCREENSHOT_HEIGHTS = 1080
+
+/** Default screenshot format/ Стандартный формат скриншотов */
+export const SCREENSHOT_FORMAT = 'webp'
+
+/** Default screenshot quality/ Стандартное качество скриншотов */
+export const SCREENSHOT_QUALITY = 80