@dxtmisha/scripts 0.4.5 → 0.4.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.4.5",
+  "version": "0.4.7",
   "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/Library/LibraryExport.ts

@@ -48,7 +48,7 @@ export class LibraryExport {
    * @param path filename/ имя файла
    */
   protected isExport(path: string | string[]): boolean {
-    return !this.getFile(path).match(UI_FLAG_NOT_EXPORT)
+    return !PropertiesFile.joinPath(path).match('.test.') && !this.getFile(path).match(UI_FLAG_NOT_EXPORT)
   }
 
   /**

package/src/classes/Properties/to/PropertiesToLink.ts

@@ -114,8 +114,9 @@ export class PropertiesToLink extends PropertiesToAbstract {
             this.addIgnore(data.value)
           }
         } else {
-          expect = true
-          break
+          // TODO: зачем это надо?
+          // expect = true
+          // break
         }
       } else if (
         isObjectNotArray(item.value)

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

@@ -131,29 +131,101 @@ Document structure (strict):
 
 **3. Special sections (if present):**
 
-**Props (only for complex cases):**
-- Describe Props only if they have complex interaction logic, dependencies, or composite types
-- DO NOT describe simple boolean/string props in a list - JSDoc comments in types are enough for them
-- Format: `## Props`, then `### PropName` for each complex prop
+Instead of simply listing Props, describe **specific component capabilities**.
+
+Each section should:
+- Have a second-level heading (`##`) describing the capability, not just the prop name
+- Briefly explain the purpose and behavior of the functionality
+- List related properties (if there are several)
+- Describe property interaction with each other and their effect on the component
+- Include usage examples with code
+
+**Capability description format:**
 
-Example of complex prop description:
 ```md
-## Props
-### `adaptive`
+## Capability Name
+
+Brief description of the capability and its purpose (1-2 paragraphs).
+
+**Properties:** (if several related properties)
+
+- `propName` — property description
+- `propName2` — property description
+
+**Possible values:** (for enum/union types)
+
+- `'value1'` — value description and its behavior
+- `'value2'` — value description and its behavior
+
+Additional description of behavior, property interaction, features, and limitations.
 
-Window adaptive behavior mode.
+[code examples]
+```
+
+**Examples of correct capability descriptions:**
 
-**Type:** `'modal' | 'menu' | 'actionSheet' | 'static'`
+```md
+## Header Position Animation
 
-**Default:** `'modal'`
+The `animationHeadPosition` property defines the behavior of the Head area during show/hide animations.
 
 **Possible values:**
-- `'modal'` — modal window in screen center with overlay
-- `'menu'` — dropdown menu attached to control element
-- `'actionSheet'` — bottom panel for mobile interfaces
-- `'static'` — static mode without overlay and positioning
+
+- `'top'` — keeps Head at the top during transition (default)
+- `'toBottom'` — animates Head down along with content
+
+Synchronizes header movement with content animation using CSS transforms for smooth transitions.
+
+[code example]
+```
+
+```md
+## Navigation and Arrows
+
+Properties `arrowCarousel`, `arrowStepper`, `disabledPrevious`, `disabledNext`, and `align` are designed for managing built-in navigation elements and content alignment.
+
+**Properties:**
+
+- `arrowCarousel` — enables navigation arrows (left/right) for switching elements
+- `arrowStepper` — enables numeric step buttons (minus/plus)
+- `disabledPrevious` — disables left button (back/minus)
+- `disabledNext` — disables right button (forward/plus)
+- `align` — horizontal content alignment (`left`, `center`, `right`)
+
+Properties work together: only one arrow mode is active — if `arrowCarousel = true`, `arrowStepper` mode is ignored and vice versa.
+
+[code example]
+```
+
+```md
+## Outline Buttons
+
+Button component supports outline mode via the `outline` property. In this mode, buttons have a minimalist visual style with transparent background and colored border:
+
+- **Minimalist design** - suitable for interfaces requiring reduced visual load
+- **Transparent background** - maintains clean appearance while remaining interactive
+- **Hover feedback** - background appears on hover for better user interaction
+
+Outline mode is especially useful for creating tertiary actions and secondary options.
+
+[code example]
 ```
 
+**When NOT to describe Props in separate sections:**
+
+- Simple boolean/string/number properties without complex logic — JSDoc comments in types are sufficient
+- Properties with obvious behavior (e.g., `disabled`, `label`, `placeholder`)
+- Single independent properties without interaction with others
+
+**When to describe capabilities in separate sections:**
+
+- Properties with complex interaction logic (e.g., `cancel` and `cancelShow`)
+- Groups of related properties working together (e.g., navigation arrows)
+- Properties with multiple operation modes (e.g., `adaptive` with different values)
+- Properties affecting other component parts or having priority over others
+- Component display modes (e.g., `primary`, `secondary`, `outline`)
+- CSS classes for behavior control
+
 **4. Mandatory sections (if present in component):**
 
 **Expose methods/properties:**
@@ -274,39 +346,45 @@ Component uses special CSS classes for behavior control:
 
 Where `*` is the component class name (e.g., `d1-window`, `m3-window`).
 
-## Props
-### `adaptive`
+## Header Position Animation
 
-Window adaptive behavior mode.
+The `animationHeadPosition` property defines the behavior of the Head area during show/hide animations.
 
-**Type:** `'modal' | 'menu' | 'actionSheet' | 'static'`
+**Possible values:**
 
-**Default:** `'modal'`
+- `'top'` — keeps Head at the top during transition (default)
+- `'toBottom'` — animates Head down along with content
 
-**Possible values:**
-- `'modal'` — modal window in screen center
-- `'menu'` — dropdown menu attached to element
-- `'actionSheet'` — bottom panel for mobile devices
-- `'static'` — static mode without overlay
+Synchronizes header movement with content animation using CSS transforms for smooth transitions.
 
-## State Management via v-model
+```html
+<template>
+  <Window v-model:open="isOpen" :animationHeadPosition="'toBottom'">
+    <template #default>
+      <p>Window content</p>
+      <button @click="isOpen = false">Close</button>
+    </template>
+  </Window>
+</template>
+```
 
-Two-way binding of window open state via `v-model:open`.
+## Navigation and Arrows
 
-**Parameters:**
-- `open: boolean` — window open state
+Properties `arrowCarousel`, `arrowStepper`, `disabledPrevious`, `disabledNext`, and `align` are designed for managing built-in navigation elements and content alignment.
 
-```html
-<script setup>
-import { ref } from 'vue'
+**Properties:**
 
-const isOpen = ref(false)
-</script>
+- `arrowCarousel` — enables navigation arrows (left/right) for switching elements
+- `arrowStepper` — enables numeric step buttons (minus/plus)
+- `disabledPrevious` — disables left button (back/minus)
+- `disabledNext` — disables right button (forward/plus)
+- `align` — horizontal content alignment (`left`, `center`, `right`)
 
-<template>
-  <button @click="isOpen = true">Open</button>
+Properties work together: only one arrow mode is active — if `arrowCarousel = true`, `arrowStepper` mode is ignored and vice versa.
 
-  <Window v-model:open="isOpen">
+```html
+<template>
+  <Window v-model:open="isOpen" :arrowCarousel="true" :align="'center'">
     <template #default>
       <p>Window content</p>
       <button @click="isOpen = false">Close</button>
@@ -315,6 +393,22 @@ const isOpen = ref(false)
 </template>
 ```
 
+## Outline Buttons
+
+Button component supports outline mode via the `outline` property. In this mode, buttons have a minimalist visual style with transparent background and colored border:
+
+- **Minimalist design** - suitable for interfaces requiring reduced visual load
+- **Transparent background** - maintains clean appearance while remaining interactive
+- **Hover feedback** - background appears on hover for better user interaction
+
+Outline mode is especially useful for creating tertiary actions and secondary options.
+
+```html
+<template>
+  <Button outline @click="handleClick">Click me</Button>
+</template>
+```
+
 ## Expose Methods
 ### `id`
 

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

@@ -133,29 +133,101 @@ export const WithIcon: Story = {
 
 **3. Специальные разделы (если есть):**
 
-**Props (только для сложных случаев):**
-- Описывай Props только если они имеют сложную логику взаимодействия, зависимости или составные типы
-- НЕ описывай простые boolean/string props списком - для них достаточно JSDoc комментариев в типах
-- Формат: `## Props`, затем `### НазваниеProp` для каждого сложного prop
+Вместо простого перечисления Props, описывай **конкретные возможности компонента**.
+
+Каждый раздел должен:
+- Иметь заголовок второго уровня (`##`), описывающий возможность, а не просто название prop
+- Кратко объяснять назначение и поведение функциональности
+- Перечислять связанные свойства (если их несколько)
+- Описывать взаимодействие свойств между собой и их влияние на компонент
+- Включать примеры использования с кодом
+
+**Формат описания возможности:**
 
-Пример описания сложного prop:
 ```md
-## Props
-### `adaptive`
+## Название возможности
+
+Краткое описание возможности и её назначения (1-2 абзаца).
+
+**Свойства:** (если несколько связанных свойств)
+
+- `propName` — описание свойства
+- `propName2` — описание свойства
+
+**Возможные значения:** (для enum/union типов)
+
+- `'value1'` — описание значения и его поведения
+- `'value2'` — описание значения и его поведения
 
-Режим адаптивного поведения окна.
+Дополнительное описание поведения, взаимодействия свойств, особенностей и ограничений.
 
-**Тип:** `'modal' | 'menu' | 'actionSheet' | 'static'`
+[примеры кода]
+```
+
+**Примеры правильного описания возможностей:**
+
+```md
+## Анимация позиции заголовка
 
-**По умолчанию:** `'modal'`
+Свойство `animationHeadPosition` определяет поведение области Head во время анимаций показа/скрытия.
 
 **Возможные значения:**
-- `'modal'` — модальное окно по центру экрана с оверлеем
-- `'menu'` — выпадающее меню, привязанное к элементу управления
-- `'actionSheet'` — нижняя панель для мобильных интерфейсов
-- `'static'` — статичный режим без оверлея и позиционирования
+
+- `'top'` — сохраняет Head вверху во время перехода (по умолчанию)
+- `'toBottom'` — анимирует Head вниз вместе с контентом
+
+Синхронизирует движение заголовка с анимацией контента, используя CSS-трансформации для плавных переходов.
+
+[код примера]
 ```
 
+```md
+## Навигация и стрелки
+
+Свойства `arrowCarousel`, `arrowStepper`, `disabledPrevious`, `disabledNext` и `align` предназначены для управления встроенными элементами навигации и выравнивания содержимого.
+
+**Свойства:**
+
+- `arrowCarousel` — включает стрелки навигации (влево/вправо) для переключения элементов
+- `arrowStepper` — включает числовые шаговые кнопки (минус/плюс)
+- `disabledPrevious` — отключает левую кнопку (назад/минус)
+- `disabledNext` — отключает правую кнопку (вперёд/плюс)
+- `align` — горизонтальное выравнивание содержимого (`left`, `center`, `right`)
+
+Свойства работают совместно: активен только один режим стрелок — если `arrowCarousel = true`, режим `arrowStepper` игнорируется и наоборот.
+
+[код примера]
+```
+
+```md
+## Контурные кнопки (outline)
+
+Компонент Button поддерживает контурный режим через свойство `outline`. В этом режиме кнопки имеют минималистичный визуальный стиль с прозрачным фоном и цветной границей:
+
+- **Минималистичный дизайн** - подходит для интерфейсов, требующих сниженной визуальной нагрузки
+- **Прозрачный фон** - поддерживает чистый внешний вид, оставаясь интерактивными
+- **Обратная связь при наведении** - фон появляется при наведении
+
+Outline режим особенно полезен для создания третичных действий и второстепенных опций.
+
+[код примера]
+```
+
+**Когда НЕ нужно описывать Props отдельными разделами:**
+
+- Простые boolean/string/number свойства без сложной логики — достаточно JSDoc комментариев в типах
+- Свойства с очевидным поведением (например, `disabled`, `label`, `placeholder`)
+- Единичные независимые свойства без взаимодействия с другими
+
+**Когда НУЖНО описывать возможности отдельными разделами:**
+
+- Свойства со сложной логикой взаимодействия (например, `cancel` и `cancelShow`)
+- Группы связанных свойств, работающих вместе (например, стрелки навигации)
+- Свойства с несколькими режимами работы (например, `adaptive` с разными значениями)
+- Свойства, влияющие на другие части компонента или имеющие приоритет над другими
+- Режимы отображения компонента (например, `primary`, `secondary`, `outline`)
+- CSS классы для управления поведением
+
 **4. Обязательные секции (если присутствуют в компоненте):**
 
 **Expose методы/свойства:**
@@ -276,45 +348,63 @@ Window управляет отображением контента поверх
 
 Где `*` — название класса компонента (например, `d1-window`, `m3-window`).
 
-## Props
-### `adaptive`
+## Анимация позиции заголовка
 
-Режим адаптивного поведения окна.
+Свойство `animationHeadPosition` определяет поведение области Head во время анимаций показа/скрытия.
 
-**Тип:** `'modal' | 'menu' | 'actionSheet' | 'static'`
+**Возможные значения:**
 
-**По умолчанию:** `'modal'`
+- `'top'` — сохраняет Head вверху во время перехода (по умолчанию)
+- `'toBottom'` — анимирует Head вниз вместе с контентом
 
-**Возможные значения:**
-- `'modal'` — модальное окно по центру экрана
-- `'menu'` — выпадающее меню, привязанное к элементу
-- `'actionSheet'` — нижняя панель для мобильных устройств
-- `'static'` — статичный режим без оверлея
+Синхронизирует движение заголовка с анимацией контента, используя CSS-трансформации для плавных переходов.
 
-## Управление состоянием через v-model
+```html
+<Window
+  v-slot:default="{ animationHeadPosition }"
+  :style="{ '--head-animation': animationHeadPosition }"
+>
+  <Header>Заголовок</Header>
+  <Content>Содержимое</Content>
+</Window>
+```
 
-Двусторонняя привязка состояния открытия окна через `v-model:open`.
+## Навигация и стрелки
 
-**Параметры:**
-- `open: boolean` — состояние открытия окна
+Свойства `arrowCarousel`, `arrowStepper`, `disabledPrevious`, `disabledNext` и `align` предназначены для управления встроенными элементами навигации и выравнивания содержимого.
+
+**Свойства:**
+
+- `arrowCarousel` — включает стрелки навигации (влево/вправо) для переключения элементов
+- `arrowStepper` — включает числовые шаговые кнопки (минус/плюс)
+- `disabledPrevious` — отключает левую кнопку (назад/минус)
+- `disabledNext` — отключает правую кнопку (вперёд/плюс)
+- `align` — горизонтальное выравнивание содержимого (`left`, `center`, `right`)
+
+Свойства работают совместно: активен только один режим стрелок — если `arrowCarousel = true`, режим `arrowStepper` игнорируется и наоборот.
 
 ```html
-<script setup>
-import { ref } from 'vue'
+<Window
+  v-slot:default="{ arrowCarousel, arrowStepper }"
+  :arrow-carousel="arrowCarousel"
+  :arrow-stepper="arrowStepper"
+>
+  <Content>Содержимое</Content>
+</Window>
+```
 
-const isOpen = ref(false)
-</script>
+## Контурные кнопки (outline)
 
-<template>
-  <button @click="isOpen = true">Открыть</button>
+Компонент Button поддерживает контурный режим через свойство `outline`. В этом режиме кнопки имеют минималистичный визуальный стиль с прозрачным фоном и цветной границей:
 
-  <Window v-model:open="isOpen">
-    <template #default>
-      <p>Содержимое окна</p>
-      <button @click="isOpen = false">Закрыть</button>
-    </template>
-  </Window>
-</template>
+- **Минималистичный дизайн** - подходит для интерфейсов, требующих сниженной визуальной нагрузки
+- **Прозрачный фон** - поддерживает чистый внешний вид, оставаясь интерактивными
+- **Обратная связь при наведении** - фон появляется при наведении
+
+Outline режим особенно полезен для создания третичных действий и второстепенных опций.
+
+```html
+<Button outline>Контурная кнопка</Button>
 ```
 
 ## Expose методы