@dxtmisha/scripts 0.11.8 → 1.0.0

package/src/classes/Design/DesignStructureRead.ts

@@ -1,349 +0,0 @@
-// export:none
-
-import { forEach, isFilled, isObjectNotArray, toCamelCase, uniqueArray } from '@dxtmisha/functional-basic'
-
-import { DesignStructureItemAbstract } from './DesignStructureItemAbstract'
-
-import {
-  type PropertyItem,
-  PropertyKey,
-  PropertyType
-} from '../../types/propertyTypes'
-import type {
-  DesignStructureItem,
-  DesignStructureItemSub,
-  DesignStructureList,
-  DesignStructureStateList
-} from '../../types/designTypes'
-
-import { UI_PROPERTY_FOR_PROPS } from '../../config'
-
-/**
- * Engine for parsing and resolving component property dependencies and states.
- * It processes the raw property metadata to identify interactive states, link classes, and compile all possible values for code generation.
- *
- * Движок для парсинга и разрешения зависимостей свойств и состояний компонента.
- * Обрабатывает сырые метаданные свойств для идентификации интерактивных состояний, связанных классов и компиляции всех возможных значений для генерации кода.
- */
-export class DesignStructureRead extends DesignStructureItemAbstract<DesignStructureList> {
-  protected states: DesignStructureStateList
-
-  protected data: DesignStructureList = {}
-
-  /**
-   * Constructor for DesignStructureRead.
-   *
-   * Конструктор для DesignStructureRead.
-   * @param component component name whose properties are being resolved / имя компонента, свойства которого разрешаются
-   */
-  constructor(
-    component: string
-  ) {
-    super(component)
-    this.states = this.makeState(this.items?.value)
-
-    this.makeMain()
-    this.makeValue()
-    this.makeValueAll()
-    this.makeValueUnique()
-    // this.makeValueState()
-  }
-
-  /**
-   * Getting all dependencies of the component.
-   *
-   * Получение всех зависимостей у компонента.
-   */
-  getStates(): DesignStructureStateList {
-    return this.states
-  }
-
-  /**
-   * Checks if the property is available for addition to props.
-   *
-   * Проверяет, доступно ли свойство для добавления в props.
-   * @param item object for checking/ объект для проверки
-   */
-  protected isProps(item: PropertyItem): boolean {
-    const is = item?.[PropertyKey.prop]
-
-    return is !== false && (
-      isFilled(is)
-      || item?.[PropertyKey.variable] === PropertyType.state
-      || UI_PROPERTY_FOR_PROPS.indexOf(item?.[PropertyKey.name] as string) !== -1
-    )
-  }
-
-  /**
-   * Checks whether the property is a reference to a class.
-   *
-   * Проверяет, является ли свойство ссылкой на класс.
-   * @param item object for checking/ объект для проверки
-   */
-  protected isLinkClass(item: PropertyItem): boolean {
-    return typeof item.value === 'string'
-      && item?.[PropertyKey.variable] === PropertyType.linkClass
-  }
-
-  /**
-   * Transformations to a class name.
-   *
-   * Преобразование в имя класса.
-   * @param value values of properties from the value field/ значения свойств из поля value
-   */
-  protected getClass(value: string): string {
-    return this.properties.get()
-      .getKeys(value)
-      .join('.')
-      .replace('.', '-')
-      .replace(/\./g, '--')
-  }
-
-  /**
-   * Returns all properties of a component by its reference.
-   *
-   * Возвращает все свойства компонента по его reference.
-   * @param index link to a property/ ссылка на свойство
-   */
-  protected getClassState(index: string): PropertyItem | undefined {
-    return this.properties.get().getItem(index)
-  }
-
-  /**
-   * Returns records that meet state conditions.
-   *
-   * Возвращает записи, удовлетворяющие условиям состояния.
-   * @param properties input data/ входной данный
-   */
-  protected makeState(properties?: PropertyItem['value']): DesignStructureStateList {
-    const state: DesignStructureStateList = []
-
-    if (
-      isFilled(properties)
-      && isObjectNotArray(properties)
-    ) {
-      forEach(properties, (item, index) => {
-        if (this.isProps(item)) {
-          state.push({
-            index,
-            type: PropertyType.property,
-            item,
-            className: undefined,
-            state: this.makeState(item.value)
-          })
-        }
-
-        if (this.isLinkClass(item)) {
-          const value = item?.[PropertyKey.css] || item.value
-
-          if (typeof value === 'string') {
-            const link = this.getClassState(value)
-
-            if (link) {
-              state.push({
-                index,
-                type: PropertyType.linkClass,
-                item: link,
-                className: this.getClass(value),
-                state: this.makeState(link.value)
-              })
-            }
-          }
-        }
-      })
-    }
-
-    return state
-  }
-
-  /**
-   * Retrieves all properties for preparing data filling.
-   *
-   * Получает все свойства для подготовки заполнения данными.
-   */
-  protected makeMain(): this {
-    this.states?.forEach(({
-      index,
-      type,
-      item,
-      className
-    }) => {
-      this.data[index] = {
-        name: this.toName(item, index),
-        index,
-        type,
-        className,
-        value: [],
-        valueAll: [],
-        state: [],
-        style: Boolean(item?.[PropertyKey.style]),
-        default: item?.[PropertyKey.default],
-        category: item?.[PropertyKey.category]
-      }
-    })
-
-    return this
-  }
-
-  /**
-   * Receives the default values.
-   *
-   * Получает базовые значения.
-   */
-  protected makeValue(): this {
-    this.states?.forEach(({
-      index,
-      item
-    }) => {
-      this.data?.[index]?.value.push(...this.toValue(item?.value))
-    })
-
-    return this
-  }
-
-  /**
-   * Gets all possible values.
-   *
-   * Получает всех возможных значения.
-   * @param state basic values/ базовые значения
-   */
-  protected makeValueAll(state = this.states): this {
-    state?.forEach(({
-      index,
-      item,
-      state
-    }) => {
-      if (index in this.data) {
-        const value = this.toValue(item?.value)
-        this.data?.[index]?.valueAll.push(...value)
-
-        if (state && value.indexOf(true) !== -1) {
-          this.makeValueAll(state)
-        }
-      }
-    })
-
-    return this
-  }
-
-  /**
-   * Updates values by removing duplicates and updating the style property value.
-   *
-   * Обновляет значения, удаляя все повторы и обновляя значения свойства style.
-   */
-  protected makeValueUnique(): this {
-    forEach(this.data, (property) => {
-      property.valueAll = uniqueArray(property.valueAll)
-
-      if (!isFilled(property.value)) {
-        property.value = [true]
-      }
-
-      if (!isFilled(property.valueAll)) {
-        property.valueAll = [true]
-      }
-    })
-
-    return this
-  }
-
-  /**
-   * Updates values in a map.
-   *
-   * Обновляет значения в карте.
-   * @param states basic values/ базовые значения
-   * @param parent
-   */
-  protected makeValueState(
-    states = this.states,
-    parent?: DesignStructureItem['state']
-  ): this {
-    states?.forEach(({
-      index,
-      item,
-      state
-    }) => {
-      const structure = this.data[index]
-
-      if (structure) {
-        if (parent) {
-          const value: DesignStructureItemSub = {
-            name: structure.name,
-            index,
-            value: this.toValue(item.value),
-            state: []
-          }
-
-          parent.push(value)
-          this.makeValueState(state, value.state)
-
-          if (
-            value.state.length > 0
-            && value.value.length === 0
-          ) {
-            value.value.push(true)
-          }
-        } else {
-          this.makeValueState(state, this.data[index]?.state)
-        }
-      }
-    })
-
-    return this
-  }
-
-  /**
-   * Returns a formatted string with the property name.
-   *
-   * Возвращает отформатированную строку с названием свойства.
-   * @param item object for checking/ объект для проверки
-   * @param index property identifier/ идентификатор свойства
-   */
-  protected toName(item: PropertyItem, index: string): string {
-    const prop = item?.[PropertyKey.prop]
-
-    return toCamelCase(
-      (typeof prop === 'string' && prop)
-      || item?.[PropertyKey.rename]
-      || item?.[PropertyKey.index]
-      || index
-    )
-  }
-
-  /**
-   * Returns all available values.
-   *
-   * Возвращает все доступные значения.
-   * @param properties array with all property records/ массив со всеми записями свойств
-   */
-  protected toValue(properties?: PropertyItem['value']): DesignStructureItem['value'] {
-    if (
-      isFilled(properties)
-      && isObjectNotArray(properties)
-    ) {
-      const value: DesignStructureItem['value'] = []
-      let isTrue = false
-
-      forEach(properties, (item, name) => {
-        if (
-          !(name in this.data)
-          || item?.[PropertyKey.prop]
-        ) {
-          if (item?.[PropertyKey.variable] === PropertyType.state) {
-            value.push(name)
-          } else {
-            isTrue = true
-          }
-        }
-      })
-
-      if (isTrue) {
-        value.push(true)
-      }
-
-      return value
-    }
-
-    return [true]
-  }
-}

package/src/classes/Design/DesignStructureStyles.ts

@@ -1,45 +0,0 @@
-// export:none
-
-import { StylesProperties } from '../Styles/StylesProperties'
-import { DesignStructureItemAbstract } from './DesignStructureItemAbstract'
-
-/**
- * Engine for compiling component-specific styles from design system tokens.
- * It coordinates the transformation of structural metadata into CSS-in-JS style rules using the global theme environment.
- *
- * Движок для компиляции специфичных для компонента стилей из токенов дизайн-системы.
- * Координирует преобразование структурных метаданных в правила стилей CSS-in-JS с использованием глобального тематического окружения.
- */
-export class DesignStructureStyles extends DesignStructureItemAbstract<string[]> {
-  protected data: string[]
-
-  /**
-   * Constructor for DesignStructureStyles.
-   *
-   * Конструктор для DesignStructureStyles.
-   * @param component component name for which styles are being compiled / имя компонента, для которого компилируются стили
-   */
-  constructor(
-    component: string
-  ) {
-    super(component)
-    this.data = this.make()
-  }
-
-  /**
-   * Performing transformation.
-   *
-   * Выполнение преобразования.
-   */
-  make(): string[] {
-    if (this.items) {
-      return [
-        '& {',
-        ...(new StylesProperties('  ', this.items)).make(),
-        '}'
-      ]
-    }
-
-    return []
-  }
-}

package/src/classes/Design/DesignTypes.ts

@@ -1,94 +0,0 @@
-import { ServerStorage } from '@dxtmisha/functional-basic'
-
-import { DesignTypesAi } from './DesignTypesAi'
-import { DesignTypesDescription } from './DesignTypesDescription'
-import { DesignTypesMake } from './DesignTypesMake'
-import { DesignTypesMcp } from './DesignTypesMcp'
-import { DesignTypesPrompts } from './DesignTypesPrompts'
-
-/**
- * Engine for generating compressed and AI-optimized TypeScript type definitions.
- * It scans the build output for declaration files, sanitizes them, and uses AI to produce a minimal, context-rich type library for use in automated coding assistants.
- *
- * Движок для генерации сжатых и оптимизированных для ИИ определений типов TypeScript.
- * Сканирует выходные данные сборки на наличие файлов деклараций, очищает их и использует ИИ для создания минимальной, насыщенной контекстом библиотеки типов для использования в автоматизированных помощниках по кодированию.
- */
-export class DesignTypes {
-  /** Instance of DesignTypesAi for AI interactions / Экземпляр DesignTypesAi для ИИ взаимодействия */
-  protected readonly ai: DesignTypesAi
-
-  /** Instance of DesignTypesDescription for description generation / Экземпляр DesignTypesDescription для генерации описания */
-  protected readonly description: DesignTypesDescription
-
-  /** Instance of DesignTypesMake for declaration file processing / Экземпляр DesignTypesMake для обработки файлов деклараций */
-  protected readonly makeTypes: DesignTypesMake
-
-  /** Instance of DesignTypesMcp for MCP server resources processing / Экземпляр DesignTypesMcp для обработки ресурсов MCP-сервера */
-  protected readonly mcp: DesignTypesMcp
-
-  /** Instance of DesignTypesPrompts for prompt file processing / Экземпляр DesignTypesPrompts для обработки файлов промптов */
-  protected readonly prompts: DesignTypesPrompts
-
-  /**
-   * Constructor for DesignTypes.
-   *
-   * Конструктор для DesignTypes.
-   * @param dir input directory path containing declaration files / входной путь к директории, содержащей файлы деклараций
-   * @param promptsDir input directory path containing prompt files / входной путь к директории, содержащей файлы промптов
-   * @param isRaw flag disabling AI processing to create raw types and empty description / флаг отключения ИИ обработки для создания сырых типов и пустого описания
-   */
-  constructor(
-    protected readonly dir: string = 'dist',
-    protected readonly promptsDir: string = 'ai-resources',
-    protected readonly isRaw: boolean = false
-  ) {
-    ServerStorage.setErrorStatus(true)
-
-    this.ai = new DesignTypesAi(this.dir, this.isRaw)
-    this.makeTypes = new DesignTypesMake(this.ai)
-    this.prompts = new DesignTypesPrompts(this.promptsDir, this.ai)
-    this.description = new DesignTypesDescription(this.ai, this.makeTypes, this.prompts, this.isRaw)
-    this.mcp = new DesignTypesMcp(this.ai, this.prompts, this.isRaw)
-  }
-
-  /**
-   * Main method to execute the type generation process.
-   *
-   * Основной метод для выполнения процесса генерации типов.
-   * @returns current instance / текущий экземпляр
-   */
-  async make(): Promise<this> {
-    console.log('DesignTypes: making AI types...')
-
-    await this.makeTypes.make()
-    await this.prompts.make()
-    await this.description.make()
-    await this.mcp.make()
-
-    console.log('DesignTypes: AI types saved.')
-
-    return this
-  }
-
-  /**
-   * Generates type definitions by combining processed files from ai-types-list directory without running AI.
-   *
-   * Генерирует определения типов путем объединения обработанных файлов из директории ai-types-list без запуска ИИ.
-   * @returns current instance / текущий экземпляр
-   */
-  async makeSave(): Promise<this> {
-    console.log('DesignTypes: saving AI types from list...')
-
-    this.makeTypes.makeSave()
-
-    if (!this.description.is()) {
-      await this.description.make()
-    }
-
-    await this.mcp.make()
-
-    console.log('DesignTypes: AI types saved.')
-
-    return this
-  }
-}

package/src/classes/Design/DesignTypesAi.ts

@@ -1,135 +0,0 @@
-import { getPackageJson } from '../../functions/getPackageJson'
-import { useAi } from '../../composables/useAi'
-
-/**
- * Class for handling low-level AI interactions, directory configuration, and prompt execution.
- *
- * Класс для низкоуровневого взаимодействия с ИИ, конфигурации директории и выполнения промптов.
- */
-export class DesignTypesAi {
-  /** Cached project name / Кэшированное название проекта */
-  protected projectName: string
-
-  /** Array of directory path segments / Массив сегментов пути директории */
-  protected readonly dirArray: string[]
-
-  /**
-   * Constructor for DesignTypesAi.
-   *
-   * Конструктор для DesignTypesAi.
-   * @param dir input directory path containing declaration files / входной путь к директории, содержащей файлы деклараций
-   * @param isRaw flag disabling AI processing / флаг отключения ИИ обработки
-   */
-  constructor(
-    protected readonly dir: string = 'dist',
-    protected readonly isRaw: boolean = false
-  ) {
-    this.dirArray = this.dir.split('/')
-    this.projectName = getPackageJson()?.name ?? 'none'
-  }
-
-  /**
-   * Returns the array of directory path segments.
-   *
-   * Возвращает массив сегментов пути директории.
-   * @returns directory path segments / сегменты пути директории
-   */
-  getDirArray(): string[] {
-    return this.dirArray
-  }
-
-  /**
-   * Returns the project name from package.json.
-   *
-   * Возвращает название проекта из package.json.
-   * @returns project name or 'none' / название проекта или 'none'
-   */
-  getProjectName(): string {
-    return this.projectName
-  }
-
-  /**
-   * Sends content and a prompt to the AI for processing.
-   *
-   * Отправляет контент и промпт ИИ для обработки.
-   * @param content content for processing / контент для обработки
-   * @param prompt instructions for the AI / инструкции для ИИ
-   * @param code code to optimize / код для оптимизации
-   * @returns AI generated content or undefined / сгенерированный ИИ контент или undefined
-   */
-  async toAi(
-    content: string,
-    prompt: string,
-    code?: string
-  ): Promise<string | undefined> {
-    if (this.isRaw) {
-      return undefined
-    }
-
-    const ai = useAi()
-
-    if (ai) {
-      if (code) {
-        ai.addPrompt(
-          `File JS Code (SUPPLEMENTARY REFERENCE & CONTEXT ONLY):\n`
-          + `The following JavaScript code is provided STRICTLY as supplementary background context to give a full picture of implementation details and logic.\n`
-          + `CRITICAL RESTRICTION: You MUST NOT treat or use this data as "File Content". Do NOT generate, return, or include any classes, methods, functions, or entities from "File JS Code" in the output unless they are explicitly present in "File Content".\n\n`
-          + '```\n'
-          + `${code}\n`
-          + '```'
-        )
-      }
-
-      ai.addPrompt('You are a world-class senior developer and an exceptional technical writer.')
-      ai.addPrompt('CRITICAL DIRECTIVE: No data stored in history, previous chat messages, or prior conversation context must influence the result. Process strictly and exclusively the data provided in the text below.')
-      ai.addPrompt(
-        `TASK INSTRUCTIONS & GOAL:\n`
-        + `The following are the exact rules, requirements, and execution instructions for processing the file content:\n\n`
-        + `${prompt}`
-      )
-      ai.addPrompt(
-        `File Content (PRIMARY DATA TO PROCESS):\n`
-        + `The following is the primary target file content that you MUST process according to the instructions in the prompt above:\n`
-        + '```\n'
-        + `${content}\n`
-        + '```'
-      )
-
-      const generate = await ai.generate('go!')
-
-      if (generate) {
-        return generate
-      }
-    }
-
-    return undefined
-  }
-
-  /**
-   * Sends content and a prompt to the AI for processing and parses the resulting JSON response.
-   *
-   * Отправляет контент и промпт ИИ для обработки и парсит полученный JSON-ответ.
-   * @param content content for processing / контент для обработки
-   * @param prompt instructions for the AI / инструкции для ИИ
-   * @param code code to optimize / код для оптимизации
-   * @returns parsed JSON object or undefined / распарсенный JSON объект или undefined
-   */
-  async toAiJson<T>(
-    content: string,
-    prompt: string,
-    code?: string
-  ): Promise<T | undefined> {
-    const generate = await this.toAi(content, prompt, code)
-
-    if (generate) {
-      try {
-        const cleaned = generate.replace(/```json|```/g, '').trim()
-        return JSON.parse(cleaned) as T
-      } catch {
-        return undefined
-      }
-    }
-
-    return undefined
-  }
-}