@dxtmisha/scripts 0.9.1 → 0.10.3

package/src/classes/Ai/ApiTmp.ts

@@ -0,0 +1,43 @@
+import { PropertiesFile } from '../Properties/PropertiesFile'
+
+const TEMPORARY_DIR = './ai-tmp'
+
+/**
+ * ApiTmp
+ */
+export class ApiTmp {
+  protected idFile = 1
+
+  /**
+   * Generates a unique file path for the temporary prompt.
+   *
+   * Генерирует уникальный путь к файлу для временного промпта.
+   */
+  protected getFileName(): string {
+    return `${TEMPORARY_DIR}/Prompt-${this.idFile++}.txt`
+  }
+
+  /**
+   * Creates a temporary file with the prompt content and returns the path formatted for the CLI.
+   *
+   * Создает временный файл с содержимым промпта и возвращает путь, отформатированный для CLI.
+   * @param content Prompt content / Содержимое промпта
+   * @returns Formatted file path (e.g., @./ai-tmp/Prompt-1.txt) / Отформатированный путь к файлу
+   */
+  createFile(content: string): string {
+    const name = this.getFileName()
+
+    PropertiesFile.writeByPath(name, content.trim())
+
+    return `Please read the following file as it contains the prompt instructions: @${name}`
+  }
+
+  /**
+   * Cleans up temporary files and directories.
+   *
+   * Очищает временные файлы и директории.
+   */
+  removeFile(): void {
+    PropertiesFile.removeDir(TEMPORARY_DIR)
+  }
+}

package/src/classes/Build/BuildPackages.ts

@@ -31,18 +31,14 @@ export class BuildPackages {
    * Сканирует директорию пакетов и собирает каждый пакет, содержащий package.json.
    */
   async make(): Promise<void> {
-    const list = PropertiesFile.readDir(this.path)
+    const list = this.getList()
     let changed = 0
 
     console.info(`Build packages(${list.length})...`)
 
-    for (const folder of list) {
-      const packageFile = new PackageFile([this.path, folder])
-
+    for (const packageFile of list) {
       if (
-        packageFile.is()
-        && !packageFile.isTest()
-        && this.isUpdate(packageFile)
+        this.isUpdate(packageFile)
         && await this.build(packageFile)
       ) {
         this.updateLog(packageFile)
@@ -80,6 +76,36 @@ export class BuildPackages {
     )
   }
 
+  /**
+   * 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(): PackageFile[] {
+    const list = PropertiesFile.readDir(this.path)
+    const packages: PackageFile[] = []
+
+    for (const folder of list) {
+      const packageFile = new PackageFile([this.path, folder])
+
+      if (
+        packageFile.is()
+        && !packageFile.isTest()
+      ) {
+        packages.push(packageFile)
+      }
+    }
+
+    return packages.sort((a, b) => {
+      const priorityA = a.get()?.['ui-priority'] ?? 500
+      const priorityB = b.get()?.['ui-priority'] ?? 500
+      return priorityA - priorityB
+    })
+  }
+
   /**
    * Returns the cached version of the package from the build log.
    *

package/src/classes/Design/DesignComponent.ts

@@ -270,7 +270,7 @@ export class DesignComponent extends DesignCommand {
           const option = prop.option
           let item: string = ''
 
-          item += `{ name: '${prop.name}', type: '${prop.type}'`
+          item += `{ name: '${prop.name}', type: '${prop.type.replace('| undefined', '').trim()}'`
 
           if (
             option

package/src/classes/Design/DesignTypes.ts

@@ -256,13 +256,14 @@ export class DesignTypes {
   protected async toAiDescription(content: string): Promise<string> {
     const generate = await this.toAi(
       content,
-      'Analyze the provided code and generate a highly technical, concise project overview for another AI coding assistant. '
-      + 'Your goal is to help the AI decide whether it needs to study this library to fulfill a user request. '
-      + 'The description must be objective, factual, and free of marketing fluff. '
+      'Analyze the provided code and generate a highly technical, structured, and concise project overview specifically designed for another AI coding assistant. '
+      + 'The description must enable the reading AI to immediately evaluate whether this library contains code, components, classes, or utilities useful for its current task, and when it is mandatory to read and analyze "ai-types.md". '
+      + 'The description must be objective, factual, precise, and free of marketing fluff. '
       + 'Include: '
-      + '1. Core Purpose: What is the primary function of this library? (e.g., UI component library, state management, utility for X). '
-      + '2. Usage Scenarios: In what specific cases and scenarios is this library indispensable? When should an AI study its API? '
-      + '3. Integration Context: How does it relate to other technologies in the stack (if evident)? '
+      + '1. Core Purpose: What is the primary technical function of this library? '
+      + '2. Key Expositions: What are the main classes, hooks, utilities, or components exposed by this project, and what specific tasks do they perform? '
+      + '3. Triggers for Studying ai-types.md: Under what specific conditions, keywords, or coding requirements is this library indispensable, making it mandatory for the AI to study its "ai-types.md" file? '
+      + '4. Integration Context: How does it connect with other technologies in the system stack? '
       + 'Ensure the structure is clean and enables immediate context retrieval. '
       + 'Return ONLY the resulting description text. No markdown, no labels like "Description:", no explanations. NOTHING but the pure content.'
     )

package/src/classes/Design/DesignWikiStorm.ts

@@ -6,7 +6,7 @@ import { PropertiesFile } from '../Properties/PropertiesFile'
 import { LibraryItems } from '../Library/LibraryItems'
 import { DesignWikiStormItem } from './DesignWikiStormItem'
 
-import type { WebTypesTags, WebTypesVueJson } from '../../types/webTypes'
+import type { WebTypesVueComponentItem, WebTypesVueJson } from '../../types/webTypes'
 
 /**
  * Engine for generating `web-types.json` to provide rich metadata and IDE support (IntelliSense) for the design system components in JetBrains editors (IntelliJ IDEA, WebStorm).
@@ -43,15 +43,15 @@ export class DesignWikiStorm {
 
     if (packageFile) {
       const data: WebTypesVueJson = {
-        $schema: 'https://json.schemastore.org/web-types',
+        $schema: 'https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json',
         framework: 'vue',
         name: toCamelCaseFirst(PropertiesConfig.getDesignName()),
         version: packageFile.version,
+        'js-types-syntax': 'typescript',
         contributions: {
           html: {
-            'types-syntax': 'typescript',
             'description-markup': 'markdown',
-            'tags': await this.getComponents()
+            'vue-components': await this.getComponents()
           }
         }
       }
@@ -68,9 +68,9 @@ export class DesignWikiStorm {
    *
    * Создает или обновляет список компонентов.
    */
-  protected async getComponents(): Promise<WebTypesTags> {
+  protected async getComponents(): Promise<WebTypesVueComponentItem[]> {
     const packageFile = getPackageJson()
-    const tags: WebTypesTags = []
+    const tags: WebTypesVueComponentItem[] = []
 
     if (packageFile) {
       for (const component of this.components.getComponentList()) {
@@ -85,7 +85,7 @@ export class DesignWikiStorm {
         const tag = await item.get()
 
         if (tag) {
-          tags.push(tag)
+          tags.push(tag as any)
         }
       }
     }

package/src/classes/Design/DesignWikiStormItem.ts

@@ -6,7 +6,7 @@ import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'
 
 import type { LibraryData } from '../../types/libraryTypes'
-import type { WebTypesAttributeItem, WebTypesAttributes, WebTypesEvents, WebTypesSlots, WebTypesTagItem } from '../../types/webTypes'
+import type { WebTypesVueComponentItem, WebTypesPropItem, WebTypesSlots, WebTypesEventItem, WebTypesProperty } from '../../types/webTypes'
 import { forEach } from '@dxtmisha/functional-basic'
 
 /**
@@ -46,73 +46,73 @@ export class DesignWikiStormItem {
    *
    * Возвращает определение тега для web-types.
    */
-  async get(): Promise<WebTypesTagItem | undefined> {
+  async get(): Promise<WebTypesVueComponentItem | undefined> {
     if (this.wiki) {
       const name = `${toCamelCaseFirst(PropertiesConfig.getDesignName())}${this.wiki.getName()}`
 
-      const tag: WebTypesTagItem = {
+      const component: WebTypesVueComponentItem = {
         name,
         description: this.wiki.getDescription(),
         source: {
           module: `${this.project}/${name}`,
           symbol: name
         },
-        attributes: this.getAttributes()
+        props: this.getProps()
       }
 
       const slots = await this.getSlots()
 
       if (slots) {
-        tag.slots = slots
+        component.slots = slots
       }
 
       const events = await this.getEvents()
 
-      if (events) {
-        tag.events = events
+      if (events && events.length > 0) {
+        component.js = {
+          events
+        }
       }
 
-      return tag
+      return component
     }
 
     return undefined
   }
 
   /**
-   * Returns the attribute definition.
+   * Returns the prop definition.
    *
-   * Возвращает определение атрибута.
+   * Возвращает определение свойства.
    * @param item prop item / элемент свойства
    */
-  getAttribute(item: WikiStorybookProp): WebTypesAttributeItem {
+  getProp(item: WikiStorybookProp): WebTypesPropItem {
     const type = this.prepareType(item.getType())
+    const cleaned = type ? this.cleanType(type) : undefined
     return {
       name: item.getName(),
       description: item.getDescription(),
-      // default: item.getDefaultValue(),
-      value: {
-        kind: 'expression',
-        type
-      }
+      default: item.getDefaultValue() ?? undefined,
+      type: cleaned
     }
   }
 
   /**
-   * Returns a list of attributes.
+   * Returns a list of props.
    *
-   * Возвращает список атрибутов.
+   * Возвращает список свойств.
    */
-  getAttributes(): WebTypesAttributes {
-    const attributes: WebTypesAttributes = []
+  getProps(): WebTypesPropItem[] {
+    const props: WebTypesPropItem[] = []
 
     if (this.wiki) {
       this.wiki.getWikiObject()
         .forEach(
-          props => attributes.push(this.getAttribute(props))
+          item => props.push(this.getProp(item))
         )
     }
 
-    return attributes
+    return props
   }
 
   /**
@@ -127,11 +127,19 @@ export class DesignWikiStormItem {
       const slots: WebTypesSlots = []
 
       data.slots.forEach(
-        props => slots.push({
-          'name': props.name,
-          'description': props.description,
-          'vue-properties': props.properties ?? []
-        })
+        slot => {
+          const vueProperties: WebTypesProperty[] = (slot.properties ?? []).map(p => ({
+            name: p.name,
+            type: p.type ? this.cleanType(p.type) : undefined,
+            description: p.description
+          }))
+
+          slots.push({
+            'name': slot.name,
+            'description': slot.description,
+            'vue-properties': vueProperties
+          })
+        }
       )
 
       return slots
@@ -145,18 +153,28 @@ export class DesignWikiStormItem {
    *
    * Возвращает список событий.
    */
-  async getEvents(): Promise<WebTypesEvents | undefined> {
+  async getEvents(): Promise<WebTypesEventItem[] | undefined> {
     const data = await this.getData()
 
     if (data && data.events) {
-      const events: WebTypesEvents = []
+      const events: WebTypesEventItem[] = []
 
       data.events.forEach(
-        event => events.push({
-          name: event.name,
-          description: event.description,
-          arguments: event.properties ?? []
-        })
+        event => {
+          let typeString = '() => void'
+          if (event.properties && event.properties.length > 0) {
+            const args = event.properties
+              .map(p => `${p.name}: ${p.type ? this.cleanType(p.type) : 'any'}`)
+              .join(', ')
+            typeString = `(${args}) => void`
+          }
+
+          events.push({
+            name: event.name,
+            description: event.description,
+            type: typeString
+          })
+        }
       )
 
       return events
@@ -262,6 +280,18 @@ export class DesignWikiStormItem {
     return type
   }
 
+  /**
+   * Cleans a type string by removing redundant parentheses, e.g., (CellClassesSub) | undefined -> CellClassesSub | undefined
+   *
+   * Очищает строку типа, удаляя лишние скобки, например: (CellClassesSub) | undefined -> CellClassesSub | undefined
+   */
+  protected cleanType(type: string): string {
+    return type
+      .replace(/^\(([^()]+)\)$/, '$1')
+      .replace(/^\(([^()]+)\)\s*\|\s*undefined$/, '$1 | undefined')
+      .trim()
+  }
+
   /**
    * Initializes the wiki object.
    *

package/src/classes/Library/LibraryAiPrompt.ts

@@ -7,8 +7,8 @@ import {
 import { PropertiesFile } from '../Properties/PropertiesFile'
 import { LibraryAiPromptItem } from './LibraryAiPromptItem'
 
-import vuePromptText from '../../media/templates/prompts/aiCodeVuePrompt.en.txt?raw'
-import globalPromptText from '../../media/templates/prompts/aiCodeGlobalPrompt.en.txt?raw'
+import vuePromptText from '../../media/templates/prompts/aiCodeVuePrompt.en.md?raw'
+import globalPromptText from '../../media/templates/prompts/aiCodeGlobalPrompt.en.md?raw'
 
 const LIBRARY_AI_PROMPT_LIST_DIRS = [
   UI_MODULES

package/src/classes/Library/LibraryAiPromptItem.ts

@@ -5,7 +5,8 @@ import {
   UI_FILE_AI_PROMPT_DESCRIPTION,
   UI_FILE_AI_PROMPT_INFO,
   UI_FILE_AI_PROMPT_TYPES,
-  UI_FILE_PACKAGE
+  UI_FILE_PACKAGE,
+  UI_FILE_AI_PROMPT_DEVELOPER
 } from '../../config'
 
 /**
@@ -53,6 +54,7 @@ export class LibraryAiPromptItem {
       || this.isInfo()
       || this.isTypes()
       || this.isScreenshot()
+      || this.isDeveloper()
   }
 
   /**
@@ -65,6 +67,16 @@ export class LibraryAiPromptItem {
     return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_DESCRIPTION))
   }
 
+  /**
+   * Checks if the developer prompt file exists.
+   *
+   * Проверяет, существует ли файл промпта разработчика.
+   * @returns true if developer prompt file exists / true, если файл промпта разработчика существует
+   */
+  isDeveloper(): boolean {
+    return PropertiesFile.is(this.getPath(UI_FILE_AI_PROMPT_DEVELOPER))
+  }
+
   /**
    * Checks if the information file exists.
    *
@@ -108,7 +120,8 @@ export class LibraryAiPromptItem {
       this.getDescription(),
       this.getInfo(),
       this.getTypes(),
-      this.getScreenshot()
+      this.getScreenshot(),
+      this.getDeveloper()
     ].filter(item => item !== undefined) as string[]
 
     if (data.length > 0) {
@@ -201,6 +214,27 @@ ${this.readFile(UI_FILE_AI_PROMPT_DESCRIPTION)}
     return undefined
   }
 
+  /**
+   * Formats and returns the developer prompt section.
+   *
+   * Форматирует и возвращает секцию промпта для разработчика.
+   * @returns formatted developer prompt or undefined / отформатированный промпт разработчика или undefined
+   * @protected
+   */
+  protected getDeveloper(): string | undefined {
+    if (this.isDeveloper()) {
+      console.log('-- Developer')
+
+      return `
+## Mandatory Study Before Development
+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 the architectural rules and instructions in this file as your absolute first action:
+'${this.getPathString()}/${UI_FILE_AI_PROMPT_DEVELOPER}'
+      `.trim()
+    }
+
+    return undefined
+  }
+
   /**
    * Formats and returns the info section for the prompt.
    *
@@ -235,7 +269,7 @@ ${this.readFile(UI_FILE_AI_PROMPT_INFO)}
 
       return `
 ## Project types: Essential for analysis
-This file contains the complete type definitions for the project. It is mandatory to study this file to perform an accurate analysis of the project structure and logic:
+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.getPathString()}/${UI_FILE_AI_PROMPT_TYPES}'
       `.trim()
     }

package/src/composables/useAi.ts

@@ -1,8 +1,13 @@
 import { PropertiesConfig } from '../classes/Properties/PropertiesConfig'
 
 import { AiAbstract } from '../classes/Ai/AiAbstract'
+import { AiClaude } from '../classes/Ai/AiClaude'
+import { AiClaudeAgent } from '../classes/Ai/AiClaudeAgent'
+import { AiClaudeCli } from '../classes/Ai/AiClaudeCli'
 import { AiGoogle } from '../classes/Ai/AiGoogle'
 import { AiGoogleCli } from '../classes/Ai/AiGoogleCli'
+import { AiOpenAi } from '../classes/Ai/AiOpenAi'
+import { AiZAi } from '../classes/Ai/AiZAi'
 
 /**
  * Composable to obtain an AI instance based on configuration.
@@ -13,10 +18,20 @@ export function useAi(): AiAbstract | undefined {
   const type = PropertiesConfig.getAiType()
 
   switch (type) {
+    case 'claude':
+      return new AiClaude()
+    case 'claude-agent':
+      return new AiClaudeAgent()
+    case 'claude-cli':
+      return new AiClaudeCli()
     case 'gemini':
       return new AiGoogle()
     case 'gemini-cli':
       return new AiGoogleCli()
+    case 'openai':
+      return new AiOpenAi()
+    case 'zai':
+      return new AiZAi()
   }
 
   return undefined

package/src/config.ts

@@ -81,15 +81,17 @@ export const UI_FILE_PACKAGE = 'package.json'
 export const UI_FILE_PROPERTY = 'properties.json'
 
 /** AI prompt description file name / Название файла с описанием промпта AI */
-export const UI_FILE_AI_PROMPT_DESCRIPTION = 'ai-description.txt'
+export const UI_FILE_AI_PROMPT_DESCRIPTION = 'ai-description.md'
 /** AI prompt info file name / Название файла с информацией промпта AI */
-export const UI_FILE_AI_PROMPT_INFO = 'ai-doc.txt'
+export const UI_FILE_AI_PROMPT_INFO = 'ai-doc.md'
 /** AI prompt instruction file name / Название файла с инструкцией промпта AI */
-export const UI_FILE_AI_PROMPT_INSTRUCTION = 'ai-instruction.txt'
+export const UI_FILE_AI_PROMPT_INSTRUCTION = 'ai-instruction.md'
 /** AI prompt result file name / Название файла с результатом промпта AI */
-export const UI_FILE_AI_PROMPT_PROMPT = 'ai-prompt.txt'
+export const UI_FILE_AI_PROMPT_PROMPT = 'ai-prompt.md'
 /** AI prompt types file name / Название файла с типами промпта AI */
-export const UI_FILE_AI_PROMPT_TYPES = 'ai-types.txt'
+export const UI_FILE_AI_PROMPT_TYPES = 'ai-types.md'
+/** AI prompt developer file name / Название файла для разработчика AI */
+export const UI_FILE_AI_PROMPT_DEVELOPER = 'ai-developer.md'
 
 /** File name for storing the list of flags/ Название файла для хранения списка флагов */
 export const UI_FILE_NAME_FLAGS = 'flags'
@@ -115,9 +117,9 @@ export const UI_FILE_NAME_VITE_WORKERS = 'vite-workers.config.ts'
 export const UI_FILE_INDEX = 'index.ts'
 
 /** AI types file name / Название файла с типами AI */
-export const UI_FILE_AI_TYPES = 'ai-types.txt'
+export const UI_FILE_AI_TYPES = 'ai-types.md'
 /** AI description file name / Название файла с описанием AI */
-export const UI_FILE_AI_DESCRIPTION = 'ai-description.txt'
+export const UI_FILE_AI_DESCRIPTION = 'ai-description.md'
 /** Style SCSS file name / Название файла стилей SCSS */
 export const UI_FILE_STYLE_SCSS = 'style.scss'
 /** UI properties SCSS file name / Название файла свойств UI в SCSS */

package/src/demo/ai.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env vite-node
+
+import { useAi } from '../composables/useAi'
+
+const ai = useAi()
+
+ai?.generate('Who are you?')
+  .then((response) => {
+    console.log('ai response: ', response)
+  })

package/src/library-ai.ts

@@ -2,9 +2,9 @@
 export * from './classes/Ai/AiAbstract'
 export * from './classes/Ai/AiGoogleLite'
 export * from './classes/Ai/AiGoogle'
-export * from './classes/Ai/AiGoogleCliLite'
-export * from './classes/Ai/AiGoogleCli'
 export * from './classes/Ai/AiClaudeLite'
 export * from './classes/Ai/AiClaude'
-export * from './classes/Ai/AiClaudeCliLite'
-export * from './classes/Ai/AiClaudeCli'
+export * from './classes/Ai/AiOpenAiLite'
+export * from './classes/Ai/AiOpenAi'
+export * from './classes/Ai/AiZAiLite'
+export * from './classes/Ai/AiZAi'