iwgt 2.4.10 → 2.4.11

package/dist/server.js

@@ -17,6 +17,7 @@ import liquidFilters from './data/references/liquid-filters.json' with { type: '
 import commonjsReference from './data/references/commonjs-reference.json' with { type: 'json' };
 import collectionsMenuPatterns from './data/references/collections-menu-patterns.json' with { type: 'json' };
 import librariesApiReference from './data/references/libraries-api-reference.json' with { type: 'json' };
+import javascriptGuide from './data/references/javascript-guide.json' with { type: 'json' };
 // Импорт модулей
 import { generateWidgetFiles } from './generators/index.js';
 import * as tools from './tools/index.js';
@@ -26,7 +27,7 @@ export class WidgetServer {
     constructor() {
         this.server = new Server({
             name: 'insales-widgets',
-            version: '2.4.10',
+            version: '2.4.11',
         }, {
             capabilities: {
                 tools: {},
@@ -251,6 +252,35 @@ export class WidgetServer {
                         },
                     },
                 },
+                {
+                    name: 'get_javascript_guide',
+                    description: 'Получить руководство по написанию JavaScript для виджетов InSales. Включает принципы, API, паттерны, частые ошибки, отладку и best practices.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            section: {
+                                type: 'string',
+                                description: 'Конкретный раздел руководства (principles, global_apis, data_attributes, patterns, common_errors, debugging, linting, checklist, golden_rule)',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Поиск по всему руководству по ключевым словам',
+                            },
+                            pattern: {
+                                type: 'string',
+                                description: 'ID конкретного паттерна (widget_isolation, declarative_cart, counters, mobile_menu, scroll_animation, products_work, cart_events)',
+                            },
+                            error: {
+                                type: 'string',
+                                description: 'ID конкретной ошибки (no_widget_isolation, global_selectors, reinventing_wheel, using_imports, return_outside_function, forgot_mobile)',
+                            },
+                            api_module: {
+                                type: 'string',
+                                description: 'Название модуля API (Cart, Products, EventBus, Shop, ajaxAPI, Template, AjaxSearch)',
+                            },
+                        },
+                    },
+                },
             ],
         }));
         // Список ресурсов
@@ -322,6 +352,12 @@ export class WidgetServer {
                     mimeType: 'application/json',
                     description: 'Подробная API документация библиотек: InsalesCutList и другие',
                 },
+                {
+                    uri: 'insales://javascript-guide',
+                    name: 'JavaScript руководство',
+                    mimeType: 'application/json',
+                    description: 'Полное руководство по написанию JavaScript для виджетов InSales: принципы, API, паттерны, ошибки, отладка',
+                },
             ],
         }));
         // Чтение ресурсов
@@ -420,7 +456,7 @@ export class WidgetServer {
                     };
                 case 'insales://widget-architecture': {
                     // Читаем markdown файл с документацией об архитектуре
-                    const docPath = join(__dirname, '../context-content/doc/4 поколение/Виджеты/widget-wrapper-and-context.md');
+                    const docPath = join(__dirname, 'data/widget-wrapper-and-context.md');
                     const content = readFileSync(docPath, 'utf-8');
                     return {
                         contents: [
@@ -442,6 +478,16 @@ export class WidgetServer {
                             },
                         ],
                     };
+                case 'insales://javascript-guide':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify(javascriptGuide, null, 2),
+                            },
+                        ],
+                    };
                 default:
                     throw new Error(`Unknown resource: ${uri}`);
             }
@@ -543,6 +589,15 @@ export class WidgetServer {
                                 },
                             ],
                         };
+                    case 'get_javascript_guide':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(tools.getJavaScriptGuide(args || {}), null, 2),
+                                },
+                            ],
+                        };
                     default:
                         throw new Error(`Unknown tool: ${name}`);
                 }

package/dist/tools/index.d.ts

@@ -43,4 +43,8 @@ export declare function getLiquidVariables(args?: any): any;
  * Получить постоянные ссылки InSales
  */
 export declare function getInsalesPermanentLinks(args?: any): any;
+/**
+ * Получить руководство по JavaScript для виджетов
+ */
+export declare function getJavaScriptGuide(args?: any): any;
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.js

@@ -13,6 +13,7 @@ import commonjsApiComplete from '../data/references/commonjs-api-complete.json'
 import collectionsMenuPatterns from '../data/references/collections-menu-patterns.json' with { type: 'json' };
 import librariesApiReference from '../data/references/libraries-api-reference.json' with { type: 'json' };
 import insalesPermanentLinks from '../data/insales-permanent-links.json' with { type: 'json' };
+import javascriptGuide from '../data/references/javascript-guide.json' with { type: 'json' };
 /**
  * Получить список блок-темплейтов с фильтрацией
  */
@@ -306,4 +307,125 @@ export function getInsalesPermanentLinks(args = {}) {
         notes: data.notes
     };
 }
+/**
+ * Получить руководство по JavaScript для виджетов
+ */
+export function getJavaScriptGuide(args = {}) {
+    const { section, search, pattern, error, api_module } = args;
+    const data = javascriptGuide;
+    if (section) {
+        const sectionData = data.sections?.[section];
+        if (sectionData) {
+            return {
+                section,
+                ...sectionData
+            };
+        }
+        return { error: `Раздел '${section}' не найден` };
+    }
+    if (pattern) {
+        const patterns = data.sections?.patterns?.patterns || [];
+        const foundPattern = patterns.find((p) => p.id === pattern);
+        if (foundPattern) {
+            return {
+                pattern: foundPattern
+            };
+        }
+        return { error: `Паттерн '${pattern}' не найден` };
+    }
+    if (error) {
+        const errors = data.sections?.common_errors?.errors || [];
+        const foundError = errors.find((e) => e.id === error);
+        if (foundError) {
+            return {
+                error: foundError
+            };
+        }
+        return { error: `Ошибка '${error}' не найдена` };
+    }
+    if (api_module) {
+        const modules = data.sections?.global_apis?.modules || [];
+        const foundModule = modules.find((m) => m.name === api_module);
+        if (foundModule) {
+            return {
+                module: foundModule
+            };
+        }
+        return { error: `Модуль API '${api_module}' не найден` };
+    }
+    if (search) {
+        const searchLower = search.toLowerCase();
+        const results = {
+            sections: {},
+            patterns: [],
+            errors: [],
+            modules: [],
+            attributes: []
+        };
+        // Поиск по разделам
+        Object.keys(data.sections || {}).forEach(sectionKey => {
+            const section = data.sections[sectionKey];
+            if (section.title?.toLowerCase().includes(searchLower) ||
+                section.description?.toLowerCase().includes(searchLower)) {
+                results.sections[sectionKey] = section;
+            }
+        });
+        // Поиск по паттернам
+        const patterns = data.sections?.patterns?.patterns || [];
+        patterns.forEach((pattern) => {
+            if (pattern.title?.toLowerCase().includes(searchLower) ||
+                pattern.description?.toLowerCase().includes(searchLower) ||
+                pattern.code?.toLowerCase().includes(searchLower)) {
+                results.patterns.push(pattern);
+            }
+        });
+        // Поиск по ошибкам
+        const errors = data.sections?.common_errors?.errors || [];
+        errors.forEach((error) => {
+            if (error.title?.toLowerCase().includes(searchLower) ||
+                error.description?.toLowerCase().includes(searchLower)) {
+                results.errors.push(error);
+            }
+        });
+        // Поиск по модулям API
+        const modules = data.sections?.global_apis?.modules || [];
+        modules.forEach((module) => {
+            if (module.name?.toLowerCase().includes(searchLower) ||
+                module.description?.toLowerCase().includes(searchLower)) {
+                results.modules.push(module);
+            }
+        });
+        // Поиск по data-атрибутам
+        const attributes = data.sections?.data_attributes?.attributes || [];
+        attributes.forEach((attr) => {
+            if (attr.name?.toLowerCase().includes(searchLower) ||
+                attr.description?.toLowerCase().includes(searchLower)) {
+                results.attributes.push(attr);
+            }
+        });
+        return {
+            search,
+            total: Object.keys(results.sections).length + results.patterns.length +
+                results.errors.length + results.modules.length + results.attributes.length,
+            results
+        };
+    }
+    return {
+        title: data.title,
+        description: data.description,
+        version: data.version,
+        sections: Object.keys(data.sections || {}),
+        available_sections: {
+            principles: "Основные принципы написания JavaScript",
+            global_apis: "Глобальные API (Cart, Products, EventBus, etc.)",
+            data_attributes: "Data-атрибуты CommonJS",
+            patterns: "Паттерны и примеры кода",
+            common_errors: "Частые ошибки и их исправление",
+            debugging: "Способы отладки",
+            linting: "Линтер и проверка кода",
+            checklist: "Чеклист перед завершением",
+            golden_rule: "Золотое правило"
+        }
+    };
+}
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iwgt",
-  "version": "2.4.10",
+  "version": "2.4.11",
   "description": "MCP server",
   "type": "module",
   "main": "dist/index.js",