iwgt 2.3.0

package/dist/server.js

@@ -0,0 +1,579 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Импорт справочников
+import categorySettings from './data/references/category-settings.json' with { type: 'json' };
+import blockTemplatesFull from './data/references/block-templates-full.json' with { type: 'json' };
+import librariesRegistry from './data/references/libraries-registry.json' with { type: 'json' };
+import iconsRegistry from './data/references/icons-registry.json' with { type: 'json' };
+import myLayoutReference from './data/references/my-layout-reference.json' with { type: 'json' };
+import liquidVariables from './data/references/liquid-variables.json' with { type: 'json' };
+import liquidFilters from './data/references/liquid-filters.json' with { type: 'json' };
+import commonjsReference from './data/references/commonjs-reference.json' with { type: 'json' };
+import collectionsMenuPatterns from './data/references/collections-menu-patterns.json' with { type: 'json' };
+// Импорт модулей
+import { generateWidgetFiles } from './generators/index.js';
+import * as tools from './tools/index.js';
+import * as utils from './utils/index.js';
+export class WidgetServer {
+    server;
+    constructor() {
+        this.server = new Server({
+            name: 'insales-widgets',
+            version: '2.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // Список инструментов
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'create_widget',
+                    description: `Создает полный виджет InSales по описанию. Генерирует содержимое всех необходимых файлов: info.json, settings_form.json, settings_data.json, snippet.liquid, snippet.scss, snippet.js, messages.json, setup.json (для block_list_widget_type).
+
+КРИТИЧЕСКИ ВАЖНО перед использованием:
+1. Прочитать ресурс 'insales://widget-architecture' для понимания системной обёртки виджетов
+2. Помнить: НЕ используется Vue.js, кастомные теги типа ui-grid-cell - это ОШИБКА
+3. Для блочных виджетов блоки доступны через data.blocks в Liquid
+4. Код из snippet.liquid автоматически оборачивается в div.layout с CSS-переменными из настроек
+5. ⚠️ SCSS: Первая строка snippet.scss ВСЕГДА должна быть @include background-color(--bg); - это устанавливает фон И автоматически определяет контрастный цвет текста
+6. ⚠️ ИКОНКИ: Фильтра | icon НЕ СУЩЕСТВУЕТ! Используйте: <i class="icon icon-название"></i>
+7. Для иконок используется иконочный шрифт (76 иконок) - используйте инструмент get_available_icons
+8. В snippet.js помнить про цикл по виджетам ($widget.each) - на странице может быть несколько экземпляров
+
+КАТЕГОРИИ ВИДЖЕТОВ (используйте точные названия):
+- headers (шапка сайта), footers (подвал), cart (корзина)
+- sliders (слайдеры), banner (баннеры), benefits (преимущества)
+- products-cards (карточки товаров), collection-products (товары категории)
+- navigation (навигация), forms (формы), text (текстовые блоки)
+- и другие - используйте get_category_info для получения полного списка`,
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            description: {
+                                type: 'string',
+                                description: 'Описание виджета (например: "Промо слайдер с автопрокруткой")',
+                            },
+                            category: {
+                                type: 'string',
+                                description: 'Категория виджета (headers, footers, sliders, banner, cart и т.д.). ВАЖНО: для шапки используйте "headers" (множественное число). Опционально - определится автоматически.',
+                            },
+                            type: {
+                                type: 'string',
+                                enum: ['simple_widget_type', 'block_list_widget_type'],
+                                description: 'Тип виджета. simple_widget_type - простой виджет, block_list_widget_type - виджет со списком блоков',
+                            },
+                            handle: {
+                                type: 'string',
+                                description: 'Handle виджета (например: my_promo_slider). Опционально - сгенерируется автоматически',
+                            },
+                        },
+                        required: ['description'],
+                    },
+                },
+                {
+                    name: 'get_block_templates',
+                    description: 'Получить список доступных шаблонов блоков с фильтрацией',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            category: {
+                                type: 'string',
+                                description: 'Категория для фильтрации шаблонов',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Поисковый запрос по keywords',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_available_icons',
+                    description: 'Получить список доступных иконок (76 шт) с возможностью поиска. Иконки используются через иконочный шрифт. В Liquid и HTML: <i class="icon icon-cart"></i>. Класс формата: icon icon-название',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            search: {
+                                type: 'string',
+                                description: 'Поиск иконки по ключевым словам',
+                            },
+                            category: {
+                                type: 'string',
+                                enum: ['navigation', 'actions', 'commerce', 'communication', 'interface'],
+                                description: 'Категория иконок',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_category_info',
+                    description: 'Получить информацию о категории виджетов: типичные настройки, библиотеки, примеры',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            category: {
+                                type: 'string',
+                                description: 'Handle категории',
+                            },
+                        },
+                        required: ['category'],
+                    },
+                },
+                {
+                    name: 'get_libraries_info',
+                    description: 'Получить информацию о доступных библиотеках',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            category: {
+                                type: 'string',
+                                description: 'Фильтр по категории виджетов',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_liquid_variables',
+                    description: 'Получить справочник Liquid переменных InSales (436 переменных в 19 категориях)',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            category: {
+                                type: 'string',
+                                description: 'Категория переменных (Product, Collection, Cart, Blog, и т.д.)',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Поиск переменных по названию или описанию',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_liquid_filters',
+                    description: 'Получить справочник Liquid фильтров InSales (53 фильтра в 7 категориях)',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            category: {
+                                type: 'string',
+                                description: 'Категория фильтров (массивы, математические, строковые, изображения, и т.д.)',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Поиск фильтров по названию или описанию',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_commonjs_api',
+                    description: 'Получить справочник CommonJS API для работы с магазином InSales (10 модулей, 43 метода, 24+ события). Включает декларативные data-атрибуты для работы без JavaScript.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            category: {
+                                type: 'string',
+                                description: 'Категория API (product, cart, lists, search, forms, events, helpers, checkout)',
+                            },
+                            module: {
+                                type: 'string',
+                                description: 'Модуль API (Products, Cart, EventBus, ajaxAPI, Compare, FavoritesProducts, Shop, Template, AjaxSearch)',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Поиск методов, атрибутов, событий по названию или описанию. Поиск включает события методов (например, add_items:insales:cart при Cart.add)',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'get_collections_menu',
+                    description: 'Получить паттерны меню категорий для виджетов InSales. Возвращает готовые решения для создания меню категорий с кешированием, различными структурами и функциональностью. Доступные паттерны: two_level_hierarchical (двухуровневое меню), multi_level_flatten (многоуровневое через flatten_branch), simple_subcollections (простое меню подкатегорий), flat_collections_list (плоский список), tree_structure_flatten (древовидная структура).',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            patternId: {
+                                type: 'string',
+                                description: 'ID паттерна меню (two_level_hierarchical, multi_level_flatten, simple_subcollections, flat_collections_list, tree_structure_flatten). Укажите для получения полного кода паттерна с настройками.',
+                            },
+                            category: {
+                                type: 'string',
+                                description: 'Фильтр по категории/назначению (шапка, сайдбар, категория и т.д.)',
+                            },
+                        },
+                    },
+                },
+            ],
+        }));
+        // Список ресурсов
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+            resources: [
+                {
+                    uri: 'insales://category-settings',
+                    name: 'Настройки категорий виджетов',
+                    mimeType: 'application/json',
+                    description: 'Справочник настроек для каждой категории виджетов',
+                },
+                {
+                    uri: 'insales://block-templates',
+                    name: 'Шаблоны блоков',
+                    mimeType: 'application/json',
+                    description: 'Полный справочник доступных шаблонов блоков',
+                },
+                {
+                    uri: 'insales://libraries',
+                    name: 'Библиотеки',
+                    mimeType: 'application/json',
+                    description: 'Справочник доступных библиотек и плагинов',
+                },
+                {
+                    uri: 'insales://icons',
+                    name: 'Иконки',
+                    mimeType: 'application/json',
+                    description: 'Справочник доступных иконок (76 шт). Используются через иконочный шрифт: <i class="icon icon-название"></i>',
+                },
+                {
+                    uri: 'insales://my-layout',
+                    name: 'My-Layout компоненты',
+                    mimeType: 'application/json',
+                    description: 'Справочник компонентов библиотеки my-layout',
+                },
+                {
+                    uri: 'insales://liquid-variables',
+                    name: 'Liquid переменные',
+                    mimeType: 'application/json',
+                    description: 'Справочник Liquid переменных InSales (436 переменных)',
+                },
+                {
+                    uri: 'insales://liquid-filters',
+                    name: 'Liquid фильтры',
+                    mimeType: 'application/json',
+                    description: 'Справочник Liquid фильтров InSales (53 фильтра)',
+                },
+                {
+                    uri: 'insales://commonjs-api',
+                    name: 'CommonJS API',
+                    mimeType: 'application/json',
+                    description: 'Справочник CommonJS API InSales',
+                },
+                {
+                    uri: 'insales://collections-menu-patterns',
+                    name: 'Паттерны меню категорий',
+                    mimeType: 'application/json',
+                    description: 'Справочник паттернов для создания меню категорий: двухуровневое, многоуровневое, простое, плоское, древовидное',
+                },
+                {
+                    uri: 'insales://widget-architecture',
+                    name: 'Архитектура и контекст виджетов',
+                    mimeType: 'text/markdown',
+                    description: 'КРИТИЧЕСКИ ВАЖНО: Системная обёртка виджетов, контекст выполнения, data.blocks, запрещённые практики',
+                },
+            ],
+        }));
+        // Чтение ресурсов
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const uri = request.params.uri;
+            switch (uri) {
+                case 'insales://category-settings':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(categorySettings, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://block-templates':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(blockTemplatesFull, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://libraries':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(librariesRegistry, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://icons':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(iconsRegistry, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://my-layout':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(myLayoutReference, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://liquid-variables':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(liquidVariables, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://liquid-filters':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(liquidFilters, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://commonjs-api':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(commonjsReference, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://collections-menu-patterns':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(collectionsMenuPatterns, null, 2),
+                            },
+                        ],
+                    };
+                case 'insales://widget-architecture': {
+                    // Читаем markdown файл с документацией об архитектуре
+                    const docPath = join(__dirname, '../context-content/doc/4 поколение/Виджеты/widget-wrapper-and-context.md');
+                    const content = readFileSync(docPath, 'utf-8');
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'text/markdown',
+                                text: content,
+                            },
+                        ],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown resource: ${uri}`);
+            }
+        });
+        // Обработка вызовов инструментов
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'create_widget':
+                        return await this.createWidget(args || {});
+                    case 'get_block_templates':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getBlockTemplates(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_available_icons':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getAvailableIcons(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_category_info':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getCategoryInfo(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_libraries_info':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getLibrariesInfo(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_liquid_variables':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getLiquidVariables(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_liquid_filters':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getLiquidFilters(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_commonjs_api':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getCommonJSAPI(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    case 'get_collections_menu':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getCollectionsMenuPatterns(args || {}), null, 2),
+                                },
+                            ],
+                        };
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${errorMessage}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    // Создание виджета
+    async createWidget(params) {
+        const description = params.description;
+        const category = params.category || utils.inferCategory(description);
+        const categoryData = categorySettings[category];
+        if (!categoryData) {
+            throw new Error(`Неизвестная категория: ${category}`);
+        }
+        // Генерируем или валидируем handle
+        let handle = params.handle || utils.generateHandle(description);
+        if (params.handle) {
+            const validation = utils.validateHandle(params.handle);
+            if (!validation.valid) {
+                throw new Error(validation.error);
+            }
+        }
+        const type = params.type || utils.inferType(description);
+        // Выбор блок-темплейта
+        let blockTemplate;
+        if (type === 'block_list_widget_type') {
+            blockTemplate = utils.selectBlockTemplate(description, category);
+        }
+        // Конфигурация виджета
+        const config = {
+            handle,
+            category,
+            type,
+            description,
+            blockTemplate,
+            libraries: categoryData.libraries,
+            commonSettings: categoryData.commonSettings.filter(s => (s.frequency || 0) > 0.5),
+        };
+        // Генерация содержимого файлов
+        const files = generateWidgetFiles(config);
+        // Форматируем вывод для AI-агента
+        let output = `✅ Виджет создан успешно!\n\n`;
+        output += `📦 Handle: ${handle}\n`;
+        output += `📂 Категория: ${category}\n`;
+        output += `🔧 Тип: ${type}\n`;
+        output += `📚 Библиотеки: ${categoryData.libraries.join(', ')}\n`;
+        output += `⚙️ Настроек: ${files.settings_form.settingsCount}\n`;
+        if (blockTemplate) {
+            output += `🎨 Блок-темплейт: ${blockTemplate.handle}\n`;
+        }
+        output += `\n`;
+        output += `📄 Созданные файлы:\n`;
+        output += Object.keys(files).filter(k => k !== 'settings_form').map(name => `  - ${name}`).join('\n');
+        output += `\n\n`;
+        output += `📝 СОДЕРЖИМОЕ ФАЙЛОВ:\n`;
+        output += `${'='.repeat(80)}\n\n`;
+        // Добавляем содержимое каждого файла
+        for (const [filename, content] of Object.entries(files)) {
+            if (filename === 'settings_form') {
+                // settings_form содержит только метаинформацию, пропускаем
+                continue;
+            }
+            output += `\n${'─'.repeat(80)}\n`;
+            output += `📄 ${filename}\n`;
+            output += `${'─'.repeat(80)}\n`;
+            output += typeof content === 'string' ? content : JSON.stringify(content, null, 2);
+            output += `\n`;
+        }
+        output += `\n${'='.repeat(80)}\n`;
+        output += `\n✨ Все файлы готовы к использованию!\n`;
+        output += `\n💡 Следующие шаги:\n`;
+        output += `1. Создайте директорию для виджета: ${handle}\n`;
+        output += `2. Сохраните каждый файл с соответствующим именем в эту директорию\n`;
+        output += `3. Настройте стили в snippet.scss под свои нужды\n`;
+        output += `4. Добавьте JavaScript функциональность в snippet.js\n`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output,
+                },
+            ],
+        };
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('InSales Widgets MCP Server running on stdio');
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/tools/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Инструменты для работы со справочной информацией
+ * Модуль содержит функции для получения данных из справочников
+ */
+/**
+ * Получить список блок-темплейтов с фильтрацией
+ */
+export declare function getBlockTemplates(args?: any): any;
+/**
+ * Получить список доступных иконок
+ * Иконки используются через иконочный шрифт
+ */
+export declare function getAvailableIcons(args?: any): any;
+/**
+ * Получить информацию о категории виджетов
+ */
+export declare function getCategoryInfo(args: any): any;
+/**
+ * Получить информацию о библиотеках
+ */
+export declare function getLibrariesInfo(args?: any): any;
+/**
+ * Получить справочник Liquid переменных
+ */
+export declare function getLiquidVariables(args?: any): any;
+/**
+ * Получить справочник Liquid фильтров
+ */
+export declare function getLiquidFilters(args?: any): any;
+/**
+ * Получить справочник CommonJS API
+ */
+export declare function getCommonJSAPI(args?: any): any;
+/**
+ * Получить паттерны меню категорий
+ */
+export declare function getCollectionsMenuPatterns(args?: any): any;
+//# sourceMappingURL=index.d.ts.map