@dxtmisha/scripts 1.0.0 → 1.1.1

package/dist/library.d.ts

@@ -910,29 +910,25 @@ export declare class BrowserItem {
  */
 export declare class BuildPackages {
     protected readonly path: string;
+    protected readonly code?: string | undefined;
+    protected readonly logFile?: string | undefined;
     /** Map of cached package build versions / Карта кэшированных версий сборки пакетов */
     protected log: Record<string, string>;
     /**
-     * Constructor initializes packages path and loads build log.
+     * Constructor initializes packages path, custom build code, custom log file, and loads build log.
      *
-     * Конструктор инициализирует путь к пакетам и загружает лог сборки.
+     * Конструктор инициализирует путь к пакетам, пользовательский код сборки, пользовательский файл лога и загружает лог сборки.
      * @param path packages directory path / путь к директории пакетов
+     * @param code custom build command or script name / пользовательская команда сборки или имя скрипта
+     * @param logFile custom log file name or path / пользовательское имя или путь к файлу лога
      */
-    constructor(path?: string);
+    constructor(path?: string, code?: string | undefined, logFile?: string | undefined);
     /**
      * Scans the packages directory and builds each package that contains a package.json.
      *
      * Сканирует директорию пакетов и собирает каждый пакет, содержащий package.json.
      */
     make(): Promise<void>;
-    /**
-     * Executes the build script command for the package.
-     *
-     * Выполняет команду скрипта сборки для пакета.
-     * @param packageFile package file instance / экземпляр файла пакета
-     * @returns boolean indicating build success / флаг успешности сборки
-     */
-    protected build(packageFile: PackageFile): Promise<boolean>;
     /**
      * Checks if the package needs to be updated.
      *
@@ -942,14 +938,20 @@ export declare class BuildPackages {
      */
     protected isUpdate(packageFile: PackageFile): boolean;
     /**
-     * Scans the packages directory and returns a list of packages sorted by the ui-priority property in package.json.
-     * If a package does not have a priority, it defaults to 500.
+     * Returns the command name for build execution.
      *
-     * Сканирует директорию пакетов и возвращает список пакетов, отсортированный по свойству ui-priority в package.json.
-     * Если у пакета нет приоритета, по умолчанию устанавливается значение 500.
-     * @returns sorted list of package files / отсортированный список файлов пакетов
+     * Возвращает имя команды для выполнения сборки.
+     * @param packageFile package file instance / экземпляр файла пакета
+     * @returns command string or undefined / строка команды или undefined
      */
-    private getList;
+    protected getCode(packageFile: PackageFile): string | undefined;
+    /**
+     * Returns the path segments to the build log file.
+     *
+     * Возвращает сегменты пути к файлу лога сборки.
+     * @returns array of path segments / массив сегментов пути
+     */
+    protected getLogPath(): string[];
     /**
      * Returns the cached version of the package from the build log.
      *
@@ -965,12 +967,35 @@ export declare class BuildPackages {
      * @param packageFile package file object / объект файла пакета
      */
     protected updateLog(packageFile: PackageFile): void;
+    /**
+     * Executes the build script command for the package.
+     *
+     * Выполняет команду скрипта сборки для пакета.
+     * @param packageFile package file instance / экземпляр файла пакета
+     * @returns boolean indicating build success / флаг успешности сборки
+     */
+    protected build(packageFile: PackageFile): Promise<boolean>;
+    /**
+     * Adds the build log file to .gitignore.
+     *
+     * Добавляет файл лога сборки в .gitignore.
+     */
+    protected initGitIgnore(): void;
     /**
      * Saves the build log to a file.
      *
      * Сохраняет лог сборки в файл.
      */
     protected saveLog(): void;
+    /**
+     * Scans the packages directory and returns a list of packages sorted by the ui-priority property in package.json.
+     * If a package does not have a priority, it defaults to 500.
+     *
+     * Сканирует директорию пакетов и возвращает список пакетов, отсортированный по свойству ui-priority в package.json.
+     * Если у пакета нет приоритета, по умолчанию устанавливается значение 500.
+     * @returns sorted list of package files / отсортированный список файлов пакетов
+     */
+    private getList;
 }
 
 /**
@@ -1256,6 +1281,13 @@ export declare class DesignTypes {
      * @returns current instance / текущий экземпляр
      */
     makeSave(): Promise<this>;
+    /**
+     * Adds all files generated by this engine to .gitignore.
+     *
+     * Добавляет все файлы, сгенерированные этим движком, в .gitignore.
+     * @protected
+     */
+    protected initGitIgnore(): void;
 }
 
 /**
@@ -1757,7 +1789,7 @@ export declare class DesignTypesMake extends DesignTypesMakeAbstract {
      * @param code code to optimize / код для оптимизации
      * @returns optimized content string / строка оптимизированного контента
      */
-    protected toAiEdit(content: string, code: string): Promise<string>;
+    protected toAiEdit(content: string, code: string): Promise<string | undefined>;
 }
 
 /**
@@ -2340,6 +2372,21 @@ export declare type DesignUiConfig = {
      * Максимальная глубина сканирования директорий для сбора пакетов промпта ИИ; более глубокая вложенность пропускается
      */
     promptScanDepth?: number;
+    /**
+     * List of library names to exclude from the ai-prompt.md file /
+     * Список названий библиотек, исключаемых из файла ai-prompt.md
+     */
+    promptExclude?: string | string[];
+    /**
+     * List of library names to include in the ai-prompt.md file; if specified, only these libraries will be included /
+     * Список названий библиотек для включения в файл ai-prompt.md; если указано, включаются только эти библиотеки
+     */
+    promptInclude?: string | string[];
+    /**
+     * Flag indicating whether to include only packages listed in package.json in the ai-prompt.md file /
+     * Флаг, указывающий, следует ли включать в файл ai-prompt.md только пакеты, указанные в package.json
+     */
+    promptPackageOnly?: boolean;
     /** AI provider type for generating content / Тип ИИ-провайдера для генерации контента */
     aiType?: AiType;
     /** AI model name for generating content / Название модели ИИ для генерации контента */
@@ -2715,6 +2762,129 @@ export declare type GitFileItem = {
  */
 export declare type GitFileList = GitFileItem[];
 
+/**
+ * Class for managing entries in `.gitignore` file.
+ *
+ * Класс для управления записями в файле `.gitignore`.
+ */
+export declare class GitIgnore {
+    /** Comment heading for the added section / Заголовок-комментарий для добавляемой секции */
+    protected comment?: string;
+    /** Cached content of the .gitignore file / Кэшированное содержимое файла .gitignore */
+    protected content?: string;
+    /** Path to .gitignore file / Путь к файлу .gitignore */
+    protected gitignorePath: PropertiesFilePath;
+    /** List of paths to ignore / Список путей для игнорирования */
+    protected paths: string[];
+    /**
+     * Constructor for GitIgnore.
+     *
+     * Конструктор для GitIgnore.
+     * @param paths optional path or list of paths to ignore / опциональный путь или список путей для добавления в игнорируемые
+     * @param comment optional comment heading for the added paths / опциональный заголовок-комментарий для добавляемых путей
+     * @param gitignorePath optional path to .gitignore file / опциональный путь к файлу .gitignore
+     */
+    constructor(paths?: string | string[], comment?: string, gitignorePath?: PropertiesFilePath);
+    /**
+     * Returns current comment heading.
+     *
+     * Возвращает текущий заголовок-комментарий.
+     * @returns comment string or undefined / строка комментария или undefined
+     */
+    getComment(): string | undefined;
+    /**
+     * Sets comment heading for the added section.
+     *
+     * Устанавливает заголовок-комментарий для добавляемой секции.
+     * @param comment optional comment string / опциональная строка комментария
+     * @returns this instance / этот экземпляр
+     */
+    setComment(comment?: string): this;
+    /**
+     * Reads and caches the content of the .gitignore file.
+     *
+     * Считывает и кэширует содержимое файла .gitignore.
+     * @returns file content string / строка содержимого файла
+     */
+    getContent(): string;
+    /**
+     * Returns path to .gitignore file.
+     *
+     * Возвращает путь к файлу .gitignore.
+     * @returns path to .gitignore / путь к .gitignore
+     */
+    getGitignorePath(): PropertiesFilePath;
+    /**
+     * Sets path to .gitignore file.
+     *
+     * Устанавливает путь к файлу .gitignore.
+     * @param gitignorePath path to .gitignore file / путь к файлу .gitignore
+     * @returns this instance / этот экземпляр
+     */
+    setGitignorePath(gitignorePath: PropertiesFilePath): this;
+    /**
+     * Returns current list of paths to ignore.
+     *
+     * Возвращает текущий список путей для игнорирования.
+     * @returns list of paths / список путей
+     */
+    getPaths(): string[];
+    /**
+     * Replaces current list of paths with new paths.
+     *
+     * Заменяет текущий список путей новым набором путей.
+     * @param paths new path or list of paths / новый путь или список путей
+     * @returns this instance / этот экземпляр
+     */
+    setPaths(paths: string | string[]): this;
+    /**
+     * Appends paths to the current list of paths.
+     *
+     * Добавляет пути к текущему списку путей.
+     * @param paths path or list of paths to append / путь или список путей для добавления
+     * @returns this instance / этот экземпляр
+     */
+    addPaths(paths: string | string[]): this;
+    /**
+     * Resets cached content.
+     *
+     * Сбрасывает кэшированное содержимое.
+     * @returns this instance / этот экземпляр
+     */
+    resetContent(): this;
+    /**
+     * Adds paths to .gitignore if they are not already present.
+     *
+     * Добавляет пути в .gitignore, если они еще не присутствуют.
+     * @returns true if .gitignore was updated, false otherwise / true, если .gitignore был обновлен, иначе false
+     */
+    make(): boolean;
+    /**
+     * Returns comment lines array to insert into .gitignore, or empty array if not applicable.
+     *
+     * Возвращает массив строк комментария для вставки в .gitignore или пустой массив, если комментарий не требуется.
+     * @returns array with comment string or empty array / массив со строкой комментария или пустой массив
+     * @protected
+     */
+    protected getCommentLines(): string[];
+    /**
+     * Splits file content into a list of trimmed lines.
+     *
+     * Разбивает содержимое файла на список строк без пробелов по краям.
+     * @returns array of trimmed lines / массив очищенных строк
+     * @protected
+     */
+    protected toLines(): string[];
+    /**
+     * Normalizes, deduplicates and filters paths that already exist in .gitignore lines.
+     *
+     * Нормализует, дедуплицирует и отфильтровывает пути, которые уже присутствуют в строках .gitignore.
+     * @returns array of missing paths / массив отсутствующих путей
+     * @protected
+     */
+    protected toPaths(): string[];
+}
+
 /**
  * Class for reading information from Git repository.
  *
@@ -3063,8 +3233,11 @@ export declare class LibraryAiMcpItem {
  */
 export declare class LibraryAiPrompt {
     protected readonly isMcp: boolean;
+    protected readonly isVue: boolean;
     /** List of directories to scan. / Список директорий для сканирования. */
     protected readonly dirs: string[];
+    /** Set of package names from root package.json for filtering. / Набор имен пакетов из корневого package.json для фильтрации. */
+    protected packageNames?: Set<string>;
     /** Regular expression to identify files in directories. / Регулярное выражение для идентификации файлов в директориях. */
     protected readonly exFileOnDirs: RegExp;
     /** Regular expression to exclude hidden files/directories. / Регулярное выражение для исключения скрытых файлов/директорий. */
@@ -3075,14 +3248,24 @@ export declare class LibraryAiPrompt {
      * Конструктор для LibraryAiPrompt.
      * @param dirs Additional directories to scan / Дополнительные директории для сканирования
      * @param isMcp Flag indicating whether to generate MCP configuration file / Флаг, указывающий, нужно ли генерировать конфигурационный файл MCP
+     * @param isVue Flag indicating whether to include Vue component prompt rules / Флаг, указывающий, нужно ли включать правила для Vue-компонентов
      */
-    constructor(dirs?: string[], isMcp?: boolean);
+    constructor(dirs?: string[], isMcp?: boolean, isVue?: boolean);
     /**
      * Main method to generate the AI prompt file.
      *
      * Основной метод для генерации файла промпта ИИ.
      */
     make(): void;
+    /**
+     * Checks whether the library should be excluded from the ai-prompt.md file based on configuration.
+     *
+     * Проверяет, должна ли библиотека быть исключена из файла ai-prompt.md на основе конфигурации.
+     * @param item prompt item to check / элемент промпта для проверки
+     * @returns true if item should be excluded / true, если элемент должен быть исключен
+     * @protected
+     */
+    protected isExclude(item: LibraryAiPromptItem): boolean;
     /**
      * Checks if there are any files in the provided list.
      *
@@ -3092,6 +3275,15 @@ export declare class LibraryAiPrompt {
      * @protected
      */
     protected isFileOnDirs(dirs: string[]): boolean;
+    /**
+     * Checks whether the library is present in the root package.json dependencies.
+     *
+     * Проверяет, присутствует ли библиотека в зависимостях корневого package.json.
+     * @param item prompt item to check / элемент промпта для проверки
+     * @returns true if library is found in package.json / true, если библиотека найдена в package.json
+     * @protected
+     */
+    protected isInPackage(item: LibraryAiPromptItem): boolean;
     /**
      * Retrieves the final self-audit prompt for AI code verification.
      *
@@ -3112,10 +3304,10 @@ export declare class LibraryAiPrompt {
      * Retrieves the Vue component implementation prompt.
      *
      * Получает промпт по реализации Vue-компонентов.
-     * @returns formatted Vue prompt or undefined / отформатированный промпт Vue или undefined
+     * @returns array with formatted Vue prompt or empty array / массив с отформатированным промптом Vue или пустой массив
      * @protected
      */
-    protected getVuePrompt(): string;
+    protected getVuePrompt(): string[];
     /**
      * Retrieves the global code implementation prompt.
      *
@@ -3135,6 +3327,14 @@ export declare class LibraryAiPrompt {
      * @protected
      */
     protected getList(dirs?: string[], path?: string[], limit?: number): LibraryAiPromptItem[];
+    /**
+     * Retrieves the set of package names defined in the root package.json.
+     *
+     * Получает набор имен пакетов, определенных в корневом package.json.
+     * @returns set of package names / набор имен пакетов
+     * @protected
+     */
+    protected getPackageNames(): Set<string>;
     /**
      * Retrieves the prompt item for the current repository root if it contains prompt data.
      *
@@ -3143,6 +3343,13 @@ export declare class LibraryAiPrompt {
      * @protected
      */
     protected getRootItem(): LibraryAiPromptItem | undefined;
+    /**
+     * Adds all files and directories generated by this script to .gitignore.
+     *
+     * Добавляет все файлы и директории, сгенерированные этим скриптом, в .gitignore.
+     * @protected
+     */
+    protected initGitIgnore(): void;
     /**
      * Writes the collected prompts to a file.
      *
@@ -3320,12 +3527,38 @@ export declare class LibraryAiPromptItem {
     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.
      *
      * Форматирует и возвращает секцию типов для промпта.
+     * Копирует файл типов в корневую директорию типов и создает ссылку на копию.
      * @returns formatted types reference or undefined / отформатированная ссылка на типы или undefined
      * @protected
      */
     protected getTypes(): string | undefined;
+    /**
+     * Returns the copied types file name based on the project name.
+     *
+     * Возвращает имя скопированного файла типов на основе названия проекта.
+     * @returns file name / имя файла
+     * @protected
+     */
+    protected getTypesFileName(): string;
+    /**
+     * Returns path segments for the copied types file in the root types directory.
+     *
+     * Возвращает сегменты пути для скопированного файла типов в корневой директории типов.
+     * @returns target path segments / сегменты целевого пути
+     * @protected
+     */
+    protected getTypesPath(): string[];
+    /**
+     * Copies the types file to the target destination in the project root.
+     *
+     * Копирует файл типов в целевое назначение в корне проекта.
+     * @param targetPath target path segments / сегменты целевого пути
+     * @protected
+     */
+    protected copyTypes(targetPath: string[]): void;
     /**
      * Reads content of a file by its name relative to the item's directory.
      *
@@ -3749,6 +3982,14 @@ export declare class PropertiesFile {
      * @param path path to the directory/ путь к директории
      */
     static toSep(path: string): PropertiesFilePath;
+    /**
+     * Converts the path into an absolute file URL for dynamic ESM imports.
+     *
+     * Преобразует путь в абсолютный file URL для динамических импортов ESM.
+     * @param path path to the file or directory / путь к файлу или директории
+     * @returns file URL string / строка file URL
+     */
+    static toUrl(path: PropertiesFilePath): string;
     /**
      * Reads the contents of the directory.
      *