@dxtmisha/scripts 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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/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

@@ -4393,8 +4393,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.
      *

package/dist/library.js

@@ -1,7 +1,7 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c, u as l } from "./AiZAi-3DWR6wJr.js";
-import { n as u, t as d } from "./PropertiesConfig-BBsuNndv.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c, u as l } from "./AiZAi-B0f94-JR.js";
+import { n as u, t as d } from "./PropertiesConfig-Cs_MJJNq.js";
 import { UI_DIRS_FILE_EXPORT as ee, UI_DIRS_LIST_EXPORT as te, UI_DIR_AI_PROMPTS as ne, UI_DIR_AI_PROMPT_SCREENSHOT as f, UI_DIR_AI_TYPES as p, UI_DIR_AI_TYPES_LIST as m, UI_DIR_PACKAGES as h, UI_DIR_RESOURCES as re, UI_FILE_AI_AGENTS as ie, UI_FILE_AI_DESCRIPTION as g, UI_FILE_AI_MCP as _, UI_FILE_AI_MCP_ALL as v, UI_FILE_AI_MCP_ALL_TS as y, UI_FILE_AI_PROMPT_DESCRIPTION as ae, UI_FILE_AI_PROMPT_DEVELOPER as b, UI_FILE_AI_PROMPT_INFO as oe, UI_FILE_AI_PROMPT_INSTRUCTION as se, UI_FILE_AI_PROMPT_PROMPT as x, UI_FILE_AI_PROMPT_SCREENSHOT_CODE as S, UI_FILE_AI_PROMPT_SCREENSHOT_JSON as ce, UI_FILE_AI_PROMPT_SCREENSHOT_STYLES as C, UI_FILE_AI_PROMPT_TYPES as w, UI_FILE_AI_TYPES as T, UI_FILE_GITIGNORE as le, UI_FILE_PACKAGE as ue, UI_FLAG_AI_NONE as de, UI_FLAG_NOT_EXPORT as fe, UI_MODULES as E } from "./config.js";
-import { a as D, i as pe, n as me, r as he, t as ge } from "./propertyTypes-CeW8CD8G.js";
+import { a as D, i as pe, n as me, r as he, t as ge } from "./propertyTypes-C2TYOJLH.js";
 import { n as _e, t as ve } from "./figmaApiTypes-CArSsNW8.js";
 import { Datetime as ye, ServerStorage as O, forEach as k, isArray as A, isFilled as j, isObject as M, isString as N, removeCommonPrefix as be, sleep as xe, toArray as P, toCamelCaseFirst as F, uniqueArray as Se } from "@dxtmisha/functional-basic";
 import Ce from "node:fs";
@@ -344,7 +344,7 @@ var Te = "./ai-tmp", V = class e {
 	getCodePublish() {
 		return "publish-to-npm" in this.getScripts() ? "npm run publish-to-npm" : "npm publish --access public";
 	}
-}, Ie = R(I);
+}, Ie = /*#__PURE__*/ R(I);
 async function Y(e, t, n = !1, r = !1) {
 	let i = e.getName(), [a, ...o] = t.split(" ");
 	try {
@@ -479,7 +479,7 @@ var Le = /^\/+|\/+$/g, X = class {
 		}
 		return t.sort((e, t) => (e.get()?.["ui-priority"] ?? 500) - (t.get()?.["ui-priority"] ?? 500));
 	}
-}, Be = R(I), Ve = class {
+}, Be = /*#__PURE__*/ R(I), Ve = class {
 	path;
 	constructor(e = h) {
 		this.path = e;
@@ -509,7 +509,7 @@ var Le = /^\/+|\/+$/g, X = class {
 			return;
 		}
 	}
-}, He = /* @__PURE__ */ new Map([
+}, He = /*#__PURE__*/ new Map([
 	["antigravity-cli", () => new U()],
 	["claude", () => new s()],
 	["claude-agent", () => new G()],

package/dist/{propertyTypes-CeW8CD8G.js → propertyTypes-C2TYOJLH.js}

@@ -1,4 +1,4 @@
-import { n as e, t } from "./PropertiesConfig-BBsuNndv.js";
+import { n as e, t } from "./PropertiesConfig-Cs_MJJNq.js";
 import { UI_DIRS_LIBRARY as n, UI_DIR_PACKAGES as r, UI_FILE_PACKAGE as i } from "./config.js";
 import { forEach as a, isFilled as o } from "@dxtmisha/functional-basic";
 import s from "node:path";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "1.5.0",
+  "version": "1.5.1",
   "type": "module",
   "description": "CLI tools, AI integration scripts, and automation utilities for DXT UI — automated component scaffolding, Figma layout generation, library packaging, documentation building, screenshot captures, and AI prompt processing.",
   "keywords": [
@@ -84,6 +84,10 @@
       "types": "./dist/library-figma.d.ts",
       "default": "./dist/library-figma.js"
     },
+    "./ui": {
+      "types": "./dist/library-ui.d.ts",
+      "default": "./dist/library-ui.js"
+    },
     "./config": {
       "types": "./dist/config.d.ts",
       "default": "./dist/config.js"
@@ -94,27 +98,27 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@dxtmisha/functional": ">=1.15.16",
-    "@dxtmisha/functional-basic": ">=1.11.0",
-    "@dxtmisha/media": ">=0.7.4",
-    "sass": ">=1.104.1",
+    "@dxtmisha/functional": ">=1.15.18",
+    "@dxtmisha/functional-basic": ">=1.11.2",
+    "@dxtmisha/media": ">=0.8.1",
+    "sass": ">=1.105.1",
     "typescript": ">=6.0.3",
     "vite-node": ">=6.0.0",
     "vue": ">=3.5.43"
   },
   "devDependencies": {
-    "puppeteer": ">=25.9.0"
+    "puppeteer": ">=25.12.0"
   },
   "peerDependencies": {
-    "@ai-sdk/xai": ">=4.0.50",
-    "@anthropic-ai/claude-agent-sdk": ">=0.3.251",
-    "@anthropic-ai/sdk": ">=0.122.0",
-    "@dxtmisha/wiki": ">=0.114.0",
-    "@google/genai": ">=2.19.0",
-    "@napi-rs/canvas": ">=1.0.8",
-    "ai": ">=7.0.85",
-    "openai": ">=7.8.0",
-    "puppeteer": ">=25.9.0"
+    "@ai-sdk/xai": ">=5.0.14",
+    "@anthropic-ai/claude-agent-sdk": ">=0.3.289",
+    "@anthropic-ai/sdk": ">=0.131.0",
+    "@dxtmisha/wiki": ">=0.118.1",
+    "@google/genai": ">=2.27.0",
+    "@napi-rs/canvas": ">=1.0.10",
+    "ai": ">=7.0.127",
+    "openai": ">=7.28.0",
+    "puppeteer": ">=25.12.0"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/xai": {
@@ -144,5 +148,6 @@
     "puppeteer": {
       "optional": true
     }
-  }
+  },
+  "sideEffects": false
 }