@dxtmisha/scripts 0.4.7 → 0.5.0

package/src/classes/Component/ComponentWiki.ts

@@ -1,29 +1,28 @@
-import { exec } from 'node:child_process'
-import { promisify } from 'node:util'
+// export:none
+
 import { getNameDirByPaths } from '../../functions/getNameDirByPaths'
 import { useAi } from '../../composables/useAi'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
-import { PropertiesFile } from '../Properties/PropertiesFile'
+import { BuildItem } from '../BuildItem'
 import { ComponentWikiFile } from './ComponentWikiFile'
 
+import type { AiAbstract } from '../Ai/AiAbstract'
+
 import {
-  UI_DIR_DIST,
   UI_DIR_TEMPORARY,
   UI_DIR_WIKI,
-  UI_DIRS_COMPONENTS,
-  UI_FILE_NAME_VITE,
-  UI_FILE_NAME_VITE_WORKERS
+  UI_DIRS_COMPONENTS
 } from '../../config'
-import { isFilled } from '@dxtmisha/functional'
-
-// Sample Vite config template path / Путь к шаблону Vite-конфига
-const FILE_VITE_SAMPLE = [__dirname, '..', '..', 'media', 'templates', 'viteComponentTemplateConfig.ts']
-// Sample AI prompt template path / Путь к шаблону AI-промпта
-const FILE_PROMPT_SAMPLE = [__dirname, '..', '..', 'media', 'templates', 'componentPrompt.en.txt']
 
-// Async exec wrapper / Обёртка для асинхронного exec
-const execAsync = promisify(exec)
+/** Sample templates directory / Директория с шаблонами */
+const DIR_SAMPLE = [__dirname, '..', '..', '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.
@@ -33,24 +32,22 @@ const execAsync = promisify(exec)
  * Использует временный билд + AI промпт для (пере)создания документации.
  */
 export class ComponentWiki {
-  // Template vite config file / Файл шаблона vite-конфига
-  protected readonly viteSample: ComponentWikiFile
-  // Template prompt file / Файл шаблона промпта
-  protected readonly promptSample: ComponentWikiFile
+  protected readonly build: BuildItem
 
-  // Aggregated built code file / Файл агрегированного собранного кода
+  /** Code file (original or AI regenerated) / Файл кода (оригинал или пересозданный ИИ) */
   protected readonly codeFile: ComponentWikiFile
-  // Types file (original or AI regenerated) / Файл типов (оригинал или пересозданный ИИ)
+  /** Types file (original or AI regenerated) / Файл типов (оригинал или пересозданный ИИ) */
   protected readonly typesFile: ComponentWikiFile
-  // Stories file (Storybook) / Файл сторис (Storybook)
+  /** Stories file (Storybook) / Файл сторис (Storybook) */
   protected readonly storiesFile: ComponentWikiFile
-  // MDX documentation file / Файл MDX документации
+  /** MDX documentation file / Файл MDX документации */
   protected readonly mdFile: ComponentWikiFile
 
-  // Prepared AI prompt file / Файл подготовленного AI промпта
-  protected readonly promptFile: ComponentWikiFile
-  // Raw AI output file / Файл «сырого» вывода ИИ
-  protected readonly aiFile: ComponentWikiFile
+  /** AI instance / Экземпляр ИИ */
+  protected readonly ai?: AiAbstract
+
+  /** Description from AI / Описание от ИИ */
+  protected description?: string
 
   /**
    * Constructor
@@ -61,38 +58,31 @@ export class ComponentWiki {
     protected readonly path: string,
     protected readonly prompt: string = ''
   ) {
-    this.viteSample = new ComponentWikiFile(FILE_VITE_SAMPLE)
-    this.promptSample = new ComponentWikiFile(FILE_PROMPT_SAMPLE)
+    this.build = new BuildItem(
+      `${this.getRootComponent().join('/')}/index.ts`
+    )
 
     this.codeFile = new ComponentWikiFile([
-      ...this.getPathTemporary(),
-      'code.txt'
-    ])
+      ...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`
-    ])
-
-    this.promptFile = new ComponentWikiFile([
-      ...this.getPathTemporary(),
-      'prompt.txt'
-    ])
+    ], true, false)
 
-    this.aiFile = new ComponentWikiFile([
-      ...this.getPathTemporary(),
-      'ai.txt'
-    ])
+    this.ai = useAi()
   }
 
   /**
@@ -101,19 +91,26 @@ export class ComponentWiki {
    * Оркестрирует билд + извлечение файлов + генерацию через ИИ.
    */
   make(): void {
-    console.log('Component wiki:', this.path)
-
-    this.build()
-      .then((status) => {
-        if (status) {
-          this.readAndWriteALlFiles()
-          this.readAndWritePrompt()
-
-          this.aiGenerate().then(() => console.log('End'))
-        } else {
-          console.log('Error!', this.path)
-        }
-      })
+    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.')
+    }
   }
 
   /**
@@ -152,18 +149,6 @@ export class ComponentWiki {
     ]
   }
 
-  /**
-   * Returns distribution temp directory path segments.
-   *
-   * Возвращает сегменты пути дистрибутива (temp).
-   */
-  protected getPathTemporaryDist(): string[] {
-    return [
-      ...this.getPathTemporary(),
-      UI_DIR_DIST
-    ]
-  }
-
   /**
    * Derives component folder name.
    *
@@ -174,131 +159,39 @@ export class ComponentWiki {
   }
 
   /**
-   * Saves existing vite config aside (rename) before custom build.
+   * Reads the demo file content.
    *
-   * Сохраняет существующий vite-конфиг (переименовывает) перед кастомным билдом.
+   * Читает содержимое демо-файла.
    */
-  protected saveViteConfig() {
-    if (
-      !PropertiesFile.is(UI_FILE_NAME_VITE_WORKERS)
-    ) {
-      PropertiesFile.rename(
-        UI_FILE_NAME_VITE,
-        UI_FILE_NAME_VITE_WORKERS
-      )
-    }
+  protected readDemo(): string {
+    return new ComponentWikiFile(FILE_DEMO_SAMPLE).read()
   }
 
   /**
-   * Restores original vite config after build.
+   * Reads the prompt template.
    *
-   * Восстанавливает оригинальный vite-конфиг после билда.
+   * Читает шаблон промпта.
    */
-  protected resetViteConfig() {
-    if (
-      PropertiesFile.is(UI_FILE_NAME_VITE_WORKERS)
-    ) {
-      PropertiesFile.removeFile(UI_FILE_NAME_VITE)
-      PropertiesFile.rename(
-        UI_FILE_NAME_VITE_WORKERS,
-        UI_FILE_NAME_VITE
-      )
-    }
-  }
-
-  /**
-   * Runs build command (npm run build) capturing stdout/stderr.
-   *
-   * Запускает команду билда (npm run build), перехватывая stdout/stderr.
-   */
-  protected async run(): Promise<boolean> {
-    try {
-      const { stdout, stderr } = await execAsync('npm run build')
-
-      console.info(stdout)
-
-      if (stderr) {
-        console.error('STD error', stderr)
-      }
-
-      return true
-    } catch (error) {
-      console.error('Error', error)
-    }
-
-    return false
-  }
-
-  /**
-   * Prepares temporary vite config, triggers build, then restores original.
-   *
-   * Готовит временный vite-конфиг, запускает билд, затем восстанавливает оригинал.
-   */
-  protected async build(): Promise<boolean> {
-    this.saveViteConfig()
-
-    const path = this.getRootComponent().join('/')
-    const vite = this.viteSample
+  protected readPrompt(): string {
+    return new ComponentWikiFile(FILE_PROMPT_SAMPLE)
       .read()
-      .replace('[path]', path)
-
-    PropertiesFile.writeByPath(UI_FILE_NAME_VITE, vite)
-
-    const status = await this.run()
-
-    this.resetViteConfig()
-
-    return status
+      .replace(/\[wikiLanguage]/g, PropertiesConfig.getWikiLanguage())
   }
 
   /**
-   * Reads built file content and wraps with header comment (file name).
+   * Prepares context for AI.
    *
-   * Читает содержимое собранного файла и оборачивает заголовком с именем файла.
-   * @param path relative built file path / относительный путь собранного файла
+   * Подготавливает контекст для ИИ.
    */
-  protected readFile(path: string): string {
-    const pathFull = PropertiesFile.joinPath([...this.getPathTemporaryDist(), path])
-    const content = PropertiesFile.readFileOnly(pathFull)
-
-    return `
-// File: ${path}
-${content}
-    `.trim()
-  }
-
-  /**
-   * Aggregates all built files into a single code snapshot file.
-   *
-   * Агрегирует все собранные файлы в единый снимок кода.
-   */
-  protected readAndWriteALlFiles(): void {
-    const list = PropertiesFile.readDirRecursive(this.getPathTemporaryDist())
-    const content: string[] = []
-
-    list.forEach((file) => {
-      content.push(this.readFile(file))
-    })
-
-    this.codeFile.write(content.join('\r\n'))
-  }
-
-  /**
-   * Builds AI prompt by injecting dynamic code/types/stories/mdx content.
-   *
-   * Формирует AI промпт, подставляя динамический код/типы/stories/mdx.
-   */
-  protected readAndWritePrompt(): void {
-    this.promptFile.write(
-      this.promptSample
-        .read()
-        .replace('[code]', this.codeFile.read())
-        .replace('[types]', this.typesFile.read())
-        .replace('[stories]', this.storiesFile.read())
-        .replace('[md]', this.mdFile.read())
-        .replace(/\[wikiLanguage]/g, PropertiesConfig.getWikiLanguage())
-        + (isFilled(this.prompt) ? `Additional conditions (these conditions take priority): ${this.prompt}` : '')
-    )
+  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()}`)
+    }
   }
 
   /**
@@ -307,19 +200,43 @@ ${content}
    * Вызывает генерацию через ИИ и делит результат на types / stories / mdx.
    */
   protected async aiGenerate(): Promise<void> {
-    const prompt = this.promptFile.read()
-    const generate = await useAi()?.generate(prompt)
+    if (this.ai) {
+      const generate = await this.ai.generate(
+        this.readPrompt()
+      )
 
-    if (generate) {
-      const files = generate.split('#########')
+      if (generate) {
+        const read = generate.split('#########')
 
-      this.typesFile.write(files[0] ?? '')
-      this.storiesFile.write(files[1] ?? '')
-      this.mdFile.write(files[2] ?? '')
+        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])
+        }
 
-      this.aiFile.write(generate)
+        if (
+          read?.[3]
+          && !read[3].match(MARK_FULL)
+        ) {
+          this.storiesFile.write(read[3])
+        }
 
-      PropertiesFile.removeDir(this.getPathTemporary())
+        if (read?.[4]) {
+          this.mdFile.write(read[4])
+        }
+      }
     }
   }
 }

package/src/classes/Component/ComponentWikiFile.ts

@@ -1,7 +1,12 @@
-import { isFilled } from '@dxtmisha/functional'
+// 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.
  *
@@ -9,41 +14,123 @@ import { PropertiesFile } from '../Properties/PropertiesFile'
  */
 export class ComponentWikiFile {
   /**
-   * @param paths target file path segments
-   * @param paths сегменты пути целевого файла
+   * 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 paths: string[],
+    protected readonly isDate: boolean = false,
+    protected readonly isOld: boolean = true
   ) {
   }
 
-  /** Returns absolute path to file / Возвращает абсолютный путь к файлу */
+  /**
+   * Returns absolute path to file.
+   *
+   * Возвращает абсолютный путь к файлу.
+   */
   getPath(): string {
     return PropertiesFile.joinPath(this.paths)
   }
 
-  /** Reads file content as string / Читает содержимое файла как строку */
+  /**
+   * 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 / Записывает содержимое в файл */
+  /**
+   * Writes content to file.
+   *
+   * Записывает содержимое в файл.
+   * @param content content to write / содержимое для записи
+   */
   write(content: string): void {
     if (isFilled(content)) {
       const contentOld = this.read()
-      const contentEdit = content
-        .trim()
-        .replace(/^```(ts|md)/, '')
-        .replace(/```$/, '')
-        .trim()
+      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(
-          `${PropertiesFile.joinPath(this.paths)}__old.txt`,
-          contentOld
+          this.paths,
+          this.addDate(contentEdit + '\r\n')
         )
-        PropertiesFile.writeByPath(this.paths, contentEdit + '\r\n')
       }
     }
   }
+
+  /**
+   * Extracts date from content string.
+   *
+   * Извлекает дату из строки содержимого.
+   * @param content content string / строка содержимого
+   */
+  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 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,4 +1,6 @@
-import { toArray } from '@dxtmisha/functional'
+// export:none
+
+import { toArray } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'

package/src/classes/Design/DesignComponent.ts

@@ -1,4 +1,6 @@
-import { forEach, isObjectNotArray, toArray, toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isObjectNotArray, toArray, toKebabCase } from '@dxtmisha/functional-basic'
 import { wikiDescriptions } from '@dxtmisha/wiki/media'
 import type { StorybookComponentsDescriptionItem } from '@dxtmisha/wiki'
 

package/src/classes/Design/DesignConstructor.ts

@@ -1,4 +1,6 @@
-import { toCamelCaseFirst } from '@dxtmisha/functional'
+// export:none
+
+import { toCamelCaseFirst } from '@dxtmisha/functional-basic'
 
 import { PropertiesFile } from '../Properties/PropertiesFile'
 

package/src/classes/Design/DesignConstructors.ts

@@ -1,4 +1,6 @@
-import { isFilled } from '@dxtmisha/functional'
+// export:none
+
+import { isFilled } from '@dxtmisha/functional-basic'
 
 import { PropertiesFile } from '../Properties/PropertiesFile'
 import { PropertiesCache } from '../Properties/PropertiesCache'

package/src/classes/Design/DesignReplace.ts

@@ -1,4 +1,6 @@
-import { forEach, getColumn, toCamelCase, toCamelCaseFirst } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, getColumn, toCamelCase, toCamelCaseFirst } from '@dxtmisha/functional-basic'
 
 import { DesignStructure } from './DesignStructure'
 

package/src/classes/Design/DesignStructure.ts

@@ -1,4 +1,6 @@
-import { toCamelCase, toCamelCaseFirst } from '@dxtmisha/functional'
+// export:none
+
+import { toCamelCase, toCamelCaseFirst } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesCache } from '../Properties/PropertiesCache'

package/src/classes/Design/DesignStructureClasses.ts

@@ -1,4 +1,6 @@
-import { forEach, isFilled, isObjectNotArray, toCamelCase } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isFilled, isObjectNotArray, toCamelCase } from '@dxtmisha/functional-basic'
 
 import { DesignStructureItemAbstract } from './DesignStructureItemAbstract'
 

package/src/classes/Design/DesignStructureItemAbstract.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { Properties } from '../Properties/Properties'
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 

package/src/classes/Design/DesignStructureRead.ts

@@ -1,4 +1,6 @@
-import { forEach, isFilled, isObjectNotArray, toCamelCase, uniqueArray } from '@dxtmisha/functional'
+// export:none
+
+import { forEach, isFilled, isObjectNotArray, toCamelCase, uniqueArray } from '@dxtmisha/functional-basic'
 
 import { DesignStructureItemAbstract } from './DesignStructureItemAbstract'
 

package/src/classes/Design/DesignStructureStyles.ts

@@ -1,3 +1,5 @@
+// export:none
+
 import { StylesProperties } from '../Styles/StylesProperties'
 import { DesignStructureItemAbstract } from './DesignStructureItemAbstract'
 

package/src/classes/Design/DesignTypescript.ts

@@ -1,4 +1,4 @@
-import { forEach } from '@dxtmisha/functional'
+import { forEach } from '@dxtmisha/functional-basic'
 import ts from 'typescript'
 
 import type {

package/src/classes/Design/DesignUi.ts

@@ -1,4 +1,6 @@
-import { toKebabCase } from '@dxtmisha/functional'
+// export:none
+
+import { toKebabCase } from '@dxtmisha/functional-basic'
 
 import { DesignComponent } from './DesignComponent'
 import { LibraryItems } from '../Library/LibraryItems'

package/src/classes/Design/DesignWiki.ts

@@ -1,4 +1,6 @@
-import { toCamelCaseFirst } from '@dxtmisha/functional'
+// export:none
+
+import { toCamelCaseFirst } from '@dxtmisha/functional-basic'
 
 import { PropertiesConfig } from '../Properties/PropertiesConfig'
 import { PropertiesFile } from '../Properties/PropertiesFile'