@dxtmisha/scripts 0.10.10 → 0.10.12

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.10.12] - 2026-08-05
+
+### Changed
+- **AI Generators & Design Types**: Added support for generating `ai-mcp.json` resources in `LibraryAiPrompt`, updated `DesignTypes.toAiEdit` JSDoc instructions, updated `AiZAiLite` prompt parameters, and updated package metadata (`ai-memory.md`).
+
+## [0.10.11] - 2026-08-05
+
+### Changed
+- **DesignTypes**: Updated AI JSDoc generation prompt rules in `toAiEdit` to delete JSDocs for obvious entities and generate concise (1-line) or detailed descriptions for non-obvious entities based on JS code inspection.
+- **DesignTypes**: Extended `toAiMcpPrompts` to include `ai-types.md` and `ai-description.md` alongside prompt files when generating MCP server resources (`ai-mcp.json`).
+
+## [0.10.10] - 2026-08-05
+
+### Changed
+- **AI Prompts**: Updated prompt templates (`aiCodeGlobalPrompt.en.md`, `aiCodeGlobalPrompt.ru.md`) to strictly mandate recording developer preferences into package `ai-memory.md` files.
+
 ## [0.10.9] - 2026-08-03
 
 ### Changed

package/bin/design-prompt.ts

@@ -2,4 +2,6 @@
 
 import { LibraryAiPrompt } from '../src/classes/Library/LibraryAiPrompt'
 
-new LibraryAiPrompt().make()
+const isMcp = process.argv?.[2] === 'true' || process.argv?.[2] === '1'
+
+new LibraryAiPrompt([], isMcp).make()

package/package.json

@@ -1,20 +1,26 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.10.10",
+  "version": "0.10.12",
   "type": "module",
-  "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
+  "description": "CLI tools, AI integration scripts, and automation utilities for DXT UI — automated component scaffolding, Figma layout generation, library packaging, documentation building, screenshot captures, and AI prompt processing.",
   "keywords": [
-    "scripts",
     "cli",
-    "development",
-    "component-generator",
-    "ui-library",
-    "dxt-ui",
+    "scripts",
     "automation",
+    "generators",
+    "scaffolding",
     "build-tools",
+    "component-generator",
+    "figma-sync",
+    "ai-tools",
+    "ai-prompts",
+    "storybook",
+    "documentation",
     "typescript",
-    "vue"
+    "vue",
+    "dxt",
+    "dxt-ui"
   ],
   "author": "dxtmisha@gmail.com",
   "license": "MIT",
@@ -70,17 +76,22 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
+    "@ai-sdk/xai": "*",
+    "@anthropic-ai/claude-agent-sdk": "*",
     "@anthropic-ai/sdk": "*",
-    "@dxtmisha/configuration": "*",
     "@dxtmisha/functional": "*",
     "@dxtmisha/functional-basic": "*",
     "@dxtmisha/media": "*",
-    "@dxtmisha/styles": "*",
-    "@dxtmisha/wiki": "*",
     "@google/genai": "*",
+    "@napi-rs/canvas": "*",
+    "ai": "*",
     "openai": "*",
     "puppeteer": "*",
+    "sass": "*",
     "typescript": "*",
     "vue": "*"
+  },
+  "devDependencies": {
+    "@dxtmisha/wiki": "*"
   }
 }

package/src/classes/Ai/AiZAiLite.ts

@@ -1,26 +1,77 @@
-import { OpenAI } from 'openai'
-import { AiOpenAiLite } from './AiOpenAiLite'
+import { createXai, type XaiProvider } from '@ai-sdk/xai'
+import { generateText } from 'ai'
+import { forEach } from '@dxtmisha/functional-basic'
+
+import { AiAbstract } from './AiAbstract'
 
 /**
- * Z.ai (Zhipu AI) implementation extending AiOpenAiLite.
- * Performs requests to the OpenAI-compatible Z.ai endpoint.
+ * xAI (Grok) implementation of AiAbstract using @ai-sdk/xai and ai SDK.
+ * Performs text generation requests via Grok models (e.g. grok-4.5).
  *
- * Реализация Z.ai (Zhipu AI) расширяющая AiOpenAiLite.
- * Выполняет запросы к OpenAI-совместимому эндпоинту Z.ai.
+ * Реализация xAI (Grok) поверх AiAbstract с использованием @ai-sdk/xai и ai SDK.
+ * Выполняет запросы генерации текста через модели Grok (например, grok-4.5).
  *
  * Responsibilities / Ответственности:
- * - Initialize OpenAI client with Z.ai baseURL / Инициализировать клиент OpenAI с baseURL Z.ai
+ * - Initialize xAI client provider / Инициализировать провайдер клиента xAI
+ * - Execute generateText via Grok responses model / Выполнять generateText через модель ответов Grok
  */
-export class AiZAiLite extends AiOpenAiLite {
+export class AiZAiLite extends AiAbstract<XaiProvider> {
   /**
-   * Initializes OpenAI client instance configured for Z.ai.
+   * Initializes xAI client provider instance.
    *
-   * Инициализирует экземпляр клиента OpenAI, настроенный для Z.ai.
+   * Инициализирует экземпляр провайдера клиента xAI.
    */
-  protected override init(): void {
-    this.ai = new OpenAI({
-      apiKey: this.key,
-      baseURL: 'https://api.z.ai/api/paas/v4'
+  protected init(): void {
+    this.ai = createXai({
+      apiKey: this.key
     })
   }
+
+  /**
+   * Implementation hook: convert accumulated images to model-specific format.
+   *
+   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+   */
+  protected toImages(): any[] {
+    return forEach(this.images, image => ({
+      type: 'image',
+      image: `data:${image.mime};base64,${image.base64}`
+    }))
+  }
+
+  /**
+   * Implementation hook: convert accumulated contents to model-specific format.
+   *
+   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+   */
+  protected toContents(): any[] {
+    return forEach(this.contents, content => ({
+      type: 'text',
+      text: content
+    }))
+  }
+
+  /**
+   * Performs content generation request using xAI responses model and returns textual result.
+   *
+   * Выполняет запрос генерации контента с использованием модели ответов xAI и возвращает текстовый результат.
+   * @param model - Model identifier (e.g., 'grok-4.5') / Идентификатор модели
+   * @param contents - Composed contents for generation / Собранный контент для генерации
+   * @returns Generated text response / Сгенерированный текстовый ответ
+   */
+  protected async response(
+    model: string,
+    contents: string
+  ): Promise<string> {
+    const client = this.ai ?? createXai({ apiKey: this.key })
+    const activeModel = model || 'grok-4.5'
+
+    const { text } = await generateText({
+      model: client.responses(activeModel as any),
+      prompt: contents,
+      ...this.config
+    })
+
+    return text ?? ''
+  }
 }

package/src/classes/Design/DesignTypes.ts

@@ -60,9 +60,22 @@ export class DesignTypes {
     const promptList = this.getListPrompts()
     const prompts = await this.toAiPrompts(promptList)
 
-    this.saveDescription(`${aiDescription}\n${prompts}`)
-
-    const mcpPrompts = await this.toAiMcpPrompts(promptList)
+    const fullDescription = `${aiDescription}\n${prompts}`
+    this.saveDescription(fullDescription)
+
+    const mcpList: DesignTypesList = [
+      {
+        path: UI_FILE_AI_TYPES,
+        content: aiContent
+      },
+      {
+        path: UI_FILE_AI_DESCRIPTION,
+        content: fullDescription
+      },
+      ...promptList
+    ]
+
+    const mcpPrompts = await this.toAiMcpPrompts(mcpList)
 
     if (mcpPrompts) {
       this.saveMcp(mcpPrompts)
@@ -233,12 +246,7 @@ export class DesignTypes {
       PropertiesFile.writeByPath(
         UI_FILE_AI_TYPES,
         [
-          `1) All these methods are in the ${packageJson.name} library.`,
-          '2) Everything that is exported can be used.',
-          '3) Use what is in this library if it exists; do not use other libraries if there is an analogue here. Do not create new ones if an analogue already exists here.',
-          '',
-          'The following is the content of "exports" from package.json:',
-          JSON.stringify(packageJson.exports, null, 2),
+          `All these methods are in the ${packageJson.name} library.`,
           '',
           content
         ].join('\n')
@@ -302,6 +310,7 @@ export class DesignTypes {
     const ai = useAi()
 
     if (ai) {
+      ai.addPrompt('You are a world-class senior developer and an exceptional technical writer.')
       ai.addPrompt(prompt)
       ai.addPrompt(`File Content: ${content}`)
 
@@ -337,14 +346,16 @@ export class DesignTypes {
       + '- Do NOT return the provided JS code in your response.\n\n'
       + 'JSDOC & COMMENT RULES:\n'
       + '- STUDY THE PROVIDED JS CODE: You are explicitly provided with the JS implementation code (`File JS Code`). You MUST study the JS code for every function/method/property to understand its exact logic, behavior, and purpose.\n'
-      + '- GENERATE MISSING JSDOCS FROM JS CODE: If an entity lacks a JSDoc comment in the input declarations, but its provided JS code implementation reveals its behavior or purpose, you MUST generate and add a clear, fluff-free English JSDoc description directly above its declaration.\n'
-      + '- DEFINITION OF OBVIOUS (NO JSDOC): An entity is "obvious" ONLY IF its name uses clear, standard English naming conventions (e.g., `isString`, `capitalize`, `copyObject`) AND its functionality is 100% self-evident from its signature alone. Obvious entities MUST NOT have a JSDoc.\n'
-      + '- MANDATORY JSDOC FOR NON-OBVIOUS ENTITIES: Any entity with an obscure, non-standard, custom, abbreviated, or ambiguous name (e.g., `abutaSudatoho`, `transformation`), or complex logic, MUST have a clear English JSDoc description generated by inspecting its JS implementation code.\n'
-      + '- Write JSDoc comments WITHOUT fluff or filler text, focusing strictly on operational logic and behavior.\n'
+      + '- IF AN EXISTING JSDOC / COMMENT IS PRESENT:\n'
+      + '  * Obvious entities (e.g., `isString`, `capitalize`, `copyObject`): DELETE the JSDoc / comment entirely.\n'
+      + '  * Non-obvious entities: OPTIMIZE the existing JSDoc — remove fluff, translate to clear English, and PRESERVE ONLY `@example`, `@remarks`, `@note`, and `@warning` tags (remove all other JSDoc tags).\n'
+      + '- IF NO JSDOC / COMMENT IS PRESENT:\n'
+      + '  * Obvious entities: DO NOTHING (do NOT add any JSDoc).\n'
+      + '  * Moderately non-obvious entities (obscure, custom, abbreviated, or ambiguous naming): Generate and add a SHORT, concise, 1-line English JSDoc description derived from inspecting its JS implementation code.\n'
+      + '  * Very unclear or highly complex entities (intricate operational logic, complex parameters, or subtle side effects): Generate and add a DETAILED, comprehensive English JSDoc description derived from inspecting its JS implementation code.\n'
       + '- Place all JSDoc comments STRICTLY directly above the target declaration.\n'
       + '- Translate all non-English comments and JSDocs to English.\n'
       + '- Remove regular inline comments (`//` or `/* ... */`).\n'
-      + '- STRICTLY PRESERVE all JSDoc tags like `@example`, `@remarks`, `@note`, and warnings—keep them intact, translating only to English if needed.\n\n'
       + 'CLEANING & OPTIMIZATION:\n'
       + '- Remove all `import` statements and local internal re-exports (e.g., `export * from "./..."`). Strictly KEEP exports from external packages.\n'
       + '- Delete all non-public content (private/protected class members, unexported elements). Keep all public API surfaces.\n'
@@ -413,7 +424,7 @@ export class DesignTypes {
 
     if (prompts) {
       return '## Mandatory Rules\n'
-        + 'Read the corresponding file if your task relates to:\n'
+        + 'Read the corresponding file ONLY when working on a task related to (even if not working directly with this package):\n'
         + `${prompts}`
     }
 
@@ -447,10 +458,10 @@ export class DesignTypes {
   }
 
   /**
-   * Generates MCP server resources structure for prompt files using AI.
+   * Generates MCP server resources structure for prompt, type definition, and description files using AI.
    *
-   * Генерирует структуру ресурсов MCP-сервера для файлов промптов с помощью ИИ.
-   * @param list list of prompt files / список файлов промптов
+   * Генерирует структуру ресурсов MCP-сервера для файлов промптов, определений типов и описаний с помощью ИИ.
+   * @param list list of documentation files / список файлов документации
    * @returns object with resources array or undefined / объект со массивом ресурсов или undefined
    */
   protected async toAiMcpPrompts(list: DesignTypesList): Promise<DesignMcpResources | undefined> {
@@ -466,7 +477,7 @@ export class DesignTypes {
       ) {
         resources.push({
           uri: `${projectName}/${item.path}`,
-          name: data.name,
+          name: `${data.name} (${projectName})`,
           mimeType: data.mimeType ?? 'text/markdown',
           description: data.description
         })

package/src/classes/Library/LibraryAiMcpItem.ts

@@ -0,0 +1,67 @@
+import { PropertiesFile } from '../Properties/PropertiesFile'
+
+import {
+  UI_FILE_AI_MCP
+} from '../../config'
+
+/**
+ * Class representing an MCP item in the AI prompt generation process.
+ * Handles reading `ai-mcp.json` configuration files for a package directory.
+ *
+ * Класс, представляющий элемент MCP в процессе создания промпта для ИИ.
+ * Управляет чтением конфигурационных файлов `ai-mcp.json` для директории пакета.
+ */
+export class LibraryAiMcpItem {
+  /**
+   * Constructor for LibraryAiMcpItem.
+   *
+   * Конструктор для LibraryAiMcpItem.
+   * @param dir Path segments to the directory / Сегменты пути к директории
+   */
+  constructor(
+    protected readonly dir: string[] = []
+  ) { }
+
+  /**
+   * Checks if the ai-mcp.json file exists in the directory.
+   *
+   * Проверяет, существует ли файл ai-mcp.json в директории.
+   * @returns true if ai-mcp.json file exists / true, если файл ai-mcp.json существует
+   */
+  isMcp(): boolean {
+    return PropertiesFile.is(this.getPath(UI_FILE_AI_MCP))
+  }
+
+  /**
+   * Reads and returns the list of MCP resource definitions from ai-mcp.json.
+   *
+   * Читает и возвращает список определений ресурсов MCP из ai-mcp.json.
+   * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
+   */
+  make(): Record<string, any>[] | undefined {
+    if (this.isMcp()) {
+      const data = PropertiesFile.readFile<Record<string, any>[]>(this.getPath(UI_FILE_AI_MCP))
+
+      if (
+        Array.isArray(data)
+        && data.length > 0
+      ) {
+        return data
+      }
+    }
+
+    return undefined
+  }
+
+  /**
+   * Constructs a full path for a file within the item's directory.
+   *
+   * Создает полный путь к файлу внутри директории элемента.
+   * @param dirFile File name / Имя файла
+   * @returns path segments / сегменты пути
+   * @protected
+   */
+  protected getPath(dirFile: string): string[] {
+    return [...this.dir, dirFile]
+  }
+}

package/src/classes/Library/LibraryAiPrompt.ts

@@ -1,4 +1,5 @@
 import {
+  UI_FILE_AI_MCP,
   UI_FILE_AI_PROMPT_INSTRUCTION,
   UI_FILE_AI_PROMPT_PROMPT,
   UI_MODULES
@@ -35,9 +36,11 @@ export class LibraryAiPrompt {
    *
    * Конструктор для LibraryAiPrompt.
    * @param dirs Additional directories to scan / Дополнительные директории для сканирования
+   * @param isMcp Flag indicating whether to generate MCP configuration file / Флаг, указывающий, нужно ли генерировать конфигурационный файл MCP
    */
   constructor(
-    dirs: string[] = []
+    dirs: string[] = [],
+    protected readonly isMcp: boolean = false
   ) {
     this.dirs = [
       ...LIBRARY_AI_PROMPT_LIST_DIRS,
@@ -68,6 +71,7 @@ Consolidated documentation, architectural guidelines, and mandatory rules for th
       this.getGlobalPrompt(),
       this.getVuePrompt()
     ]
+    const mcpData: Record<string, any>[] = []
 
     if (list.length > 0) {
       list.forEach((item) => {
@@ -76,6 +80,14 @@ Consolidated documentation, architectural guidelines, and mandatory rules for th
         if (prompt) {
           prompts.push(prompt)
         }
+
+        if (this.isMcp) {
+          const mcp = item.getMcp()
+
+          if (mcp) {
+            mcpData.push(...mcp)
+          }
+        }
       })
     }
 
@@ -87,6 +99,10 @@ Consolidated documentation, architectural guidelines, and mandatory rules for th
 
     this.write(prompts)
 
+    if (this.isMcp) {
+      this.writeMcp(mcpData)
+    }
+
     console.log('end')
   }
 
@@ -216,4 +232,21 @@ ${globalPromptText}
 
     return this
   }
+
+  /**
+   * Writes the collected MCP definitions to a file.
+   *
+   * Записывает собранные определения MCP в файл.
+   * @param mcpData list of MCP resource definitions / список определений ресурсов MCP
+   * @returns this instance / этот экземпляр
+   * @protected
+   */
+  protected writeMcp(mcpData: Record<string, any>[]): this {
+    PropertiesFile.writeByPath(
+      UI_FILE_AI_MCP,
+      mcpData
+    )
+
+    return this
+  }
 }

package/src/classes/Library/LibraryAiPromptItem.ts

@@ -1,12 +1,13 @@
 import { PropertiesFile } from '../Properties/PropertiesFile'
+import { LibraryAiMcpItem } from './LibraryAiMcpItem'
+import { getPackageJson } from '../../functions/getPackageJson'
 
 import {
   UI_DIR_AI_PROMPT_SCREENSHOT,
   UI_FILE_AI_PROMPT_DESCRIPTION,
+  UI_FILE_AI_PROMPT_DEVELOPER,
   UI_FILE_AI_PROMPT_INFO,
-  UI_FILE_AI_PROMPT_TYPES,
-  UI_FILE_PACKAGE,
-  UI_FILE_AI_PROMPT_DEVELOPER
+  UI_FILE_AI_PROMPT_TYPES
 } from '../../config'
 
 /**
@@ -19,8 +20,8 @@ import {
  * для создания насыщенного контекстом промпта для ИИ.
  */
 export class LibraryAiPromptItem {
-  /** Cached partition of package.json. / Кэш содержимого файла package.json. */
-  protected packageJson?: Record<string, any>
+  /** Item instance for working with MCP files. / Экземпляр элемента для работы с файлами MCP. */
+  protected readonly itemMcp: LibraryAiMcpItem
 
   /**
    * Constructor for LibraryAiPromptItem.
@@ -31,6 +32,27 @@ export class LibraryAiPromptItem {
   constructor(
     protected readonly dir: string[] = []
   ) {
+    this.itemMcp = new LibraryAiMcpItem(this.dir)
+  }
+
+  /**
+   * Returns directory path segments.
+   *
+   * Возвращает сегменты пути к директории.
+   * @returns path segments / сегменты пути
+   */
+  getDir(): string[] {
+    return this.dir
+  }
+
+  /**
+   * Reads and returns the list of MCP resource definitions from ai-mcp.json.
+   *
+   * Читает и возвращает список определений ресурсов MCP из ai-mcp.json.
+   * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
+   */
+  getMcp(): Record<string, any>[] | undefined {
+    return this.itemMcp.make()
   }
 
   /**
@@ -40,7 +62,7 @@ export class LibraryAiPromptItem {
    * @returns project name or 'none' / название проекта или 'none'
    */
   getProjectName(): string {
-    return this.getPackageJson().name ?? 'none'
+    return getPackageJson(this.dir)?.name ?? 'none'
   }
 
   /**
@@ -55,6 +77,7 @@ export class LibraryAiPromptItem {
       || this.isTypes()
       || this.isScreenshot()
       || this.isDeveloper()
+      || this.isMcp()
   }
 
   /**
@@ -88,13 +111,13 @@ export class LibraryAiPromptItem {
   }
 
   /**
-   * Checks if the types file exists.
+   * Checks if the ai-mcp.json file exists.
    *
-   * Проверяет, существует ли файл с типами.
-   * @returns true if types file exists / true, если файл типов существует
+   * Проверяет, существует ли файл ai-mcp.json.
+   * @returns true if ai-mcp.json file exists / true, если файл ai-mcp.json существует
    */
-  isTypes(): boolean {
-    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_TYPES))
+  isMcp(): boolean {
+    return this.itemMcp.isMcp()
   }
 
   /**
@@ -107,6 +130,16 @@ export class LibraryAiPromptItem {
     return PropertiesFile.is(this.getPath(UI_DIR_AI_PROMPT_SCREENSHOT))
   }
 
+  /**
+   * Checks if the types file exists.
+   *
+   * Проверяет, существует ли файл с типами.
+   * @returns true if types file exists / true, если файл типов существует
+   */
+  isTypes(): boolean {
+    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_TYPES))
+  }
+
   /**
    * Gathers all available prompt content and formats it as a single string.
    *
@@ -137,63 +170,6 @@ ${data.join('\n\n')}
     return undefined
   }
 
-  /**
-   * Constructs a full path for a file within the item's directory.
-   *
-   * Создает полный путь к файлу внутри директории элемента.
-   * @param dirFile File name / Имя файла
-   * @returns path segments / сегменты пути
-   * @protected
-   */
-  protected getPath(dirFile: string): string[] {
-    return [...this.dir, dirFile]
-  }
-
-  /**
-   * Returns the directory path as a string joined by a slash.
-   *
-   * Возвращает путь к директории в виде строки, объединенной слешем.
-   * @returns path string / строка пути
-   * @protected
-   */
-  protected getPathString(): string {
-    return this.dir.join('/')
-  }
-
-  /**
-   * Retrieves and caches package.json content.
-   *
-   * Получает и кэширует содержимое файла package.json.
-   * @returns package.json object / объект package.json
-   * @protected
-   */
-  protected getPackageJson(): Record<string, any> {
-    if (!this.packageJson) {
-      const path = this.getPath(UI_FILE_PACKAGE)
-      this.packageJson = PropertiesFile.readFile(path) ?? {}
-    }
-
-    return this.packageJson
-  }
-
-  /**
-   * Reads content of a file by its name relative to the item's directory.
-   *
-   * Читает содержимое файла по его имени относительно директории элемента.
-   * @param dirFile File name / Имя файла
-   * @returns file content / содержимое файла
-   * @protected
-   */
-  protected readFile(dirFile: string): string {
-    const file = PropertiesFile.readFileOnly(this.getPath(dirFile))
-
-    if (file) {
-      return file.replace(/([ '"`]|^)\.\//g, `$1${this.getPathString()}/`)
-    }
-
-    return ''
-  }
-
   /**
    * Formats and returns the description section for the prompt.
    *
@@ -255,23 +231,26 @@ ${this.readFile(UI_FILE_AI_PROMPT_INFO)}
   }
 
   /**
-   * Formats and returns the types section for the prompt.
+   * Constructs a full path for a file within the item's directory.
    *
-   * Форматирует и возвращает секцию типов для промпта.
-   * @returns formatted types reference or undefined / отформатированная ссылка на типы или undefined
+   * Создает полный путь к файлу внутри директории элемента.
+   * @param dirFile File name / Имя файла
+   * @returns path segments / сегменты пути
    * @protected
    */
-  protected getTypes(): string | undefined {
-    if (this.isTypes()) {
-      console.log('-- Types')
-
-      return `
-## Package Type Definitions (Must Read in Full When Working with Package)
-'${this.getPathString()}/${UI_FILE_AI_PROMPT_TYPES}'
-      `.trim()
-    }
+  protected getPath(dirFile: string): string[] {
+    return [...this.dir, dirFile]
+  }
 
-    return undefined
+  /**
+   * Returns the directory path as a string joined by a slash.
+   *
+   * Возвращает путь к директории в виде строки, объединенной слешем.
+   * @returns path string / строка пути
+   * @protected
+   */
+  protected getPathString(): string {
+    return this.dir.join('/')
   }
 
   /**
@@ -311,4 +290,42 @@ ${screenshot}
 
     return undefined
   }
+
+  /**
+   * Formats and returns the types section for the prompt.
+   *
+   * Форматирует и возвращает секцию типов для промпта.
+   * @returns formatted types reference or undefined / отформатированная ссылка на типы или undefined
+   * @protected
+   */
+  protected getTypes(): string | undefined {
+    if (this.isTypes()) {
+      console.log('-- Types')
+
+      return `
+## Package Type Definitions (Must Read in Full When Working with Package)
+'${this.getPathString()}/${UI_FILE_AI_PROMPT_TYPES}'
+      `.trim()
+    }
+
+    return undefined
+  }
+
+  /**
+   * Reads content of a file by its name relative to the item's directory.
+   *
+   * Читает содержимое файла по его имени относительно директории элемента.
+   * @param dirFile File name / Имя файла
+   * @returns file content / содержимое файла
+   * @protected
+   */
+  protected readFile(dirFile: string): string {
+    const file = PropertiesFile.readFileOnly(this.getPath(dirFile))
+
+    if (file) {
+      return file.replace(/([ '"`]|^)\.\//g, `$1${this.getPathString()}/`)
+    }
+
+    return ''
+  }
 }

package/src/functions/getPackageJson.ts

@@ -1,11 +1,19 @@
-import { PropertiesFile } from '../classes/Properties/PropertiesFile'
+import { PropertiesFile, type PropertiesFilePath } from '../classes/Properties/PropertiesFile'
 import { UI_FILE_PACKAGE } from '../config'
 
 /**
  * Returns the package.json file content.
  *
  * Возвращает содержимое файла package.json.
+ * @param path path to directory or package.json file / путь к директории или файлу package.json
  */
-export function getPackageJson(): Record<string, any> | undefined {
+export function getPackageJson(path?: PropertiesFilePath): Record<string, any> | undefined {
+  if (path) {
+    const targetPath = PropertiesFile.isDir(path)
+      ? PropertiesFile.getPathFile(path, UI_FILE_PACKAGE, '')
+      : path
+    return PropertiesFile.readFile<Record<string, any>>(targetPath)
+  }
+
   return PropertiesFile.readFile<Record<string, any>>(UI_FILE_PACKAGE)
 }

package/src/library.ts

@@ -1,67 +1,68 @@
-// Classes
-export * from './classes/Ai/AiAbstract'
-export * from './classes/Ai/AiClaude'
-export * from './classes/Ai/AiClaudeAgent'
-export * from './classes/Ai/AiClaudeAgentLite'
-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'
-export * from './classes/Ai/AiDocItemClasses'
-export * from './classes/Ai/AiDocItemComposables'
-export * from './classes/Ai/AiDocType'
-export * from './classes/Ai/AiGoogle'
-export * from './classes/Ai/AiGoogleCli'
-export * from './classes/Ai/AiGoogleCliLite'
-export * from './classes/Ai/AiGoogleLite'
-export * from './classes/Ai/AiOpenAi'
-export * from './classes/Ai/AiOpenAiLite'
-export * from './classes/Ai/AiZAi'
-export * from './classes/Ai/AiZAiLite'
-export * from './classes/Ai/ApiTmp'
-export * from './classes/BrowserItem'
-export * from './classes/Build/BuildFunctional'
-export * from './classes/Build/BuildPackages'
-export * from './classes/Build/BuildPublishPackages'
-export * from './classes/BuildItem'
-export * from './classes/Design/DesignFigma'
-export * from './classes/Design/DesignScreenshot'
-export * from './classes/Design/DesignTypes'
-export * from './classes/Design/DesignTypescript'
-export * from './classes/Design/DesignWikiStorm'
-export * from './classes/Design/DesignWikiStormItem'
-export * from './classes/FigmaApi'
-export * from './classes/Git/GitRead'
-export * from './classes/Library/LibraryAiPrompt'
-export * from './classes/Library/LibraryAiPromptItem'
-export * from './classes/Library/LibraryAiWiki'
-export * from './classes/Library/LibraryAiWikiItem'
-export * from './classes/Library/LibraryExport'
-export * from './classes/Library/LibraryList'
-export * from './classes/Library/LibraryPlugin'
-export * from './classes/Library/LibraryTypes'
-export * from './classes/Package/PackageFile'
-export * from './classes/Properties/PropertiesFile'
-
-// Composables
-export * from './composables/useAi'
-
-// Functions
-export * from './functions/getConfigAi'
-export * from './functions/getDirname'
-export * from './functions/getPackageJson'
-export * from './functions/hasNativeDirname'
-export * from './functions/run'
-
-// Types
-export * from './types/aiTypes'
-export * from './types/configTypes'
-export * from './types/designTypes'
-export * from './types/figmaApiTypes'
-export * from './types/gitTypes'
-export * from './types/libraryTypes'
-export * from './types/propertyTypes'
-export * from './types/screenshotTypes'
-export * from './types/webTypes'
+// Classes
+export * from './classes/Ai/AiAbstract'
+export * from './classes/Ai/AiClaude'
+export * from './classes/Ai/AiClaudeAgent'
+export * from './classes/Ai/AiClaudeAgentLite'
+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'
+export * from './classes/Ai/AiDocItemClasses'
+export * from './classes/Ai/AiDocItemComposables'
+export * from './classes/Ai/AiDocType'
+export * from './classes/Ai/AiGoogle'
+export * from './classes/Ai/AiGoogleCli'
+export * from './classes/Ai/AiGoogleCliLite'
+export * from './classes/Ai/AiGoogleLite'
+export * from './classes/Ai/AiOpenAi'
+export * from './classes/Ai/AiOpenAiLite'
+export * from './classes/Ai/AiZAi'
+export * from './classes/Ai/AiZAiLite'
+export * from './classes/Ai/ApiTmp'
+export * from './classes/BrowserItem'
+export * from './classes/Build/BuildFunctional'
+export * from './classes/Build/BuildPackages'
+export * from './classes/Build/BuildPublishPackages'
+export * from './classes/BuildItem'
+export * from './classes/Design/DesignFigma'
+export * from './classes/Design/DesignScreenshot'
+export * from './classes/Design/DesignTypes'
+export * from './classes/Design/DesignTypescript'
+export * from './classes/Design/DesignWikiStorm'
+export * from './classes/Design/DesignWikiStormItem'
+export * from './classes/FigmaApi'
+export * from './classes/Git/GitRead'
+export * from './classes/Library/LibraryAiMcpItem'
+export * from './classes/Library/LibraryAiPrompt'
+export * from './classes/Library/LibraryAiPromptItem'
+export * from './classes/Library/LibraryAiWiki'
+export * from './classes/Library/LibraryAiWikiItem'
+export * from './classes/Library/LibraryExport'
+export * from './classes/Library/LibraryList'
+export * from './classes/Library/LibraryPlugin'
+export * from './classes/Library/LibraryTypes'
+export * from './classes/Package/PackageFile'
+export * from './classes/Properties/PropertiesFile'
+
+// Composables
+export * from './composables/useAi'
+
+// Functions
+export * from './functions/getConfigAi'
+export * from './functions/getDirname'
+export * from './functions/getPackageJson'
+export * from './functions/hasNativeDirname'
+export * from './functions/run'
+
+// Types
+export * from './types/aiTypes'
+export * from './types/configTypes'
+export * from './types/designTypes'
+export * from './types/figmaApiTypes'
+export * from './types/gitTypes'
+export * from './types/libraryTypes'
+export * from './types/propertyTypes'
+export * from './types/screenshotTypes'
+export * from './types/webTypes'