@dxtmisha/scripts 0.11.8 → 1.0.0

package/src/classes/Component/ComponentWiki.ts

@@ -1,258 +0,0 @@
-// export:none
-
-import { getNameDirByPaths } from '../../functions/getNameDirByPaths'
-import { useAi } from '../../composables/useAi'
-
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { BuildItem } from '../BuildItem'
-import { ComponentWikiFile } from './ComponentWikiFile'
-
-import type { AiAbstract } from '../Ai/AiAbstract'
-
-import {
-  UI_DIR_TEMPORARY,
-  UI_DIR_WIKI,
-  UI_DIRS_COMPONENTS
-} from '../../config'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-/** Sample templates directory / Директория с шаблонами */
-const DIR_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates', 'prompts']
-/** Sample AI prompt template path / Путь к шаблону AI-промпта */
-const FILE_PROMPT_SAMPLE = [...DIR_SAMPLE, 'componentPrompt.en.txt']
-/** Sample demo component MDX path / Путь к MDX демо-компоненту */
-const FILE_DEMO_SAMPLE = [...DIR_SAMPLE, 'demoComponentEn.mdx']
-/** Marker indicating no changes needed / Метка, указывающая на отсутствие изменений */
-const MARK_FULL = '--FULL--'
-
-/**
- * Generates wiki artifacts (code snapshot, stories, mdx) for a component.
- * Uses a temporary build + AI prompt to (re)create documentation.
- *
- * Генерирует wiki-артефакты (снимок кода, stories, mdx) для компонента.
- * Использует временный билд + AI промпт для (пере)создания документации.
- */
-export class ComponentWiki {
-  protected readonly build: BuildItem
-
-  /** Code file (original or AI regenerated) / Файл кода (оригинал или пересозданный ИИ) */
-  protected readonly codeFile: ComponentWikiFile
-  /** Types file (original or AI regenerated) / Файл типов (оригинал или пересозданный ИИ) */
-  protected readonly typesFile: ComponentWikiFile
-  /** Stories file (Storybook) / Файл сторис (Storybook) */
-  protected readonly storiesFile: ComponentWikiFile
-  /** MDX documentation file / Файл MDX документации */
-  protected readonly mdFile: ComponentWikiFile
-
-  /** AI instance / Экземпляр ИИ */
-  protected readonly ai?: AiAbstract
-
-  /** Description from AI / Описание от ИИ */
-  protected description?: string
-
-  /**
-   * Constructor
-   * @param path component relative path inside components dirs/ относительный путь компонента внутри директорий компонентов
-   * @param prompt additional custom prompt text to append/ дополнительный кастомный текст промпта для добавления
-   */
-  constructor(
-    protected readonly path: string,
-    protected readonly prompt: string = ''
-  ) {
-    this.build = new BuildItem(
-      `${this.getRootComponent().join('/')}/index.ts`
-    )
-
-    this.codeFile = new ComponentWikiFile([
-      ...this.getRootComponent(),
-      `${this.getName()}.vue`
-    ], false, false)
-
-    this.typesFile = new ComponentWikiFile([
-      ...this.getRootComponent(),
-      'types.ts'
-    ], false, false)
-
-    this.storiesFile = new ComponentWikiFile([
-      ...this.getPathWiki(),
-      `${this.getName()}.stories.ts`
-    ], false, false)
-
-    this.mdFile = new ComponentWikiFile([
-      ...this.getPathWiki(),
-      `${this.getName()}.mdx`
-    ], true, false)
-
-    this.ai = useAi()
-  }
-
-  /**
-   * Orchestrates build + file extraction + AI generation.
-   *
-   * Оркестрирует билд + извлечение файлов + генерацию через ИИ.
-   */
-  make(): void {
-    console.log('Component wiki:', this.path, '...')
-
-    if (this.ai) {
-      this.build
-        .make()
-        .then((status) => {
-          if (status) {
-            this.makeAi()
-            this.aiGenerate()
-              .then(() => {
-                console.log('...', 'End')
-                this.build.removeDir()
-              })
-          } else {
-            console.log('Error!', this.path)
-          }
-        })
-    } else {
-      console.error('AI is not configured.')
-    }
-  }
-
-  /**
-   * Returns root path segments for the component.
-   *
-   * Возвращает сегменты корневого пути компонента.
-   * @protected
-   */
-  protected getRootComponent(): string[] {
-    return [
-      ...UI_DIRS_COMPONENTS,
-      ...this.path.split('/')
-    ]
-  }
-
-  /**
-   * Returns wiki directory path segments.
-   *
-   * Возвращает сегменты пути wiki директории.
-   * @protected
-   */
-  protected getPathWiki(): string[] {
-    return [
-      ...this.getRootComponent(),
-      UI_DIR_WIKI
-    ]
-  }
-
-  /**
-   * Returns temporary directory path segments.
-   *
-   * Возвращает сегменты пути временной директории.
-   * @protected
-   */
-  protected getPathTemporary(): string[] {
-    return [
-      ...this.getPathWiki(),
-      UI_DIR_TEMPORARY
-    ]
-  }
-
-  /**
-   * Derives component folder name.
-   *
-   * Получает имя директории компонента.
-   * @protected
-   */
-  protected getName(): string {
-    return String(getNameDirByPaths(this.getRootComponent()))
-  }
-
-  /**
-   * Reads the demo file content.
-   *
-   * Читает содержимое демо-файла.
-   * @protected
-   */
-  protected readDemo(): string {
-    return new ComponentWikiFile(FILE_DEMO_SAMPLE).read()
-  }
-
-  /**
-   * Reads the prompt template.
-   *
-   * Читает шаблон промпта.
-   * @protected
-   */
-  protected readPrompt(): string {
-    return new ComponentWikiFile(FILE_PROMPT_SAMPLE)
-      .read()
-      .replace(/\[wikiLanguage]/g, PropertiesConfig.getWikiLanguage())
-  }
-
-  /**
-   * Prepares context for AI.
-   *
-   * Подготавливает контекст для ИИ.
-   * @protected
-   */
-  protected makeAi(): void {
-    if (this.ai) {
-      this.ai.addContent(`Code: ${this.build.getCode()}`)
-      this.ai.addContent(`Original code: ${this.codeFile.read()}`)
-      this.ai.addContent(`Original types.ts: ${this.typesFile.read()}`)
-      this.ai.addContent(`Demo (only for template analysis, all data is fake): ${this.readDemo()}`)
-      this.ai.addContent(`Original *.stories.ts: ${this.storiesFile.read()}`)
-      this.ai.addContent(`Original MDX: ${this.mdFile.read()}`)
-    }
-  }
-
-  /**
-   * Invokes AI generation and splits result into types / stories / mdx.
-   *
-   * Вызывает генерацию через ИИ и делит результат на types / stories / mdx.
-   * @protected
-   */
-  protected async aiGenerate(): Promise<void> {
-    if (this.ai) {
-      const generate = await this.ai.generate(
-        this.readPrompt()
-      )
-
-      if (generate) {
-        const read = generate.split('#########')
-
-        if (read?.[0]) {
-          this.description = read[0].trim()
-        }
-
-        if (
-          read?.[1]
-          && !read[1].match(MARK_FULL)
-        ) {
-          this.codeFile.write(read[1])
-        }
-
-        if (
-          read?.[2]
-          && !read[2].match(MARK_FULL)
-        ) {
-          this.typesFile.write(read[2])
-        }
-
-        if (
-          read?.[3]
-          && !read[3].match(MARK_FULL)
-        ) {
-          this.storiesFile.write(read[3])
-        }
-
-        if (read?.[4]) {
-          this.mdFile.write(read[4])
-        }
-      }
-    }
-  }
-}

package/src/classes/Component/ComponentWikiFile.ts

@@ -1,138 +0,0 @@
-// export:none
-
-import { Datetime, isFilled } from '@dxtmisha/functional-basic'
-
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-/** Regex to match date in content / Регекс для поиска даты в содержимом */
-const DATE_UPDATED_MATCH = /\*\*Date: (.*?)\.\*\*/i
-
-/**
- * Utility class for reading and writing a single wiki component file.
- *
- * Утилитный класс для чтения и записи одного файла wiki компонента.
- */
-export class ComponentWikiFile {
-  /**
-   * Constructor.
-   *
-   * Конструктор.
-   * @param paths target file path segments / сегменты пути целевого файла
-   * @param isDate whether to extract date from content / извлекать ли дату из содержимого
-   * @param isOld whether to keep old version of file / сохранять ли старую версию файла
-   */
-  constructor(
-    protected readonly paths: string[],
-    protected readonly isDate: boolean = false,
-    protected readonly isOld: boolean = true
-  ) {
-  }
-
-  /**
-   * Returns absolute path to file.
-   *
-   * Возвращает абсолютный путь к файлу.
-   */
-  getPath(): string {
-    return PropertiesFile.joinPath(this.paths)
-  }
-
-  /**
-   * Returns date from file content.
-   *
-   * Возвращает дату из содержимого файла.
-   */
-  getDate(): Datetime {
-    const content = this.read()
-    return this.extractDateFromContent(content)
-  }
-
-  /**
-   * Reads file content as string.
-   *
-   * Читает содержимое файла как строку.
-   */
-  read(): string {
-    return PropertiesFile.readFile<string>(this.paths) ?? ''
-  }
-
-  /**
-   * Writes content to file.
-   *
-   * Записывает содержимое в файл.
-   * @param content content to write / содержимое для записи
-   */
-  write(content: string): void {
-    if (isFilled(content)) {
-      const contentOld = this.read()
-      let contentEdit = content.trim()
-
-      if (contentEdit.startsWith('```')) {
-        contentEdit = contentEdit
-          .replace(/^```(ts|md)/, '')
-          .replace(/```$/, '')
-          .trim()
-      }
-
-      if (contentEdit !== contentOld.trim()) {
-        if (
-          this.isOld
-          && isFilled(contentOld.trim())
-        ) {
-          PropertiesFile.writeByPath(
-            `${PropertiesFile.joinPath(this.paths)}__old.txt`,
-            contentOld
-          )
-        }
-
-        PropertiesFile.writeByPath(
-          this.paths,
-          this.addDate(contentEdit + '\r\n')
-        )
-      }
-    }
-  }
-
-  /**
-   * Extracts date from content string.
-   *
-   * Извлекает дату из строки содержимого.
-   * @param content content string / строка содержимого
-   * @protected
-   */
-  protected extractDateFromContent(content: string): Datetime {
-    const match = content.match(DATE_UPDATED_MATCH)
-    let date = '1970-01-01'
-
-    if (
-      match
-      && match?.[1]
-    ) {
-      date = match[1]
-    }
-
-    return new Datetime(date, 'full')
-  }
-
-  /**
-   * Adds current date to content if isDate is true.
-   *
-   * Добавляет текущую дату в содержимое, если isDate равно true.
-   * @param content content string / строка содержимого
-   * @protected
-   */
-  protected addDate(content: string): string {
-    if (this.isDate) {
-      const date = new Datetime(new Date(), 'full').standard()
-      const dateString = `\n\r**Date: ${date}.**\r\n`
-
-      if (DATE_UPDATED_MATCH.test(content)) {
-        return `${content.replace(DATE_UPDATED_MATCH, '').trim()}\r\n${dateString}`
-      }
-
-      return `${content}${dateString}`
-    }
-
-    return content
-  }
-}

package/src/classes/Design/DesignCommand.ts

@@ -1,243 +0,0 @@
-// export:none
-
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { toArray, toCamelCase, toCamelCaseFirst, toKebabCase } from '@dxtmisha/functional-basic'
-import { hasNativeDirname } from '../../functions/hasNativeDirname'
-import { getPackageJson } from '../../functions/getPackageJson'
-
-import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { PropertiesFile } from '../Properties/PropertiesFile'
-import { DesignStructure } from './DesignStructure'
-import { DesignReplace } from './DesignReplace'
-
-import { UI_FILE_PACKAGE } from '../../config'
-
-const dirnamePath = hasNativeDirname()
-  ? __dirname
-  : dirname(fileURLToPath(import.meta.url))
-
-const DIR_SAMPLE = [dirnamePath, '..', '..', 'media', 'templates']
-
-/**
- * Base abstract class for generating script files and design system components.
- * Provides unified logic for template reading, data transformation, and file writing.
- *
- * Базовый абстрактный класс для генерации файлов скриптов и компонентов дизайн-системы.
- * Обеспечивает единую логику чтения шаблонов, трансформации данных и записи файлов.
- */
-export abstract class DesignCommand {
-  protected abstract DIR_SAMPLE: string
-  protected abstract dir: string[]
-
-  protected structure?: DesignStructure
-
-  /**
-   * Constructor for DesignCommand.
-   *
-   * Конструктор для DesignCommand.
-   * @param command component name or command identifier / название компонента или идентификатор команды
-   * @param options additional key-value parameters / дополнительные параметры ключ-значение
-   */
-  protected constructor(
-    protected readonly command: string,
-    protected readonly options: Record<string, string> = {}
-  ) {
-  }
-
-  /**
-   * Main entry point for executing the command.
-   * Validates input and triggers the primary initialization logic.
-   *
-   * Основная точка входа для выполнения команды.
-   * Проверяет входные данные и запускает основную логику инициализации.
-   */
-  make(): void {
-    if (this.command) {
-      console.info(`-- ${PropertiesConfig.getDesignName()}.${this.command}:`)
-
-      this.initMain()
-
-      console.info('-- end')
-    } else {
-      console.info('-- not name')
-    }
-  }
-
-  /**
-   * Initializes the creation of all files for the current team.
-   *
-   * Инициализирует создание всех файлов для текущей команды.
-   */
-  protected abstract initMain(): void
-
-  /**
-   * Checks the presence of a file.
-   *
-   * Проверяет наличие файла.
-   * @param name file name/ название файла
-   */
-  protected isFile(name: string | string[]): boolean {
-    return PropertiesFile.is([...this.dir, ...toArray(name)])
-  }
-
-  /**
-   * Returns the names for the team.
-   *
-   * Возвращает названия для команды.
-   */
-  protected getCommand(): string {
-    return this.command
-  }
-
-  protected getName(): string {
-    return toCamelCaseFirst(this.getCommand())
-  }
-
-  protected getNameMin(): string {
-    return toCamelCase(this.getCommand())
-  }
-
-  protected getCode(): string {
-    return toKebabCase(this.getCommand())
-  }
-
-  protected getFullName(): string {
-    return toCamelCaseFirst(`${PropertiesConfig.getDesignName()}-${this.getCommand()}`)
-  }
-
-  protected getProjectName(): string {
-    return toCamelCaseFirst(PropertiesConfig.getProjectName())
-  }
-
-  /**
-   * Returns a structure object.
-   *
-   * Возвращает объект структуры.
-   */
-  protected getStructure(): DesignStructure {
-    if (!this.structure) {
-      this.structure = new DesignStructure(this.getCommand())
-    }
-
-    return this.structure
-  }
-
-  /**
-   * Returns an object for template transformation.
-   *
-   * Возвращает объект для преобразования шаблона.
-   * @param sample property template/ шаблон свойства
-   */
-  protected getReplace(sample?: string): DesignReplace {
-    return new DesignReplace(
-      this.getStructure(),
-      this.DIR_SAMPLE,
-      sample ?? ''
-    )
-  }
-
-  /**
-   * Reading.
-   *
-   * Читает файл.
-   * @param name file name/ название файла
-   */
-  protected read(name: string | string[]): string | undefined {
-    return PropertiesFile.readFile<string>([...this.dir, ...toArray(name)])
-  }
-
-  /**
-   * This code reads a template.
-   *
-   * Читает шаблона.
-   * @param name file name/ название файла
-   */
-  protected readSample(name: string): string | undefined {
-    return PropertiesFile.readFile<string>([...DIR_SAMPLE, this.DIR_SAMPLE, name])
-  }
-
-  /**
-   * Reads the file itself or its template if it is not found.
-   *
-   * Читает сам файл или его шаблон, если его нет.
-   * @param name file name/ название файла
-   * @param callback the function is executed if there is no such file/ функция выполняется, если такого файла нет
-   */
-  protected readDefinable(name: string, callback?: (sample: DesignReplace) => void): DesignReplace {
-    const fileName = this.getReplace().getNameFile(name)
-
-    if (this.isFile(fileName)) {
-      return this.getReplace(this.read(fileName))
-    }
-
-    const replace = this.getReplace(this.readSample(name))
-
-    if (callback) {
-      callback(replace)
-    }
-
-    replace
-      .replaceOnce()
-      .replaceName()
-
-    return replace
-  }
-
-  /**
-   * Creating or rewriting a file.
-   *
-   * Создание или перезапись файла.
-   * @param name file name/ название файла
-   * @param value values for storage/ значения для хранения
-   */
-  protected write(name: string, value: string): void {
-    this.console(name)
-
-    PropertiesFile.write(
-      this.dir,
-      name,
-      value,
-      ''
-    )
-  }
-
-  protected updatePackage(
-    namePath: string,
-    value: any
-  ): this {
-    const packageFile = getPackageJson()
-    let focus: Record<string, any> | any | undefined = packageFile
-
-    if (packageFile && focus) {
-      const names = namePath.split('|')
-      const key = names.pop()
-
-      for (const name of names) {
-        if (!(name in focus)) {
-          focus[name] = {}
-        }
-
-        focus = focus[name]
-      }
-
-      if (key) {
-        focus[key] = value
-      }
-
-      PropertiesFile.writeByPath(UI_FILE_PACKAGE, packageFile)
-    }
-
-    return this
-  }
-
-  /**
-   * Outputting data to the console.
-   *
-   * Вывод данных в консоль.
-   * @param name file name/ название файла
-   */
-  protected console(name: string): void {
-    console.info(`--  ${this.isFile(name) ? 'update' : 'create'} ${name}`)
-  }
-}