@dxtmisha/scripts 0.8.1 → 0.8.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.8.1",
+  "version": "0.8.3",
   "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/Design/DesignComponent.ts

@@ -793,7 +793,7 @@ export class DesignComponent extends DesignCommand {
     this.updatePackage(
       `exports|${name}`,
       {
-        types: `./dist/library/${this.getFullName()}.d.ts`,
+        types: `./dist/src/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/constructors/${command}/index.d.ts`,
+        types: `./dist/src/constructors/${command}/index.d.ts`,
         default: `./dist/${this.getNameMin()}.js`
       }
     )

package/src/classes/Design/DesignReplace.ts

@@ -215,7 +215,7 @@ export class DesignReplace {
         && !this.isNoMark(mark, name)
       ) {
         const typesString = !constructor && !types.match(/string|boolean/) && types.match(/'/)
-          ? `string | ${types}`
+          ? `${types}` // string |
           : types
 
         templates.push(`${name}?: ${typesString}`)

package/src/classes/Design/DesignUi.ts

@@ -106,15 +106,15 @@ export class DesignUi {
 
     if (packageJson?.exports) {
       packageJson.exports['.'] = {
-        types: './dist/library/types.d.ts',
+        types: './dist/src/library/types.d.ts',
         default: './dist/types.js'
       }
       packageJson.exports['./plugin'] = {
-        types: './dist/library/plugin.d.ts',
+        types: './dist/src/library/plugin.d.ts',
         default: './dist/plugin.js'
       }
       packageJson.exports['./media'] = {
-        types: './dist/library/media.d.ts',
+        types: './dist/src/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/library/types.d.ts'
+      packageJson.exports['./types.d.ts'] = './dist/src/library/types.d.ts'
       packageJson['web-types'] = './dist/web-types.json'
 
       PropertiesFile.writeByPath(UI_FILE_PACKAGE, packageJson)

package/src/classes/Design/DesignWikiStormItem.ts

@@ -7,6 +7,13 @@ import { PropertiesFile } from '../Properties/PropertiesFile'
 
 import type { LibraryData } from '../../types/libraryTypes'
 import type { WebTypesAttributeItem, WebTypesAttributes, WebTypesEvents, WebTypesSlots, WebTypesTagItem } from '../../types/webTypes'
+import { forEach } from '@dxtmisha/functional-basic'
+
+/**
+ * List of basic types that do not need to be wrapped in quotes for web-types/
+ * Список базовых типов, которые не нужно оборачивать в кавычки для web-types
+ */
+const BASE_TYPES = /^(boolean|number|string|null|any|void|object|unknown|never)$/
 
 /**
  * Resolver for extracting and formatting IDE metadata for a specific component.
@@ -78,13 +85,14 @@ export class DesignWikiStormItem {
    * @param item prop item / элемент свойства
    */
   getAttribute(item: WikiStorybookProp): WebTypesAttributeItem {
+    const type = this.prepareType(item.getType())
     return {
       name: item.getName(),
       description: item.getDescription(),
-      default: item.getDefaultValue(),
+      // default: item.getDefaultValue(),
       value: {
         kind: 'expression',
-        type: item.getType()
+        type
       }
     }
   }
@@ -120,8 +128,8 @@ export class DesignWikiStormItem {
 
       data.slots.forEach(
         props => slots.push({
-          name: props.name,
-          description: props.description,
+          'name': props.name,
+          'description': props.description,
           'vue-properties': props.properties ?? []
         })
       )
@@ -186,10 +194,12 @@ export class DesignWikiStormItem {
       const filePath = this.getPaths(['wikiData.ts'])
 
       if (PropertiesFile.is(filePath)) {
-        const wiki: Record<string, any> = await import(filePath.join('/'))
-        const data: WikiDataItem | undefined = Object.values(wiki).find(item => 'component' in item)
-
-        this.dataComponent = data
+        try {
+          const wiki: Record<string, any> = await import(filePath.join('/'))
+          this.dataComponent = Object.values(wiki).find(item => 'component' in item)
+        } catch (error) {
+          console.error(filePath, error)
+        }
       }
     }
 
@@ -222,6 +232,36 @@ export class DesignWikiStormItem {
     ]
   }
 
+  /**
+   * Formats a type string for web-types.
+   *
+   * Форматирует строку типа для web-types.
+   * @param type original type string / исходная строка типа
+   */
+  protected prepareType(type?: string): string | undefined {
+    if (type) {
+      return forEach(
+        type.split('|'),
+        (item) => {
+          const trimmed = item.trim()
+
+          if (trimmed === 'undefined') {
+            return undefined
+          }
+
+          if (BASE_TYPES.test(trimmed)) {
+            return trimmed
+          }
+
+          return `'${trimmed}'`
+        }
+      )
+        .join(' | ')
+    }
+
+    return type
+  }
+
   /**
    * Initializes the wiki object.
    *

package/src/classes/Library/LibraryAiPrompt.ts

@@ -8,6 +8,7 @@ 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'
 
 const LIBRARY_AI_PROMPT_LIST_DIRS = [
   UI_MODULES
@@ -65,6 +66,7 @@ It is critically important to strictly follow all the prompts and instructions l
 - If you do not know something or lack information, state it explicitly rather than making assumptions.
 - Be sure to study package.json to know which packages are available and rely exclusively on them when writing code.
       `.trim(),
+      this.getGlobalPrompt(),
       this.getVuePrompt()
     ]
 
@@ -133,6 +135,21 @@ ${vuePromptText}
     `.trim()
   }
 
+  /**
+   * Retrieves the global code implementation prompt.
+   *
+   * Получает глобальный промпт по реализации кода.
+   * @returns formatted global prompt or undefined / отформатированный глобальный промпт или undefined
+   * @protected
+   */
+  protected getGlobalPrompt(): string {
+    return `
+## Global code implementation rules
+The global rules for code implementation are listed below. These instructions are mandatory for ensuring high-quality, professional-grade development across the entire project.
+${globalPromptText}
+    `.trim()
+  }
+
   /**
    * Recursively scans directories to collect LibraryAiPromptItem instances.
    *

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

@@ -0,0 +1,40 @@
+### Global Development Principles (AI Code Promise)
+
+Your primary goal is to generate flawless, industrial-grade code that adheres to dxt-ui standards. You promise to follow these rules strictly:
+
+1. **"Copy-Paste Ready" Principle**:
+   - Generate code that can be copied and run without a single manual edit.
+   - All imports must be absolute or correct relative paths.
+   - No `// ... rest of the code`, no `// imports here`. Only the complete, working file.
+
+2. **Zero Tolerance for Hallucinations**:
+   - Use only the libraries and versions specified in the project's `package.json`.
+   - Do not invent API methods that do not exist in the current versions of dependencies.
+   - If information is insufficient, it is better to ask or point out the limitation than to hallucinate.
+
+3. **Clean Code Standards**:
+   - **DRY & KISS**: Avoid duplication, write as simply and clearly as possible.
+   - **SOLID**: Every module, class, or function must have one clear responsibility.
+   - **Declarative Approach**: Prefer a declarative programming style (array functional methods, composition).
+
+4. **Uncompromising TypeScript**:
+   - No `any`. Use `unknown` if the type is truly unknown, or create generic types.
+   - Always define interfaces for input and output data.
+   - Use `as const`, `readonly`, and enums/union types to increase reliability.
+
+5. **Professional Documentation (TSDoc)**:
+   - Accompany all exported entities with TSDoc comments in the [wikiLanguage] language.
+   - Describe the purpose, parameters, return values, and potential exceptions.
+   - Usage examples in comments are encouraged for complex functions.
+
+6. **Architectural Consistency**:
+   - Respect the project structure. If it is standard in the project to move logic into `composables` or `utils`, follow that pattern.
+   - Do not modify global styles or styles of base UI components unless explicitly requested.
+
+7. **Security and Performance**:
+   - Write error-proof code (guard clauses, optional chaining `?.`, nullish coalescing `??`).
+   - Avoid redundant calculations in loops and heavy operations in reactive dependencies.
+
+8. **Aesthetics and Conciseness**:
+   - The code must be beautiful. Use logical indentation and group code by meaning.
+   - Save tokens by avoiding redundant comments where the code speaks for itself.

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

@@ -0,0 +1,40 @@
+### Глобальные принципы разработки (AI Code Promise)
+
+Твоя главная цель — генерировать безупречный, промышленный код, который соответствует стандартам dxt-ui. Ты обещаешь следовать этим правилам неукоснительно:
+
+1. **Принцип «Copy-Paste Ready» (Готовность к использованию)**:
+   - Генерируй код, который можно скопировать и запустить без единой правки.
+   - Все импорты должны быть абсолютными или корректными относительными.
+   - Никаких `// ... остальной код`, никаких `// импорты здесь`. Только полный, рабочий файл.
+
+2. **Нулевая толерантность к галлюцинациям**:
+   - Используй только те библиотеки и версии, которые указаны в `package.json` проекта.
+   - Не выдумывай методы API, которых не существует в текущих версиях зависимостей.
+   - Если информации недостаточно — лучше спроси или укажи на ограничение, чем галлюцинируй.
+
+3. **Стандарты чистого кода (Clean Code)**:
+   - **DRY & KISS**: Избегай дублирования, пиши максимально просто и понятно.
+   - **SOLID**: Каждый модуль, класс или функция должны иметь одну четкую ответственность.
+   - **Декларативность**: Отдавай предпочтение декларативному стилю программирования (функциональные методы массивов, композиция).
+
+4. **Бескомпромиссный TypeScript**:
+   - Никаких `any`. Используй `unknown`, если тип действительно неизвестен, или создавай generic-типы.
+   - Всегда определяй интерфейсы для входных и выходных данных.
+   - Используй `as const`, `readonly` и перечисления (enums/union types) для повышения надежности.
+
+5. **Профессиональное документирование (TSDoc)**:
+   - Сопровождай все экспортируемые сущности комментариями TSDoc на [wikiLanguage] языке.
+   - Описывай назначение, параметры, возвращаемые значения и возможные исключения.
+   - Примеры использования в комментариях приветствуются для сложных функций.
+
+6. **Архитектурная консистентность**:
+   - Соблюдай структуру проекта. Если в проекте принято выносить логику в `composables` или `utils` — следуй этому паттерну.
+   - Не изменяй глобальные стили или стили базовых UI-компонентов, если это не было явно запрошено.
+
+7. **Безопасность и Производительность**:
+   - Пиши код, защищенный от ошибок (guard clauses, опциональная цепочка `?.`, nullish coalescing `??`).
+   - Избегай лишних вычислений в циклах и тяжелых операций в реактивных зависимостях.
+
+8. **Эстетика и Лаконичность**:
+   - Код должен быть красивым. Используй логические отступы и группировку кода по смыслу.
+   - Экономь токены, избегая избыточных комментариев там, где код говорит сам за себя.

package/src/types/webTypes.ts

@@ -25,7 +25,7 @@ export type WebTypesProperties = WebTypesProperty[]
  *
  * Вид значения атрибута.
  */
-export type WebTypesAttributeKind = 'expression' | 'string'
+export type WebTypesAttributeKind = 'expression' | 'plainText' | 'string'
 
 /**
  * Attribute definition for a tag.