iwgt 2.4.6 → 2.4.9

package/dist/tools/index.d.ts

@@ -28,11 +28,17 @@ export declare function getLiquidVariables(args?: any): any;
  */
 export declare function getLiquidFilters(args?: any): any;
 /**
- * Получить справочник CommonJS API
+ * Получить справочник CommonJS API v2 для InSales
+ * ОБНОВЛЕНО: использует commonjs-api-complete.json с акцентом на глобальные переменные
  */
 export declare function getCommonJSAPI(args?: any): any;
 /**
  * Получить паттерны меню категорий
  */
 export declare function getCollectionsMenuPatterns(args?: any): any;
+/**
+ * Получить справочник API библиотек
+ * Объединяет информацию из libraries-registry и libraries-api-reference
+ */
+export declare function getLibrariesAPI(args?: any): any;
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.js

@@ -9,8 +9,9 @@ import categorySettings from '../data/references/category-settings.json' with {
 import librariesRegistry from '../data/references/libraries-registry.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 commonjsApiComplete from '../data/references/commonjs-api-complete.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' };
 /**
  * Получить список блок-темплейтов с фильтрацией
  */
@@ -240,121 +241,207 @@ export function getLiquidFilters(args = {}) {
     }
 }
 /**
- * Получить справочник CommonJS API
+ * Получить справочник CommonJS API v2 для InSales
+ * ОБНОВЛЕНО: использует commonjs-api-complete.json с акцентом на глобальные переменные
  */
 export function getCommonJSAPI(args = {}) {
     const { category, module, search } = args;
-    const data = commonjsReference;
-    // Без параметров - общая информация
+    const completeData = commonjsApiComplete;
+    // Без параметров - критическая информация и обзор
     if (!category && !module && !search) {
         return {
-            modules: data.modules.map(m => ({
-                name: m.name,
-                description: m.description,
-                methods_count: m.methods?.length || 0,
-                events_count: m.events?.length || 0,
+            version: completeData.version,
+            title: completeData.title,
+            description: completeData.description,
+            critical_info: completeData.critical_info,
+            installation: completeData.installation,
+            global_modules: Object.keys(completeData.global_modules).map(name => ({
+                name,
+                description: completeData.global_modules[name].description,
+                global_access: completeData.global_modules[name].global_access,
+                declarative: completeData.global_modules[name].declarative || false,
+                has_data_attributes: Object.keys(completeData.global_modules[name].data_attributes || {}).length > 0,
+                methods_count: Object.keys(completeData.global_modules[name].methods || {}).length,
+                events_count: Object.keys(completeData.global_modules[name].events || {}).length,
+            })),
+            ui_components: Object.keys(completeData.ui_components || {}).map(key => ({
+                name: completeData.ui_components[key].name,
+                description: completeData.ui_components[key].description,
+                declarative: completeData.ui_components[key].declarative,
+                no_js_needed: completeData.ui_components[key].no_js_needed,
             })),
-            total_modules: data.modules.length,
-            total_methods: data.modules.reduce((sum, m) => sum + (m.methods?.length || 0), 0),
-            total_events: data.modules.reduce((sum, m) => sum + (m.events?.length || 0), 0),
-            message: "Укажите module или search для детальной информации",
+            quick_reference: completeData.quick_reference,
+            message: "⚠️ ВСЕ модули доступны ГЛОБАЛЬНО! НЕ используйте import. Укажите module или search для детальной информации."
         };
     }
-    // Поиск по категории (не используется в CommonJS)
+    // Поиск по категории (для UI компонентов)
     if (category) {
-        // CommonJS не имеет категорий, игнорируем
-        const modules = data.modules;
-        return {
+        const categoryMap = {
+            'product': ['Cart', 'Products', 'ajax_products', 'ajax_product', 'accessories'],
+            'cart': ['Cart'],
+            'lists': ['Compare', 'FavoritesProducts'],
+            'search': ['AjaxSearch'],
+            'forms': ['feedback_form', 'reviews_form', 'comments_form'],
+            'events': ['EventBus'],
+            'helpers': ['Shop', 'Template', 'ajaxAPI'],
+            'checkout': ['quick_checkout']
+        };
+        const modulesInCategory = categoryMap[category] || [];
+        const results = {
             category,
-            modules: modules.map(m => ({
-                name: m.name,
-                description: m.description,
-                methods: m.methods,
-                attributes: m.attributes,
-                events: m.events,
-            })),
+            global_modules: [],
+            ui_components: [],
         };
+        modulesInCategory.forEach((modName) => {
+            if (completeData.global_modules[modName]) {
+                results.global_modules.push({
+                    name: modName,
+                    ...completeData.global_modules[modName]
+                });
+            }
+            if (completeData.ui_components[modName]) {
+                results.ui_components.push({
+                    key: modName,
+                    ...completeData.ui_components[modName]
+                });
+            }
+        });
+        return results;
     }
     // Поиск по модулю
     if (module) {
-        const mod = data.modules.find(m => m.name === module);
-        if (!mod) {
+        // Сначала ищем в глобальных модулях
+        if (completeData.global_modules[module]) {
+            const mod = completeData.global_modules[module];
+            return {
+                type: 'global_module',
+                name: module,
+                ...mod,
+                usage_note: mod.declarative ?
+                    "💡 Этот модуль поддерживает декларативную работу через data-атрибуты. Используйте их вместо JavaScript где возможно." :
+                    "⚠️ Этот модуль требует JavaScript для работы.",
+                best_practices: completeData.best_practices,
+            };
+        }
+        // Затем ищем в UI компонентах
+        if (completeData.ui_components[module]) {
+            const comp = completeData.ui_components[module];
             return {
-                error: `Модуль "${module}" не найден`,
-                available_modules: data.modules.map(m => m.name),
+                type: 'ui_component',
+                key: module,
+                ...comp,
+                usage_note: comp.no_js_needed ?
+                    "✅ Этот компонент работает ПОЛНОСТЬЮ без JavaScript!" :
+                    "⚠️ Этот компонент требует инициализации через JavaScript.",
             };
         }
         return {
-            module: mod.name,
-            description: mod.description,
-            methods: mod.methods,
-            attributes: mod.attributes,
-            events: mod.events,
-            examples: mod.examples,
+            error: `Модуль "${module}" не найден`,
+            available_global_modules: Object.keys(completeData.global_modules),
+            available_ui_components: Object.keys(completeData.ui_components || {}),
         };
     }
     // Поиск по ключевому слову
     if (search) {
         const searchLower = search.toLowerCase();
         const results = {
+            global_modules: [],
+            data_attributes: [],
             methods: [],
             events: [],
-            attributes: [],
-            method_events: [], // События, связанные с методами
+            ui_components: [],
+            patterns: [],
         };
-        data.modules.forEach(mod => {
+        // Поиск в глобальных модулях
+        Object.entries(completeData.global_modules).forEach(([name, mod]) => {
+            // Поиск по имени и описанию модуля
+            if (name.toLowerCase().includes(searchLower) ||
+                mod.description?.toLowerCase().includes(searchLower)) {
+                results.global_modules.push({
+                    name,
+                    description: mod.description,
+                    global_access: mod.global_access,
+                    declarative: mod.declarative,
+                });
+            }
+            // Поиск по data-атрибутам
+            if (mod.data_attributes) {
+                Object.entries(mod.data_attributes).forEach(([attrName, attr]) => {
+                    if (attrName.toLowerCase().includes(searchLower) ||
+                        attr.description?.toLowerCase().includes(searchLower)) {
+                        results.data_attributes.push({
+                            name: attrName,
+                            module: name,
+                            ...attr,
+                        });
+                    }
+                });
+            }
             // Поиск по методам
-            mod.methods?.forEach(method => {
-                if (method.name.toLowerCase().includes(searchLower) ||
-                    method.description?.toLowerCase().includes(searchLower)) {
-                    results.methods.push({
-                        ...method,
-                        module: mod.name,
-                    });
-                }
-                // Поиск по событиям внутри методов
-                method.events?.forEach(event => {
-                    if (event.name.toLowerCase().includes(searchLower) ||
+            if (mod.methods) {
+                Object.entries(mod.methods).forEach(([methodName, method]) => {
+                    if (methodName.toLowerCase().includes(searchLower) ||
+                        method.description?.toLowerCase().includes(searchLower)) {
+                        results.methods.push({
+                            name: methodName,
+                            module: name,
+                            ...method,
+                        });
+                    }
+                });
+            }
+            // Поиск по событиям
+            if (mod.events) {
+                Object.entries(mod.events).forEach(([eventName, event]) => {
+                    if (eventName.toLowerCase().includes(searchLower) ||
                         event.description?.toLowerCase().includes(searchLower)) {
-                        results.method_events.push({
+                        results.events.push({
+                            name: eventName,
+                            module: name,
                             ...event,
-                            module: mod.name,
-                            method: method.name,
                         });
                     }
                 });
-            });
-            // Поиск по событиям модуля
-            mod.events?.forEach(event => {
-                if (event.name.toLowerCase().includes(searchLower) ||
-                    event.description?.toLowerCase().includes(searchLower)) {
-                    results.events.push({
-                        ...event,
-                        module: mod.name,
+            }
+        });
+        // Поиск в UI компонентах
+        if (completeData.ui_components) {
+            Object.entries(completeData.ui_components).forEach(([key, comp]) => {
+                if (key.toLowerCase().includes(searchLower) ||
+                    comp.name?.toLowerCase().includes(searchLower) ||
+                    comp.description?.toLowerCase().includes(searchLower)) {
+                    results.ui_components.push({
+                        key,
+                        ...comp,
                     });
                 }
             });
-            // Поиск по атрибутам
-            mod.attributes?.forEach(attr => {
-                if (attr.name.toLowerCase().includes(searchLower) ||
-                    attr.description?.toLowerCase().includes(searchLower)) {
-                    results.attributes.push({
-                        ...attr,
-                        module: mod.name,
+        }
+        // Поиск в паттернах
+        if (completeData.common_patterns) {
+            Object.entries(completeData.common_patterns).forEach(([key, pattern]) => {
+                if (key.toLowerCase().includes(searchLower) ||
+                    pattern.title?.toLowerCase().includes(searchLower)) {
+                    results.patterns.push({
+                        key,
+                        ...pattern,
                     });
                 }
             });
-        });
+        }
+        const totalResults = results.global_modules.length +
+            results.data_attributes.length +
+            results.methods.length +
+            results.events.length +
+            results.ui_components.length +
+            results.patterns.length;
         return {
             search,
-            methods_count: results.methods.length,
-            events_count: results.events.length,
-            method_events_count: results.method_events.length,
-            attributes_count: results.attributes.length,
-            note: results.attributes.length > 0
-                ? 'Data-атрибуты работают автоматически при добавлении в HTML. JavaScript не требуется для базовой функциональности.'
-                : undefined,
+            total_results: totalResults,
             results,
+            note: totalResults === 0 ?
+                "Ничего не найдено. Попробуйте другой запрос или используйте module для просмотра конкретного модуля." :
+                `Найдено ${totalResults} результатов. Используйте data-атрибуты вместо JavaScript где возможно!`,
         };
     }
 }
@@ -427,4 +514,144 @@ export function getCollectionsMenuPatterns(args = {}) {
         };
     }
 }
+/**
+ * Получить справочник API библиотек
+ * Объединяет информацию из libraries-registry и libraries-api-reference
+ */
+export function getLibrariesAPI(args = {}) {
+    const { library, search, category } = args;
+    const apiData = librariesApiReference;
+    const registryData = librariesRegistry;
+    // Без параметров - список всех библиотек с API документацией
+    if (!library && !search && !category) {
+        return {
+            title: apiData.title,
+            description: apiData.description,
+            libraries_with_api: apiData.libraries.map((lib) => ({
+                name: lib.name,
+                handle: lib.handle,
+                type: lib.type,
+                description: lib.description,
+                dependencies: lib.dependencies,
+                categories: lib.categories,
+            })),
+            total_libraries: apiData.libraries.length,
+            message: "Укажите library для получения полной документации по API, или search для поиска",
+            available_libraries: apiData.libraries.map((lib) => lib.handle),
+        };
+    }
+    // Поиск конкретной библиотеки
+    if (library) {
+        const lib = apiData.libraries.find((l) => l.handle === library || l.name.toLowerCase() === library.toLowerCase());
+        if (!lib) {
+            return {
+                error: `Библиотека "${library}" не найдена в API справочнике`,
+                available_libraries: apiData.libraries.map((l) => ({
+                    handle: l.handle,
+                    name: l.name,
+                })),
+                note: "Некоторые библиотеки могут не иметь подробной API документации",
+            };
+        }
+        // Полная информация о библиотеке
+        return {
+            library: {
+                name: lib.name,
+                handle: lib.handle,
+                version: lib.version,
+                type: lib.type,
+                description: lib.description,
+                categories: lib.categories,
+                dependencies: lib.dependencies,
+            },
+            usage: lib.usage,
+            options: lib.options,
+            methods: lib.methods,
+            events: lib.events,
+            cssClasses: lib.cssClasses,
+            examples: lib.examples,
+            bestPractices: lib.bestPractices,
+            notes: lib.notes,
+        };
+    }
+    // Поиск по ключевому слову
+    if (search) {
+        const searchLower = search.toLowerCase();
+        const results = {
+            libraries: [],
+            options: [],
+            methods: [],
+            examples: [],
+        };
+        apiData.libraries.forEach((lib) => {
+            // Поиск по библиотекам
+            if (lib.name.toLowerCase().includes(searchLower) ||
+                lib.handle.toLowerCase().includes(searchLower) ||
+                lib.description?.toLowerCase().includes(searchLower)) {
+                results.libraries.push({
+                    name: lib.name,
+                    handle: lib.handle,
+                    description: lib.description,
+                    type: lib.type,
+                });
+            }
+            // Поиск по опциям
+            lib.options?.forEach((opt) => {
+                if (opt.name.toLowerCase().includes(searchLower) ||
+                    opt.description?.toLowerCase().includes(searchLower)) {
+                    results.options.push({
+                        ...opt,
+                        library: lib.name,
+                        library_handle: lib.handle,
+                    });
+                }
+            });
+            // Поиск по методам
+            lib.methods?.forEach((method) => {
+                if (method.name.toLowerCase().includes(searchLower) ||
+                    method.description?.toLowerCase().includes(searchLower)) {
+                    results.methods.push({
+                        ...method,
+                        library: lib.name,
+                        library_handle: lib.handle,
+                    });
+                }
+            });
+            // Поиск по примерам
+            lib.examples?.forEach((example) => {
+                if (example.title?.toLowerCase().includes(searchLower) ||
+                    example.description?.toLowerCase().includes(searchLower)) {
+                    results.examples.push({
+                        ...example,
+                        library: lib.name,
+                        library_handle: lib.handle,
+                    });
+                }
+            });
+        });
+        return {
+            search,
+            libraries_count: results.libraries.length,
+            options_count: results.options.length,
+            methods_count: results.methods.length,
+            examples_count: results.examples.length,
+            results,
+        };
+    }
+    // Фильтрация по категории
+    if (category) {
+        const categoryLibraries = apiData.libraries.filter((lib) => lib.categories?.includes(category));
+        return {
+            category,
+            count: categoryLibraries.length,
+            libraries: categoryLibraries.map((lib) => ({
+                name: lib.name,
+                handle: lib.handle,
+                description: lib.description,
+                type: lib.type,
+                usage: lib.usage,
+            })),
+        };
+    }
+}
 //# sourceMappingURL=index.js.map

package/package.json

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