@dxtmisha/scripts 0.4.7 → 0.5.0

package/src/media/templates/prompts/demoComposableEn.mdx

@@ -0,0 +1,103 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title="[title]" />
+
+# Composable useToggle
+
+Composable for managing boolean state with extended toggle methods. Provides a convenient interface for working with visibility flags, modals, and other toggleable states.
+
+## Key Features
+
+- **Simple toggling** — intuitive API for state changes
+- **Explicit methods** — separate functions for setting true/false
+- **Argument support** — ability to set specific value via toggle
+- **Full reactivity** — based on Vue Reactivity API
+- **Type safety** — strict typing of parameters and return values
+
+## Function
+
+### `useToggle`
+
+Creates a boolean state management object.
+
+**Parameters:**
+- `initialValue: boolean` — initial state value (default `false`)
+
+**Returns:** `UseToggleReturn` — object with state and management methods
+
+**UseToggleReturn:**
+- `value: Ref<boolean>` — reactive value
+- `toggle: (nextValue?: boolean) => void` — toggles value or sets the passed one
+- `setTrue: () => void` — sets value to true
+- `setFalse: () => void` — sets value to false
+
+```javascript
+import { useToggle } from '@dxtmisha/demo'
+
+// Initialization
+const { value, toggle } = useToggle(false)
+
+// Usage
+toggle() // value becomes true
+```
+
+## Basic Usage
+
+### Basic Management
+
+```javascript
+import { useToggle } from '@dxtmisha/demo'
+
+const { value: isMenuOpen, toggle, setFalse: closeMenu } = useToggle()
+
+// Open menu
+toggle()
+
+// Close menu (explicit action)
+closeMenu()
+```
+
+### Usage with v-if
+
+```javascript
+import { useToggle } from '@dxtmisha/demo'
+
+export default {
+  setup() {
+    const { value: showDetails, toggle } = useToggle(false)
+
+    return { showDetails, toggle }
+  }
+}
+
+// Template:
+// <button @click="toggle()">
+//   {{ showDetails ? 'Hide' : 'Show' }} details
+// </button>
+// <div v-if="showDetails">
+//   Detailed information...
+// </div>
+```
+
+## Working with Data Types
+
+### Renaming
+
+```javascript
+// Destructuring allows giving meaningful names
+const {
+  value: isLoading,
+  setTrue: startLoading,
+  setFalse: stopLoading
+} = useToggle(false)
+
+const loadData = async () => {
+  startLoading()
+  try {
+    await api.getData()
+  } finally {
+    stopLoading()
+  }
+}
+```
+

package/src/media/templates/prompts/demoComposableRu.mdx

@@ -0,0 +1,103 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title="[title]" />
+
+# Композабл useToggle
+
+Композабл для управления булевым состоянием с расширенными методами переключения. Предоставляет удобный интерфейс для работы с флагами видимости, модальными окнами и другими переключаемыми состояниями.
+
+## Основные возможности
+
+- **Простое переключение** — интуитивное API для смены состояния
+- **Явные методы** — отдельные функции для установки true/false
+- **Поддержка аргументов** — возможность установки конкретного значения через toggle
+- **Полная реактивность** — базируется на Vue Reactivity API
+- **Типобезопасность** — строгая типизация параметров и возвращаемых значений
+
+## Функция
+
+### `useToggle`
+
+Создаёт объект управления булевым состоянием.
+
+**Параметры:**
+- `initialValue: boolean` — начальное значение состояния (по умолчанию `false`)
+
+**Возвращает:** `UseToggleReturn` — объект с состоянием и методами управления
+
+**UseToggleReturn:**
+- `value: Ref<boolean>` — реактивное значение
+- `toggle: (nextValue?: boolean) => void` — переключает значение или устанавливает переданное
+- `setTrue: () => void` — устанавливает значение в true
+- `setFalse: () => void` — устанавливает значение в false
+
+```javascript
+import { useToggle } from '@dxtmisha/demo'
+
+// Инициализация
+const { value, toggle } = useToggle(false)
+
+// Использование
+toggle() // value становится true
+```
+
+## Основное использование
+
+### Базовое управление
+
+```javascript
+import { useToggle } from '@dxtmisha/demo'
+
+const { value: isMenuOpen, toggle, setFalse: closeMenu } = useToggle()
+
+// Открыть меню
+toggle()
+
+// Закрыть меню (явное действие)
+closeMenu()
+```
+
+### Использование с v-if
+
+```javascript
+import { useToggle } from '@dxtmisha/demo'
+
+export default {
+  setup() {
+    const { value: showDetails, toggle } = useToggle(false)
+
+    return { showDetails, toggle }
+  }
+}
+
+// Template:
+// <button @click="toggle()">
+//   {{ showDetails ? 'Скрыть' : 'Показать' }} детали
+// </button>
+// <div v-if="showDetails">
+//   Подробная информация...
+// </div>
+```
+
+## Работа с типами данных
+
+### Переопределение имен
+
+```javascript
+// Деструктуризация позволяет давать понятные имена
+const {
+  value: isLoading,
+  setTrue: startLoading,
+  setFalse: stopLoading
+} = useToggle(false)
+
+const loadData = async () => {
+  startLoading()
+  try {
+    await api.getData()
+  } finally {
+    stopLoading()
+  }
+}
+```
+

package/src/media/templates/prompts/demoDocEn.mdx

@@ -0,0 +1,30 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title="[title]" />
+
+## `toBinds`
+
+Merges multiple property objects by sequentially applying `toBind` to each. Smartly handles classes and styles, creating composite property objects.
+
+**Parameters:**
+- `...values: (ItemList | undefined)[]` — list of property objects to merge
+
+**Returns:**
+Final merged object with all properties, classes and styles.
+
+```javascript
+import { toBinds } from '@dxtmisha/functional'
+
+// Merging multiple objects
+toBinds(
+  {class: 'btn', disabled: false},
+  {class: 'primary', type: 'button'},
+  {class: 'large', id: 'submit-btn'}
+)
+// Result: {
+//   class: ['btn', 'primary', 'large'],
+//   disabled: false,
+//   type: 'button',
+//   id: 'submit-btn'
+// }
+```

package/src/media/templates/prompts/demoDocRu.mdx

@@ -0,0 +1,30 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title="[title]" />
+
+## `toBinds`
+
+Объединяет несколько объектов со свойствами, последовательно применяя `toBind` к каждому. Умно обрабатывает классы и стили, создавая составные объекты свойств.
+
+**Параметры:**
+- `...values: (ItemList | undefined)[]` — список объектов свойств для объединения
+
+**Возвращает:**
+Итоговый объединённый объект со всеми свойствами, классами и стилями.
+
+```javascript
+import { toBinds } from '@dxtmisha/functional'
+
+// Объединение нескольких объектов
+toBinds(
+  {class: 'btn', disabled: false},
+  {class: 'primary', type: 'button'},
+  {class: 'large', id: 'submit-btn'}
+)
+// Результат: {
+//   class: ['btn', 'primary', 'large'],
+//   disabled: false,
+//   type: 'button',
+//   id: 'submit-btn'
+// }
+```

package/src/media/templates/viteComponentTemplateConfig.ts

@@ -8,7 +8,7 @@ import { viteComponentOnly } from '@dxtmisha/configuration/viteComponentOnly'
 export default mergeConfig(
   {}, // viteWorkers,
   viteComponentOnly(
-    resolve(__dirname, './[path]/index.ts'),
+    resolve(__dirname, './[path]'),
     resolve(__dirname, './src')
   )
 )

package/src/types/aiTypes.ts

@@ -0,0 +1,19 @@
+import type { Datetime } from '@dxtmisha/functional-basic'
+import type { GitFileItem } from './gitTypes'
+
+export type AiImageItem = {
+  mime: string
+  base64: string
+}
+export type AiImageList = AiImageItem[]
+
+export type AiDocFile = {
+  content: string
+  date: Datetime
+}
+
+export type AiDocTypeItem = {
+  check: (item: GitFileItem) => boolean
+  item: any
+}
+export type AiDocTypes = AiDocTypeItem[]

package/src/types/configTypes.ts

@@ -1,5 +1,5 @@
 /** AI type for content generation / Тип ИИ для генерации контента */
-export type AiType = 'gemini'
+export type AiType = 'gemini' | 'gemini-cli'
 
 /** Configuration structure for the design system UI project / Структура конфигурации для проекта дизайн-системы UI */
 export type DesignUiConfig = {
@@ -39,6 +39,12 @@ export type DesignUiConfig = {
   /** AI model for generating content / Модель ИИ для генерации контента */
   aiModel?: string
 
-  /** Google API key for accessing Google services / Ключ Google API для доступа к сервисам Google */
+  /** Google AI key for accessing Google services / Ключ Google AI для доступа к сервисам Google */
   aiKey?: string
+
+  /** Directories for AI documentation generation / Каталоги для генерации AI документации */
+  aiDocDirectory?: string[]
+
+  /** Paths to Storybook for AI documentation generation / Пути к Storybook для генерации AI документации */
+  aiDocStorybookPath?: string
 }

package/src/types/gitTypes.ts

@@ -0,0 +1,59 @@
+/**
+ * Git file status codes/
+ * Коды статусов файлов Git
+ */
+export enum GitStatus {
+  // Basic statuses
+  /** File has been modified / Файл был изменен */
+  MODIFIED = 'M',
+  /** File has been added / Файл был добавлен */
+  ADDED = 'A',
+  /** File has been deleted / Файл был удален */
+  DELETED = 'D',
+  /** File has been renamed / Файл был переименован */
+  RENAMED = 'R',
+  /** File has been copied / Файл был скопирован */
+  COPIED = 'C',
+  /** File has been updated / Файл был обновлен */
+  UPDATED = 'U',
+  /** File is untracked / Файл не отслеживается */
+  UNTRACKED = '??',
+  /** File is ignored / Файл игнорируется */
+  IGNORED = '!!',
+  // Merge conflict statuses
+  /** File modified by both sides / Файл изменен с обеих сторон */
+  BOTH_MODIFIED = 'UU',
+  /** File added by us / Файл добавлен нами */
+  ADDED_BY_US = 'AU',
+  /** File deleted by us / Файл удален нами */
+  DELETED_BY_US = 'DU',
+  /** File added by them / Файл добавлен ими */
+  ADDED_BY_THEM = 'UA',
+  /** File deleted by them / Файл удален ими */
+  DELETED_BY_THEM = 'UD',
+  /** File added by both sides / Файл добавлен с обеих сторон */
+  BOTH_ADDED = 'AA',
+  /** File deleted by both sides / Файл удален с обеих сторон */
+  BOTH_DELETED = 'DD',
+  // Index and work tree statuses
+  /** File modified in index / Файл изменен в индексе */
+  MODIFIED_IN_INDEX = 'MM',
+  /** File added in index / Файл добавлен в индексе */
+  ADDED_IN_INDEX = 'AM',
+  /** File deleted in index / Файл удален в индексе */
+  DELETED_IN_INDEX = 'DM',
+  /** File renamed in index / Файл переименован в индексе */
+  RENAMED_IN_INDEX = 'RM',
+  /** File copied in index / Файл скопирован в индексе */
+  COPIED_IN_INDEX = 'CM'
+}
+
+export type GitFileItem = {
+  path: string
+  pathByOS: string[]
+  pathFull: string
+  date: string
+  status?: GitStatus
+}
+
+export type GitFileList = GitFileItem[]