@dxtmisha/scripts 0.8.2 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.8.2] - 2026-05-13
+
+### Changed
+- **Type Generation**: Modified `DesignReplace.ts` to implement stricter typing for generated component properties. Removed the automatic addition of the generic `string` type to union prop definitions, ensuring generated components use precise literal types.
+- **Wiki Integration**: Updated `DesignWikiStormItem.ts` to improve technical data generation for the wiki system.
+
 ## [0.8.0] - 2026-05-10
 
 ### Added

package/bin/build-functional.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env vite-node
 
-import { BuildFunctional } from '../src/classes/Build/buildFunctional'
+import { BuildFunctional } from '../src/classes/Build/BuildFunctional'
 
 new BuildFunctional().make()

package/bin/build-packages.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env vite-node
+
+import { BuildPackages } from '../src/classes/Build/BuildPackages'
+
+new BuildPackages()
+  .make()
+  .then()

package/bin/build-publish-packages.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env vite-node
+
+import { BuildPublishPackages } from '../src/classes/Build/BuildPublishPackages'
+
+new BuildPublishPackages()
+  .make()
+  .then()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.8.2",
+  "version": "0.9.0",
   "type": "module",
   "description": "Development scripts and CLI tools for DXT UI projects - automated component generation, library building and project management tools",
   "keywords": [
@@ -44,6 +44,8 @@
   "bin": {
     "dxt-ai-doc": "bin/ai-doc.ts",
     "dxt-build-functional": "bin/build-functional.ts",
+    "dxt-build-packages": "bin/build-packages.ts",
+    "dxt-build-publish-packages": "bin/build-publish-packages.ts",
     "dxt-component": "bin/design-component.ts",
     "dxt-component-wiki": "bin/design-component-wiki.ts",
     "dxt-constructor": "bin/design-constructor.ts",

package/src/classes/Build/BuildPackages.ts

@@ -0,0 +1,111 @@
+import { run } from '../../functions/run'
+
+import { PropertiesFile } from '../Properties/PropertiesFile'
+import { PackageFile } from '../Package/PackageFile'
+
+import { UI_DIR_PACKAGES } from '../../config'
+
+const UI_BUILD_LOG_FILE = ['.', 'logs', 'ui-build.log.json']
+
+/**
+ * Class for building all packages in the project.
+ *
+ * Класс для сборки всех пакетов в проекте.
+ */
+export class BuildPackages {
+  protected readonly log: Record<string, string>
+
+  /**
+   * Constructor
+   * @param path packages directory path / путь к директории пакетов
+   */
+  constructor(
+    protected readonly path: string = UI_DIR_PACKAGES
+  ) {
+    this.log = PropertiesFile.readFile(UI_BUILD_LOG_FILE) ?? {}
+  }
+
+  /**
+   * Scans the packages directory and builds each package that contains a package.json.
+   *
+   * Сканирует директорию пакетов и собирает каждый пакет, содержащий package.json.
+   */
+  async make(): Promise<void> {
+    const list = PropertiesFile.readDir(this.path)
+    let changed = 0
+
+    console.info(`Build packages(${list.length})...`)
+
+    for (const folder of list) {
+      const packageFile = new PackageFile([this.path, folder])
+
+      if (
+        packageFile.is()
+        && !packageFile.isTest()
+        && this.isUpdate(packageFile)
+        && await this.build(packageFile)
+      ) {
+        this.updateLog(packageFile)
+        changed++
+      }
+    }
+
+    if (changed > 0) {
+      this.saveLog()
+      console.info(`Build packages changed: ${changed}`)
+    } else {
+      console.info('Build packages - no changes')
+    }
+  }
+
+  protected async build(packageFile: PackageFile): Promise<boolean> {
+    const code = packageFile.getCodeBuildOrRecovery()
+
+    if (code) {
+      return await run(packageFile, `npm run ${code}`)
+    }
+
+    return false
+  }
+
+  /**
+   * Checks if the package needs to be updated.
+   *
+   * Проверяет, нужно ли обновлять пакет.
+   * @param packageFile package file object / объект файла пакета
+   */
+  protected isUpdate(packageFile: PackageFile): boolean {
+    return !packageFile.isVersionConsistency(
+      this.getVersionLog(packageFile.getName())
+    )
+  }
+
+  /**
+   * Returns the cached version of the package from the build log.
+   *
+   * Возвращает кэшированную версию пакета из лога сборки.
+   * @param name package name / имя пакета
+   */
+  protected getVersionLog(name: string): string {
+    return this.log?.[name] ?? '0.0.0'
+  }
+
+  /**
+   * Updates the build log with the current package version in memory.
+   *
+   * Обновляет лог сборки текущей версией пакета в памяти.
+   * @param packageFile package file object / объект файла пакета
+   */
+  protected updateLog(packageFile: PackageFile): void {
+    this.log[packageFile.getName()] = packageFile.getVersion()
+  }
+
+  /**
+   * Saves the build log to a file.
+   *
+   * Сохраняет лог сборки в файл.
+   */
+  protected saveLog(): void {
+    PropertiesFile.writeByPath(UI_BUILD_LOG_FILE, this.log)
+  }
+}

package/src/classes/Build/BuildPublishPackages.ts

@@ -0,0 +1,105 @@
+import { PropertiesFile } from '../Properties/PropertiesFile'
+import { PackageFile } from '../Package/PackageFile'
+import { run } from '../../functions/run'
+import { UI_DIR_PACKAGES } from '../../config'
+
+const UI_PUBLISH_LOG_FILE = ['.', 'logs', 'ui-publish.log.json']
+
+/**
+ * Class for publishing all packages in the project.
+ *
+ * Класс для публикации всех пакетов в проекте.
+ */
+export class BuildPublishPackages {
+  protected readonly log: Record<string, string>
+
+  /**
+   * Constructor
+   * @param path packages directory path / путь к директории пакетов
+   */
+  constructor(
+    protected readonly path: string = UI_DIR_PACKAGES
+  ) {
+    this.log = PropertiesFile.readFile(UI_PUBLISH_LOG_FILE) ?? {}
+  }
+
+  /**
+   * Scans the packages directory and publishes each package that has a new version.
+   *
+   * Сканирует директорию пакетов и публикует каждый пакет с новой версией.
+   */
+  async make(): Promise<void> {
+    const list = PropertiesFile.readDir(this.path)
+    let changed = 0
+
+    console.info(`Publish packages(${list.length})...`)
+
+    for (const folder of list) {
+      const packageFile = new PackageFile([this.path, folder])
+
+      if (
+        packageFile.is()
+        && !packageFile.isNoPublish()
+      ) {
+        if (
+          this.log[packageFile.getName()] === undefined
+          || (
+            this.isUpdate(packageFile)
+            && await run(packageFile, packageFile.getCodePublish(), true, true)
+          )
+        ) {
+          this.updateLog(packageFile)
+          changed++
+        }
+      }
+    }
+
+    if (changed > 0) {
+      this.saveLog()
+      console.info(`Publish packages changed: ${changed}`)
+    } else {
+      console.info('Publish packages - no changes')
+    }
+  }
+
+  /**
+   * Checks if the package needs to be published.
+   *
+   * Проверяет, нужно ли публиковать пакет.
+   * @param packageFile package file object / объект файла пакета
+   */
+  protected isUpdate(packageFile: PackageFile): boolean {
+    return !packageFile.isVersionConsistency(
+      this.getVersionLog(packageFile.getName())
+    )
+  }
+
+  /**
+   * Returns the cached version of the package from the publish log.
+   *
+   * Возвращает кэшированную версию пакета из лога публикации.
+   * @param name package name / имя пакета
+   */
+  protected getVersionLog(name: string): string {
+    return this.log?.[name] ?? '0.0.0'
+  }
+
+  /**
+   * Updates the publish log with the current package version in memory.
+   *
+   * Обновляет лог публикации текущей версией пакета в памяти.
+   * @param packageFile package file object / объект файла пакета
+   */
+  protected updateLog(packageFile: PackageFile): void {
+    this.log[packageFile.getName()] = packageFile.getVersion()
+  }
+
+  /**
+   * Saves the publish log to a file.
+   *
+   * Сохраняет лог публикации в файл.
+   */
+  protected saveLog(): void {
+    PropertiesFile.writeByPath(UI_PUBLISH_LOG_FILE, this.log)
+  }
+}

package/src/classes/Design/DesignWikiStormItem.ts

@@ -7,6 +7,13 @@ import { PropertiesFile } from '../Properties/PropertiesFile'
 
 import type { LibraryData } from '../../types/libraryTypes'
 import type { WebTypesAttributeItem, WebTypesAttributes, WebTypesEvents, WebTypesSlots, WebTypesTagItem } from '../../types/webTypes'
+import { forEach } from '@dxtmisha/functional-basic'
+
+/**
+ * List of basic types that do not need to be wrapped in quotes for web-types/
+ * Список базовых типов, которые не нужно оборачивать в кавычки для web-types
+ */
+const BASE_TYPES = /^(boolean|number|string|null|any|void|object|unknown|never)$/
 
 /**
  * Resolver for extracting and formatting IDE metadata for a specific component.
@@ -78,13 +85,14 @@ export class DesignWikiStormItem {
    * @param item prop item / элемент свойства
    */
   getAttribute(item: WikiStorybookProp): WebTypesAttributeItem {
+    const type = this.prepareType(item.getType())
     return {
       name: item.getName(),
       description: item.getDescription(),
-      default: item.getDefaultValue(),
+      // default: item.getDefaultValue(),
       value: {
         kind: 'expression',
-        type: item.getType()
+        type
       }
     }
   }
@@ -120,8 +128,8 @@ export class DesignWikiStormItem {
 
       data.slots.forEach(
         props => slots.push({
-          name: props.name,
-          description: props.description,
+          'name': props.name,
+          'description': props.description,
           'vue-properties': props.properties ?? []
         })
       )
@@ -224,6 +232,36 @@ export class DesignWikiStormItem {
     ]
   }
 
+  /**
+   * Formats a type string for web-types.
+   *
+   * Форматирует строку типа для web-types.
+   * @param type original type string / исходная строка типа
+   */
+  protected prepareType(type?: string): string | undefined {
+    if (type) {
+      return forEach(
+        type.split('|'),
+        (item) => {
+          const trimmed = item.trim()
+
+          if (trimmed === 'undefined') {
+            return undefined
+          }
+
+          if (BASE_TYPES.test(trimmed)) {
+            return trimmed
+          }
+
+          return `'${trimmed}'`
+        }
+      )
+        .join(' | ')
+    }
+
+    return type
+  }
+
   /**
    * Initializes the wiki object.
    *

package/src/classes/Package/PackageFile.ts

@@ -0,0 +1,150 @@
+import { toArray } from '@dxtmisha/functional-basic'
+import { PropertiesFile } from '../Properties/PropertiesFile'
+import { UI_FILE_PACKAGE } from '../../config'
+
+/**
+ * Class for working with the package.json file.
+ *
+ * Класс для работы с файлом package.json.
+ */
+export class PackageFile {
+  protected readonly data?: Record<string, any>
+
+  /**
+   * Constructor
+   * @param path path to the directory containing package.json / путь к директории, содержащей package.json
+   */
+  constructor(
+    protected readonly path: string | string[]
+  ) {
+    if (this.is()) {
+      this.data = PropertiesFile.readFile(this.getPath()) ?? {}
+    }
+  }
+
+  /**
+   * Checks if the directory is a package (contains package.json).
+   *
+   * Проверяет, является ли директория пакетом (содержит package.json).
+   */
+  is(): boolean {
+    return PropertiesFile.is(this.getPath())
+  }
+
+  /**
+   * Checks if the package version matches the specified version.
+   *
+   * Проверяет, соответствует ли версия пакета указанной версии.
+   * @param version version to compare with / версия для сравнения
+   */
+  isVersionConsistency(version?: string): boolean {
+    return Boolean(version) && this.getVersion() === version
+  }
+
+  /**
+   * Checks if the package is a test package.
+   *
+   * Проверяет, является ли пакет тестовым.
+   */
+  isTest(): boolean {
+    return this.get()?.['ui-test'] === true
+  }
+
+  /**
+   * Checks if the package should not be published.
+   *
+   * Проверяет, не должен ли пакет публиковаться.
+   */
+  isNoPublish(): boolean {
+    const data = this.get()
+    return data?.['ui-no-publish'] === true || data?.private === true
+  }
+
+  /**
+   * Returns the package data.
+   *
+   * Возвращает данные пакета.
+   */
+  get(): Record<string, any> {
+    return this.data ?? {}
+  }
+
+  /**
+   * Returns the package name.
+   *
+   * Возвращает имя пакета.
+   */
+  getName(): string {
+    return this.get()?.name ?? PropertiesFile.joinPath(this.getDir())
+  }
+
+  /**
+   * Returns the package version.
+   *
+   * Возвращает версию пакета.
+   */
+  getVersion(): string {
+    return this.get()?.version ?? '0.0.0'
+  }
+
+  /**
+   * Returns the package scripts.
+   *
+   * Возвращает скрипты пакета.
+   */
+  getScripts(): Record<string, string> {
+    return this.get()?.scripts ?? {}
+  }
+
+  /**
+   * Returns the package directory path segments.
+   *
+   * Возвращает сегменты пути к директории пакета.
+   */
+  getDir(): string[] {
+    return toArray(this.path)
+  }
+
+  /**
+   * Returns the package path.
+   *
+   * Возвращает путь к пакету.
+   */
+  getPath(): string[] {
+    return [...this.getDir(), UI_FILE_PACKAGE]
+  }
+
+  /**
+   * Returns the command name for build or build-recovery.
+   *
+   * Возвращает название команды для build или build-recovery.
+   */
+  getCodeBuildOrRecovery(): string | undefined {
+    const scripts = this.getScripts()
+
+    if ('build-recovery' in scripts) {
+      return 'build-recovery'
+    }
+
+    if ('build' in scripts) {
+      return 'build'
+    }
+
+    return undefined
+  }
+
+  /**
+   * Returns the command name for publish or publish-to-npm.
+   *
+   * Возвращает название команды для publish или publish-to-npm.
+   */
+  getCodePublish(): string {
+    const scripts = this.getScripts()
+
+    if ('publish-to-npm' in scripts) {
+      return 'npm run publish-to-npm'
+    }
+
+    return 'npm publish --access public'
+  }
+}

package/src/functions/run.ts

@@ -0,0 +1,47 @@
+import { promisify } from 'node:util'
+import { exec } from 'node:child_process'
+
+import { PackageFile } from '../classes/Package/PackageFile'
+import { PropertiesFile } from '../classes/Properties/PropertiesFile'
+
+const execAsync = promisify(exec)
+
+/**
+ * Executes a command for a specific package.
+ *
+ * Выполняет команду для конкретного пакета.
+ * @param packageFile package file object / объект файла пакета
+ * @param command command to execute / команда для выполнения
+ * @param showStdout whether to show stdout in the console / нужно ли выводить stdout в консоль
+ * @param showStderr whether to show stderr in the console / нужно ли выводить stderr в консоль
+ */
+export async function run(
+  packageFile: PackageFile,
+  command: string,
+  showStdout: boolean = false,
+  showStderr: boolean = false
+): Promise<boolean> {
+  const name = packageFile.getName()
+
+  try {
+    const { stdout, stderr } = await execAsync(command, {
+      cwd: PropertiesFile.joinPath(packageFile.getDir())
+    })
+
+    console.log(`Command ${command} for ${name}`)
+
+    if (stdout && showStdout) {
+      console.log(stdout)
+    }
+
+    if (stderr && showStderr) {
+      console.error(stderr)
+    }
+
+    return true
+  } catch (error) {
+    console.error(`Error command ${command} for ${name}:`, error)
+
+    return false
+  }
+}

package/src/library.ts

@@ -15,7 +15,7 @@ export * from './classes/Ai/AiGoogleCli'
 export * from './classes/Ai/AiGoogleCliLite'
 export * from './classes/Ai/AiGoogleLite'
 export * from './classes/BrowserItem'
-export * from './classes/Build/buildFunctional'
+export * from './classes/Build/BuildFunctional'
 export * from './classes/BuildItem'
 export * from './classes/Design/DesignFigma'
 export * from './classes/Design/DesignScreenshot'

package/src/media/templates/packages/library/package.json

@@ -15,22 +15,26 @@
   },
   "files": [
     "dist",
-    "README.md",
-    "package.json"
+    "ai-description.txt",
+    "ai-doc.ru.txt",
+    "ai-doc.txt",
+    "ai-types.txt",
+    "CHANGELOG.md",
+    "LICENSE",
+    "package.json",
+    "README.md"
   ],
   "main": "dist/library.js",
   "module": "dist/library.js",
-  "types": "dist/library.d.ts",
+  "types": "dist/src/library.d.ts",
   "exports": {
     ".": {
       "import": "./dist/library.js",
-      "types": "./dist/library.d.ts"
+      "types": "./dist/src/library.d.ts"
     },
-    "./style.css": "./dist/style.css",
-    "./types/*": "./dist/*",
-    "./types/**/*.d.ts": "./dist/**/*.d.ts"
+    "./style.css": "./dist/style.css"
   },
   "dependencies": {},
   "devDependencies": {},
   "sideEffects": false
-}
+}

package/src/types/webTypes.ts

@@ -25,7 +25,7 @@ export type WebTypesProperties = WebTypesProperty[]
  *
  * Вид значения атрибута.
  */
-export type WebTypesAttributeKind = 'expression' | 'string'
+export type WebTypesAttributeKind = 'expression' | 'plainText' | 'string'
 
 /**
  * Attribute definition for a tag.

package/src/classes/Build/__tests__/buildFunctional.test.ts

@@ -1,43 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-import { BuildFunctional } from '../buildFunctional'
-import { PropertiesFile } from '../../Properties/PropertiesFile'
-import { UI_DIRS_LIBRARY } from '../../../config'
-
-vi.mock('@dxtmisha/functional', () => ({
-  func1: vi.fn(),
-  func2: vi.fn()
-}))
-
-vi.mock('../../Properties/PropertiesFile', () => ({
-  PropertiesFile: {
-    writeByPath: vi.fn()
-  }
-}))
-
-describe('BuildFunctional', () => {
-  it('getList should return keys of the functional package', () => {
-    const build = new BuildFunctional()
-    const list = build.getList()
-    expect(list).toContain('func1')
-    expect(list).toContain('func2')
-    expect(list).toHaveLength(2)
-  })
-
-  it('make should call PropertiesFile.writeByPath with correct arguments', () => {
-    const build = new BuildFunctional()
-    build.make()
-
-    expect(PropertiesFile.writeByPath).toHaveBeenCalledWith(
-      [...UI_DIRS_LIBRARY, 'functional.ts'],
-      expect.stringContaining('export { func1 } from \'@dxtmisha/functional\'')
-    )
-    expect(PropertiesFile.writeByPath).toHaveBeenCalledWith(
-      [...UI_DIRS_LIBRARY, 'functional.ts'],
-      expect.stringContaining('export { func2 } from \'@dxtmisha/functional\'')
-    )
-    expect(PropertiesFile.writeByPath).toHaveBeenCalledWith(
-      [...UI_DIRS_LIBRARY, 'functional.ts'],
-      expect.stringContaining('export type * from \'@dxtmisha/functional\'')
-    )
-  })
-})