@dxtmisha/scripts 1.1.2 → 1.1.4

package/dist/library.d.ts

@@ -182,6 +182,81 @@ export declare abstract class AiAbstract<AI = any> {
     protected abstract response(model: string, contents: string): Promise<string>;
 }
 
+/**
+ * Google Antigravity AI implementation via CLI (`agy`).
+ * Extends AiAntigravityCliLite and provides configuration from the project environment.
+ *
+ * Реализация Google Antigravity AI через CLI (`agy`).
+ * Расширяет AiAntigravityCliLite и предоставляет конфигурацию из окружения проекта.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key and model from config / Предоставить API ключ и модель из конфигурации
+ * - Initialize CLI wrapper / Инициализировать обертку CLI
+ *
+ * Notes / Примечания:
+ * - Uses getConfigAi() to retrieve credentials / Использует getConfigAi() для получения учетных данных
+ */
+export declare class AiAntigravityCli extends AiAntigravityCliLite {
+    /**
+     * Constructor initializes Antigravity CLI AI with project configuration.
+     *
+     * Конструктор инициализирует Antigravity CLI AI с конфигурацией проекта.
+     */
+    constructor();
+}
+
+/**
+ * Google Antigravity AI implementation via CLI (`agy`).
+ * Executes Antigravity CLI commands directly without a system shell.
+ *
+ * Реализация Google Antigravity AI через CLI (`agy`).
+ * Выполняет команды Antigravity CLI напрямую, без системной оболочки.
+ *
+ * Responsibilities / Ответственности:
+ * - Construct Antigravity CLI command / Сформировать команду Antigravity CLI
+ * - Execute command without shell / Выполнить команду без оболочки
+ * - Return stdout as result / Вернуть stdout как результат
+ *
+ * Notes / Примечания:
+ * - Requires 'agy' CLI tool installed / Требует установленной утилиты 'agy'
+ * - API key is passed via environment variable or config / API ключ передается через переменную окружения или конфиг
+ */
+export declare class AiAntigravityCliLite extends AiAbstract<{}> {
+    /** Temporary prompt file manager / Менеджер временных файлов промпта */
+    protected readonly tmp: ApiTmp;
+    /**
+     * Initializes the client instance.
+     *
+     * Инициализирует экземпляр клиента.
+     */
+    protected init(): Promise<void>;
+    /**
+     * Implementation hook: convert accumulated images to model-specific format.
+     * CLI implementation currently ignores images.
+     *
+     * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+     * Реализация CLI в настоящее время игнорирует изображения.
+     * @returns array of converted images / массив преобразованных изображений
+     */
+    protected toImages(): any;
+    /**
+     * Implementation hook: convert accumulated contents to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+     * @returns array of formatted prompt strings / массив отформатированных строк промпта
+     */
+    protected toContents(): any;
+    /**
+     * Performs content generation request via Antigravity CLI and returns textual result.
+     *
+     * Выполняет запрос генерации контента через Antigravity CLI и возвращает текстовый результат.
+     * @param model model identifier / идентификатор модели
+     * @param contents composed contents for generation / собранный контент для генерации
+     * @returns generated text response / сгенерированный текстовый ответ
+     */
+    protected response(model: string, contents: string): Promise<string>;
+}
+
 /**
  * Claude AI implementation of AiAbstract.
  * Initializes Anthropic client and performs text generation requests.
@@ -645,7 +720,7 @@ export declare class AiOpenAiLite extends AiAbstract<OpenAI> {
  *
  * Тип ИИ-провайдера для генерации кода и контента.
  */
-export declare type AiType = 'claude' | 'claude-cli' | 'claude-agent' | 'gemini' | 'gemini-cli' | 'openai' | 'zai';
+export declare type AiType = 'antigravity-cli' | 'claude' | 'claude-agent' | 'claude-cli' | 'gemini' | 'gemini-cli' | 'openai' | 'zai';
 
 /**
  * Z.ai (Zhipu AI) implementation extending AiZAiLite.
@@ -1084,10 +1159,10 @@ export declare type DesignMcpResources = DesignMcpResourceItem[];
 
 /**
  * Automates the capturing of full-page component screenshots and extraction of DOM/CSS styles.
- * Spawns a local development server, navigates headless browser, captures screenshots, and dumps HTML and CSS artifacts.
+ * Spawns a local development server, navigates headless browser, captures screenshots, dumps HTML and CSS artifacts, and generates AI visual metadata.
  *
  * Автоматизирует создание полностраничных скриншотов компонентов и извлечение DOM/CSS стилей.
- * Запускает локальный сервер разработки, открывает headless-браузер, делает скриншоты и сохраняет HTML и CSS артефакты.
+ * Запускает локальный сервер разработки, открывает headless-браузер, делает скриншоты, сохраняет HTML и CSS артефакты и генерирует визуальные метаданные с помощью ИИ.
  */
 export declare class DesignScreenshot {
     protected readonly file: string;
@@ -1102,6 +1177,13 @@ export declare class DesignScreenshot {
      * @param file output path / путь к файлу
      */
     constructor(file?: string);
+    /**
+     * Returns an instance of DesignScreenshotDescription for AI metadata analysis.
+     *
+     * Возвращает экземпляр DesignScreenshotDescription для ИИ анализа метаданных.
+     * @returns instance of DesignScreenshotDescription / экземпляр DesignScreenshotDescription
+     */
+    getDescription(): DesignScreenshotDescription;
     /**
      * Starts the screenshot process.
      *
@@ -1133,6 +1215,124 @@ export declare class DesignScreenshot {
     makeUrl(data: string): this;
 }
 
+/**
+ * Class for analyzing individual component screenshots using AI and generating structured JSON metadata descriptions.
+ * Reads captured screenshot image files, analyzes visible components per screenshot with multimodal AI, and saves the list of screenshot descriptors to a JSON file.
+ *
+ * Класс для анализа отдельных скриншотов компонентов с помощью ИИ и генерации структурированных JSON описаний метаданных.
+ * Читает сохраненные файлы изображений скриншотов, анализирует видимые компоненты для каждого скриншота с помощью мультимодального ИИ и сохраняет список дескрипторов скриншотов в JSON файл.
+ */
+export declare class DesignScreenshotDescription {
+    protected readonly file: string;
+    /** Cached list of analyzed screenshot items / Кэшированный список проанализированных элементов скриншота */
+    protected items?: DesignScreenshotList;
+    /**
+     * Constructor initializes target screenshot file path.
+     *
+     * Конструктор инициализирует целевой путь к файлу скриншота.
+     * @param file target screenshot file base path / базовый путь к целевому файлу скриншота
+     */
+    constructor(file?: string);
+    /**
+     * Checks if the screenshot description JSON file exists.
+     *
+     * Проверяет, существует ли JSON файл описания скриншота.
+     * @returns true if description file exists / true, если файл описания существует
+     */
+    is(): boolean;
+    /**
+     * Returns the directory containing the screenshot files.
+     *
+     * Возвращает директорию, содержащую файлы скриншотов.
+     * @returns directory path / путь к директории
+     */
+    getDir(): string;
+    /**
+     * Returns the JSON description file path.
+     *
+     * Возвращает путь к JSON файлу описания.
+     * @returns JSON file path / путь к JSON файлу
+     */
+    getJsonPath(): string;
+    /**
+     * Returns the list of screenshot description items from cache or file.
+     *
+     * Возвращает список элементов описания скриншота из кэша или файла.
+     * @returns list of screenshot description items / список элементов описания скриншота
+     */
+    getItems(): DesignScreenshotList;
+    /**
+     * Executes AI screenshot analysis for each screenshot image file and writes results to the JSON file.
+     *
+     * Выполняет анализ скриншотов с помощью ИИ для каждого файла изображения скриншота и записывает результаты в JSON файл.
+     * @returns this instance / этот экземпляр
+     */
+    make(): Promise<this>;
+    /**
+     * Loads an individual image file by name and returns an AI image item with base64 data.
+     *
+     * Загружает отдельный файл изображения по имени и возвращает элемент изображения ИИ с данными base64.
+     * @param fileName image file name / имя файла изображения
+     * @returns AI image item or undefined / элемент изображения ИИ или undefined
+     * @protected
+     */
+    protected getImage(fileName: string): AiImageItem | undefined;
+    /**
+     * Scans screenshot directory and returns a sorted list of image file names.
+     *
+     * Сканирует директорию скриншотов и возвращает отсортированный список имен файлов изображений.
+     * @returns sorted array of image file names / отсортированный массив имен файлов изображений
+     * @protected
+     */
+    protected getImageFiles(): string[];
+    /**
+     * Determines MIME type based on image file extension.
+     *
+     * Определяет MIME-тип на основе расширения файла изображения.
+     * @param file filename or path / имя файла или путь
+     * @returns image MIME type string / строка MIME-типа изображения
+     * @protected
+     */
+    protected getMimeType(file: string): string;
+    /**
+     * Saves the generated screenshot description list to a JSON file.
+     *
+     * Сохраняет сгенерированный список описаний скриншота в JSON файл.
+     * @param items description items list / список элементов описания
+     * @protected
+     */
+    protected saveJson(items: DesignScreenshotList): void;
+    /**
+     * Sends a single screenshot image and prompt to AI and parses the JSON response into a screenshot descriptor item.
+     *
+     * Отправляет отдельное изображение скриншота и промпт ИИ и парсит полученный JSON-ответ в элемент дескриптора скриншота.
+     * @param fileName image file name / имя файла изображения
+     * @param image image item with base64 data / элемент изображения с данными base64
+     * @returns parsed screenshot item or undefined / распарсенный элемент скриншота или undefined
+     * @protected
+     */
+    protected toAiItem(fileName: string, image: AiImageItem): Promise<DesignScreenshotItem | undefined>;
+}
+
+/**
+ * Screenshot visual analysis item containing component name and description.
+ *
+ * Элемент визуального анализа скриншота, содержащий название компонента и описание.
+ */
+export declare type DesignScreenshotItem = {
+    /** Component or visual element name / Название компонента или визуального элемента */
+    name: string;
+    /** Description of the component or visual element / Описание компонента или визуального элемента */
+    description: string;
+};
+
+/**
+ * List of screenshot visual analysis items.
+ *
+ * Список элементов визуального анализа скриншотов.
+ */
+export declare type DesignScreenshotList = DesignScreenshotItem[];
+
 /**
  * Design structure class item containing class index, CSS class name, and completeness flag.
  *
@@ -3383,6 +3583,8 @@ export declare class LibraryAiPromptItem {
     protected readonly dir: string[];
     /** Item instance for working with MCP files. / Экземпляр элемента для работы с файлами MCP. */
     protected readonly itemMcp: LibraryAiMcpItem;
+    /** Item instance for working with screenshot files. / Экземпляр элемента для работы с файлами скриншотов. */
+    protected readonly itemScreenshot: LibraryAiPromptScreenshot;
     /**
      * Constructor for LibraryAiPromptItem.
      *
@@ -3509,22 +3711,6 @@ export declare class LibraryAiPromptItem {
      * @protected
      */
     protected getPathString(dirFile?: string): string;
-    /**
-     * Formats and returns the screenshot section for the prompt.
-     *
-     * Форматирует и возвращает секцию скриншотов для промпта.
-     * @returns formatted screenshot list or undefined / отформатированный список скриншотов или undefined
-     * @protected
-     */
-    protected getScreenshot(): string | undefined;
-    /**
-     * Retrieves the list of files in the screenshot directory.
-     *
-     * Получает список файлов в директории скриншотов.
-     * @returns list of screenshot file names or undefined / список имен файлов скриншотов или undefined
-     * @protected
-     */
-    protected getScreenshotList(): string[] | undefined;
     /**
      * Formats and returns the types section for the prompt.
      * Copies the types file to the root types directory and links to the copy.
@@ -3536,13 +3722,13 @@ export declare class LibraryAiPromptItem {
      */
     protected getTypes(): string | undefined;
     /**
-     * Returns the copied types file name based on the project name.
+     * Returns the directory name for the copied types based on the project name.
      *
-     * Возвращает имя скопированного файла типов на основе названия проекта.
-     * @returns file name / имя файла
+     * Возвращает имя директории для скопированных типов на основе названия проекта.
+     * @returns directory name / имя директории
      * @protected
      */
-    protected getTypesFileName(): string;
+    protected getTypesDirName(): string;
     /**
      * Returns path segments for the copied types file in the root types directory.
      *
@@ -3570,6 +3756,122 @@ export declare class LibraryAiPromptItem {
     protected readFile(dirFile: string): string;
 }
 
+/**
+ * Class representing screenshot handling in the AI prompt generation process.
+ * Manages reading screenshot image references, copying HTML/CSS showcase artifacts, and enriching screenshot lists with AI descriptions.
+ *
+ * Класс, представляющий обработку скриншотов в процессе генерации промпта для ИИ.
+ * Управляет чтением ссылок на изображения скриншотов, копированием HTML/CSS артефактов витрины и обогащением списка скриншотов описаниями ИИ.
+ */
+export declare class LibraryAiPromptScreenshot {
+    protected readonly dir: string[];
+    protected readonly projectName: string;
+    /** Map of screenshot file names to their textual descriptions. / Карта имен файлов скриншотов и их текстовых описаний. */
+    protected descriptionsMap?: Map<string, string>;
+    /**
+     * Constructor for LibraryAiPromptScreenshot.
+     *
+     * Конструктор для LibraryAiPromptScreenshot.
+     * @param dir Path segments to the directory / Сегменты пути к директории
+     * @param projectName Project name from package.json / Название проекта из package.json
+     */
+    constructor(dir?: string[], projectName?: string);
+    /**
+     * Checks if the screenshot directory exists.
+     *
+     * Проверяет, существует ли директория со скриншотами.
+     * @returns true if screenshot directory exists / true, если директория скриншотов существует
+     */
+    isScreenshot(): boolean;
+    /**
+     * Formats and returns the screenshot section for the AI prompt.
+     * Copies HTML and CSS showcase files to the root types directory and enriches screenshot image references with descriptions.
+     *
+     * Форматирует и возвращает секцию скриншотов для промпта ИИ.
+     * Копирует файлы HTML и CSS витрины в корневую директорию типов и обогащает ссылки на изображения скриншотов описаниями.
+     * @returns formatted screenshot section or undefined / отформатированная секция скриншотов или undefined
+     */
+    make(): string | undefined;
+    /**
+     * Checks whether the file is an image file and not a metadata/code file.
+     *
+     * Проверяет, является ли файл изображением, а не файлом метаданных/кода.
+     * @param fileName file name to verify / имя файла для проверки
+     * @returns true if file is an image / true, если файл является изображением
+     * @protected
+     */
+    protected isImageFile(fileName: string): boolean;
+    /**
+     * Retrieves and caches the map of screenshot descriptions from screenshot.json.
+     *
+     * Получает и кэширует карту описаний скриншотов из screenshot.json.
+     * @returns map of file names to descriptions / карта имен файлов к описаниям
+     * @protected
+     */
+    protected getDescriptionsMap(): Map<string, string>;
+    /**
+     * Constructs a full path for a file or directory within the item's directory.
+     *
+     * Создает полный путь к файлу или директории внутри директории элемента.
+     * @param dirFile File or directory name / Имя файла или директории
+     * @returns path segments / сегменты пути
+     * @protected
+     */
+    protected getPath(dirFile: string): string[];
+    /**
+     * Returns the directory path or file path within the directory as a string.
+     *
+     * Возвращает путь к директории или путь к файлу внутри директории в виде строки.
+     * @param dirFile optional file name or subpath / опциональное имя файла или подпуть
+     * @returns formatted path string / отформатированная строка пути
+     * @protected
+     */
+    protected getPathString(dirFile?: string): string;
+    /**
+     * Retrieves the list of files in the screenshot directory.
+     *
+     * Получает список файлов в директории скриншотов.
+     * @returns list of screenshot file names or undefined / список имен файлов скриншотов или undefined
+     * @protected
+     */
+    protected getScreenshotList(): string[] | undefined;
+    /**
+     * Constructs a full path for a file inside the screenshot directory.
+     *
+     * Создает полный путь к файлу внутри директории скриншотов.
+     * @param fileName File name / Имя файла
+     * @returns path segments / сегменты пути
+     * @protected
+     */
+    protected getScreenshotPath(fileName: string): string[];
+    /**
+     * Returns the directory name for the copied files based on the project name.
+     *
+     * Возвращает имя директории для скопированных файлов на основе названия проекта.
+     * @returns directory name / имя директории
+     * @protected
+     */
+    protected getTypesDirName(): string;
+    /**
+     * Returns path segments for a copied file in the root types directory.
+     *
+     * Возвращает сегменты пути для скопированного файла в корневой директории типов.
+     * @param fileName File name / Имя файла
+     * @returns target path segments / сегменты целевого пути
+     * @protected
+     */
+    protected getTypesPath(fileName: string): string[];
+    /**
+     * Copies a screenshot artifact file to the target destination in the root types directory.
+     *
+     * Копирует файл артефакта скриншота в целевое назначение в корневой директории типов.
+     * @param fileName file name to copy / имя файла для копирования
+     * @returns target path segments / сегменты целевого пути
+     * @protected
+     */
+    protected copyScreenshotFile(fileName: string): string[];
+}
+
 /**
  * List of all library items across the design system.
  *
@@ -4695,20 +4997,20 @@ export declare interface ScreenshotMetrics {
 export declare interface ScreenshotOptions {
     /** Additional CLI flags for browser launch / Дополнительные CLI-флаги для запуска браузера */
     args?: string[];
-    /** Navigation lifecycle event conditions to consider page loaded / Условия событий жизненного цикла навигации для завершения загрузки */
-    waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
+    /** Image output format / Формат сохранения изображения */
+    format?: 'png' | 'jpeg' | 'webp';
+    /** Whether to capture full scrollable page height / Делать ли снимок всей прокручиваемой страницы */
+    fullPage?: boolean;
+    /** Image compression quality (1-100) / Качество сжатия изображения (1-100) */
+    quality?: number;
     /** Maximum timeout in milliseconds for loading the page / Максимальный таймаут в миллисекундах для загрузки страницы */
     timeout?: number;
+    /** Navigation lifecycle event conditions to consider page loaded / Условия событий жизненного цикла навигации для завершения загрузки */
+    waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
     /** Width of the screenshot viewport in pixels / Ширина области просмотра скриншота в пикселях */
     width?: number;
     /** Height of the screenshot viewport in pixels / Высота области просмотра скриншота в пикселях */
     height?: number;
-    /** Image output format / Формат сохранения изображения */
-    format?: 'png' | 'jpeg' | 'webp';
-    /** Image compression quality (1-100) / Качество сжатия изображения (1-100) */
-    quality?: number;
-    /** Whether to capture full scrollable page height / Делать ли снимок всей прокручиваемой страницы */
-    fullPage?: boolean;
 }
 
 /**