@dxtmisha/scripts 1.5.0 → 1.5.2

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.2] - 2026-10-07
+
+### Added
+- **Package Modification Date Tracking in `BuildPackages`**:
+  - Added `--date` (`-t`) CLI option to `dxt-build-packages` (`bin/build-packages.ts`) enabling rebuilds when package modification dates or git commit timestamps change.
+  - Added `BuildPackagesOptions` interface with `{ path, code, logFile, date }` configuration properties.
+  - Added `BuildPackageLogItem` interface (`{ version: string, date?: string }`) supporting structured build log entries.
+  - Added `getDate(packageFile)` method resolving commit timestamp via `GitRead.getFileDate()` with filesystem mtime fallback via `PropertiesFile.getTime()`.
+  - Added `getDateLog(name)` method to extract cached package timestamps from memory/file build logs.
+
+### Changed
+- **`BuildPackages` Constructor & Options Refactoring**:
+  - Refactored `BuildPackages` constructor to accept a unified `BuildPackagesOptions` object instead of separate positional arguments.
+  - Enhanced `updateLog()` to record both `version` and `date` in `ui-build.log.json`.
+  - Updated `getVersionLog()` to maintain backward compatibility with both legacy string-based and new object-based log records.
+  - Updated `isUpdate()` logic to evaluate date invalidation when `date: true` option is enabled.
+  - Updated unit test suite in `BuildPackages.test.ts` covering object-based options, date-driven rebuild detection, and log persistence.
+
+## [1.5.1] - 2026-10-05
+
+### Added
+- **`./ui` Export Subpath**:
+  - Added `"./ui"` export in `package.json` pointing to `./dist/library-ui.d.ts` and `./dist/library-ui.js`, enabling granular tree-shakeable imports of UI scaffolding and design system constructors (`ComponentCreator`, `DesignConstructors`, `DesignFlags`, `DesignUi`, `DesignWikiStorm`, `PackageInit`).
+
+### Changed
+- **Lazy Initialization in `PropertiesConfig`**:
+  - Converted `PropertiesConfig.config` from an eager static property evaluated at module load time (`static { this.config = this.loadConfig() }`) to a lazy caching getter `get config()`, eliminating top-level module side effects and enabling complete tree shaking.
+- **Lazy Initialization in `PropertiesFile`**:
+  - Converted `PropertiesFile.root` and `PropertiesFile.module` from eager static initialization to lazy getters `get root()` and `get module()`, moving directory resolution inside getter execution and eliminating static block evaluation.
+- **Dependency & Peer Dependency Updates**:
+  - Updated dependencies `@dxtmisha/functional` (>=1.15.18), `@dxtmisha/functional-basic` (>=1.11.2), `@dxtmisha/media` (>=0.8.1), and `sass` (>=1.105.1).
+  - Updated optional peer dependencies including `@ai-sdk/xai`, `@anthropic-ai/sdk`, `@google/genai`, `ai`, `openai`, and `puppeteer`.
+
+### Fixed
+- **Tree-Shaking Pure Annotations (`/*#__PURE__*/`)**:
+  - Added `/*#__PURE__*/` annotations to top-level `promisify(execFile)` in `src/functions/run.ts` and `src/classes/Build/BuildPublishPackages.ts`.
+  - Added `/*#__PURE__*/` annotation to top-level `AI_PROVIDER_REGISTRY = new Map(...)` in `src/composables/useAi.ts`, preventing bundlers from treating module initialization as an unshakeable side effect.
+- **Resilient File Reading in `PropertiesFile`**:
+  - Added safe `try / catch` handling in `PropertiesFile.readFile` and `PropertiesFile.readFileOnly` to safely return `undefined` when reading non-existent, unreadable, or mocked files without throwing uncaught filesystem exceptions.
+
+## [1.5.0] - 2026-10-04
+
+### Added
+- **`--library` Option in `dxt-component` CLI**:
+  - Added `--library` (`-l`) boolean option in `bin/design-component.ts` (default `false`) allowing explicit generation of library entry files when scaffolding new components.
+  - Added `makeLibrary()` method to `ComponentItem` (`src/classes/Component/ComponentItem.ts`) which conditionally creates `src/library/component-[Name].ts` exporting the component index.
+- **Global AI Rules for Pure Annotations & PurgeCSS**:
+  - Added Rule 12 (**Mandatory Pure Annotations (`/*#__PURE__*/`)**) to `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` requiring top-level calls, constructor invocations, and pure factory functions to be annotated with `/*#__PURE__*/` for dead-code elimination.
+  - Added Rule 13 (**PurgeCSS & CSS Tree-Shaking Compatibility**) to `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` prohibiting dynamic class name string concatenation and requiring unbroken class name literals, dictionaries, or safelist blocks.
+
+### Changed
+- **Default `isLibrary` Value in Component Generator**:
+  - Changed default constructor parameter `isLibrary: boolean = false` in `ComponentCreator` (`src/classes/Component/ComponentCreator.ts`).
+  - Changed default constructor parameter `isLibrary: boolean = false` in `ComponentItem` (`src/classes/Component/ComponentItem.ts`).
+  - Updated CLI instantiation in `bin/design-component.ts` to `new ComponentCreator(Boolean(values.library)).make()`.
+  - Updated test suites in `ComponentCreator.test.ts` and `ComponentItem.test.ts` to test default behavior and explicit `isLibrary: true` generation.
+
 ## [1.4.0] - 2026-09-23
 
 ### Added

package/bin/build-packages.ts

@@ -6,13 +6,18 @@ import { BuildPackages } from '../dist/library.js'
 
 const { values } = parseCliArguments(
   'Scans, sorts, and builds monorepo packages managing build order by priorities.',
-  'Usage: dxt-build-packages [--code CODE] [--dir DIR] [--log LOG]',
+  'Usage: dxt-build-packages [--code CODE] [--date] [--dir DIR] [--log LOG]',
   {
     code: {
       type: 'string',
       short: 'c',
       description: 'Custom build command or script name to execute'
     },
+    date: {
+      type: 'boolean',
+      short: 't',
+      description: 'Compare package modification date in addition to version'
+    },
     dir: {
       type: 'string',
       short: 'd',
@@ -29,8 +34,14 @@ const { values } = parseCliArguments(
 const dir = typeof values.dir === 'string' ? values.dir : undefined
 const code = typeof values.code === 'string' ? values.code : undefined
 const log = typeof values.log === 'string' ? values.log : undefined
+const date = typeof values.date === 'boolean' ? values.date : undefined
 
-new BuildPackages(dir, code, log)
+new BuildPackages({
+  path: dir,
+  code,
+  logFile: log,
+  date
+})
   .make()
   .catch((error) => {
     console.error('dxt-build-packages failed:', error)

package/dist/{AiZAi-3DWR6wJr.js → AiZAi-B0f94-JR.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./PropertiesConfig-BBsuNndv.js";
+import { t as e } from "./PropertiesConfig-Cs_MJJNq.js";
 import { forEach as t, isFilled as n, random as r, sleep as i } from "@dxtmisha/functional-basic";
 //#region src/classes/Ai/AiAbstract.ts
 var a = class {

package/dist/{PropertiesConfig-BBsuNndv.js → PropertiesConfig-Cs_MJJNq.js}

@@ -10,9 +10,25 @@ function m(e) {
 }
 //#endregion
 //#region src/classes/Properties/PropertiesFile.ts
-var h = d.dirname(f(import.meta.url)), g = class {
-	static root;
-	static module;
+var h = class {
+	static _root;
+	static _module;
+	static get root() {
+		return this._root === void 0 && (this._root = process.cwd()), this._root;
+	}
+	static set root(e) {
+		this._root = e;
+	}
+	static get module() {
+		if (this._module === void 0) {
+			let e = d.dirname(f(import.meta.url));
+			this._module = !!e.match("node_modules");
+		}
+		return this._module;
+	}
+	static set module(e) {
+		this._module = e;
+	}
 	static is(e) {
 		return u.existsSync(this.joinPath(e));
 	}
@@ -92,10 +108,18 @@ var h = d.dirname(f(import.meta.url)), g = class {
 		}), a;
 	}
 	static readFile(e) {
-		if (this.is(e)) return c(u.readFileSync(this.joinPath(e)).toString());
+		if (this.is(e)) try {
+			return c(u.readFileSync(this.joinPath(e)).toString());
+		} catch {
+			return;
+		}
 	}
 	static readFileOnly(e) {
-		if (this.is(e)) return u.readFileSync(this.joinPath(e)).toString();
+		if (this.is(e)) try {
+			return u.readFileSync(this.joinPath(e)).toString();
+		} catch {
+			return;
+		}
 	}
 	static createDir(e) {
 		let t = [this.root];
@@ -130,11 +154,14 @@ var h = d.dirname(f(import.meta.url)), g = class {
 	static removeRootInPath(e) {
 		return this.joinPath(e).replace(`${this.root}${d.sep}`, "").replace(`${this.root}`, "");
 	}
-	static {
-		this.module = !!h.match("node_modules"), this.root = process.cwd();
+}, g = class {
+	static _config;
+	static get config() {
+		return this._config ||= this.loadConfig(), this._config;
+	}
+	static set config(e) {
+		this._config = e;
 	}
-}, _ = class {
-	static config;
 	static isPromptPackageOnly() {
 		return !!this.config?.promptPackageOnly;
 	}
@@ -217,9 +244,9 @@ var h = d.dirname(f(import.meta.url)), g = class {
 		return this.config?.wikiLanguage ?? "en";
 	}
 	static getExtends(e, t = []) {
-		let n = [...t, m(e)], r = this.getLocalPath(n), i = g.readFile(n), a = g.readFile(r), o = a?.extends ?? i?.extends;
+		let n = [...t, m(e)], r = this.getLocalPath(n), i = h.readFile(n), a = h.readFile(r), o = a?.extends ?? i?.extends;
 		return o ? {
-			...this.getExtends(o, [g.getPathDir(n)]),
+			...this.getExtends(o, [h.getPathDir(n)]),
 			...i,
 			...a
 		} : {
@@ -239,12 +266,12 @@ var h = d.dirname(f(import.meta.url)), g = class {
 		let t = [];
 		for (let n = 0; n < 32; n++) {
 			let n = [...t, e], r = this.getLocalPath(n);
-			if (g.is(n) || g.is(r)) {
-				let e = g.readFile(n), t = g.readFile(r);
+			if (h.is(n) || h.is(r)) {
+				let e = h.readFile(n), t = h.readFile(r);
 				if (e || t) {
 					let r = t?.extends ?? e?.extends;
 					return r ? {
-						...this.getExtends(r, [g.getPathDir(n)]),
+						...this.getExtends(r, [h.getPathDir(n)]),
 						...e,
 						...t
 					} : {
@@ -257,9 +284,6 @@ var h = d.dirname(f(import.meta.url)), g = class {
 		}
 		return {};
 	}
-	static {
-		this.config = this.loadConfig();
-	}
 };
 //#endregion
-export { g as n, _ as t };
+export { h as n, g as t };

package/dist/library-ai.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s, u as c } from "./AiZAi-3DWR6wJr.js";
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s, u as c } from "./AiZAi-B0f94-JR.js";
 export { c as AiAbstract, o as AiClaude, t as AiClaudeLite, e as AiGoogle, i as AiGoogleLite, a as AiOpenAi, n as AiOpenAiLite, s as AiZAi, r as AiZAiLite };

package/dist/library-figma.js

@@ -1,4 +1,4 @@
-import { t as e } from "./PropertiesConfig-BBsuNndv.js";
+import { t as e } from "./PropertiesConfig-Cs_MJJNq.js";
 import { n as t, t as n } from "./figmaApiTypes-CArSsNW8.js";
 //#region src/classes/FigmaApi.ts
 var r = class {

package/dist/library-ui.js

@@ -1,6 +1,6 @@
-import { n as e, t } from "./PropertiesConfig-BBsuNndv.js";
+import { n as e, t } from "./PropertiesConfig-Cs_MJJNq.js";
 import { UI_DIRS_COMPONENTS as n, UI_DIRS_CONSTRUCTOR as r, UI_DIRS_ICONS as i, UI_DIRS_LIBRARY as a, UI_DIRS_STYLES as o, UI_DIRS_TOKENS as s, UI_DIRS_WIKI as c, UI_DIR_COMPONENTS as l, UI_DIR_CONSTRUCTOR as u, UI_DIR_DIST as d, UI_DIR_STRUCTURE as f, UI_EXTENSION_STYLE as p, UI_FILE_NAME_DESIGN as ee, UI_FILE_NAME_MEDIA as te, UI_FILE_NAME_PLUGIN as ne, UI_FILE_NAME_STYLE as re, UI_FILE_NAME_WIKI as ie, UI_FILE_PACKAGE as ae, UI_FILE_PROPERTY as m, UI_FILE_STYLE_PROPERTIES as oe, UI_FILE_STYLE_SCSS as se, UI_KEY_CUSTOM as ce, UI_PROJECT_CONSTRUCTOR_FULL_NAME as le, UI_PROJECT_CONSTRUCTOR_NAME as h, UI_PROPERTY_FOR_PROPS as ue, UI_STRUCTURE_CLASSES as de } from "./config.js";
-import { a as g, i as fe, n as _, r as v, t as y } from "./propertyTypes-CeW8CD8G.js";
+import { a as g, i as fe, n as _, r as v, t as y } from "./propertyTypes-C2TYOJLH.js";
 import { ServerStorage as pe, copyObject as me, forEach as b, getColumn as x, isArray as S, isFilled as C, isNull as he, isObject as w, isObjectNotArray as T, isSelected as E, isString as ge, replaceComponentName as _e, replaceRecursive as D, splice as ve, strFill as ye, toArray as O, toCamelCase as k, toCamelCaseFirst as A, toKebabCase as j, uniqueArray as be } from "@dxtmisha/functional-basic";
 import M from "typescript";
 import * as xe from "sass";

package/dist/library.d.ts

@@ -991,6 +991,18 @@ export declare class BrowserItem {
     protected toConsole(text: string): void;
 }
 
+/**
+ * Cached package build log entry.
+ *
+ * Запись лога сборки пакета в кэше.
+ */
+export declare interface BuildPackageLogItem {
+    /** Package version / Версия пакета */
+    version: string;
+    /** Last modification date or commit timestamp / Дата последнего изменения или временная метка коммита */
+    date?: string;
+}
+
 /**
  * Orchestrator for scanning, sorting, and building monorepo packages.
  * Manages build order based on package priorities and tracks build versions via log cache.
@@ -999,20 +1011,20 @@ export declare class BrowserItem {
  * Управляет порядком сборки на основе приоритетов пакетов и отслеживает версии сборки через лог-кэш.
  */
 export declare class BuildPackages {
+    protected readonly options: BuildPackagesOptions;
+    /** Map of cached package build logs / Карта кэшированных логов сборки пакетов */
+    protected log: Record<string, BuildPackageLogItem | string>;
     protected readonly path: string;
-    protected readonly code?: string | undefined;
-    protected readonly logFile?: string | undefined;
-    /** Map of cached package build versions / Карта кэшированных версий сборки пакетов */
-    protected log: Record<string, string>;
+    protected readonly code?: string;
+    protected readonly logFile?: string;
+    protected readonly date?: boolean;
     /**
-     * Constructor initializes packages path, custom build code, custom log file, and loads build log.
+     * Constructor initializes packages path, custom build code, custom log file, date comparison flag, and loads build log.
      *
-     * Конструктор инициализирует путь к пакетам, пользовательский код сборки, пользовательский файл лога и загружает лог сборки.
-     * @param path packages directory path / путь к директории пакетов
-     * @param code custom build command or script name / пользовательская команда сборки или имя скрипта
-     * @param logFile custom log file name or path / пользовательское имя или путь к файлу лога
+     * Конструктор инициализирует путь к пакетам, пользовательский код сборки, пользовательский файл лога, флаг сравнения дат и загружает лог сборки.
+     * @param options configuration options / параметры конфигурации
      */
-    constructor(path?: string, code?: string | undefined, logFile?: string | undefined);
+    constructor(options?: BuildPackagesOptions);
     /**
      * Scans the packages directory and builds each package that contains a package.json.
      *
@@ -1024,7 +1036,7 @@ export declare class BuildPackages {
      *
      * Проверяет, нужно ли обновлять пакет.
      * @param packageFile package file object / объект файла пакета
-     * @returns true if version differs from log cache / true, если версия отличается от кэша лога
+     * @returns true if version or modification date differs from log cache / true, если версия или дата изменения отличается от кэша лога
      */
     protected isUpdate(packageFile: PackageFile): boolean;
     /**
@@ -1035,6 +1047,22 @@ export declare class BuildPackages {
      * @returns command string or undefined / строка команды или undefined
      */
     protected getCode(packageFile: PackageFile): string | undefined;
+    /**
+     * Returns the last modification date of the package.
+     *
+     * Возвращает дату последнего изменения пакета.
+     * @param packageFile package file instance / экземпляр файла пакета
+     * @returns commit date string / строка даты коммита
+     */
+    protected getDate(packageFile: PackageFile): string;
+    /**
+     * Returns the cached modification date of the package from the build log.
+     *
+     * Возвращает кэшированную дату изменения пакета из лога сборки.
+     * @param name package name / имя пакета
+     * @returns cached date string or undefined / строка кэшированной даты или undefined
+     */
+    protected getDateLog(name: string): string | undefined;
     /**
      * Returns the path segments to the build log file.
      *
@@ -1051,9 +1079,9 @@ export declare class BuildPackages {
      */
     protected getVersionLog(name: string): string;
     /**
-     * Updates the build log with the current package version in memory.
+     * Updates the build log with the current package version and date in memory.
      *
-     * Обновляет лог сборки текущей версией пакета в памяти.
+     * Обновляет лог сборки текущей версией и датой пакета в памяти.
      * @param packageFile package file object / объект файла пакета
      */
     protected updateLog(packageFile: PackageFile): void;
@@ -1088,6 +1116,22 @@ export declare class BuildPackages {
     private getList;
 }
 
+/**
+ * Configuration options for BuildPackages.
+ *
+ * Параметры конфигурации для BuildPackages.
+ */
+export declare interface BuildPackagesOptions {
+    /** Directory path to packages / Путь к директории пакетов */
+    path?: string;
+    /** Custom build command or script name / Пользовательская команда сборки или имя скрипта */
+    code?: string;
+    /** Custom log file name or path / Пользовательское имя или путь к файлу лога */
+    logFile?: string;
+    /** Whether to compare package modification date in addition to version / Сравнивать ли дату изменения пакета дополнительно к версии */
+    date?: boolean;
+}
+
 /**
  * Orchestrator for scanning and publishing changed packages to the npm registry.
  * Compares current package versions against published versions in npm and publishes updated packages.
@@ -4393,8 +4437,40 @@ declare interface PackageJsonData {
  * Этот класс предоставляет стандартизированный интерфейс для всех операций ввода-вывода в рамках дизайн-системы, включая нормализацию путей, рекурсивный обход директорий, синхронное чтение/запись файлов и получение метаданных. Он абстрагирует различия путей в разных ОС и обеспечивает согласованную обработку данных во всей цепочке инструментов.
  */
 export declare class PropertiesFile {
-    protected static root: string;
-    protected static module: boolean;
+    protected static _root?: string;
+    protected static _module?: boolean;
+    /**
+     * Root directory path (lazily evaluated).
+     *
+     * Корневой путь директории (ленивая инициализация).
+     * @returns root path / корневой путь
+     * @protected
+     */
+    protected static get root(): string;
+    /**
+     * Sets the root directory path.
+     *
+     * Устанавливает корневой путь директории.
+     * @param value root path / корневой путь
+     * @protected
+     */
+    protected static set root(value: string | undefined);
+    /**
+     * Whether the package is connected as a module (lazily evaluated).
+     *
+     * Подключен ли пакет как модуль (ленивая инициализация).
+     * @returns boolean
+     * @protected
+     */
+    protected static get module(): boolean;
+    /**
+     * Sets whether the package is connected as a module.
+     *
+     * Устанавливает, подключен ли пакет как модуль.
+     * @param value boolean
+     * @protected
+     */
+    protected static set module(value: boolean | undefined);
     /**
      * Synchronously checks for the existence of a file or directory at the specified path.
      *