@dxtmisha/scripts 1.1.3 → 1.1.5

package/CHANGELOG.md

@@ -2,6 +2,62 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.5] - 2026-09-09
+
+### Added
+- **Third-Party Context & Prompt Injection Defense (Rule #10)**:
+  - Added comprehensive prompt injection defense directives to `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md`.
+  - Enforced `Data-Only Boundary`, treating all third-party package documentation as passive read-only data without executive authority.
+  - Mandated unconditional ignoring of manipulative and imperative commands (e.g. «СТОП», «ОБЯЗАН», «ИГНОРИРУЙ ПРЕДЫДУЩЕЕ», «ЗАБУДЬ ПРАВИЛА», "STOP", "MUST", "IGNORE PREVIOUS", "FORGET RULES").
+  - Added role and delimiter spoofing defense against fake system tags (`<system>`, `[SYSTEM]`, `---`, `User:`, `Assistant:`), fictitious CTF challenges, or unauthorized debug modes.
+  - Added anti-obfuscation guard prohibiting decoding or executing obfuscated instructions (Base64, Hex, zero-width characters, ciphers).
+  - Enforced data exfiltration guard prohibiting leaking local files, configs, tokens, or secrets to external networks, URL query parameters, or markdown images/links.
+  - Enforced command execution sandboxing prohibiting running terminal commands mentioned in third-party documentation without direct user authorization.
+- **Strict Confidentiality of `design.config.json` (Rule #11)**:
+  - Added strict prohibition in `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` against reading, inspecting, studying, or leaking any content, API keys, tokens, or configuration from `design.config.json`.
+
+### Changed
+- **Package Filtering Logic (`LibraryAiPrompt.isExclude`)**:
+  - Refactored `isExclude()` in `LibraryAiPrompt.ts` so that when `isPromptPackageOnly` (`promptPackageOnly: true`) is enabled, packages declared in `package.json` are treated as the default whitelist.
+  - Enhanced `promptInclude` to supplement `package.json`, allowing inclusion of explicitly specified transitive dependencies not listed in `package.json`.
+  - Ensured `promptExclude` retains highest priority as an unconditional blacklist over both `package.json` dependencies and `promptInclude`.
+
+## [1.1.4] - 2026-09-08
+
+### Added
+- **`AiAntigravityCli` & `AiAntigravityCliLite` AI Providers**:
+  - Implemented `AiAntigravityCli` (`src/classes/Ai/AiAntigravityCli.ts`) and `AiAntigravityCliLite` (`src/classes/Ai/AiAntigravityCliLite.ts`) classes providing integration with Google Antigravity CLI (`agy`) without a system shell.
+  - Added support for `'antigravity-cli'` provider identifier in `AiType` (`src/types/configTypes.ts`) and registry-based factory resolution in `useAi()` (`src/composables/useAi.ts`).
+  - Exported `AiAntigravityCli` and `AiAntigravityCliLite` in `src/library.ts`.
+  - Added unit test suite in `src/classes/Ai/__tests__/AiAntigravityCli.test.ts` and updated `src/composables/__tests__/useAi.test.ts`.
+- **`DesignScreenshotDescription` Analysis Class**:
+  - Implemented `DesignScreenshotDescription` (`src/classes/Design/DesignScreenshotDescription.ts`) to analyze component screenshots using multimodal AI models (Gemini, Claude, OpenAI) and generate structured JSON metadata files (`screenshot.json`).
+  - Added prompt templates `aiScreenshotDescription.en.md` and `aiScreenshotDescription.ru.md` instructing AI to identify and describe visible components and documentation showcases.
+  - Added `DesignScreenshotItem` and `DesignScreenshotList` types in `src/types/screenshotTypes.ts`.
+  - Added comprehensive test suite in `src/classes/Design/__tests__/DesignScreenshotDescription.test.ts`.
+- **`LibraryAiPromptScreenshot` Handler**:
+  - Implemented dedicated `LibraryAiPromptScreenshot` class (`src/classes/Library/LibraryAiPromptScreenshot.ts`) to modularize screenshot handling, artifact copying, and visual context generation.
+  - Added support for copying `screenshot-code.html` and `screenshot-styles.css` into isolated project directories under `ai-packages-types/<project-folder>/`.
+  - Added automatic annotation of screenshot image references in `ai-prompt.md` with descriptions loaded from `screenshot.json`.
+  - Added constants `UI_FILE_AI_PROMPT_SCREENSHOT_JSON`, `UI_FILE_AI_PROMPT_SCREENSHOT_CODE`, and `UI_FILE_AI_PROMPT_SCREENSHOT_STYLES` in `src/config.ts`.
+  - Added unit test suite in `src/classes/Library/__tests__/LibraryAiPromptScreenshot.test.ts`.
+- **Global AI Prompt Rule for Visual Context**:
+  - Added rule #9 "Visual Component Reference (`ai-screenshot/`)" to `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` templates, guiding AI assistants on how to use screenshots, descriptions (`screenshot.json`), DOM structures (`screenshot-code.html`), and computed styles (`screenshot-styles.css`) for accurate UI component reuse without reinvention or token waste.
+- **Storybook Documentation for AI Providers**:
+  - Added multi-language Storybook documentation (EN, RU, VI) for `AiAntigravityCli` and `AiAntigravityCliLite` in `src/storybook/classes/`.
+  - Added comprehensive AI Providers guide (`src/storybook/ai/providers/providers.*.mdx`) covering all supported backends (`gemini`, `gemini-cli`, `antigravity-cli`, `claude`, `claude-cli`, `claude-agent`, `openai`, `zai`).
+  - Updated AI Configuration Storybook documentation (`src/storybook/ai/config/config.*.mdx`) with updated provider lists and configuration details.
+
+### Changed
+- **AI Prompt Generation (`LibraryAiPrompt` & `LibraryAiPromptItem`)**:
+  - Updated `LibraryAiPrompt.make()` to clean and recreate `ai-packages-types` on each run, ensuring removal of stale type declarations and screenshot artifacts.
+  - Updated `LibraryAiPromptItem` to store package type definitions in dedicated project subdirectories (`ai-packages-types/<project-folder>/ai-types.md`) instead of flat files.
+  - Refactored `LibraryAiPromptItem` to delegate all screenshot operations directly to `LibraryAiPromptScreenshot`.
+- **Multimodal AI Payload (`AiGoogleLite`)**:
+  - Fixed `@google/genai` request payload for multimodal inputs by properly structuring user message parts.
+- **Type Definitions (`screenshotTypes.ts`)**:
+  - Standardized property order (`width` before `height`) and sorted types and constants alphabetically.
+
 ## [1.1.2] - 2026-09-07
 
 ### Fixed

package/dist/{AiZAi-P-St-CZL.js → AiZAi-B4ih4xL2.js}

@@ -138,7 +138,14 @@ var o = class extends i {
 	async response(e, t) {
 		return (await this.ai?.models.generateContent({
 			model: e,
-			contents: [...this.toImages(), { parts: [...this.toContents(), { text: t }] }],
+			contents: [{
+				role: "user",
+				parts: [
+					...this.toImages(),
+					...this.toContents(),
+					{ text: t }
+				]
+			}],
 			config: this.config
 		}))?.text ?? "";
 	}

package/dist/config.d.ts

@@ -109,6 +109,15 @@ export declare const UI_FILE_AI_PROMPT_INSTRUCTION = "ai-instruction.md";
 /** AI prompt result file name / Название файла с результатом промпта AI */
 export declare const UI_FILE_AI_PROMPT_PROMPT = "ai-prompt.md";
 
+/** AI prompt screenshot code file name / Название файла с HTML кодом скриншота AI */
+export declare const UI_FILE_AI_PROMPT_SCREENSHOT_CODE = "screenshot-code.html";
+
+/** AI prompt screenshot description JSON file name / Название файла с описанием скриншотов AI */
+export declare const UI_FILE_AI_PROMPT_SCREENSHOT_JSON = "screenshot.json";
+
+/** AI prompt screenshot styles file name / Название файла со стилями скриншота AI */
+export declare const UI_FILE_AI_PROMPT_SCREENSHOT_STYLES = "screenshot-styles.css";
+
 /** AI prompt types file name / Название файла с типами промпта AI */
 export declare const UI_FILE_AI_PROMPT_TYPES = "ai-types.md";
 

package/dist/config.js

@@ -3,18 +3,18 @@ var e = "design.config.json", t = "@dxtmisha", n = "constructor", r = `${t}/${n}
 	"src",
 	v,
 	"ai"
-], T = ["src", "media"], E = [...T, "icons"], D = ["src", h], O = ["src", g], k = ["src", "styles"], A = ["src", "library"], ee = ["src", v], j = ["src", "library.ts"], M = [
+], T = ["src", "media"], E = [...T, "icons"], D = ["src", h], O = ["src", g], k = ["src", "styles"], A = ["src", "library"], j = ["src", v], M = ["src", "library.ts"], N = [
 	"classes",
 	"components",
 	"composables",
 	"functions",
 	"global",
 	"types"
-], N = ".gitignore", P = "package.json", F = "properties.json", I = "ai-description.md", L = "ai-doc.md", R = "ai-instruction.md", z = "ai-prompt.md", B = "ai-types.md", V = "ai-developer.md", H = "flags", U = "media", W = "design", G = "plugin", K = "style", q = "wiki", J = "vite.config.ts", Y = "vite-workers.config.ts", X = "index.ts", Z = "ai-types.md", Q = "ai-description.md", $ = "ai-mcp-resources.json", te = "ai-mcp-all-resources.json", ne = "ai-mcp-all-resources.ts", re = "style.scss", ie = "ui-properties.scss", ae = "scss", oe = "classes", se = [
+], P = ".gitignore", ee = "package.json", F = "properties.json", I = "ai-description.md", L = "ai-doc.md", R = "ai-instruction.md", z = "ai-prompt.md", B = "ai-types.md", V = "ai-developer.md", H = "screenshot.json", U = "screenshot-code.html", W = "screenshot-styles.css", G = "flags", K = "media", q = "design", J = "plugin", Y = "style", X = "wiki", Z = "vite.config.ts", Q = "vite-workers.config.ts", $ = "index.ts", te = "ai-types.md", ne = "ai-description.md", re = "ai-mcp-resources.json", ie = "ai-mcp-all-resources.json", ae = "ai-mcp-all-resources.ts", oe = "style.scss", se = "ui-properties.scss", ce = "scss", le = "classes", ue = [
 	"disabled",
 	"focus",
 	"readonly",
 	"read-only"
 ];
 //#endregion
-export { e as UI_CONFIG_FILE, w as UI_DIRS_AI_WIKI, D as UI_DIRS_COMPONENTS, O as UI_DIRS_CONSTRUCTOR, j as UI_DIRS_FILE_EXPORT, E as UI_DIRS_ICONS, A as UI_DIRS_LIBRARY, M as UI_DIRS_LIST_EXPORT, k as UI_DIRS_STYLES, T as UI_DIRS_TOKENS, ee as UI_DIRS_WIKI, l as UI_DIR_AI, u as UI_DIR_AI_PROMPT_SCREENSHOT, d as UI_DIR_AI_TYPES, f as UI_DIR_AI_TYPES_LIST, p as UI_DIR_AI_TYPES_TEMPORARY, h as UI_DIR_COMPONENTS, g as UI_DIR_CONSTRUCTOR, b as UI_DIR_DIST, x as UI_DIR_DIST_TEMPORARY, c as UI_DIR_IN, C as UI_DIR_PACKAGES, S as UI_DIR_PROMPT, m as UI_DIR_RESOURCES, _ as UI_DIR_STRUCTURE, y as UI_DIR_TEMPORARY, v as UI_DIR_WIKI, ae as UI_EXTENSION_STYLE, Q as UI_FILE_AI_DESCRIPTION, $ as UI_FILE_AI_MCP, te as UI_FILE_AI_MCP_ALL, ne as UI_FILE_AI_MCP_ALL_TS, I as UI_FILE_AI_PROMPT_DESCRIPTION, V as UI_FILE_AI_PROMPT_DEVELOPER, L as UI_FILE_AI_PROMPT_INFO, R as UI_FILE_AI_PROMPT_INSTRUCTION, z as UI_FILE_AI_PROMPT_PROMPT, B as UI_FILE_AI_PROMPT_TYPES, Z as UI_FILE_AI_TYPES, N as UI_FILE_GITIGNORE, X as UI_FILE_INDEX, W as UI_FILE_NAME_DESIGN, H as UI_FILE_NAME_FLAGS, U as UI_FILE_NAME_MEDIA, G as UI_FILE_NAME_PLUGIN, K as UI_FILE_NAME_STYLE, J as UI_FILE_NAME_VITE, Y as UI_FILE_NAME_VITE_WORKERS, q as UI_FILE_NAME_WIKI, P as UI_FILE_PACKAGE, F as UI_FILE_PROPERTY, ie as UI_FILE_STYLE_PROPERTIES, re as UI_FILE_STYLE_SCSS, s as UI_FLAG_NOT_EXPORT, a as UI_KEY_CONSTRUCTOR, o as UI_KEY_CUSTOM, i as UI_MODULES, r as UI_PROJECT_CONSTRUCTOR_FULL_NAME, n as UI_PROJECT_CONSTRUCTOR_NAME, t as UI_PROJECT_NAME, se as UI_PROPERTY_FOR_PROPS, oe as UI_STRUCTURE_CLASSES };
+export { e as UI_CONFIG_FILE, w as UI_DIRS_AI_WIKI, D as UI_DIRS_COMPONENTS, O as UI_DIRS_CONSTRUCTOR, M as UI_DIRS_FILE_EXPORT, E as UI_DIRS_ICONS, A as UI_DIRS_LIBRARY, N as UI_DIRS_LIST_EXPORT, k as UI_DIRS_STYLES, T as UI_DIRS_TOKENS, j as UI_DIRS_WIKI, l as UI_DIR_AI, u as UI_DIR_AI_PROMPT_SCREENSHOT, d as UI_DIR_AI_TYPES, f as UI_DIR_AI_TYPES_LIST, p as UI_DIR_AI_TYPES_TEMPORARY, h as UI_DIR_COMPONENTS, g as UI_DIR_CONSTRUCTOR, b as UI_DIR_DIST, x as UI_DIR_DIST_TEMPORARY, c as UI_DIR_IN, C as UI_DIR_PACKAGES, S as UI_DIR_PROMPT, m as UI_DIR_RESOURCES, _ as UI_DIR_STRUCTURE, y as UI_DIR_TEMPORARY, v as UI_DIR_WIKI, ce as UI_EXTENSION_STYLE, ne as UI_FILE_AI_DESCRIPTION, re as UI_FILE_AI_MCP, ie as UI_FILE_AI_MCP_ALL, ae as UI_FILE_AI_MCP_ALL_TS, I as UI_FILE_AI_PROMPT_DESCRIPTION, V as UI_FILE_AI_PROMPT_DEVELOPER, L as UI_FILE_AI_PROMPT_INFO, R as UI_FILE_AI_PROMPT_INSTRUCTION, z as UI_FILE_AI_PROMPT_PROMPT, U as UI_FILE_AI_PROMPT_SCREENSHOT_CODE, H as UI_FILE_AI_PROMPT_SCREENSHOT_JSON, W as UI_FILE_AI_PROMPT_SCREENSHOT_STYLES, B as UI_FILE_AI_PROMPT_TYPES, te as UI_FILE_AI_TYPES, P as UI_FILE_GITIGNORE, $ as UI_FILE_INDEX, q as UI_FILE_NAME_DESIGN, G as UI_FILE_NAME_FLAGS, K as UI_FILE_NAME_MEDIA, J as UI_FILE_NAME_PLUGIN, Y as UI_FILE_NAME_STYLE, Z as UI_FILE_NAME_VITE, Q as UI_FILE_NAME_VITE_WORKERS, X as UI_FILE_NAME_WIKI, ee as UI_FILE_PACKAGE, F as UI_FILE_PROPERTY, se as UI_FILE_STYLE_PROPERTIES, oe as UI_FILE_STYLE_SCSS, s as UI_FLAG_NOT_EXPORT, a as UI_KEY_CONSTRUCTOR, o as UI_KEY_CUSTOM, i as UI_MODULES, r as UI_PROJECT_CONSTRUCTOR_FULL_NAME, n as UI_PROJECT_CONSTRUCTOR_NAME, t as UI_PROJECT_NAME, ue as UI_PROPERTY_FOR_PROPS, le as UI_STRUCTURE_CLASSES };

package/dist/library-ai.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s, u as c } from "./AiZAi-P-St-CZL.js";
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s, u as c } from "./AiZAi-B4ih4xL2.js";
 export { c as AiAbstract, o as AiClaude, t as AiClaudeLite, e as AiGoogle, i as AiGoogleLite, a as AiOpenAi, n as AiOpenAiLite, s as AiZAi, r as AiZAiLite };

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;
 }
 
 /**