@dxtmisha/scripts 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.1] - 2026-09-07
+
+### Added
+- **`PropertiesFile.toUrl` Helper**:
+  - Added static `PropertiesFile.toUrl()` method for resolving paths to absolute file URLs for ESM dynamic imports.
+  - Added unit test suite in `src/classes/Properties/__tests__/PropertiesFile.test.ts` and updated Storybook documentation (EN, RU, VI).
+
+### Fixed
+- **Web-Types Generation (`DesignWikiStormItem`)**:
+  - Fixed type formatting in `web-types.json`: string enum options from `getOptions()` are now properly quoted as literal string unions (`'sm' | 'md' | 'lg' | 'auto'`), while interfaces, generics, and function types retain clean TypeScript syntax without invalid outer quotes.
+  - Improved `cleanType()` to remove redundant enclosing parentheses and trailing `| undefined`.
+
+## [1.1.0] - 2026-09-07
+
+### Added
+- **`GitIgnore` Helper**:
+  - Implemented `GitIgnore` class (`src/classes/Git/GitIgnore.ts`) for parsing, querying, and synchronizing `.gitignore` files across monorepo packages.
+  - Added automated `.gitignore` synchronization during package builds.
+- **`BuildPackages` Enhancements**:
+  - Added support for custom build code execution (`customCode`) before and after package compilation.
+  - Added support for custom log files (`fileLog`) to capture build outputs.
+- **AI Prompt Generation & Configurations**:
+  - Added `promptInclude` and `promptPackageOnly` configuration options in `DesignUiConfigPackagePrompt`.
+  - Added Russian AI prompt templates (`aiCodeGlobalPrompt.ru.md`, `aiDescriptionGeneration.ru.md`, `aiPromptMetadata.ru.md`, `aiTypeOptimization.ru.md`).
+  - Added prompt exclusions support (`promptExclude`).
+- **Storybook Documentation**:
+  - Added Storybook guides for `GitIgnore`, `LibraryAiPrompt`, `PropertiesConfig`, and `BuildPackages` in `src/storybook/`.
+
+### Changed
+- **Dependencies**: Updated workspace package dependencies to explicit `>=` semver ranges.
+- **Error Handling**: Improved error diagnostics and recovery in `DesignTypes` pipeline.
+
 ## [1.0.0] - 2026-08-30
 
 ### Added

package/bin/build-packages.ts

@@ -4,12 +4,33 @@ import process from 'node:process'
 import { parseCliArguments } from './arguments'
 import { BuildPackages } from '../dist/library.js'
 
-parseCliArguments(
+const { values } = parseCliArguments(
   'Scans, sorts, and builds monorepo packages managing build order by priorities.',
-  'Usage: dxt-build-packages'
+  'Usage: dxt-build-packages [--code CODE] [--dir DIR] [--log LOG]',
+  {
+    code: {
+      type: 'string',
+      short: 'c',
+      description: 'Custom build command or script name to execute'
+    },
+    dir: {
+      type: 'string',
+      short: 'd',
+      description: 'Packages directory path'
+    },
+    log: {
+      type: 'string',
+      short: 'l',
+      description: 'Custom build log file name or path'
+    }
+  }
 )
 
-new BuildPackages()
+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
+
+new BuildPackages(dir, code, log)
   .make()
   .catch((error) => {
     console.error('dxt-build-packages failed:', error)

package/bin/design-prompt.ts

@@ -6,19 +6,24 @@ import { LibraryAiPrompt } from '../dist/library.js'
 
 const { values } = parseCliArguments(
   'Generates the consolidated AI prompt file ai-prompt.md for the project.',
-  'Usage: dxt-prompt [--mcp]',
+  'Usage: dxt-prompt [--mcp] [--vue]',
   {
     mcp: {
       type: 'boolean',
       short: 'm',
       default: false,
       description: 'Also generate the MCP configuration files'
+    },
+    vue: {
+      type: 'boolean',
+      default: false,
+      description: 'Include Vue component prompt rules'
     }
   }
 )
 
 try {
-  new LibraryAiPrompt([], values.mcp === true).make()
+  new LibraryAiPrompt([], values.mcp === true, values.vue !== false).make()
   process.exit(0)
 } catch (error) {
   console.error('dxt-prompt failed:', error)

package/dist/{AiZAi-x3CInynJ.js → AiZAi-P-St-CZL.js}

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

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

@@ -3,14 +3,14 @@ import { Datetime as i, forEach as a, toArray as o, toKebabCase as s, transforma
 import l from "path";
 import u from "node:fs";
 import d from "node:path";
-import { fileURLToPath as f } from "node:url";
+import { fileURLToPath as f, pathToFileURL as p } from "node:url";
 //#region src/functions/toPathStandardSep.ts
-function p(e) {
+function m(e) {
 	return e.replace(/\//g, l.sep);
 }
 //#endregion
 //#region src/classes/Properties/PropertiesFile.ts
-var m = d.dirname(f(import.meta.url)), h = class {
+var h = d.dirname(f(import.meta.url)), g = class {
 	static root;
 	static module;
 	static is(e) {
@@ -69,6 +69,9 @@ var m = d.dirname(f(import.meta.url)), h = class {
 	static toSep(e) {
 		return this.sep() === "/" ? e : e.replace("/", this.sep());
 	}
+	static toUrl(e) {
+		return p(d.resolve(this.root, this.joinPath(e))).href;
+	}
 	static readDir(e) {
 		return this.is(e) ? u.readdirSync(this.joinPath(e)) : [];
 	}
@@ -128,43 +131,64 @@ var m = d.dirname(f(import.meta.url)), h = class {
 		return this.joinPath(e).replace(`${this.root}${d.sep}`, "").replace(`${this.root}`, "");
 	}
 	static {
-		this.module = !!m.match("node_modules"), this.root = process.cwd();
+		this.module = !!h.match("node_modules"), this.root = process.cwd();
 	}
-}, g = class {
+}, _ = class {
 	static config;
-	static getProjectName() {
-		return this.config?.project ?? "ui";
+	static isPromptPackageOnly() {
+		return !!this.config?.promptPackageOnly;
 	}
-	static getDesignName() {
-		return this.config?.name ?? "ui";
+	static isTypesWithoutVue() {
+		return !!this.config?.typesWithoutVue;
 	}
-	static getDesignAlternativeName() {
-		return this.config?.alternativeName;
+	static getAiConfig() {
+		return this.config?.aiConfig ?? {};
 	}
-	static getPackagePrefix() {
-		return this.config?.packagePrefix ?? void 0;
+	static getAiKey() {
+		return this.config?.aiKey ?? "";
 	}
-	static getTypesTemporaryDirectory() {
-		return this.config?.typesDir ?? "ai-types-temp";
+	static getAiModel() {
+		return this.config?.aiModel ?? "";
 	}
-	static getTypesPaths() {
-		return this.config?.typesPaths;
+	static getAiResourcesDir() {
+		return this.config?.aiResourcesDir ?? "ai-resources";
 	}
-	static getTypesMatch() {
-		return this.config?.typesMatch;
+	static getAiType() {
+		return this.config?.aiType ?? "gemini";
 	}
-	static getTypesExclude() {
-		return this.config?.typesExclude;
+	static getAiTypesConcurrency() {
+		return this.config?.aiTypesConcurrency ?? 8;
 	}
-	static getTypesWithoutVue() {
-		return this.config?.typesWithoutVue;
+	static getDesignAlternativeName() {
+		return this.config?.alternativeName;
 	}
-	static isTypesWithoutVue() {
-		return !!this.config?.typesWithoutVue;
+	static getDesignName() {
+		return this.config?.name ?? "ui";
 	}
 	static getDistDir() {
 		return this.config?.distDir ?? "dist";
 	}
+	static getFigmaToken() {
+		return this.config?.figmaToken ?? "";
+	}
+	static getPackagePrefix() {
+		return this.config?.packagePrefix ?? void 0;
+	}
+	static getProjectName() {
+		return this.config?.project ?? "ui";
+	}
+	static getPromptExclude() {
+		return Array.isArray(this.config?.promptExclude) ? this.config.promptExclude : this.config?.promptExclude ? [this.config.promptExclude] : [];
+	}
+	static getPromptInclude() {
+		return Array.isArray(this.config?.promptInclude) ? this.config.promptInclude : this.config?.promptInclude ? [this.config.promptInclude] : [];
+	}
+	static getPromptPackageOnly() {
+		return this.config?.promptPackageOnly;
+	}
+	static getPromptScanDepth() {
+		return this.config?.promptScanDepth ?? 6;
+	}
 	static getSeparator() {
 		return this.config?.separator ?? "/";
 	}
@@ -174,37 +198,28 @@ var m = d.dirname(f(import.meta.url)), h = class {
 	static getSeparatorLimit() {
 		return this.config?.separatorLimit ?? 6;
 	}
-	static getWikiLanguage() {
-		return this.config?.wikiLanguage ?? "en";
-	}
-	static getAiResourcesDir() {
-		return this.config?.aiResourcesDir ?? "ai-resources";
-	}
-	static getPromptScanDepth() {
-		return this.config?.promptScanDepth ?? 6;
-	}
-	static getAiType() {
-		return this.config?.aiType ?? "gemini";
+	static getTypesExclude() {
+		return this.config?.typesExclude;
 	}
-	static getAiModel() {
-		return this.config?.aiModel ?? "";
+	static getTypesMatch() {
+		return this.config?.typesMatch;
 	}
-	static getAiKey() {
-		return this.config?.aiKey ?? "";
+	static getTypesPaths() {
+		return this.config?.typesPaths;
 	}
-	static getAiConfig() {
-		return this.config?.aiConfig ?? {};
+	static getTypesTemporaryDirectory() {
+		return this.config?.typesDir ?? "ai-types-temp";
 	}
-	static getAiTypesConcurrency() {
-		return this.config?.aiTypesConcurrency ?? 8;
+	static getTypesWithoutVue() {
+		return this.config?.typesWithoutVue;
 	}
-	static getFigmaToken() {
-		return this.config?.figmaToken ?? "";
+	static getWikiLanguage() {
+		return this.config?.wikiLanguage ?? "en";
 	}
 	static getExtends(e, t = []) {
-		let n = [...t, p(e)], r = this.getLocalPath(n), i = h.readFile(n), a = h.readFile(r), o = a?.extends ?? i?.extends;
+		let n = [...t, m(e)], r = this.getLocalPath(n), i = g.readFile(n), a = g.readFile(r), o = a?.extends ?? i?.extends;
 		return o ? {
-			...this.getExtends(o, [h.getPathDir(n)]),
+			...this.getExtends(o, [g.getPathDir(n)]),
 			...i,
 			...a
 		} : {
@@ -224,12 +239,12 @@ var m = d.dirname(f(import.meta.url)), h = class {
 		let t = [];
 		for (let n = 0; n < 32; n++) {
 			let n = [...t, e], r = this.getLocalPath(n);
-			if (h.is(n) || h.is(r)) {
-				let e = h.readFile(n), t = h.readFile(r);
+			if (g.is(n) || g.is(r)) {
+				let e = g.readFile(n), t = g.readFile(r);
 				if (e || t) {
 					let r = t?.extends ?? e?.extends;
 					return r ? {
-						...this.getExtends(r, [h.getPathDir(n)]),
+						...this.getExtends(r, [g.getPathDir(n)]),
 						...e,
 						...t
 					} : {
@@ -247,4 +262,4 @@ var m = d.dirname(f(import.meta.url)), h = class {
 	}
 };
 //#endregion
-export { h as n, g as t };
+export { g as n, _ as t };

package/dist/config.d.ts

@@ -7,6 +7,9 @@ export declare const UI_DIR_AI = "ai";
 /** Screenshot folder name for AI / Название папки со снимками экрана для AI */
 export declare const UI_DIR_AI_PROMPT_SCREENSHOT = "ai-screenshot";
 
+/** AI types directory name in root / Название директории типов AI в корне */
+export declare const UI_DIR_AI_TYPES = "ai-packages-types";
+
 /** AI types list directory name / Название директории со списком типов AI */
 export declare const UI_DIR_AI_TYPES_LIST = "ai-types-list";
 
@@ -112,6 +115,9 @@ export declare const UI_FILE_AI_PROMPT_TYPES = "ai-types.md";
 /** AI types file name / Название файла с типами AI */
 export declare const UI_FILE_AI_TYPES = "ai-types.md";
 
+/** Gitignore file name / Название файла .gitignore */
+export declare const UI_FILE_GITIGNORE = ".gitignore";
+
 /** Index file name / Название файла index */
 export declare const UI_FILE_INDEX = "index.ts";
 

package/dist/config.js

@@ -1,20 +1,20 @@
 //#region src/config.ts
-var e = "design.config.json", t = "@dxtmisha", n = "constructor", r = `${t}/${n}`, i = "node_modules", a = "d", o = "custom", s = /\/\/ *export:none/, c = "src", l = "ai", u = "ai-screenshot", d = "ai-types-list", f = "ai-types-temp", p = "resources", m = "components", h = "constructors", g = "structure", _ = "wiki", v = "temporary", y = "dist", b = "dist-temporary", x = "prompt", S = "packages", C = [
+var e = "design.config.json", t = "@dxtmisha", n = "constructor", r = `${t}/${n}`, i = "node_modules", a = "d", o = "custom", s = /\/\/ *export:none/, c = "src", l = "ai", u = "ai-screenshot", d = "ai-packages-types", f = "ai-types-list", p = "ai-types-temp", m = "resources", h = "components", g = "constructors", _ = "structure", v = "wiki", y = "temporary", b = "dist", x = "dist-temporary", S = "prompt", C = "packages", w = [
 	"src",
-	_,
+	v,
 	"ai"
-], w = ["src", "media"], T = [...w, "icons"], E = ["src", m], D = ["src", h], O = ["src", "styles"], k = ["src", "library"], A = ["src", _], ee = ["src", "library.ts"], j = [
+], T = ["src", "media"], E = [...T, "icons"], D = ["src", h], O = ["src", g], k = ["src", "styles"], A = ["src", "library"], ee = ["src", v], j = ["src", "library.ts"], M = [
 	"classes",
 	"components",
 	"composables",
 	"functions",
 	"global",
 	"types"
-], M = "package.json", N = "properties.json", P = "ai-description.md", F = "ai-doc.md", I = "ai-instruction.md", L = "ai-prompt.md", R = "ai-types.md", z = "ai-developer.md", B = "flags", V = "media", H = "design", U = "plugin", W = "style", G = "wiki", K = "vite.config.ts", q = "vite-workers.config.ts", J = "index.ts", Y = "ai-types.md", X = "ai-description.md", Z = "ai-mcp-resources.json", Q = "ai-mcp-all-resources.json", $ = "ai-mcp-all-resources.ts", te = "style.scss", ne = "ui-properties.scss", re = "scss", ie = "classes", ae = [
+], N = ".gitignore", P = "package.json", F = "properties.json", I = "ai-description.md", L = "ai-doc.md", R = "ai-instruction.md", z = "ai-prompt.md", B = "ai-types.md", V = "ai-developer.md", H = "flags", U = "media", W = "design", G = "plugin", K = "style", q = "wiki", J = "vite.config.ts", Y = "vite-workers.config.ts", X = "index.ts", Z = "ai-types.md", Q = "ai-description.md", $ = "ai-mcp-resources.json", te = "ai-mcp-all-resources.json", ne = "ai-mcp-all-resources.ts", re = "style.scss", ie = "ui-properties.scss", ae = "scss", oe = "classes", se = [
 	"disabled",
 	"focus",
 	"readonly",
 	"read-only"
 ];
 //#endregion
-export { e as UI_CONFIG_FILE, C as UI_DIRS_AI_WIKI, E as UI_DIRS_COMPONENTS, D as UI_DIRS_CONSTRUCTOR, ee as UI_DIRS_FILE_EXPORT, T as UI_DIRS_ICONS, k as UI_DIRS_LIBRARY, j as UI_DIRS_LIST_EXPORT, O as UI_DIRS_STYLES, w as UI_DIRS_TOKENS, A as UI_DIRS_WIKI, l as UI_DIR_AI, u as UI_DIR_AI_PROMPT_SCREENSHOT, d as UI_DIR_AI_TYPES_LIST, f as UI_DIR_AI_TYPES_TEMPORARY, m as UI_DIR_COMPONENTS, h as UI_DIR_CONSTRUCTOR, y as UI_DIR_DIST, b as UI_DIR_DIST_TEMPORARY, c as UI_DIR_IN, S as UI_DIR_PACKAGES, x as UI_DIR_PROMPT, p as UI_DIR_RESOURCES, g as UI_DIR_STRUCTURE, v as UI_DIR_TEMPORARY, _ as UI_DIR_WIKI, re as UI_EXTENSION_STYLE, X as UI_FILE_AI_DESCRIPTION, Z as UI_FILE_AI_MCP, Q as UI_FILE_AI_MCP_ALL, $ as UI_FILE_AI_MCP_ALL_TS, P as UI_FILE_AI_PROMPT_DESCRIPTION, z as UI_FILE_AI_PROMPT_DEVELOPER, F as UI_FILE_AI_PROMPT_INFO, I as UI_FILE_AI_PROMPT_INSTRUCTION, L as UI_FILE_AI_PROMPT_PROMPT, R as UI_FILE_AI_PROMPT_TYPES, Y as UI_FILE_AI_TYPES, J as UI_FILE_INDEX, H as UI_FILE_NAME_DESIGN, B as UI_FILE_NAME_FLAGS, V as UI_FILE_NAME_MEDIA, U as UI_FILE_NAME_PLUGIN, W as UI_FILE_NAME_STYLE, K as UI_FILE_NAME_VITE, q as UI_FILE_NAME_VITE_WORKERS, G as UI_FILE_NAME_WIKI, M as UI_FILE_PACKAGE, N as UI_FILE_PROPERTY, ne as UI_FILE_STYLE_PROPERTIES, te as UI_FILE_STYLE_SCSS, s as UI_FLAG_NOT_EXPORT, a as UI_KEY_CONSTRUCTOR, o as UI_KEY_CUSTOM, i as UI_MODULES, r as UI_PROJECT_CONSTRUCTOR_FULL_NAME, n as UI_PROJECT_CONSTRUCTOR_NAME, t as UI_PROJECT_NAME, ae as UI_PROPERTY_FOR_PROPS, ie as UI_STRUCTURE_CLASSES };
+export { e as UI_CONFIG_FILE, w as UI_DIRS_AI_WIKI, D as UI_DIRS_COMPONENTS, O as UI_DIRS_CONSTRUCTOR, j as UI_DIRS_FILE_EXPORT, E as UI_DIRS_ICONS, A as UI_DIRS_LIBRARY, M as UI_DIRS_LIST_EXPORT, k as UI_DIRS_STYLES, T as UI_DIRS_TOKENS, ee as UI_DIRS_WIKI, l as UI_DIR_AI, u as UI_DIR_AI_PROMPT_SCREENSHOT, d as UI_DIR_AI_TYPES, f as UI_DIR_AI_TYPES_LIST, p as UI_DIR_AI_TYPES_TEMPORARY, h as UI_DIR_COMPONENTS, g as UI_DIR_CONSTRUCTOR, b as UI_DIR_DIST, x as UI_DIR_DIST_TEMPORARY, c as UI_DIR_IN, C as UI_DIR_PACKAGES, S as UI_DIR_PROMPT, m as UI_DIR_RESOURCES, _ as UI_DIR_STRUCTURE, y as UI_DIR_TEMPORARY, v as UI_DIR_WIKI, ae as UI_EXTENSION_STYLE, Q as UI_FILE_AI_DESCRIPTION, $ as UI_FILE_AI_MCP, te as UI_FILE_AI_MCP_ALL, ne as UI_FILE_AI_MCP_ALL_TS, I as UI_FILE_AI_PROMPT_DESCRIPTION, V as UI_FILE_AI_PROMPT_DEVELOPER, L as UI_FILE_AI_PROMPT_INFO, R as UI_FILE_AI_PROMPT_INSTRUCTION, z as UI_FILE_AI_PROMPT_PROMPT, B as UI_FILE_AI_PROMPT_TYPES, Z as UI_FILE_AI_TYPES, N as UI_FILE_GITIGNORE, X as UI_FILE_INDEX, W as UI_FILE_NAME_DESIGN, H as UI_FILE_NAME_FLAGS, U as UI_FILE_NAME_MEDIA, G as UI_FILE_NAME_PLUGIN, K as UI_FILE_NAME_STYLE, J as UI_FILE_NAME_VITE, Y as UI_FILE_NAME_VITE_WORKERS, q as UI_FILE_NAME_WIKI, P as UI_FILE_PACKAGE, F as UI_FILE_PROPERTY, ie as UI_FILE_STYLE_PROPERTIES, re as UI_FILE_STYLE_SCSS, s as UI_FLAG_NOT_EXPORT, a as UI_KEY_CONSTRUCTOR, o as UI_KEY_CUSTOM, i as UI_MODULES, r as UI_PROJECT_CONSTRUCTOR_FULL_NAME, n as UI_PROJECT_CONSTRUCTOR_NAME, t as UI_PROJECT_NAME, se as UI_PROPERTY_FOR_PROPS, oe as UI_STRUCTURE_CLASSES };

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-x3CInynJ.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-P-St-CZL.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-ChizwW5y.js";
+import { t as e } from "./PropertiesConfig-BBsuNndv.js";
 import { n as t, t as n } from "./figmaApiTypes-CArSsNW8.js";
 //#region src/classes/FigmaApi.ts
 var r = class {