@dxtmisha/scripts 0.10.12 → 0.10.14

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.10.12] - 2026-08-05
+## [0.10.13] - 2026-08-06
+
+### Changed
+- **AI Workspace Memory**: Updated `aiCodeGlobalPrompt` templates (EN & RU) and root `ai-prompt.md` to restrict `ai-memory.md` updates strictly to explicit developer requests or critical architectural rules.
+- **DesignTypes**: Refined AI prompt summary generation in `toAiPromptName` to produce high-density topic and trigger criteria descriptions, and fixed prompt string joining formatting.
+
+
 
 ### 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`).

package/bin/design-types.ts

@@ -2,8 +2,10 @@
 
 import { DesignTypes } from '../src/classes/Design/DesignTypes'
 
-const dir: string = process.argv?.[2] ?? 'dist'
+const isRaw: boolean = process.argv?.[2] === 'raw' || process.argv?.[2] === '1' || process.argv?.[2] === 'true'
+const dir: string = process.argv?.[3]
+const resourcesDir: string = process.argv?.[4]
 
-new DesignTypes(dir)
+new DesignTypes(dir, resourcesDir, isRaw)
   .make()
   .then()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.10.12",
+  "version": "0.10.14",
   "type": "module",
   "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": [
@@ -14,7 +14,7 @@
     "component-generator",
     "figma-sync",
     "ai-tools",
-    "ai-prompts",
+    "ai-resources",
     "storybook",
     "documentation",
     "typescript",
@@ -89,6 +89,7 @@
     "puppeteer": "*",
     "sass": "*",
     "typescript": "*",
+    "vite-node": "*",
     "vue": "*"
   },
   "devDependencies": {

package/src/classes/Ai/AiClaudeCliLite.ts

@@ -106,4 +106,3 @@ export class AiClaudeCliLite extends AiAbstract<{}> {
     })
   }
 }
-

package/src/classes/Design/DesignFigma.ts

@@ -1,9 +1,25 @@
 import { FigmaApi } from '../FigmaApi'
 import { PropertiesConfig } from '../Properties/PropertiesConfig.ts'
 
+/**
+ * Class for downloading and processing design assets from Figma API.
+ * Serves as an abstraction for initializing SVG graphics and frame exports from specified Figma files.
+ *
+ * Класс для скачивания и обработки дизайн-ассетов из Figma API.
+ * Служит абстракцией для инициализации SVG-графики и экспорта кадров из указанных файлов Figma.
+ */
 export class DesignFigma {
+  /** Figma REST API client instance / Экземпляр клиента REST API Figma */
   protected readonly api: FigmaApi
 
+  /**
+   * Creates an instance of DesignFigma.
+   *
+   * Создает экземпляр DesignFigma.
+   * @param fileKey unique Figma file identifier / уникальный идентификатор файла Figma
+   * @param nodeId target node or frame identifier in Figma file / идентификатор целевого узла или кадра в файле Figma
+   * @param token Figma API access token / токен доступа к API Figma
+   */
   constructor(
     protected readonly fileKey: string,
     protected readonly nodeId?: string,
@@ -12,10 +28,21 @@ export class DesignFigma {
     this.api = new FigmaApi(token, fileKey, nodeId)
   }
 
+  /**
+   * Executes the main workflow for retrieving and logging Figma design image assets.
+   *
+   * Выполняет основной процесс получения и логирования графических ассетов дизайна Figma.
+   */
   async make(): Promise<void> {
     console.log('Design Figma', await this.initImage())
   }
 
+  /**
+   * Requests SVG image export URLs for the specified node from Figma API.
+   *
+   * Запрашивает URL-адреса экспорта SVG-изображений для указанного узла через API Figma.
+   * @returns map of node IDs to SVG image URLs, or undefined on error / карта ID узлов к URL SVG-изображений или undefined в случае ошибки
+   */
   async initImage(): Promise<Record<string, string> | undefined> {
     const image = await this.api.fileImages({
       ids: this.nodeId as string,

package/src/classes/Design/DesignTypes.ts

@@ -29,10 +29,12 @@ export class DesignTypes {
    * Конструктор для DesignTypes.
    * @param dir input directory path containing declaration files / входной путь к директории, содержащей файлы деклараций
    * @param promptsDir input directory path containing prompt files / входной путь к директории, содержащей файлы промптов
+   * @param isRaw flag disabling AI processing to create raw types and empty description / флаг отключения ИИ обработки для создания сырых типов и пустого описания
    */
   constructor(
     protected readonly dir: string = 'dist',
-    protected readonly promptsDir: string = 'ai-prompts'
+    protected readonly promptsDir: string = 'ai-resources',
+    protected readonly isRaw: boolean = false
   ) {
     ServerStorage.setErrorStatus(true)
     this.dirArray = this.dir.split('/')
@@ -49,38 +51,43 @@ export class DesignTypes {
     const files = this.getListByFilter()
     const jsFiles = this.getListByFilterJs()
 
-    const fullContent = this.toOneFile(files)
+    const fullContent = this.cleanContent(this.toOneFile(files))
     const fullJsContent = this.toOneFile(jsFiles)
 
-    const aiContent = await this.toAiEdit(fullContent, fullJsContent)
+    const aiContent = this.isRaw
+      ? fullContent
+      : await this.toAiEdit(fullContent, fullJsContent)
+    let fullDescription = ''
+    let mcpPrompts: DesignMcpResources | undefined
+
     this.save(aiContent)
 
-    const aiDescription = await this.toAiDescription(fullContent, fullJsContent)
+    if (!this.isRaw) {
+      const aiDescription = await this.toAiDescription(fullContent, fullJsContent)
 
-    const promptList = this.getListPrompts()
-    const prompts = await this.toAiPrompts(promptList)
+      const promptList = this.getListPrompts()
+      const prompts = await this.toAiPrompts(promptList)
 
-    const fullDescription = `${aiDescription}\n${prompts}`
-    this.saveDescription(fullDescription)
+      fullDescription = `${aiDescription}\n${prompts}`
+
+      const mcpList: DesignTypesList = [
+        {
+          path: UI_FILE_AI_TYPES,
+          content: aiContent
+        },
+        {
+          path: UI_FILE_AI_DESCRIPTION,
+          content: fullDescription
+        },
+        ...promptList
+      ]
 
-    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)
+      mcpPrompts = await this.toAiMcpPrompts(mcpList)
     }
 
+    this.saveDescription(fullDescription)
+    this.saveMcp(mcpPrompts ?? [])
+
     console.log('DesignTypes: AI types saved.')
   }
 
@@ -243,10 +250,11 @@ export class DesignTypes {
     const packageJson = getPackageJson()
 
     if (packageJson) {
+      const versionStr = packageJson.version ? ` (v${packageJson.version})` : ''
       PropertiesFile.writeByPath(
         UI_FILE_AI_TYPES,
         [
-          `All these methods are in the ${packageJson.name} library.`,
+          `All these methods are in the ${packageJson.name}${versionStr} library.`,
           '',
           content
         ].join('\n')
@@ -307,10 +315,15 @@ export class DesignTypes {
     prompt: string,
     code?: string
   ): Promise<string | undefined> {
+    if (this.isRaw) {
+      return undefined
+    }
+
     const ai = useAi()
 
     if (ai) {
       ai.addPrompt('You are a world-class senior developer and an exceptional technical writer.')
+      ai.addPrompt('CRITICAL DIRECTIVE: No data stored in history, previous chat messages, or prior conversation context must influence the result. Process strictly and exclusively the data provided in the text below.')
       ai.addPrompt(prompt)
       ai.addPrompt(`File Content: ${content}`)
 
@@ -328,6 +341,28 @@ export class DesignTypes {
     return undefined
   }
 
+  /**
+   * Cleans up the content by removing imports, local exports, and empty lines.
+   *
+   * Очищает контент, удаляя импорты, локальные экспорты и пустые строки.
+   * @param content content to clean / контент для очистки
+   */
+  protected cleanContent(content: string): string {
+    return content
+      // Remove multi-line and single-line imports (only local files)
+      .replace(/^import\s+(?:{[^}]+}|[^{]+)\s+from\s+['"]\.[^'"]+['"];?/gm, '')
+      .replace(/^import\s+['"]\.[^'"]+['"];?/gm, '')
+      // Remove local internal re-exports (e.g., export * from "./...")
+      .replace(/^export\s+(?:\*|{[^}]+})\s+from\s+['"]\.[^'"]+['"];?/gm, '')
+      // Remove single-line private and protected properties
+      .replace(/^\s*(?:private|protected)\s+[^({]+;/gm, '')
+      // Remove lines that only contain inline comments
+      .replace(/^\s*\/\/.*$/gm, '')
+      // Remove empty lines
+      .replace(/^\s*[\r\n]/gm, '')
+      .trim()
+  }
+
   /**
    * Sends content to AI for optimization.
    *
@@ -408,24 +443,20 @@ export class DesignTypes {
    */
   protected async toAiPrompts(list: DesignTypesList): Promise<string> {
     const projectName = this.getProjectName()
-    const promptList = await Promise.all(
-      forEach(list, async (item) => {
-        const content = await this.toAiPromptName(item.content)
-
-        if (isFilled(content)) {
-          return `- '${UI_MODULES}/${projectName}/${item.path}': ${content}`
-        }
+    const prompts: string[] = []
 
-        return ''
-      })
-    )
+    for (const item of list) {
+      const content = await this.toAiPromptName(item.content)
 
-    const prompts = promptList.filter(Boolean).join('\n')
+      if (isFilled(content)) {
+        prompts.push(`- '${UI_MODULES}/${projectName}/${item.path}': ${content}`)
+      }
+    }
 
-    if (prompts) {
+    if (prompts.length > 0) {
       return '## Mandatory Rules\n'
         + 'Read the corresponding file ONLY when working on a task related to (even if not working directly with this package):\n'
-        + `${prompts}`
+        + `${prompts.join('\n')}`
     }
 
     return ''
@@ -440,18 +471,19 @@ export class DesignTypes {
   protected async toAiPromptName(content: string): Promise<string> {
     const generate = await this.toAi(
       content,
-      'Goal: Generate an EXTREMELY SHORT, high-density topic summary for an AI coding assistant describing what rules/topics are covered in this prompt document.\n\n'
+      'Goal: Generate an EXTREMELY SHORT, high-density trigger and topic summary for an AI coding assistant describing what rules/topics are covered AND under what specific tasks, conditions, or use cases this document must be studied.\n\n'
       + 'CRITICAL RESTRICTIONS:\n'
-      + '- The output MUST be EXTREMELY CONCISE: 1 short sentence or clause (maximum 10-15 words).\n'
-      + '- Do NOT include repetitive filler like "When working with...", "you MUST study this document", or "in order to follow...".\n'
+      + '- The output MUST be EXTREMELY CONCISE: 1-2 short sentence or clause (maximum 30-35 words).\n'
+      + '- Clearly specify BOTH the key topics/rules AND the specific scenarios, tasks, or triggers when this document must be read.\n'
+      + '- Do NOT include repetitive filler like "you MUST study this document", "in order to follow...", or "when working with...".\n'
       + '- Analyze ONLY the text explicitly provided in this prompt.\n'
       + '- Do NOT include file paths, URLs, quotes, or markdown syntax.\n\n'
       + 'EXAMPLES OF GOOD OUTPUT:\n'
-      + '- "Class structure, typing standards, SSR safety, and primitive helpers"\n'
-      + '- "HTTP client, storage management, localization, and DOM event helpers"\n'
-      + '- "MDX documentation generation rules for TypeScript classes"\n\n'
+      + '- "Class structure, typing standards, SSR safety, and primitive utility functions"\n'
+      + '- "HTTP client, storage management, localization formatting, and DOM event helpers"\n'
+      + '- "Implementing or wrapping D1 components, slot/event types, or customizing theme variables"\n\n'
       + 'OUTPUT REQUIREMENTS:\n'
-      + 'Return ONLY the resulting short topic summary. No markdown code blocks (```), no labels, no quotes, and no conversational text.'
+      + 'Return ONLY the resulting short trigger and topic summary. No markdown code blocks (```), no labels, no quotes, and no conversational text.'
     )
 
     return generate ?? ''

package/src/classes/Design/DesignWikiStorm.ts

@@ -43,12 +43,12 @@ export class DesignWikiStorm {
 
     if (packageFile) {
       const data: WebTypesVueJson = {
-        $schema: 'https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json',
-        framework: 'vue',
-        name: toCamelCaseFirst(PropertiesConfig.getDesignName()),
-        version: packageFile.version,
+        '$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: {
+        'contributions': {
           html: {
             'description-markup': 'markdown',
             'vue-components': await this.getComponents()

package/src/classes/Design/DesignWikiStormItem.ts

@@ -127,7 +127,7 @@ export class DesignWikiStormItem {
       const slots: WebTypesSlots = []
 
       data.slots.forEach(
-        slot => {
+        (slot) => {
           const vueProperties: WebTypesProperty[] = (slot.properties ?? []).map(p => ({
             name: p.name,
             type: p.type ? this.cleanType(p.type) : undefined,
@@ -160,7 +160,7 @@ export class DesignWikiStormItem {
       const events: WebTypesEventItem[] = []
 
       data.events.forEach(
-        event => {
+        (event) => {
           let typeString = '() => void'
           if (event.properties && event.properties.length > 0) {
             const args = event.properties

package/src/classes/Library/LibraryAiMcpItem.ts

@@ -6,10 +6,10 @@ import {
 
 /**
  * Class representing an MCP item in the AI prompt generation process.
- * Handles reading `ai-mcp.json` configuration files for a package directory.
+ * Handles reading `ai-mcp-resources.json` configuration files for a package directory.
  *
  * Класс, представляющий элемент MCP в процессе создания промпта для ИИ.
- * Управляет чтением конфигурационных файлов `ai-mcp.json` для директории пакета.
+ * Управляет чтением конфигурационных файлов `ai-mcp-resources.json` для директории пакета.
  */
 export class LibraryAiMcpItem {
   /**
@@ -23,19 +23,19 @@ export class LibraryAiMcpItem {
   ) { }
 
   /**
-   * Checks if the ai-mcp.json file exists in the directory.
+   * Checks if the ai-mcp-resources.json file exists in the directory.
    *
-   * Проверяет, существует ли файл ai-mcp.json в директории.
-   * @returns true if ai-mcp.json file exists / true, если файл ai-mcp.json существует
+   * Проверяет, существует ли файл ai-mcp-resources.json в директории.
+   * @returns true if ai-mcp-resources.json file exists / true, если файл ai-mcp-resources.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.
+   * Reads and returns the list of MCP resource definitions from ai-mcp-resources.json.
    *
-   * Читает и возвращает список определений ресурсов MCP из ai-mcp.json.
+   * Читает и возвращает список определений ресурсов MCP из ai-mcp-resources.json.
    * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
    */
   make(): Record<string, any>[] | undefined {

package/src/classes/Library/LibraryAiPrompt.ts

@@ -1,5 +1,5 @@
 import {
-  UI_FILE_AI_MCP,
+  UI_FILE_AI_MCP_ALL,
   UI_FILE_AI_PROMPT_INSTRUCTION,
   UI_FILE_AI_PROMPT_PROMPT,
   UI_MODULES
@@ -243,7 +243,7 @@ ${globalPromptText}
    */
   protected writeMcp(mcpData: Record<string, any>[]): this {
     PropertiesFile.writeByPath(
-      UI_FILE_AI_MCP,
+      UI_FILE_AI_MCP_ALL,
       mcpData
     )
 

package/src/classes/Library/LibraryAiPromptItem.ts

@@ -46,9 +46,9 @@ export class LibraryAiPromptItem {
   }
 
   /**
-   * Reads and returns the list of MCP resource definitions from ai-mcp.json.
+   * Reads and returns the list of MCP resource definitions from ai-mcp-resources.json.
    *
-   * Читает и возвращает список определений ресурсов MCP из ai-mcp.json.
+   * Читает и возвращает список определений ресурсов MCP из ai-mcp-resources.json.
    * @returns list of MCP resource items or undefined / список элементов ресурсов MCP или undefined
    */
   getMcp(): Record<string, any>[] | undefined {
@@ -111,10 +111,10 @@ export class LibraryAiPromptItem {
   }
 
   /**
-   * Checks if the ai-mcp.json file exists.
+   * Checks if the ai-mcp-resources.json file exists.
    *
-   * Проверяет, существует ли файл ai-mcp.json.
-   * @returns true if ai-mcp.json file exists / true, если файл ai-mcp.json существует
+   * Проверяет, существует ли файл ai-mcp-resources.json.
+   * @returns true if ai-mcp-resources.json file exists / true, если файл ai-mcp-resources.json существует
    */
   isMcp(): boolean {
     return this.itemMcp.isMcp()

package/src/config.ts

@@ -121,7 +121,9 @@ export const UI_FILE_AI_TYPES = 'ai-types.md'
 /** AI description file name / Название файла с описанием AI */
 export const UI_FILE_AI_DESCRIPTION = 'ai-description.md'
 /** AI MCP resources file name / Название файла с ресурсами MCP AI */
-export const UI_FILE_AI_MCP = 'ai-mcp.json'
+export const UI_FILE_AI_MCP = 'ai-mcp-resources.json'
+/** AI MCP all resources file name / Название файла со всеми ресурсами MCP AI */
+export const UI_FILE_AI_MCP_ALL = 'ai-mcp-all-resources.json'
 /** Style SCSS file name / Название файла стилей SCSS */
 export const UI_FILE_STYLE_SCSS = 'style.scss'
 /** UI properties SCSS file name / Название файла свойств UI в SCSS */

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

@@ -17,12 +17,12 @@
     "publish-to-npm": "npm publish --access public"
   },
   "files": [
-    "ai-prompts/",
+    "ai-resources/",
     "ai-screenshot/",
     "dist",
     "ai-description.md",
     "ai-doc.md",
-    "ai-mcp.json",
+    "ai-mcp-resources.json",
     "ai-types.md",
     "CHANGELOG.md",
     "LICENSE",

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

@@ -17,5 +17,5 @@ Strictly follow these rules for flawless dxt-ui code:
 7. **Security & Performance**: Error-proof code (`?.`, `??`, guard clauses). Use explicit `try-catch` for async. Never swallow errors. Avoid heavy ops in loops/reactivity.
 8. **Aesthetics & Conciseness**: Group logically. Save tokens by avoiding redundant comments if code is self-explanatory.
 9. **Strict Adherence & Optimization**: Follow instructions precisely without guessing. Propose relevant technical optimizations while strictly adhering to plans.
-10. **AI Workspace Memory (`ai-memory.md`)**: Actively APPLY its rules (highest priority). Update it on developer feedback. **CRITICAL**: Any remark from the developer that has value for the future (e.g., code style, dos and don'ts) MUST be saved here. If the developer explicitly asks to save or remember something, you MUST save it. Do NOT store change logs or absolute paths (use relative). Keep it focused strictly on architectural constraints and developer preferences.
+10. **AI Workspace Memory (`ai-memory.md`)**: Actively APPLY its rules (highest priority). Update local `ai-memory.md` **ONLY** upon explicit developer command (e.g., "remember", "save to memory") or for critical architectural rules/fixes. **STRICTLY FORBIDDEN** to overwrite or delete existing file contents: you MUST **ONLY append** new directives to the end of the file. Do NOT add routine edits indiscriminately, change logs, or absolute paths (use relative only). Keep it focused strictly on critical architectural constraints and explicit developer instructions.
 11. **Mandatory Full-File Self-Audit**: When creating new entities, you MUST audit the ENTIRE file (not just modified parts) to ensure no logic duplication (DRY) and full compliance with project rules. *Exception: minor bug fixes to existing code do not require a full audit.*

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

@@ -17,5 +17,5 @@
 7. **Безопасность и Производительность**: Защищенный код (`?.`, `??`, guard clauses). Явный `try-catch` для асинхронности. Не скрывай ошибки. Избегай тяжелых операций в циклах/реактивности.
 8. **Эстетика и Лаконичность**: Логическая группировка. Экономь токены, избегая избыточных комментариев, если код очевиден.
 9. **Строгое следование инструкциям**: Выполняй команды без додумывания, но предлагай уместные технические оптимизации, придерживаясь плана.
-10. **Память ИИ (`ai-memory.md`)**: Активно ПРИМЕНЯЙ ее правила (высший приоритет). Обновляй при правках от разработчика. **ВАЖНО**: Любое замечание от разработчика, которое имеет ценность для будущего (например, стиль кода, что надо делать, а что нет), ДОЛЖНО быть сохранено здесь. Также, если разработчик просит сохранить или запомнить какую-либо информацию, ты ОБЯЗАН это сделать. ЗАПРЕЩЕНО хранить историю изменений (changelogs) и абсолютные пути (только относительные). Только актуальные стандарты и предпочтения разработчика.
+10. **Память ИИ (`ai-memory.md`)**: Активно ПРИМЕНЯЙ ее правила (высший приоритет). Обновляй локальный `ai-memory.md` **ТОЛЬКО** по явной команде разработчика (напр., «запомни», «сохрани в память») или при критических архитектурных правках/правилах. **СТРОГО ЗАПРЕЩЕНО** полностью переписывать или удалять содержимое файла: записи разрешено **ТОЛЬКО дополнять** (append) в конец существующего содержимого. ЗАПРЕЩЕНО добавлять всё подряд, историю изменений (changelogs) и абсолютные пути (только относительные). Храни только действительно важные архитектурные ограничения и явные указания разработчика.
 11. **Обязательный полный самоаудит**: При создании новых сущностей ОБЯЗАТЕЛЬНО проверяй ВЕСЬ файл целиком. Строго контролируй отсутствие дублирования (DRY) и соблюдение всех правил проекта. *Исключение: мелкие правки существующего кода не требуют полного аудита.*

package/src/types/webTypes.ts

@@ -120,12 +120,12 @@ export type WebTypesVueComponentItem = WebTypesInfo & {
  * Корневой объект для JSON Web Types.
  */
 export type WebTypesVueJson = {
-  $schema: string
-  framework: 'vue'
-  name: string
-  version: string
+  '$schema': string
+  'framework': 'vue'
+  'name': string
+  'version': string
   'js-types-syntax'?: 'typescript'
-  contributions: {
+  'contributions': {
     html: {
       'description-markup': 'markdown'
       'vue-components': WebTypesVueComponentItem[]