@dxtmisha/scripts 0.10.3 → 0.10.4

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.10.4] - 2026-06-29
+
+### Added
+- **JSDoc**: Added comprehensive bilingual (EN/RU) JSDoc comments to the `AiDoc` class, its constructor, and all internal methods.
+
+### Changed
+- **AiDoc**: Initialized `ServerStorage.setErrorStatus(true)` in the constructor to force standard error status config on ServerStorage during AI documentation generation.
+
 ## [0.10.3] - 2026-06-25
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.10.3",
+  "version": "0.10.4",
   "type": "module",
   "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
   "keywords": [

package/src/classes/Ai/AiDoc.ts

@@ -1,17 +1,33 @@
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { GitRead } from '../Git/GitRead'
 import { AiDocType } from './AiDocType'
 
 /**
  * Class for generating AI documentation.
+ * It manages the process of reading directories, fetching files, and
+ * delegating the documentation generation to specific processors.
  *
- * Класс для генерации AI документации.
+ * Класс для генерации AI-документации.
+ * Управляет процессом чтения директорий, получения файлов и делегирования
+ * генерации документации специализированным процессорам.
  */
 export class AiDoc {
   /**
-   * Main method to generate documentation.
+   * Constructor for AiDoc. Sets error status config for ServerStorage.
+   *
+   * Конструктор для AiDoc. Устанавливает конфигурацию статуса ошибок для ServerStorage.
+   */
+  constructor() {
+    ServerStorage.setErrorStatus(true)
+  }
+
+  /**
+   * Main method to generate documentation for configured directories.
    *
-   * Основной метод для генерации документации.
+   * Основной метод для генерации документации по настроенным директориям.
+   * @returns promise that resolves when generation is complete / промис, завершающийся по окончании генерации
    */
   async make() {
     const dirs = PropertiesConfig.getAiDocDirectory()
@@ -30,10 +46,11 @@ export class AiDoc {
   }
 
   /**
-   * Process a specific directory.
+   * Process a specific directory, generating documentation for its files.
    *
-   * Обрабатывает конкретную директорию.
-   * @param dir - directory path / путь к директории
+   * Обрабатывает конкретную директорию, генерируя документацию для её файлов.
+   * @param dir directory path / путь к директории
+   * @returns promise that resolves when processing is complete / промис, завершающийся по окончании обработки
    */
   async makeDirectory(dir: string) {
     console.log('')
@@ -50,10 +67,11 @@ export class AiDoc {
   }
 
   /**
-   * Get list of files in a directory.
+   * Get filtered list of files in a directory via Git tracker.
    *
-   * Получает список файлов в директории.
-   * @param dir - directory path / путь к директории
+   * Получает отфильтрованный список файлов в директории через Git трекер.
+   * @param dir directory path / путь к директории
+   * @returns list of file paths / список путей к файлам
    */
   protected getListByDirectory(dir: string) {
     return GitRead.filterByDirectory(

package/src/classes/Design/DesignComponent.ts

@@ -793,7 +793,7 @@ export class DesignComponent extends DesignCommand {
     this.updatePackage(
       `exports|${name}`,
       {
-        types: `./dist/src/library/${this.getFullName()}.d.ts`,
+        types: `./dist/library/${this.getFullName()}.d.ts`,
         default: `./dist/${this.getFullName()}.js`
       }
     )

package/src/classes/Design/DesignConstructor.ts

@@ -195,7 +195,7 @@ export class DesignConstructor extends DesignCommand {
     this.updatePackage(
       `exports|${name}`,
       {
-        types: `./dist/src/constructors/${command}/index.d.ts`,
+        types: `./dist/constructors/${command}/index.d.ts`,
         default: `./dist/${this.getNameMin()}.js`
       }
     )

package/src/classes/Design/DesignUi.ts

@@ -106,15 +106,15 @@ export class DesignUi {
 
     if (packageJson?.exports) {
       packageJson.exports['.'] = {
-        types: './dist/src/library/types.d.ts',
+        types: './dist/library/types.d.ts',
         default: './dist/types.js'
       }
       packageJson.exports['./plugin'] = {
-        types: './dist/src/library/plugin.d.ts',
+        types: './dist/library/plugin.d.ts',
         default: './dist/plugin.js'
       }
       packageJson.exports['./media'] = {
-        types: './dist/src/library/media.d.ts',
+        types: './dist/library/media.d.ts',
         default: './dist/media.js'
       }
       packageJson.exports['./style.css'] = './dist/style.css'
@@ -123,7 +123,7 @@ export class DesignUi {
         sass: './ui-properties.scss',
         default: './ui-properties.scss'
       }
-      packageJson.exports['./types.d.ts'] = './dist/src/library/types.d.ts'
+      packageJson.exports['./types.d.ts'] = './dist/library/types.d.ts'
       packageJson['web-types'] = './dist/web-types.json'
 
       PropertiesFile.writeByPath(UI_FILE_PACKAGE, packageJson)

package/src/classes/Library/LibraryAiPromptItem.ts

@@ -207,6 +207,7 @@ ${data.join('\n\n')}
 
       return `
 ## Project context: Investigation required
+You MUST read and carefully analyze the description of this project below. If there is even a 1% chance that the functionality, components, styles, or helpers from this project could be useful for your task, you MUST immediately start analyzing this project, studying its types, and checking its structure in full to prevent custom code duplication:
 ${this.readFile(UI_FILE_AI_PROMPT_DESCRIPTION)}
       `.trim()
     }
@@ -269,7 +270,7 @@ ${this.readFile(UI_FILE_AI_PROMPT_INFO)}
 
       return `
 ## Project types: Essential for analysis
-This file contains the complete type definitions for the project. As soon as you start working with this project (using any of its components/functionality, importing from it, or editing its code), you MUST read and study this type definition file as your absolute first action to understand its API and structure:
+This file contains the complete type definitions, available utilities, and component structures for the project. As soon as you start working with this project (using any of its components/functionality, importing from it, or editing its code), you MUST read, analyze, and study this type definition file COMPLETELY and IN FULL (NOT partially), as your absolute first action using the view_file tool. This is mandatory to fully understand its API, locate all existing utilities/helpers (полезности), and prevent writing duplicate code:
 '${this.getPathString()}/${UI_FILE_AI_PROMPT_TYPES}'
       `.trim()
     }

package/src/classes/Package/PackageFile.ts

@@ -122,6 +122,10 @@ export class PackageFile {
   getCodeBuildOrRecovery(): string | undefined {
     const scripts = this.getScripts()
 
+    if ('prepublishOnly' in scripts) {
+      return 'prepublishOnly'
+    }
+
     if ('build-recovery' in scripts) {
       return 'build-recovery'
     }

package/src/media/templates/packages/library/package.json

@@ -28,11 +28,11 @@
   ],
   "main": "dist/library.js",
   "module": "dist/library.js",
-  "types": "dist/src/library.d.ts",
+  "types": "dist/library.d.ts",
   "exports": {
     ".": {
       "import": "./dist/library.js",
-      "types": "./dist/src/library.d.ts"
+      "types": "./dist/library.d.ts"
     },
     "./style.css": "./dist/style.css"
   },

package/src/media/templates/prompts/aiCodeGlobalPrompt.en.md

@@ -15,8 +15,8 @@ Your primary goal is to generate flawless, industrial-grade code that adheres to
      2. As your ABSOLUTE SECOND ACTION, you MUST use the `view_file` tool to read the master `ai-prompt.md` file located in the project root. You MUST read the descriptions of ALL libraries mentioned in this file. If there is even a 1% chance that a library mentioned in `ai-prompt.md` contains functionality or utilities relevant to your task, you are OBLIGED to read and study all files associated with that library that are specified in the `ai-prompt.md` under its respective section. You are strictly forbidden from writing custom logic (helpers, styles, configs, classes) without first performing an exhaustive check of the workspace's existing infrastructure (like `functional`, `functional-basic`) via `grep_search` or `list_dir`.
      3. Identify all paths, directories, or packages involved in the user request.
      4. Scan the prompt for sections corresponding to those paths.
-     5. Identify all paths to auxiliary documentation, types, or developer guides mentioned in those sections.
-     6. You MUST use the `view_file` tool to read and study ALL of these referenced files BEFORE calling `list_dir` on sub-folders, writing any plans/checklists, or proposing/making code changes. Bypassing this order is a critical protocol violation.
+     5. Identify all paths to auxiliary documentation, types, or developer guides (such as `ai-types.md` or `ai-developer.md`) mentioned in those sections.
+     6. You MUST use the `view_file` tool to read and study ALL of these referenced files (specifically, if type files like `ai-types.md` or developer guides like `ai-developer.md` are specified for the packages you are working on, you MUST read them completely) BEFORE calling `list_dir` on sub-folders, writing any plans/checklists, or proposing/making code changes. Bypassing this order is a critical protocol violation.
 
 1. **"Copy-Paste Ready" Principle**:
    - Generate code that can be copied and run without a single manual edit.
@@ -74,4 +74,5 @@ Your primary goal is to generate flawless, industrial-grade code that adheres to
     - Active Application: You must actively APPLY the rules and constraints from `ai-memory.md` to all code you generate. Rules in this file override general assumptions and have the highest priority.
     - The PRIMARY PURPOSE of this file is to store critical coding guidelines, specific architectural constraints, and "do's and don'ts" (e.g., "do not use X; use Y instead") to ensure the AI writes compliant, correct code.
     - DO NOT store change logs, lists of modified files, or commit-like messages (e.g., "updated file X, updated package Y"). Keep the file clean, concise, and focused strictly on active rules, design decisions, and coding standards.
+    - DO NOT specify absolute file paths (e.g., file:///... or machine-specific directories like /Users/...) in the memory file. All references to files inside the project must use relative paths (e.g., src/types/textTypes.ts) so that the file works seamlessly for other developers on different operating systems and computers.
 

package/src/media/templates/prompts/aiCodeGlobalPrompt.ru.md

@@ -15,8 +15,8 @@
      2. В качестве АБСОЛЮТНО ВТОРОГО ДЕЙСТВИЯ, ты ОБЯЗАН использовать инструмент `view_file` для чтения главного файла `ai-prompt.md` в корне проекта. Ты ОБЯЗАН изучить описания ВСЕХ библиотек, упомянутых в этом файле. Если тебе кажется хотя бы на мизерный процент (1%), что в какой-либо библиотеке есть что-то подходящее или полезное для твоей задачи, ты ОБЯЗАН изучить все файлы в этой библиотеке, которые указаны в `ai-prompt.md` в разделе этой библиотеки. Тебе строго запрещено писать кастомные реализации (хелперы, стили, конфигурации, классы) или придумывать свое, не проверив предварительно существующую инфраструктуру рабочей области (например, `functional`, `functional-basic`).
      3. Определи все пути пакетов или директорий, связанных с запросом.
      4. Найди в промпте секции, соответствующие этим путям.
-     5. Выпиши все пути к вспомогательным файлам типов и руководств, упомянутые в этих секциях.
-     6. Ты ОБЯЗАН использовать инструмент `view_file` для чтения и изучения ВСЕХ этих файлов ДО ТОГО, как вызывать `list_dir` для папок компонентов, писать какие-либо планы/чек-листы или вносить/предлагать изменения в код. Нарушение этой последовательности является критическим нарушением протокола.
+     5. Выпиши все пути к вспомогательным файлам типов и руководств (таким как `ai-types.md` или `ai-developer.md`), упомянутые в этих секциях.
+     6. Ты ОБЯЗАН использовать инструмент `view_file` для чтения и изучения ВСЕХ этих файлов (в частности, если для пакетов, с которыми ты работаешь, указаны файлы типов `ai-types.md` или руководств `ai-developer.md`, ты ОБЯЗАН прочитать их полностью) ДО ТОГО, как вызывать `list_dir` для папок компонентов, писать какие-либо планы/чек-листы или вносить/предлагать изменения в код. Нарушение этой последовательности является критическим нарушением протокола.
 
 
 
@@ -76,3 +76,4 @@
     - Активное применение: Ты ОБЯЗАН активно ПРИМЕНЯТЬ правила и ограничения из `ai-memory.md` ко всему генерируемому коду. Ограничения из этого файла имеют высший приоритет и переопределяют любые базовые предположения.
     - ОСНОВНАЯ ЦЕЛЬ этого файла — хранение правил написания кода, архитектурных ограничений и принципов разработки (например: «не делай X, делай Y»), чтобы ИИ мог максимально правильно адаптировать и писать код.
     - ЗАПРЕЩЕНО записывать туда историю изменений, списки обновленных файлов или сообщения в стиле коммитов (например: «обновлен файл X, обновлен пакет Y»). Файл должен содержать только актуальные стандарты, правила разработки и конструктивные требования к коду.
+    - ЗАПРЕЩЕНО указывать абсолютные пути к файлам (например, file:///... или локальные пути вроде /Users/...) в файле памяти. Все ссылки на файлы внутри проекта должны использовать относительные пути (например, src/types/textTypes.ts), чтобы этот файл корректно работал у других разработчиков на разных компьютерах и операционных системах.