@dxtmisha/scripts 0.9.1 → 0.10.3

package/src/classes/Git/__tests__/GitRead.test.ts

@@ -1,70 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { GitRead } from '../GitRead'
-import { execSync } from 'node:child_process'
-import { PropertiesFile } from '../../Properties/PropertiesFile'
-
-vi.mock('node:child_process', () => ({
-  execSync: vi.fn()
-}))
-
-vi.mock('../../Properties/PropertiesFile', () => ({
-  PropertiesFile: {
-    getTime: vi.fn()
-  }
-}))
-
-describe('GitRead', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('getDirPrefix should return the result of git rev-parse', () => {
-    vi.mocked(execSync).mockReturnValue('packages/scripts/' as any)
-    const result = GitRead.getDirPrefix()
-    expect(execSync).toHaveBeenCalledWith('git rev-parse --show-prefix', expect.anything())
-    expect(result).toBe('packages/scripts/')
-  })
-
-  it('getFilesPath should return list of HEAD files', () => {
-    vi.mocked(execSync).mockReturnValue('file1.ts\nfile2.ts\n' as any)
-    const result = GitRead.getFilesPath()
-    expect(result).toEqual(['file1.ts', 'file2.ts'])
-  })
-
-  it('getList should return files with metadata', () => {
-    vi.mocked(execSync).mockImplementation((cmd: string) => {
-      if (cmd.startsWith('git rev-parse')) return 'prefix/' as any
-      if (cmd.startsWith('git ls-tree')) return 'file.ts\n' as any
-      if (cmd.startsWith('git log')) return '2023-10-27 12:00:00 +0300' as any
-      return '' as any
-    })
-
-    const result = GitRead.getList()
-    expect(result[0]).toMatchObject({
-      path: 'file.ts',
-      pathFull: 'prefix/file.ts',
-      date: expect.stringContaining('2023-10-27')
-    })
-  })
-
-  it('getListPorcelain should parse git status and metadata', () => {
-    vi.mocked(execSync).mockImplementation((cmd: string) => {
-      if (cmd.startsWith('git rev-parse')) return 'prefix/' as any
-      if (cmd.startsWith('git status')) return 'M  file.ts\nA  new.ts\n' as any
-      return '' as any
-    })
-    vi.mocked(PropertiesFile.getTime).mockReturnValue('2023-10-27 12:00:00' as any)
-
-    const result = GitRead.getListPorcelain()
-    expect(result).toHaveLength(2)
-    expect(result[0]).toMatchObject({
-      path: 'file.ts',
-      status: 'M'
-    })
-  })
-
-  it('splitPath should correctly split string', () => {
-    expect(GitRead.splitPath('a/b/c')).toEqual(['a', 'b', 'c'])
-    expect(GitRead.splitPath('/a/b/')).toEqual(['a', 'b'])
-  })
-})

package/src/composables/__tests__/useAi.test.ts

@@ -1,75 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { useAi } from '../useAi'
-import { PropertiesConfig } from '../../classes/Properties/PropertiesConfig'
-import { AiGoogle } from '../../classes/Ai/AiGoogle'
-import { AiGoogleCli } from '../../classes/Ai/AiGoogleCli'
-
-vi.mock('../../classes/Properties/PropertiesConfig', () => ({
-  PropertiesConfig: {
-    getAiType: vi.fn()
-  }
-}))
-
-vi.mock('../../classes/Ai/AiGoogle', () => {
-  return {
-    AiGoogle: vi.fn().mockImplementation(function () {
-      return { name: 'AiGoogleInstance' }
-    })
-  }
-})
-
-vi.mock('../../classes/Ai/AiGoogleCli', () => {
-  return {
-    AiGoogleCli: vi.fn().mockImplementation(function () {
-      return { name: 'AiGoogleCliInstance' }
-    })
-  }
-})
-
-describe('useAi', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('should return an instance of AiGoogle when the type is gemini', () => {
-    vi.mocked(PropertiesConfig.getAiType).mockReturnValue('gemini')
-    const mockInstance = { name: 'AiGoogleInstance' }
-    vi.mocked(AiGoogle).mockImplementation(function () {
-      return mockInstance as any
-    })
-
-    const result = useAi()
-
-    expect(result).toEqual(mockInstance)
-    expect(AiGoogle).toHaveBeenCalled()
-  })
-
-  it('should return an instance of AiGoogleCli when the type is gemini-cli', () => {
-    vi.mocked(PropertiesConfig.getAiType).mockReturnValue('gemini-cli')
-    const mockInstance = { name: 'AiGoogleCliInstance' }
-    vi.mocked(AiGoogleCli).mockImplementation(function () {
-      return mockInstance as any
-    })
-
-    const result = useAi()
-
-    expect(result).toEqual(mockInstance)
-    expect(AiGoogleCli).toHaveBeenCalled()
-  })
-
-  it('should return undefined for an unknown type', () => {
-    vi.mocked(PropertiesConfig.getAiType).mockReturnValue('unknown' as any)
-
-    const result = useAi()
-
-    expect(result).toBeUndefined()
-  })
-
-  it('should return undefined if no type is configured', () => {
-    vi.mocked(PropertiesConfig.getAiType).mockReturnValue(undefined as any)
-
-    const result = useAi()
-
-    expect(result).toBeUndefined()
-  })
-})

package/src/functions/__tests__/getComponentPaths.test.ts

@@ -1,19 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { getComponentPaths } from '../getComponentPaths'
-import { UI_DIRS_COMPONENTS } from '../../config'
-
-describe('getComponentPaths', () => {
-  it('should return an array containing UI_DIRS_COMPONENTS and the given path', () => {
-    const path = 'test-component'
-    const result = getComponentPaths(path)
-
-    expect(result).toEqual([...UI_DIRS_COMPONENTS, path])
-  })
-
-  it('it should work with nested paths', () => {
-    const path = 'nested/test-component'
-    const result = getComponentPaths(path)
-
-    expect(result).toEqual([...UI_DIRS_COMPONENTS, path])
-  })
-})

package/src/functions/__tests__/getConfigAi.test.ts

@@ -1,26 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-import { getConfigAi } from '../getConfigAi'
-import { PropertiesConfig } from '../../classes/Properties/PropertiesConfig'
-
-vi.mock('../../classes/Properties/PropertiesConfig', () => ({
-  PropertiesConfig: {
-    getAiKey: vi.fn(),
-    getAiModel: vi.fn()
-  }
-}))
-
-describe('getConfigAi', () => {
-  it('should return AI key and model from PropertiesConfig', () => {
-    const mockKey = 'test-key'
-    const mockModel = 'test-model'
-
-    vi.mocked(PropertiesConfig.getAiKey).mockReturnValue(mockKey)
-    vi.mocked(PropertiesConfig.getAiModel).mockReturnValue(mockModel)
-
-    const result = getConfigAi()
-
-    expect(result).toEqual([mockKey, mockModel])
-    expect(PropertiesConfig.getAiKey).toHaveBeenCalled()
-    expect(PropertiesConfig.getAiModel).toHaveBeenCalled()
-  })
-})

package/src/functions/__tests__/getConstructorProperties.test.ts

@@ -1,51 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { getConstructorProperties } from '../getConstructorProperties'
-import { PropertiesFile } from '../../classes/Properties/PropertiesFile'
-import { hasNativeDirname } from '../hasNativeDirname'
-
-vi.mock('../../classes/Properties/PropertiesFile', () => ({
-  PropertiesFile: {
-    readFile: vi.fn()
-  }
-}))
-
-vi.mock('../hasNativeDirname', () => ({
-  hasNativeDirname: vi.fn()
-}))
-
-describe('getConstructorProperties', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('should return properties for given constructor names', () => {
-    const mockItem = { some: 'property' }
-    vi.mocked(hasNativeDirname).mockReturnValue(true)
-    vi.mocked(PropertiesFile.readFile).mockReturnValue(mockItem)
-
-    const result = getConstructorProperties(['Button', 'Input'])
-
-    expect(result).toEqual({
-      Button: mockItem,
-      Input: mockItem
-    })
-    expect(PropertiesFile.readFile).toHaveBeenCalledTimes(2)
-  })
-
-  it('should return an empty object if no constructors found or error occurs', () => {
-    vi.mocked(hasNativeDirname).mockReturnValue(true)
-    vi.mocked(PropertiesFile.readFile).mockReturnValue(undefined)
-
-    const result = getConstructorProperties(['NonExistent'])
-
-    expect(result).toEqual({})
-  })
-
-  it('should handles non-native dirname environment', () => {
-    vi.mocked(hasNativeDirname).mockReturnValue(false)
-    vi.mocked(PropertiesFile.readFile).mockReturnValue({ status: 'ok' })
-
-    const result = getConstructorProperties(['Button'])
-    expect(result).toEqual({ Button: { status: 'ok' } })
-  })
-})

package/src/functions/__tests__/getDirname.test.ts

@@ -1,31 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { getDirname } from '../getDirname'
-import { hasNativeDirname } from '../hasNativeDirname'
-
-vi.mock('../hasNativeDirname', () => ({
-  hasNativeDirname: vi.fn()
-}))
-
-// We can't easily mock import.meta.url or __dirname globally in a way that affects the module internally without ESM tricks,
-// but we can at least test that it calls the right path based on hasNativeDirname
-describe('getDirname', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('should return __dirname when hasNativeDirname is true', () => {
-    vi.mocked(hasNativeDirname).mockReturnValue(true)
-
-    // In a vitest environment with native support, __dirname should be defined
-    // We expect it to not throw and return a string
-    const result = getDirname()
-    expect(typeof result).toBe('string')
-  })
-
-  it('should return a path via fileURLToPath when hasNativeDirname is false', () => {
-    vi.mocked(hasNativeDirname).mockReturnValue(false)
-
-    const result = getDirname()
-    expect(typeof result).toBe('string')
-  })
-})

package/src/functions/__tests__/getNameDirByPaths.test.ts

@@ -1,40 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { getNameDirByPaths } from '../getNameDirByPaths'
-import { PropertiesFile } from '../../classes/Properties/PropertiesFile'
-
-vi.mock('../../classes/Properties/PropertiesFile', () => ({
-  PropertiesFile: {
-    splitForDir: vi.fn(),
-    joinPath: vi.fn()
-  }
-}))
-
-describe('getNameDirByPaths', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('should return the last directory name from provided paths', () => {
-    const mockPaths = ['src', 'components', 'button']
-    const mockJoinedPath = 'src/components/button'
-    const mockSplitDirs = ['src', 'components', 'button']
-
-    vi.mocked(PropertiesFile.joinPath).mockReturnValue(mockJoinedPath)
-    vi.mocked(PropertiesFile.splitForDir).mockReturnValue(mockSplitDirs)
-
-    const result = getNameDirByPaths(mockPaths)
-
-    expect(result).toBe('button')
-    expect(PropertiesFile.joinPath).toHaveBeenCalledWith(mockPaths)
-    expect(PropertiesFile.splitForDir).toHaveBeenCalledWith(mockJoinedPath)
-  })
-
-  it('should work with a single path segment', () => {
-    const mockPaths = ['root']
-    vi.mocked(PropertiesFile.joinPath).mockReturnValue('root')
-    vi.mocked(PropertiesFile.splitForDir).mockReturnValue(['root'])
-
-    const result = getNameDirByPaths(mockPaths)
-    expect(result).toBe('root')
-  })
-})

package/src/functions/__tests__/getPackageJson.test.ts

@@ -1,34 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { getPackageJson } from '../getPackageJson'
-import { PropertiesFile } from '../../classes/Properties/PropertiesFile'
-import { UI_FILE_PACKAGE } from '../../config'
-
-vi.mock('../../classes/Properties/PropertiesFile', () => ({
-  PropertiesFile: {
-    readFile: vi.fn()
-  }
-}))
-
-describe('getPackageJson', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('should return package.json content via PropertiesFile.readFile', () => {
-    const mockContent = { name: 'test-package', version: '1.0.0' }
-    vi.mocked(PropertiesFile.readFile).mockReturnValue(mockContent)
-
-    const result = getPackageJson()
-
-    expect(result).toEqual(mockContent)
-    expect(PropertiesFile.readFile).toHaveBeenCalledWith(UI_FILE_PACKAGE)
-  })
-
-  it('should return undefined if file reading fails', () => {
-    vi.mocked(PropertiesFile.readFile).mockReturnValue(undefined)
-
-    const result = getPackageJson()
-
-    expect(result).toBeUndefined()
-  })
-})

package/src/functions/__tests__/hasNativeDirname.test.ts

@@ -1,18 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { hasNativeDirname } from '../hasNativeDirname'
-
-describe('hasNativeDirname', () => {
-  it('should return a boolean', () => {
-    const result = hasNativeDirname()
-    expect(typeof result).toBe('boolean')
-  })
-
-  it('it should return true if __dirname is defined', () => {
-    // In vitest/node environment, __dirname is usually defined
-    // We can't easily "un-define" it for a negative test without complex environment manipulation,
-    // but we can verify it returns true if it's there
-    if (typeof __dirname !== 'undefined') {
-      expect(hasNativeDirname()).toBe(true)
-    }
-  })
-})

package/src/functions/__tests__/toPathStandardSep.test.ts

@@ -1,31 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest'
-import { toPathStandardSep } from '../toPathStandardSep'
-import requirePath from 'path'
-
-vi.mock('path', async (importOriginal) => {
-  const actual = await importOriginal<typeof import('path')>()
-  return {
-    ...actual,
-    default: {
-      ...actual,
-      sep: '/'
-    }
-  }
-})
-
-describe('toPathStandardSep', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-    vi.mocked(requirePath).sep = '/'
-  })
-
-  it('should replace all forward slashes with the platform-specific separator', () => {
-    vi.mocked(requirePath).sep = '\\'
-    expect(toPathStandardSep('src/components/button')).toBe('src\\components\\button')
-  })
-
-  it('should not change the path if it already uses the correct separator (unix)', () => {
-    vi.mocked(requirePath).sep = '/'
-    expect(toPathStandardSep('src/components/button')).toBe('src/components/button')
-  })
-})

package/src/media/templates/componentDoc/wiki/prompt.txt

@@ -1,16 +0,0 @@
-Task Goal:
-The primary goal is to write comprehensive, high-quality documentation for the Vue 3 component.
-
-Component Resolution & Analysis:
-If the source files of the component were not directly attached or provided in the prompt, they are located in the parent directory (one folder above the current "wiki" folder). In this case, you must thoroughly locate and study the component's main Vue file, its properties/types files, styling sheets, and all reachable dependencies to fully understand its features, internal logic, and behavior in its entirety.
-
-Mandatory Instruction:
-You must read and strictly follow the basic rules, coding standards, and templates specified in:
-node_modules/@dxtmisha/scripts/src/media/templates/prompts/componentPrompt.en.txt
-
-All constraints, formatting standards, and styling helper classes described in that file must be adhered to without exception.
-(Warning: If this file is not accessible, missing, or cannot be read, you do not need to study or follow the instructions from it; instead, proceed with standard high-quality documentation practices.)
-
----
-CRITICAL PRIORITY RULE:
-Everything below this line has a higher priority than the text above it.

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

@@ -1,40 +0,0 @@
-### 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

@@ -1,40 +0,0 @@
-### Глобальные принципы разработки (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. **Эстетика и Лаконичность**:
-   - Код должен быть красивым. Используй логические отступы и группировку кода по смыслу.
-   - Экономь токены, избегая избыточных комментариев там, где код говорит сам за себя.