@dxtmisha/scripts 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -2,15 +2,53 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.4] - 2026-09-08
+
+### Added
+- **`AiAntigravityCli` & `AiAntigravityCliLite` AI Providers**:
+  - Implemented `AiAntigravityCli` (`src/classes/Ai/AiAntigravityCli.ts`) and `AiAntigravityCliLite` (`src/classes/Ai/AiAntigravityCliLite.ts`) classes providing integration with Google Antigravity CLI (`agy`) without a system shell.
+  - Added support for `'antigravity-cli'` provider identifier in `AiType` (`src/types/configTypes.ts`) and registry-based factory resolution in `useAi()` (`src/composables/useAi.ts`).
+  - Exported `AiAntigravityCli` and `AiAntigravityCliLite` in `src/library.ts`.
+  - Added unit test suite in `src/classes/Ai/__tests__/AiAntigravityCli.test.ts` and updated `src/composables/__tests__/useAi.test.ts`.
+- **`DesignScreenshotDescription` Analysis Class**:
+  - Implemented `DesignScreenshotDescription` (`src/classes/Design/DesignScreenshotDescription.ts`) to analyze component screenshots using multimodal AI models (Gemini, Claude, OpenAI) and generate structured JSON metadata files (`screenshot.json`).
+  - Added prompt templates `aiScreenshotDescription.en.md` and `aiScreenshotDescription.ru.md` instructing AI to identify and describe visible components and documentation showcases.
+  - Added `DesignScreenshotItem` and `DesignScreenshotList` types in `src/types/screenshotTypes.ts`.
+  - Added comprehensive test suite in `src/classes/Design/__tests__/DesignScreenshotDescription.test.ts`.
+- **`LibraryAiPromptScreenshot` Handler**:
+  - Implemented dedicated `LibraryAiPromptScreenshot` class (`src/classes/Library/LibraryAiPromptScreenshot.ts`) to modularize screenshot handling, artifact copying, and visual context generation.
+  - Added support for copying `screenshot-code.html` and `screenshot-styles.css` into isolated project directories under `ai-packages-types/<project-folder>/`.
+  - Added automatic annotation of screenshot image references in `ai-prompt.md` with descriptions loaded from `screenshot.json`.
+  - Added constants `UI_FILE_AI_PROMPT_SCREENSHOT_JSON`, `UI_FILE_AI_PROMPT_SCREENSHOT_CODE`, and `UI_FILE_AI_PROMPT_SCREENSHOT_STYLES` in `src/config.ts`.
+  - Added unit test suite in `src/classes/Library/__tests__/LibraryAiPromptScreenshot.test.ts`.
+- **Global AI Prompt Rule for Visual Context**:
+  - Added rule #9 "Visual Component Reference (`ai-screenshot/`)" to `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` templates, guiding AI assistants on how to use screenshots, descriptions (`screenshot.json`), DOM structures (`screenshot-code.html`), and computed styles (`screenshot-styles.css`) for accurate UI component reuse without reinvention or token waste.
+- **Storybook Documentation for AI Providers**:
+  - Added multi-language Storybook documentation (EN, RU, VI) for `AiAntigravityCli` and `AiAntigravityCliLite` in `src/storybook/classes/`.
+  - Added comprehensive AI Providers guide (`src/storybook/ai/providers/providers.*.mdx`) covering all supported backends (`gemini`, `gemini-cli`, `antigravity-cli`, `claude`, `claude-cli`, `claude-agent`, `openai`, `zai`).
+  - Updated AI Configuration Storybook documentation (`src/storybook/ai/config/config.*.mdx`) with updated provider lists and configuration details.
+
+### Changed
+- **AI Prompt Generation (`LibraryAiPrompt` & `LibraryAiPromptItem`)**:
+  - Updated `LibraryAiPrompt.make()` to clean and recreate `ai-packages-types` on each run, ensuring removal of stale type declarations and screenshot artifacts.
+  - Updated `LibraryAiPromptItem` to store package type definitions in dedicated project subdirectories (`ai-packages-types/<project-folder>/ai-types.md`) instead of flat files.
+  - Refactored `LibraryAiPromptItem` to delegate all screenshot operations directly to `LibraryAiPromptScreenshot`.
+- **Multimodal AI Payload (`AiGoogleLite`)**:
+  - Fixed `@google/genai` request payload for multimodal inputs by properly structuring user message parts.
+- **Type Definitions (`screenshotTypes.ts`)**:
+  - Standardized property order (`width` before `height`) and sorted types and constants alphabetically.
+
 ## [1.1.2] - 2026-09-07
 
 ### Fixed
 - **Web-Types Generator AST Parsing (`DesignWikiStormItem`)**:
   - Replaced runtime dynamic Node.js ESM imports (`await import(...)`) of `wikiData.ts` with static TypeScript AST parsing via the TypeScript Compiler API (`ts.createSourceFile`).
   - Fixed `ERR_MODULE_NOT_FOUND` resolution errors occurring when `@dxtmisha/scripts` is installed and executed as an external package in consumer repositories containing extensionless TypeScript imports (`'../../../wiki/wiki'`, `'./props'`).
-  - Added AST-based extraction for default prop values (`getDefaultsFromProps`) from `props.ts` and design wiki configurations (`getWikiDesign`) from `src/wiki/wiki.ts`.
+  - Added recursive scanning and parsing of all files in the `src/wiki/` directory (e.g. `wikiStyle.ts`, `wiki.ts`, `wikiDescriptions.ts`), merging all `wiki*` dictionaries and descriptions into a centralized AST cache (`wikiDesignCache`).
+  - Added AST evaluation for `PropertyAccessExpression` nodes, supporting `StorybookControl.*` (e.g. `'select'`, `'boolean'`, `'number'`, `'string'`) and `StorybookCategory.*` (e.g. `'Styles'`, `'Actions'`, `'Adaptive'`, `'ARIA'`) enum values.
+  - Added AST-based extraction for default prop values (`getDefaultsFromProps`) from `props.ts`.
   - Fixed TypeScript typing in `getSlots()` by removing unsupported `description` access on `StorybookSlotProperty`.
-  - Updated unit tests in `src/classes/Design/__tests__/DesignWikiStorm.test.ts` to test AST metadata extraction.
+  - Updated unit tests in `src/classes/Design/__tests__/DesignWikiStorm.test.ts` to test AST metadata extraction, directory scanning, and enum evaluation.
 
 ## [1.1.1] - 2026-09-07
 

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

@@ -138,7 +138,14 @@ var o = class extends i {
 	async response(e, t) {
 		return (await this.ai?.models.generateContent({
 			model: e,
-			contents: [...this.toImages(), { parts: [...this.toContents(), { text: t }] }],
+			contents: [{
+				role: "user",
+				parts: [
+					...this.toImages(),
+					...this.toContents(),
+					{ text: t }
+				]
+			}],
 			config: this.config
 		}))?.text ?? "";
 	}

package/dist/config.d.ts

@@ -109,6 +109,15 @@ export declare const UI_FILE_AI_PROMPT_INSTRUCTION = "ai-instruction.md";
 /** AI prompt result file name / Название файла с результатом промпта AI */
 export declare const UI_FILE_AI_PROMPT_PROMPT = "ai-prompt.md";
 
+/** AI prompt screenshot code file name / Название файла с HTML кодом скриншота AI */
+export declare const UI_FILE_AI_PROMPT_SCREENSHOT_CODE = "screenshot-code.html";
+
+/** AI prompt screenshot description JSON file name / Название файла с описанием скриншотов AI */
+export declare const UI_FILE_AI_PROMPT_SCREENSHOT_JSON = "screenshot.json";
+
+/** AI prompt screenshot styles file name / Название файла со стилями скриншота AI */
+export declare const UI_FILE_AI_PROMPT_SCREENSHOT_STYLES = "screenshot-styles.css";
+
 /** AI prompt types file name / Название файла с типами промпта AI */
 export declare const UI_FILE_AI_PROMPT_TYPES = "ai-types.md";
 

package/dist/config.js

@@ -3,18 +3,18 @@ var e = "design.config.json", t = "@dxtmisha", n = "constructor", r = `${t}/${n}
 	"src",
 	v,
 	"ai"
-], 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 = [
+], T = ["src", "media"], E = [...T, "icons"], D = ["src", h], O = ["src", g], k = ["src", "styles"], A = ["src", "library"], j = ["src", v], M = ["src", "library.ts"], N = [
 	"classes",
 	"components",
 	"composables",
 	"functions",
 	"global",
 	"types"
-], 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 = [
+], P = ".gitignore", ee = "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 = "screenshot.json", U = "screenshot-code.html", W = "screenshot-styles.css", G = "flags", K = "media", q = "design", J = "plugin", Y = "style", X = "wiki", Z = "vite.config.ts", Q = "vite-workers.config.ts", $ = "index.ts", te = "ai-types.md", ne = "ai-description.md", re = "ai-mcp-resources.json", ie = "ai-mcp-all-resources.json", ae = "ai-mcp-all-resources.ts", oe = "style.scss", se = "ui-properties.scss", ce = "scss", le = "classes", ue = [
 	"disabled",
 	"focus",
 	"readonly",
 	"read-only"
 ];
 //#endregion
-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 };
+export { e as UI_CONFIG_FILE, w as UI_DIRS_AI_WIKI, D as UI_DIRS_COMPONENTS, O as UI_DIRS_CONSTRUCTOR, M as UI_DIRS_FILE_EXPORT, E as UI_DIRS_ICONS, A as UI_DIRS_LIBRARY, N as UI_DIRS_LIST_EXPORT, k as UI_DIRS_STYLES, T as UI_DIRS_TOKENS, j 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, ce as UI_EXTENSION_STYLE, ne as UI_FILE_AI_DESCRIPTION, re as UI_FILE_AI_MCP, ie as UI_FILE_AI_MCP_ALL, ae 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, U as UI_FILE_AI_PROMPT_SCREENSHOT_CODE, H as UI_FILE_AI_PROMPT_SCREENSHOT_JSON, W as UI_FILE_AI_PROMPT_SCREENSHOT_STYLES, B as UI_FILE_AI_PROMPT_TYPES, te as UI_FILE_AI_TYPES, P as UI_FILE_GITIGNORE, $ as UI_FILE_INDEX, q as UI_FILE_NAME_DESIGN, G as UI_FILE_NAME_FLAGS, K as UI_FILE_NAME_MEDIA, J as UI_FILE_NAME_PLUGIN, Y as UI_FILE_NAME_STYLE, Z as UI_FILE_NAME_VITE, Q as UI_FILE_NAME_VITE_WORKERS, X as UI_FILE_NAME_WIKI, ee as UI_FILE_PACKAGE, F as UI_FILE_PROPERTY, se as UI_FILE_STYLE_PROPERTIES, oe 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, ue as UI_PROPERTY_FOR_PROPS, le 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-P-St-CZL.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-B4ih4xL2.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-ui.js

@@ -3608,10 +3608,41 @@ defineOptions({
 		let n = A(t.getProjectName());
 		return e.writeByPath(oe, `@forward "./src/styles/${n}/style.scss";`), this;
 	}
-}, Tr = class {
+}, Tr = {
+	text: "text",
+	string: "string",
+	number: "number",
+	boolean: "boolean",
+	select: "select",
+	array: "array",
+	object: "object"
+}, Er = {
+	actions: "Actions",
+	adaptive: "Adaptive",
+	aria: "ARIA",
+	arrow: "Arrow",
+	attributes: "Attributes",
+	bars: "Bars",
+	counter: "Counter",
+	form: "Form",
+	hook: "Hook",
+	icon: "Icon",
+	information: "Information",
+	mask: "Mask",
+	option: "Options",
+	search: "Search",
+	sort: "Sort",
+	status: "Status",
+	style: "Styles",
+	technical: "Technical",
+	text: "Text",
+	value: "Values"
+}, Dr = class n {
 	project;
 	path;
 	data;
+	static wikiDesignCache;
+	static wikiDescriptionsCache;
 	wiki;
 	dataComponent;
 	constructor(e, t, n) {
@@ -3742,24 +3773,11 @@ defineOptions({
 	getPaths(e) {
 		return [...this.getDirs(), ...e];
 	}
+	getWikiDescriptions() {
+		return n.wikiDescriptionsCache || this.loadWikiFiles(), n.wikiDescriptionsCache;
+	}
 	getWikiDesign() {
-		let t = [
-			".",
-			"src",
-			"wiki",
-			"wiki.ts"
-		];
-		if (e.is(t)) {
-			let n = e.readFileOnly(t);
-			if (n) {
-				let e = M.createSourceFile("wiki.ts", n, M.ScriptTarget.Latest, !0), t = this.extractVariables(e);
-				for (let [e, n] of t.entries()) if (e.startsWith("wiki")) {
-					let e = this.evalNode(n, t);
-					if (w(e)) return e;
-				}
-			}
-		}
-		return {};
+		return n.wikiDesignCache ? n.wikiDesignCache : (this.loadWikiFiles(), n.wikiDesignCache ?? {});
 	}
 	cleanType(e) {
 		let t = e.trim();
@@ -3803,6 +3821,13 @@ defineOptions({
 				}
 				return n;
 			}
+			if (M.isPropertyAccessExpression(e)) {
+				let n = e.expression.getText().replace(/^['"]|['"]$/g, ""), r = e.name.text;
+				if (n === "StorybookControl") return Tr[r] ?? r;
+				if (n === "StorybookCategory") return Er[r] ?? r;
+				let i = this.evalNode(e.expression, t);
+				return w(i) && r in i ? i[r] : r;
+			}
 			if (M.isIdentifier(e)) {
 				let n = e.text;
 				return t.has(n) ? this.evalNode(t.get(n), t) : void 0;
@@ -3819,11 +3844,40 @@ defineOptions({
 	async initWiki() {
 		let e = await this.getData();
 		if (e) {
-			let { WikiStorybook: t } = await import("@dxtmisha/wiki"), { wiki: n, wikiDescriptions: r } = await import("@dxtmisha/wiki/media");
-			return new t(e.component, e.props, e.defaults, e.wikiDesign, n, r);
+			let { WikiStorybook: t } = await import("@dxtmisha/wiki"), { wiki: n, wikiDescriptions: r } = await import("@dxtmisha/wiki/media"), i = this.getWikiDescriptions(), a = i && i.length > 0 ? [...r, ...i] : r;
+			return new t(e.component, e.props, e.defaults, e.wikiDesign, n, a);
+		}
+	}
+	loadWikiFiles() {
+		if (n.wikiDesignCache) return;
+		let t = [[
+			".",
+			"src",
+			"wiki"
+		], ["src", "wiki"]].find((t) => e.is(t));
+		if (!t) {
+			n.wikiDesignCache = {};
+			return;
+		}
+		let r = e.readDirRecursive(t).filter((e) => e.endsWith(".ts") || e.endsWith(".js")), i = /* @__PURE__ */ new Map();
+		for (let n of r) {
+			let r = [...t, n], a = e.readFileOnly(r);
+			if (a) {
+				let e = M.createSourceFile(n, a, M.ScriptTarget.Latest, !0), t = this.extractVariables(e);
+				for (let [e, n] of t.entries()) i.set(e, n);
+			}
+		}
+		let a = {};
+		for (let [e, t] of i.entries()) if (e === "wikiDescriptions" || e.endsWith("Descriptions")) {
+			let e = this.evalNode(t, i);
+			S(e) && (n.wikiDescriptionsCache = e);
+		} else if (e.startsWith("wiki")) {
+			let e = this.evalNode(t, i);
+			w(e) && Object.assign(a, e);
 		}
+		n.wikiDesignCache = a;
 	}
-}, Er = class {
+}, Or = class {
 	dir;
 	components;
 	constructor(e = "dist") {
@@ -3849,7 +3903,7 @@ defineOptions({
 	async getComponents() {
 		let e = g(), t = [];
 		if (e) for (let n of this.components.getComponentList()) {
-			let r = new Tr(e.name, this.components.getComponentsPath(), n);
+			let r = new Dr(e.name, this.components.getComponentsPath(), n);
 			await r.init();
 			let i = await r.get();
 			i && t.push(i);
@@ -3858,4 +3912,4 @@ defineOptions({
 	}
 };
 //#endregion
-export { Te as ComponentCreator, Rn as DesignConstructors, Kn as DesignFlags, wr as DesignUi, Er as DesignWikiStorm, fe as PackageInit };
+export { Te as ComponentCreator, Rn as DesignConstructors, Kn as DesignFlags, wr as DesignUi, Or as DesignWikiStorm, fe as PackageInit };