iwgt 2.4.11 → 2.4.13

package/dist/server.js

@@ -18,16 +18,30 @@ import commonjsReference from './data/references/commonjs-reference.json' with {
 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 settingsTypesReference from './data/references/settings-types.json' with { type: 'json' };
 // Импорт модулей
 import { generateWidgetFiles } from './generators/index.js';
 import * as tools from './tools/index.js';
 import * as utils from './utils/index.js';
+import { createSetting } from './utils/settings.js';
+// Функция для преобразования SettingsField[] в Setting[]
+function convertSettingsFieldToSetting(field) {
+    if (!field.label) {
+        throw new Error(`Поле label обязательно для настройки ${field.name}`);
+    }
+    return createSetting({
+        type: field.type,
+        name: field.name,
+        label: field.label,
+        ...field
+    });
+}
 export class WidgetServer {
     server;
     constructor() {
         this.server = new Server({
             name: 'insales-widgets',
-            version: '2.4.11',
+            version: '2.4.13',
         }, {
             capabilities: {
                 tools: {},
@@ -59,7 +73,14 @@ export class WidgetServer {
 - sliders (слайдеры), banner (баннеры), benefits (преимущества)
 - products-cards (карточки товаров), collection-products (товары категории)
 - navigation (навигация), forms (формы), text (текстовые блоки)
-- и другие - используйте get_category_info для получения полного списка`,
+- и другие - используйте get_category_info для получения полного списка
+
+ПАРАМЕТРЫ:
+- description (string): описание виджета
+- category (string, опционально): категория виджета
+- type (string, опционально): simple_widget_type или block_list_widget_type
+- handle (string, опционально): уникальный handle виджета
+- cleanMode (boolean, опционально): если true, генерирует файлы без служебных комментариев`,
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -80,6 +101,10 @@ export class WidgetServer {
                                 type: 'string',
                                 description: 'Handle виджета (например: my_promo_slider). Опционально - сгенерируется автоматически',
                             },
+                            cleanMode: {
+                                type: 'boolean',
+                                description: 'Если true, генерирует файлы без служебных комментариев (ВАЖНО, КРИТИЧЕСКИ ВАЖНО и т.д.)',
+                            },
                         },
                         required: ['description'],
                     },
@@ -281,6 +306,23 @@ export class WidgetServer {
                         },
                     },
                 },
+                {
+                    name: 'get_settings_types_reference',
+                    description: 'Получить справочник типов настроек виджетов InSales. Включает описание всех доступных типов настроек, их параметры, примеры использования и валидацию.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            type: {
+                                type: 'string',
+                                description: 'Конкретный тип настройки для получения детальной информации (text, number, checkbox, select, color и т.д.)',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Поиск по типам настроек по названию или описанию',
+                            },
+                        },
+                    },
+                },
             ],
         }));
         // Список ресурсов
@@ -598,6 +640,15 @@ export class WidgetServer {
                                 },
                             ],
                         };
+                    case 'get_settings_types_reference':
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(this.getSettingsTypesReference(args || {}), null, 2),
+                                },
+                            ],
+                        };
                     default:
                         throw new Error(`Unknown tool: ${name}`);
                 }
@@ -624,6 +675,10 @@ export class WidgetServer {
         if (!categoryData) {
             throw new Error(`Неизвестная категория: ${category}`);
         }
+        // Преобразуем SettingsField[] в Setting[]
+        const convertedCommonSettings = categoryData.commonSettings
+            .filter((s) => (s.frequency || 0) > 0.5)
+            .map(convertSettingsFieldToSetting);
         // Генерируем или валидируем handle
         let handle = params.handle || utils.generateHandle(description);
         if (params.handle) {
@@ -646,10 +701,11 @@ export class WidgetServer {
             description,
             blockTemplate,
             libraries: categoryData.libraries,
-            commonSettings: categoryData.commonSettings.filter(s => (s.frequency || 0) > 0.5),
+            commonSettings: convertedCommonSettings,
         };
         // Генерация содержимого файлов
-        const files = generateWidgetFiles(config);
+        const cleanMode = params.cleanMode === true; // По умолчанию false для обратной совместимости
+        const files = generateWidgetFiles(config, cleanMode);
         // Форматируем вывод для AI-агента
         let output = `✅ Виджет создан успешно!\n\n`;
         output += `📦 Handle: ${handle}\n`;
@@ -694,6 +750,45 @@ export class WidgetServer {
             ],
         };
     }
+    /**
+     * Получить справочник типов настроек виджетов
+     */
+    getSettingsTypesReference(params) {
+        const { type, search } = params;
+        // Если указан конкретный тип, возвращаем только его
+        if (type) {
+            const typeData = settingsTypesReference.types[type];
+            if (!typeData) {
+                throw new Error(`Тип настройки "${type}" не найден. Доступные типы: ${Object.keys(settingsTypesReference.types).join(', ')}`);
+            }
+            return {
+                type,
+                ...typeData
+            };
+        }
+        // Если указан поиск, фильтруем результаты
+        if (search) {
+            const types = settingsTypesReference.types;
+            const filteredTypes = {};
+            for (const [typeName, typeData] of Object.entries(types)) {
+                const searchLower = search.toLowerCase();
+                const matchesSearch = typeName.toLowerCase().includes(searchLower) ||
+                    typeData.description?.toLowerCase().includes(searchLower) ||
+                    typeData.parameters?.some((p) => p.name?.toLowerCase().includes(searchLower) ||
+                        p.description?.toLowerCase().includes(searchLower));
+                if (matchesSearch) {
+                    filteredTypes[typeName] = typeData;
+                }
+            }
+            return {
+                search,
+                types: filteredTypes,
+                totalFound: Object.keys(filteredTypes).length
+            };
+        }
+        // Возвращаем полный справочник
+        return settingsTypesReference;
+    }
     /**
      * Подключить внешний транспорт (например, SSE)
      */

package/dist/tools/index.js

@@ -148,7 +148,12 @@ export function getLiquidFilters(args = {}) {
 export function getCommonJSAPI(args = {}) {
     const { category, module, search } = args;
     const data = commonjsApiComplete;
-    let modules = data.modules || [];
+    // Получаем модули из global_modules
+    const globalModules = data.global_modules || {};
+    let modules = Object.keys(globalModules).map(key => ({
+        name: key,
+        ...globalModules[key]
+    }));
     if (module) {
         modules = modules.filter((mod) => mod.name === module);
     }
@@ -159,16 +164,20 @@ export function getCommonJSAPI(args = {}) {
         const searchLower = search.toLowerCase();
         modules = modules.filter((mod) => mod.name.toLowerCase().includes(searchLower) ||
             mod.description?.toLowerCase().includes(searchLower) ||
-            mod.methods?.some((m) => m.name.toLowerCase().includes(searchLower)));
+            (mod.methods && Object.keys(mod.methods).some((methodName) => methodName.toLowerCase().includes(searchLower))) ||
+            (mod.events && Object.keys(mod.events).some((eventName) => eventName.toLowerCase().includes(searchLower))));
     }
     return {
         total: modules.length,
         modules: modules.map((mod) => ({
             name: mod.name,
             description: mod.description,
-            category: mod.category,
-            methods: mod.methods || [],
-            events: mod.events || []
+            global_access: mod.global_access,
+            type: mod.type,
+            declarative: mod.declarative,
+            methods: mod.methods || {},
+            events: mod.events || {},
+            data_attributes: mod.data_attributes || {}
         }))
     };
 }

package/dist/types/index.d.ts

@@ -1,3 +1,5 @@
+import type { Setting } from './settings.js';
+export type { Setting, BaseSetting, TextSetting, NumberSetting, CheckboxSetting, SelectSetting, RangeSetting, ButtonGroupSetting, FileSetting, ColorSetting, BlogSetting, InfoSetting, CurrentPageDescriptionSetting, IconGroupSetting, LinkToWidgetSetting, ButtonSwitchSetting } from './settings.js';
 export interface WidgetInfo {
     widget_category_handle: string;
     widget_type: 'simple_widget_type' | 'block_list_widget_type';
@@ -33,7 +35,7 @@ export interface BlockField {
     name: string;
 }
 export interface CategoryData {
-    commonSettings: SettingsField[];
+    commonSettings: Setting[];
     totalWidgets: number;
     libraries: string[];
     blockTemplates: string[];

package/dist/types/settings.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Типы настроек для виджетов InSales
+ * Сгенерировано на основе документации и анализа системных виджетов
+ */
+export interface BaseSetting {
+    name: string;
+    label: string;
+    type: string;
+    value?: any;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}
+export interface TextSetting extends BaseSetting {
+    type: 'text';
+    value?: string;
+    placeholder?: string;
+}
+export interface RichTextSetting extends BaseSetting {
+    type: 'rich-text';
+    value?: string;
+}
+export interface NumberSetting extends BaseSetting {
+    type: 'number';
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    with_btns?: boolean;
+}
+export interface CheckboxSetting extends BaseSetting {
+    type: 'checkbox';
+    value?: boolean;
+}
+export interface SelectSetting extends BaseSetting {
+    type: 'select';
+    value?: string;
+    options: Array<[string, string]> | Array<{
+        value: string;
+        text: string;
+    }>;
+}
+export interface RangeSetting extends BaseSetting {
+    type: 'range';
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    with_btns?: boolean;
+}
+export interface ButtonGroupSetting extends BaseSetting {
+    type: 'button-group';
+    value?: string;
+    options: Array<{
+        value: string;
+        title: string;
+        icon?: string;
+    }>;
+}
+export interface FileSetting extends BaseSetting {
+    type: 'file';
+    value?: string | null;
+    'with-generate-logo'?: boolean;
+}
+export interface ColorSetting extends BaseSetting {
+    type: 'color';
+    value?: string;
+    clearable?: boolean;
+    fallback?: string;
+}
+export interface BlogSetting extends BaseSetting {
+    type: 'blog';
+    value?: string | null;
+    edit_admin_link?: string;
+}
+export interface InfoSetting extends BaseSetting {
+    type: 'info';
+    value?: string;
+}
+export interface CurrentPageDescriptionSetting extends BaseSetting {
+    type: 'current-page-description';
+    value?: string;
+}
+export interface IconGroupSetting extends BaseSetting {
+    type: 'icon_group';
+    value?: string;
+}
+export interface LinkToWidgetSetting extends BaseSetting {
+    type: 'link-to-widget';
+    value?: string;
+}
+export interface ButtonSwitchSetting extends BaseSetting {
+    type: 'button_switch';
+    value?: boolean;
+}
+export type Setting = TextSetting | RichTextSetting | NumberSetting | CheckboxSetting | SelectSetting | RangeSetting | ButtonGroupSetting | FileSetting | ColorSetting | BlogSetting | InfoSetting | CurrentPageDescriptionSetting | IconGroupSetting | LinkToWidgetSetting | ButtonSwitchSetting;
+export interface SettingGroup {
+    type: 'group';
+    name: string;
+    items: Setting[];
+}
+export interface SettingsForm {
+    [groupName: string]: SettingGroup[];
+}
+export interface SettingValidation {
+    isValid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+        suggestion?: string;
+    }>;
+}
+export declare function validateSetting(setting: any): SettingValidation;
+export declare const AVAILABLE_SETTING_TYPES: readonly ["text", "rich-text", "number", "checkbox", "select", "range", "button-group", "file", "color", "blog", "info", "current-page-description", "icon_group", "link-to-widget", "button_switch"];
+export type SettingType = typeof AVAILABLE_SETTING_TYPES[number];
+export declare function isValidSettingType(type: string): type is SettingType;
+//# sourceMappingURL=settings.d.ts.map

package/dist/types/settings.js

@@ -0,0 +1,71 @@
+/**
+ * Типы настроек для виджетов InSales
+ * Сгенерировано на основе документации и анализа системных виджетов
+ */
+// Функция валидации настройки
+export function validateSetting(setting) {
+    const errors = [];
+    // Проверяем обязательные поля
+    if (!setting.name) {
+        errors.push({ field: 'name', message: 'Поле name обязательно' });
+    }
+    if (!setting.label) {
+        errors.push({ field: 'label', message: 'Поле label обязательно' });
+    }
+    if (!setting.type) {
+        errors.push({ field: 'type', message: 'Поле type обязательно' });
+    }
+    // Проверяем специфичные для типа поля
+    if (setting.type === 'select' && !setting.options) {
+        errors.push({
+            field: 'options',
+            message: 'Для типа select обязательно поле options',
+            suggestion: 'Добавьте массив опций: [["Текст", "значение"], ...]'
+        });
+    }
+    if (setting.type === 'button-group' && !setting.options) {
+        errors.push({
+            field: 'options',
+            message: 'Для типа button-group обязательно поле options',
+            suggestion: 'Добавьте массив объектов: [{value: "val", title: "Title", icon: "icon"}]'
+        });
+    }
+    if ((setting.type === 'number' || setting.type === 'range') && setting.min !== undefined && setting.max !== undefined) {
+        if (setting.min >= setting.max) {
+            errors.push({
+                field: 'min/max',
+                message: 'min должно быть меньше max',
+                suggestion: 'Проверьте значения min и max'
+            });
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors
+    };
+}
+// Список всех доступных типов настроек (из документации + системные виджеты)
+export const AVAILABLE_SETTING_TYPES = [
+    // Основные типы из документации
+    'text',
+    'rich-text',
+    'number',
+    'checkbox',
+    'select',
+    'range',
+    'button-group',
+    'file',
+    'color',
+    'blog',
+    // Дополнительные типы из системных виджетов
+    'info',
+    'current-page-description',
+    'icon_group',
+    'link-to-widget',
+    'button_switch'
+];
+// Проверка валидности типа настройки
+export function isValidSettingType(type) {
+    return AVAILABLE_SETTING_TYPES.includes(type);
+}
+//# sourceMappingURL=settings.js.map

package/dist/utils/settings.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Утилиты для создания настроек виджетов с валидацией
+ */
+import type { Setting, TextSetting, NumberSetting, CheckboxSetting, SelectSetting, RangeSetting, ButtonGroupSetting, FileSetting, ColorSetting, BlogSetting, InfoSetting, CurrentPageDescriptionSetting, IconGroupSetting, LinkToWidgetSetting, ButtonSwitchSetting } from '../types/settings.js';
+/**
+ * Создает текстовую настройку
+ */
+export declare function createTextSetting(config: {
+    name: string;
+    label: string;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+    placeholder?: string;
+}): TextSetting;
+/**
+ * Создает числовую настройку
+ */
+export declare function createNumberSetting(config: {
+    name: string;
+    label: string;
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    with_btns?: boolean;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): NumberSetting;
+/**
+ * Создает настройку-чекбокс
+ */
+export declare function createCheckboxSetting(config: {
+    name: string;
+    label: string;
+    value?: boolean;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): CheckboxSetting;
+/**
+ * Создает настройку-селект
+ */
+export declare function createSelectSetting(config: {
+    name: string;
+    label: string;
+    options: Array<[string, string]> | Array<{
+        value: string;
+        text: string;
+    }>;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): SelectSetting;
+/**
+ * Создает настройку-ползунок
+ */
+export declare function createRangeSetting(config: {
+    name: string;
+    label: string;
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    with_btns?: boolean;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): RangeSetting;
+/**
+ * Создает настройку-группу кнопок
+ */
+export declare function createButtonGroupSetting(config: {
+    name: string;
+    label: string;
+    options: Array<{
+        value: string;
+        title: string;
+        icon?: string;
+    }>;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): ButtonGroupSetting;
+/**
+ * Создает настройку-файл
+ */
+export declare function createFileSetting(config: {
+    name: string;
+    label: string;
+    value?: string | null;
+    'with-generate-logo'?: boolean;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): FileSetting;
+/**
+ * Создает настройку-цвет
+ */
+export declare function createColorSetting(config: {
+    name: string;
+    label: string;
+    value?: string;
+    clearable?: boolean;
+    fallback?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): ColorSetting;
+/**
+ * Создает настройку-блог
+ */
+export declare function createBlogSetting(config: {
+    name: string;
+    label: string;
+    value?: string | null;
+    edit_admin_link?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): BlogSetting;
+/**
+ * Валидирует массив настроек
+ */
+export declare function validateSettings(settings: Setting[]): {
+    isValid: boolean;
+    errors: Array<{
+        setting: string;
+        errors: string[];
+    }>;
+};
+/**
+ * Создает информационную настройку
+ */
+export declare function createInfoSetting(config: {
+    name: string;
+    label: string;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): InfoSetting;
+/**
+ * Создает настройку описания текущей страницы
+ */
+export declare function createCurrentPageDescriptionSetting(config: {
+    name: string;
+    label: string;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): CurrentPageDescriptionSetting;
+/**
+ * Создает настройку группы иконок
+ */
+export declare function createIconGroupSetting(config: {
+    name: string;
+    label: string;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): IconGroupSetting;
+/**
+ * Создает настройку ссылки на виджет
+ */
+export declare function createLinkToWidgetSetting(config: {
+    name: string;
+    label: string;
+    value?: string;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): LinkToWidgetSetting;
+/**
+ * Создает настройку переключателя кнопок
+ */
+export declare function createButtonSwitchSetting(config: {
+    name: string;
+    label: string;
+    value?: boolean;
+    help?: string;
+    general?: boolean;
+    general_position?: number;
+    general_label?: string;
+    enable_server_reload?: boolean;
+    hide_mobile?: boolean;
+    class?: string;
+}): ButtonSwitchSetting;
+/**
+ * Создает настройку с автоматическим определением типа
+ */
+export declare function createSetting(config: {
+    type: string;
+    name: string;
+    label: string;
+    [key: string]: any;
+}): Setting;
+//# sourceMappingURL=settings.d.ts.map