@dxtmisha/scripts 0.5.9 → 0.5.12

package/bin/design-types.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env vite-node
+
+import { DesignTypes } from '../src/classes/Design/DesignTypes'
+
+const dir: string = process.argv?.[2] ?? 'dist'
+
+new DesignTypes(dir).make()

package/bin/design-ui.ts

@@ -2,6 +2,6 @@
 
 import { DesignUi } from '../src/classes/Design/DesignUi'
 
-const name: string = process.argv?.[2] ?? ''
+const name: string | undefined = process.argv?.[2] ?? undefined
 
 new DesignUi(name).make()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.5.9",
+  "version": "0.5.12",
   "type": "module",
   "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
   "keywords": [
@@ -46,6 +46,7 @@
     "dxt-constructor": "bin/design-constructor.ts",
     "dxt-library": "bin/design-library.ts",
     "dxt-package": "bin/design-package.ts",
+    "dxt-types": "bin/design-types.ts",
     "dxt-ui": "bin/design-ui.ts"
   },
   "exports": {

package/src/classes/Ai/AiGoogleCliLite.ts

@@ -1,7 +1,8 @@
+import { forEach } from '@dxtmisha/functional-basic'
 import { exec } from 'node:child_process'
+
+import { PropertiesFile } from '../Properties/PropertiesFile'
 import { AiAbstract } from './AiAbstract'
-import { PropertiesFile } from '../Properties/PropertiesFile.ts'
-import { forEach } from '@dxtmisha/functional-basic'
 
 const TEMPORARY_DIR = './ai-tmp'
 

package/src/classes/Design/DesignTypes.ts

@@ -0,0 +1,196 @@
+import { forEach } from '@dxtmisha/functional-basic'
+import { useAi } from '../../composables/useAi'
+
+import { PropertiesFile } from '../Properties/PropertiesFile'
+
+import type { DesignTypesList } from '../../types/designTypes'
+
+import { UI_FILE_AI_TYPES } from '../../config'
+
+/**
+ * Class for generating AI-optimized type definitions.
+ *
+ * Класс для генерации оптимизированных ИИ определений типов.
+ */
+export class DesignTypes {
+  /**
+   * Array of directory path segments.
+   *
+   * Массив сегментов пути директории.
+   */
+  protected readonly dirArray: string[]
+
+  /**
+   * Constructor
+   * @param dir directory path / путь к директории
+   */
+  constructor(
+    protected readonly dir: string = 'dist'
+  ) {
+    this.dirArray = this.dir.split('/')
+  }
+
+  /**
+   * Main method to execute the type generation process.
+   *
+   * Основной метод для выполнения процесса генерации типов.
+   */
+  make() {
+    console.log('DesignTypes: making AI types...')
+
+    const files = this.getListByFilter()
+    const fullContent = this.toOneFile(files)
+
+    this.toAiEdit(fullContent).then(
+      (aiContent) => {
+        this.save(aiContent)
+
+        console.log('DesignTypes: AI types saved.')
+      }
+    )
+  }
+
+  /**
+   * Checks if the file is a valid declaration file.
+   *
+   * Проверяет, является ли файл валидным файлом декларации.
+   * @param file file name / имя файла
+   */
+  protected isFile(file: string): boolean {
+    return file.endsWith('.d.ts')
+      && (
+        !file.includes('constructors/')
+        || (
+          !file.endsWith('/props.d.ts')
+          && !file.endsWith('/types.d.ts')
+        )
+      )
+  }
+
+  /**
+   * Checks if the content contains type definitions.
+   *
+   * Проверяет, содержит ли контент определения типов.
+   * @param content file content / содержимое файла
+   */
+  protected isContent(content?: string): content is string {
+    return Boolean(
+      content && (
+        content.includes('export interface')
+        || content.includes('export type')
+        || content.includes('export enum')
+      ))
+  }
+
+  /**
+   * Returns the full path segments for a file.
+   *
+   * Возвращает сегменты полного пути для файла.
+   * @param file file name / имя файла
+   */
+  protected getPath(file: string): string[] {
+    return [...this.dirArray, file]
+  }
+
+  /**
+   * Reads the directory recursively.
+   *
+   * Читает директорию рекурсивно.
+   */
+  protected getList() {
+    return PropertiesFile.readDirRecursive(this.dirArray)
+  }
+
+  /**
+   * Gets a list of files filtered by criteria.
+   *
+   * Получает список файлов, отфильтрованный по критериям.
+   */
+  protected getListByFilter(): DesignTypesList {
+    return forEach(
+      this.getList(),
+      (file) => {
+        if (this.isFile(file)) {
+          const content = this.readFile(file)
+
+          if (this.isContent(content)) {
+            return {
+              path: file,
+              content
+            }
+          }
+        }
+
+        return undefined
+      }
+    ) as DesignTypesList
+  }
+
+  /**
+   * Reads the content of a file.
+   *
+   * Читает содержимое файла.
+   * @param path file path / путь к файлу
+   */
+  protected readFile(path: string): string | undefined {
+    return PropertiesFile.readFileOnly(this.getPath(path))
+  }
+
+  /**
+   * Saves the generated content to a file.
+   *
+   * Сохраняет сгенерированный контент в файл.
+   * @param content content to save / контент для сохранения
+   */
+  protected save(content: string) {
+    PropertiesFile.writeByPath(
+      UI_FILE_AI_TYPES,
+      content
+    )
+  }
+
+  /**
+   * Combines a list of files into a single string.
+   *
+   * Объединяет список файлов в одну строку.
+   * @param list list of files / список файлов
+   */
+  protected toOneFile(list: DesignTypesList): string {
+    return forEach(
+      list,
+      item => `// File: ${item.path}\n${item.content}`
+    )
+      .join('\n\n')
+  }
+
+  /**
+   * Sends content to AI for optimization.
+   *
+   * Отправляет контент ИИ для оптимизации.
+   * @param content content to optimize / контент для оптимизации
+   */
+  protected async toAiEdit(content: string): Promise<string> {
+    const ai = useAi()
+
+    if (ai) {
+      ai.addPrompt(`File Content: ${content}`)
+
+      const generate = await ai.generate(
+        'Remove all Russian comments from this code. '
+        + 'Remove comments if the property name makes its purpose obvious. '
+        + 'Remove all imports. '
+        + 'Remove empty lines. '
+        + 'Remove the "export" keyword if possible. '
+        + 'Keep only "type", "interface" and "enum" definitions, remove everything else. '
+        + 'Minimize the content as much as possible without losing any data or logic. '
+        + 'Return only the corrected code without any additional text or explanations.'
+      )
+
+      if (generate) {
+        return generate
+      }
+    }
+
+    return content
+  }
+}

package/src/classes/Package/PackageItem.ts

@@ -1,10 +1,10 @@
 // export:none
 
 import requirePath from 'path'
+import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'
 
 import { UI_DIR_PACKAGES, UI_DIRS_LIBRARY, UI_FILE_PACKAGE } from '../../config'
-import { PropertiesConfig } from '../Properties/PropertiesConfig.ts'
 
 const DIR_SAMPLE = [__dirname, '..', '..', 'media', 'templates', 'packages']
 const DIR_STORYBOOK = [

package/src/config.ts

@@ -83,6 +83,8 @@ export const UI_FILE_NAME_VITE_WORKERS = 'vite-workers.config.ts'
 
 export const UI_FILE_INDEX = 'index.ts'
 
+export const UI_FILE_AI_TYPES = 'ai-types.txt'
+
 /** SCSS file extension/ Расширение файлов SCSS */
 export const UI_EXTENSION_STYLE = 'scss'
 

package/src/functions/getPackageJson.ts

@@ -0,0 +1,11 @@
+import { PropertiesFile } from '../classes/Properties/PropertiesFile'
+import { UI_FILE_PACKAGE } from '../config'
+
+/**
+ * Returns the package.json file content.
+ *
+ * Возвращает содержимое файла package.json.
+ */
+export function getPackageJson(): Record<string, any> | undefined {
+  return PropertiesFile.readFile<Record<string, any>>(UI_FILE_PACKAGE)
+}

package/src/library.ts

@@ -11,6 +11,7 @@ export * from './classes/Ai/AiGoogleCli'
 export * from './classes/Ai/AiGoogleCliLite'
 export * from './classes/Ai/AiGoogleLite'
 export * from './classes/BuildItem'
+export * from './classes/Design/DesignTypes'
 export * from './classes/Design/DesignTypescript'
 export * from './classes/Git/GitRead'
 export * from './classes/Properties/PropertiesFile'
@@ -20,6 +21,7 @@ export * from './composables/useAi'
 
 // Functions
 export * from './functions/getConfigAi'
+export * from './functions/getPackageJson'
 
 // Types
 export * from './types/aiTypes'

package/src/media/templates/componentDoc/wiki/run.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env vite-node
+/// <reference types="node" />
 
 import { spawn } from 'node:child_process'
 

package/src/media/templates/prompts/aiDocClassPrompt.en.txt

@@ -12,7 +12,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 ### Documentation Structure:
 
 1.  **Header**:
-    ```javascript (or typescript if typing is present)
+    ```javascript (or typescript if generics are present)
     import {Meta} from '@storybook/addon-docs/blocks'
 
     <Meta title='[title]'/>
@@ -42,8 +42,8 @@ Use the following template and style. Your response must contain ONLY MDX code.
             - List: `- `name: type` — description`.
         - **Returns:** (if it returns a value)
             - `Type` — description.
-        - **Code Example**:
-            ```javascript (or typescript if typing is present)
+        - **Code Example** (use typescript only if generics are present):
+            ```javascript (or typescript if generics are present)
             // Example usage
             Class.method(arg);
             ```
@@ -56,6 +56,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 3.2. Try to preserve original descriptions unchanged.
 4. Use the correct terminology.
 4.1. All headings must be in [wikiLanguage].
+4.2. Avoid using Generics and TypeScript types in code examples if possible (e.g., avoid `export type EventHandler<T = any> = (data: T) => void`).
 5. Do not add unnecessary introductions or conclusions, only MDX.
 6. Return only the full MDX documentation code without any additional text, comments, or markdown formatting (```).
 7. The result must be exclusively text (response); do not attach any files.

package/src/media/templates/prompts/aiDocClassPrompt.ru.txt

@@ -12,7 +12,7 @@
 ### Структура документации:
 
 1.  **Шапка**:
-    ```javascript (или typescript, если есть типизация)
+    ```javascript (или typescript, если есть generics)
     import {Meta} from '@storybook/addon-docs/blocks'
 
     <Meta title='[title]'/>
@@ -42,8 +42,8 @@
             - Список: `- `имя: тип` — описание`.
         - **Возвращает:** (если возвращает значение)
             - `Тип` — описание.
-        - **Пример кода**:
-            ```javascript (или typescript, если есть типизация)
+        - **Пример кода** (используй typescript, только если есть generics):
+            ```javascript (или typescript, если есть generics)
             // Пример вызова
             Class.method(arg);
             ```
@@ -56,6 +56,7 @@
 3.2. Старайся сохранять оригинальные описания без изменений.
 4. Используй правильную терминологию.
 4.1. Все заголовки должны быть на языке [wikiLanguage].
+4.2. Избегай использования Generics и типов TypeScript в примерах кода, если это возможно (например, избегай `export type EventHandler<T = any> = (data: T) => void`).
 5. Не добавляй лишних введений или заключений, только MDX.
 6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
 7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.

package/src/media/templates/prompts/aiDocComposablePrompt.en.txt

@@ -12,7 +12,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 ### Documentation Structure:
 
 1.  **Header**:
-    ```javascript (or typescript if typing is present)
+    ```javascript (or typescript if generics are present)
     import {Meta} from '@storybook/addon-docs/blocks'
 
     <Meta title='[title]'/>
@@ -38,8 +38,8 @@ Use the following template and style. Your response must contain ONLY MDX code.
     - **Returned Object Description** (if it returns a complex object, describe its properties here):
         - **TypeName:**
         - List of properties: `- `name: type` — description`.
-    - **Code Example**:
-        ```javascript (or typescript if typing is present)
+    - **Code Example** (use typescript only if generics are present):
+        ```javascript (or typescript if generics are present)
         import { useName } from '@package'
         // Initialization example
         ```
@@ -47,7 +47,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 5.  **Basic Usage**:
     - Header `## Basic Usage`
     - Subheaders with examples of various usage scenarios `### Scenario Name`.
-    - Code and brief description if needed.
+    - Code (use typescript only if generics are present) and brief description if needed.
 
 6.  **Data Types** (Optional, if there are additional important types not described in the Function section):
     - Header `## Data Types`
@@ -60,6 +60,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 3.2. Try to preserve original descriptions unchanged.
 4. Use the correct terminology (Composable, Ref, Reactive).
 4.1. All headings must be in [wikiLanguage].
+4.2. Avoid using Generics and TypeScript types in code examples if possible (e.g., avoid `export type EventHandler<T = any> = (data: T) => void`).
 5. Do not add unnecessary introductions or conclusions, only MDX.
 6. Return only the full MDX documentation code without any additional text, comments, or markdown formatting (```).
 7. The result must be exclusively text (response); do not attach any files.

package/src/media/templates/prompts/aiDocComposablePrompt.ru.txt

@@ -12,7 +12,7 @@
 ### Структура документации:
 
 1.  **Шапка**:
-    ```javascript (или typescript, если есть типизация)
+    ```javascript (или typescript, если есть generics)
     import {Meta} from '@storybook/addon-docs/blocks'
 
     <Meta title='[title]'/>
@@ -38,8 +38,8 @@
     - **Описание возвращаемого объекта** (если возвращает сложный объект, опиши его свойства тут же):
         - **ИмяТипа:**
         - Список свойств: `- `имя: тип` — описание`.
-    - **Пример кода**:
-        ```javascript (или typescript, если есть типизация)
+    - **Пример кода** (используй typescript, только если есть generics):
+        ```javascript (или typescript, если есть generics)
         import { useName } from '@package'
         // Пример инициализации
         ```
@@ -47,7 +47,7 @@
 5.  **Основное использование (Basic Usage)**:
     - Заголовок `## Основное использование`
     - Подзаголовки с примерами различных сценариев использования `### Название сценария`.
-    - Код и краткое описание если нужно.
+    - Код (используй typescript, только если есть generics) и краткое описание если нужно.
 
 6.  **Типы данных** (Опционально, если есть дополнительные важные типы, которые не описаны в разделе Функция):
     - Заголовок `## Типы данных`
@@ -60,6 +60,7 @@
 3.2. Старайся сохранять оригинальные описания без изменений.
 4. Используй правильную терминологию (Composable, Ref, Reactive).
 4.1. Все заголовки должны быть на языке [wikiLanguage].
+4.2. Избегай использования Generics и типов TypeScript в примерах кода, если это возможно (например, избегай `export type EventHandler<T = any> = (data: T) => void`).
 5. Не добавляй лишних введений или заключений, только MDX.
 6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
 7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.

package/src/media/templates/prompts/aiDocFunctionPrompt.en.txt

@@ -12,7 +12,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 ### Documentation Structure:
 
 1.  **Header**:
-    ```javascript (or typescript if typing is present)
+    ```javascript (or typescript if generics are present)
     import {Meta} from '@storybook/addon-docs/blocks'
 
     <Meta title='[title]'/>
@@ -31,8 +31,8 @@ Use the following template and style. Your response must contain ONLY MDX code.
     - Description of the return value or type.
 
 5.  **Example**:
-    - Usage code example.
-        ```javascript (or typescript if typing is present)
+    - Usage code example (use typescript only if generics are present).
+        ```javascript (or typescript if generics are present)
         import { name } from '@package'
         // Call example
         ```
@@ -50,6 +50,7 @@ Use the following template and style. Your response must contain ONLY MDX code.
 3.2. Try to preserve original descriptions unchanged.
 4. Use the correct terminology.
 4.1. All headings must be in [wikiLanguage].
+4.2. Avoid using Generics and TypeScript types in code examples if possible (e.g., avoid `export type EventHandler<T = any> = (data: T) => void`).
 5. Do not add unnecessary introductions or conclusions, only MDX.
 6. Return only the full MDX documentation code without any additional text, comments, or markdown formatting (```).
 7. The result must be exclusively text (response); do not attach any files.

package/src/media/templates/prompts/aiDocFunctionPrompt.ru.txt

@@ -12,7 +12,7 @@
 ### Структура документации:
 
 1.  **Шапка**:
-    ```javascript (или typescript, если есть типизация)
+    ```javascript (или typescript, если есть generics)
     import {Meta} from '@storybook/addon-docs/blocks'
 
     <Meta title='[title]'/>
@@ -31,8 +31,8 @@
     - Описание возвращаемого значения или типа.
 
 5.  **Пример**:
-    - Пример кода использования.
-        ```javascript (или typescript, если есть типизация)
+    - Пример кода использования (используй typescript, только если есть generics).
+        ```javascript (или typescript, если есть generics)
         import { name } from '@package'
         // Пример вызова
         ```
@@ -50,6 +50,7 @@
 3.2. Старайся сохранять оригинальные описания без изменений.
 4. Используй правильную терминологию.
 4.1. Все заголовки должны быть на языке [wikiLanguage].
+4.2. Избегай использования Generics и типов TypeScript в примерах кода, если это возможно (например, избегай `export type EventHandler<T = any> = (data: T) => void`).
 5. Не добавляй лишних введений или заключений, только MDX.
 6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
 7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.

package/src/media/templates/prompts/componentPrompt.en.txt

@@ -26,7 +26,7 @@ Use the following template and style.
     - Format: `- Use case.`
 
 4.  **Basic Usage**:
-    - Code example using the component (use typescript if typing is present).
+    - Code example using the component.
         ```html
         <script setup>
         // Script code

package/src/media/templates/prompts/componentPrompt.ru.txt

@@ -26,7 +26,7 @@
     - Формат: `- Сценарий.`
 
 4.  **Пример использования (Basic Usage)**:
-    - Пример кода с использованием компонента (используй typescript, если есть типизация).
+    - Пример кода с использованием компонента.
         ```html
         <script setup>
         // Код скрипта

package/src/types/designTypes.ts

@@ -94,3 +94,10 @@ export type DesignTypescriptItem = {
 
 /** List of TypeScript items / Список TypeScript элементов */
 export type DesignTypescriptList = DesignTypescriptItem[]
+
+export type DesignTypesItem = {
+  path: string
+  content: string
+}
+
+export type DesignTypesList = DesignTypesItem[]