iwgt 2.4.6 → 2.4.9

package/dist/data/references/commonjs-api-complete.json

@@ -0,0 +1,1037 @@
+{
+    "version": "3.0.0",
+    "title": "Полный справочник CommonJS API v2 для InSales",
+    "description": "Библиотека common.v2.js создана для минимизации JavaScript кода. Большинство функций работают через data-атрибуты БЕЗ написания JS. Все модули доступны глобально через window.",
+    "generatedAt": "2025-01-08",
+    "critical_info": {
+        "no_imports_needed": "⚠️ ВСЕ модули доступны ГЛОБАЛЬНО через window. НЕ НУЖНО использовать import или require!",
+        "declarative_first": "✅ ПРИОРИТЕТ: используйте data-атрибуты вместо JavaScript где возможно",
+        "lodash_not_global": "⚠️ Lodash НЕ глобальный! Он импортируется внутри модулей CommonJS. В виджетах используйте нативный JS или jQuery.",
+        "jquery_is_global": "✅ jQuery доступен глобально как $ и jQuery",
+        "minimal_js": "💡 Библиотека создана чтобы писать МИНИМУМ JavaScript - используйте декларативный подход"
+    },
+    "installation": {
+        "method": "liquid_tag",
+        "code": "{% include_insales_scripts \"common-js@v2\" %}",
+        "description": "Добавьте этот тег в layout.liquid перед закрывающим </body>",
+        "note": "После подключения ВСЕ модули доступны глобально"
+    },
+    "global_modules": {
+        "Cart": {
+            "description": "Управление корзиной",
+            "global_access": "window.Cart или window.InsalesCommonCart",
+            "type": "class",
+            "declarative": true,
+            "declarative_note": "Большинство функций работают через data-атрибуты БЕЗ JavaScript",
+            "data_attributes": {
+                "data-cart-form": {
+                    "required": true,
+                    "description": "Обязательный атрибут для формы корзины",
+                    "example": "<form data-cart-form>...</form>",
+                    "note": "Инициализирует корзину автоматически"
+                },
+                "data-item-id": {
+                    "description": "ID позиции в корзине",
+                    "example": "<div data-item-id=\"{{ item.id }}\">...</div>"
+                },
+                "data-item-delete": {
+                    "description": "Кнопка удаления позиции",
+                    "example": "<button data-item-delete>Удалить</button>",
+                    "no_js_needed": true
+                },
+                "data-cart-clear": {
+                    "description": "Очистить всю корзину",
+                    "example": "<button data-cart-clear>Очистить корзину</button>",
+                    "no_js_needed": true
+                },
+                "data-cart-total-price": {
+                    "description": "Общая сумма корзины",
+                    "example": "<span data-cart-total-price></span>",
+                    "auto_updates": true
+                },
+                "data-cart-full-total-price": {
+                    "description": "Сумма с учетом скидок",
+                    "example": "<span data-cart-full-total-price></span>",
+                    "auto_updates": true
+                },
+                "data-cart-positions-count": {
+                    "description": "Количество позиций",
+                    "example": "<span data-cart-positions-count></span>",
+                    "auto_updates": true
+                },
+                "data-cart-item-count": {
+                    "description": "Количество товаров",
+                    "example": "<span data-cart-item-count></span>",
+                    "auto_updates": true
+                },
+                "data-coupon-submit": {
+                    "description": "Применить купон",
+                    "example": "<button data-coupon-submit>Применить</button>",
+                    "no_js_needed": true
+                },
+                "data-cart-discounts-ajax": {
+                    "description": "Вывод скидок через AJAX",
+                    "example": "<div data-cart-discounts-ajax></div>",
+                    "auto_updates": true
+                },
+                "data-item-accessories": {
+                    "description": "Опции товара в корзине",
+                    "example": "<div data-item-accessories>...</div>"
+                }
+            },
+            "methods": {
+                "add": {
+                    "description": "Добавить товар в корзину",
+                    "params": [
+                        { "name": "variant_id", "type": "number", "required": true },
+                        { "name": "quantity", "type": "number", "default": 1 },
+                        { "name": "comment", "type": "string", "optional": true }
+                    ],
+                    "returns": "Promise",
+                    "example": "Cart.add(12345, 2).then(data => console.log(data));",
+                    "note": "Обычно НЕ нужен - используйте data-item-add"
+                },
+                "update": {
+                    "description": "Обновить количество",
+                    "params": [
+                        { "name": "order_line_id", "type": "number", "required": true },
+                        { "name": "quantity", "type": "number", "required": true }
+                    ],
+                    "returns": "Promise",
+                    "example": "Cart.update(123, 3);",
+                    "note": "Обычно НЕ нужен - работает автоматически"
+                },
+                "remove": {
+                    "description": "Удалить позицию",
+                    "params": [{ "name": "order_line_id", "type": "number", "required": true }],
+                    "returns": "Promise",
+                    "example": "Cart.remove(123);",
+                    "note": "Обычно НЕ нужен - используйте data-item-delete"
+                },
+                "clear": {
+                    "description": "Очистить корзину",
+                    "returns": "Promise",
+                    "example": "Cart.clear();",
+                    "note": "Обычно НЕ нужен - используйте data-cart-clear"
+                },
+                "setCoupon": {
+                    "description": "Установить купон",
+                    "params": [{ "name": "coupon", "type": "string", "required": true }],
+                    "returns": "Promise",
+                    "example": "Cart.setCoupon('SALE2024');",
+                    "note": "Обычно НЕ нужен - используйте data-coupon-submit"
+                }
+            },
+            "events": {
+                "add_items:insales:cart": {
+                    "description": "Товар добавлен в корзину",
+                    "data": "{ order_lines: [...], cart: {...} }",
+                    "example": "EventBus.subscribe('add_items:insales:cart', data => console.log(data));"
+                },
+                "update_items:insales:cart": {
+                    "description": "Корзина обновлена",
+                    "data": "{ order_lines: [...], cart: {...} }"
+                },
+                "delete_items:insales:cart": {
+                    "description": "Товар удален",
+                    "data": "{ order_lines: [...], cart: {...} }"
+                },
+                "clear_items:insales:cart": {
+                    "description": "Корзина очищена",
+                    "data": "{ cart: {...} }"
+                },
+                "set_coupon:insales:cart": {
+                    "description": "Купон применен",
+                    "data": "{ cart: {...}, coupon: '...' }"
+                },
+                "before:insales:cart": {
+                    "description": "Перед любым действием с корзиной"
+                },
+                "always:insales:cart": {
+                    "description": "После любого действия с корзиной"
+                }
+            },
+            "usage_priority": "data-атрибуты > события > методы"
+        },
+        "Products": {
+            "description": "Управление товарами",
+            "global_access": "window.Products",
+            "type": "class",
+            "declarative": true,
+            "declarative_note": "Работает полностью через data-атрибуты",
+            "data_attributes": {
+                "data-product-id": {
+                    "required": true,
+                    "description": "Инициализация товара (обязательно!)",
+                    "example": "<form data-product-id=\"{{ product.id }}\">...</form>",
+                    "note": "Все остальные атрибуты должны быть внутри этого элемента"
+                },
+                "data-product-variants": {
+                    "description": "Селектор вариантов товара",
+                    "example": "<select name=\"variant_id\" data-product-variants></select>",
+                    "accepts_json": true,
+                    "json_example": "data-product-variants='{\"default\": \"option-radio\", \"Цвет\": \"option-span\"}'",
+                    "display_types": ["option-select", "option-radio", "option-span", "option-preview", "select-image"]
+                },
+                "data-quantity": {
+                    "description": "Обертка для количества",
+                    "example": "<div data-quantity><input name=\"quantity\" value=\"1\"></div>"
+                },
+                "data-quantity-change": {
+                    "description": "Кнопки +/- для изменения количества",
+                    "example": "<button data-quantity-change=\"-\">-</button><button data-quantity-change=\"+\">+</button>",
+                    "no_js_needed": true
+                },
+                "data-item-add": {
+                    "description": "Кнопка добавления в корзину",
+                    "example": "<button type=\"submit\" data-item-add>В корзину</button>",
+                    "no_js_needed": true
+                },
+                "data-product-card-price": {
+                    "description": "Цена товара",
+                    "example": "<span data-product-card-price></span>",
+                    "auto_updates": true
+                },
+                "data-product-card-old-price": {
+                    "description": "Старая цена",
+                    "example": "<span data-product-card-old-price></span>",
+                    "auto_updates": true
+                },
+                "data-product-card-sku": {
+                    "description": "Артикул",
+                    "example": "<span data-product-card-sku></span>",
+                    "auto_updates": true
+                },
+                "data-product-card-available": {
+                    "description": "Наличие товара",
+                    "example": "<span data-product-card-available></span>",
+                    "auto_updates": true
+                },
+                "data-product-card-sale-value": {
+                    "description": "Размер скидки",
+                    "example": "<span data-product-card-sale-value></span>",
+                    "auto_updates": true
+                },
+                "data-add-cart-counter": {
+                    "description": "Комплексный компонент счетчика корзины",
+                    "example": "<div data-add-cart-counter>...</div>",
+                    "complex": true
+                },
+                "data-quick-checkout": {
+                    "description": "Быстрый заказ в один клик",
+                    "example": "<button data-quick-checkout='[data-product-id=\"12345\"]'>Купить в 1 клик</button>",
+                    "no_js_needed": true
+                },
+                "data-product-accessories": {
+                    "description": "Опции товара (аксессуары)",
+                    "example": "<div data-product-accessories></div>",
+                    "requires_templates": true
+                }
+            },
+            "methods": {
+                "getInfo": {
+                    "description": "Получить информацию о товаре",
+                    "params": [{ "name": "product_id", "type": "number", "required": true }],
+                    "returns": "Promise<Object>",
+                    "example": "Products.getInfo(12345).then(data => console.log(data));",
+                    "note": "Редко нужен - обычно данные уже есть в Liquid"
+                }
+            },
+            "events": {
+                "init_instance:insales:product": {
+                    "description": "Товар инициализирован",
+                    "data": "{ product_id, $form, variant }",
+                    "example": "EventBus.subscribe('init_instance:insales:product', data => console.log(data));"
+                },
+                "change_variant:insales:product": {
+                    "description": "Вариант товара изменен",
+                    "data": "{ product_id, variant, $form }"
+                },
+                "update_variant:insales:product": {
+                    "description": "Данные варианта обновлены",
+                    "data": "{ product_id, variant, $form }"
+                },
+                "change_quantity:insales:product": {
+                    "description": "Количество изменено",
+                    "data": "{ product_id, quantity, $form }"
+                },
+                "before:insales:product": {
+                    "description": "Перед действием"
+                },
+                "always:insales:product": {
+                    "description": "После действия"
+                }
+            },
+            "css_classes": {
+                "with-old-price": "У варианта есть старая цена",
+                "without-old-price": "Нет старой цены",
+                "with-sku": "Есть артикул",
+                "without-sku": "Нет артикула",
+                "is-available": "Товар в наличии",
+                "not-available": "Нет в наличии",
+                "with-sale-value": "Есть скидка"
+            },
+            "usage_priority": "data-атрибуты > события > методы"
+        },
+        "EventBus": {
+            "description": "Шина событий для коммуникации между компонентами",
+            "global_access": "window.EventBus",
+            "type": "object",
+            "declarative": false,
+            "methods": {
+                "subscribe": {
+                    "description": "Подписаться на событие",
+                    "params": [
+                        { "name": "event", "type": "string", "required": true },
+                        { "name": "callback", "type": "function", "required": true }
+                    ],
+                    "returns": "void",
+                    "example": "EventBus.subscribe('add_items:insales:cart', data => {\n  console.log('Товар добавлен', data);\n});"
+                },
+                "publish": {
+                    "description": "Опубликовать событие",
+                    "params": [
+                        { "name": "event", "type": "string", "required": true },
+                        { "name": "data", "type": "any", "optional": true }
+                    ],
+                    "returns": "void",
+                    "example": "EventBus.publish('my-event:insales:site', { foo: 'bar' });"
+                },
+                "unsubscribe": {
+                    "description": "Отписаться от события",
+                    "params": [
+                        { "name": "event", "type": "string", "required": true },
+                        { "name": "callback", "type": "function", "required": true }
+                    ],
+                    "returns": "void",
+                    "example": "EventBus.unsubscribe('add_items:insales:cart', myCallback);"
+                }
+            },
+            "event_naming": {
+                "pattern": "action:namespace:module",
+                "examples": [
+                    "add_items:insales:cart",
+                    "update:insales:search",
+                    "init-products:ui-ajax-products"
+                ]
+            },
+            "common_events": {
+                "cart": ["add_items:insales:cart", "update_items:insales:cart", "delete_items:insales:cart", "clear_items:insales:cart"],
+                "product": ["init_instance:insales:product", "change_variant:insales:product", "update_variant:insales:product"],
+                "compare": ["add_item:insales:compares", "remove_item:insales:compares", "update_items:insales:compares"],
+                "favorites": ["add_item:insales:favorites_products", "remove_item:insales:favorites_products", "update_items:insales:favorites_products"],
+                "search": ["before:insales:search", "update:insales:search", "always:insales:search"]
+            }
+        },
+        "Compare": {
+            "description": "Сравнение товаров",
+            "global_access": "window.Compare",
+            "type": "class",
+            "declarative": true,
+            "data_attributes": {
+                "data-compare-add": {
+                    "description": "Добавить в сравнение",
+                    "example": "<button data-compare-add=\"{{ product.id }}\">Сравнить</button>",
+                    "no_js_needed": true
+                },
+                "data-compare-delete": {
+                    "description": "Удалить из сравнения",
+                    "example": "<button data-compare-delete=\"{{ product.id }}\">Удалить</button>",
+                    "no_js_needed": true
+                },
+                "data-compare-trigger": {
+                    "description": "Переключатель (добавить/удалить)",
+                    "example": "<button data-compare-trigger=\"{{ product.id }}\">Сравнить</button>",
+                    "no_js_needed": true,
+                    "note": "Автоматически меняет состояние"
+                },
+                "data-compare-counter": {
+                    "description": "Счетчик товаров в сравнении",
+                    "example": "<span data-compare-counter></span>",
+                    "auto_updates": true
+                }
+            },
+            "methods": {
+                "add": {
+                    "description": "Добавить товар",
+                    "params": [{ "name": "product_id", "type": "number", "required": true }],
+                    "example": "Compare.add(12345);",
+                    "note": "Обычно НЕ нужен - используйте data-compare-add"
+                },
+                "remove": {
+                    "description": "Удалить товар",
+                    "params": [{ "name": "product_id", "type": "number", "required": true }],
+                    "example": "Compare.remove(12345);",
+                    "note": "Обычно НЕ нужен - используйте data-compare-delete"
+                },
+                "update": {
+                    "description": "Обновить состояние UI",
+                    "example": "Compare.update();",
+                    "note": "Нужен после AJAX-загрузки товаров"
+                }
+            },
+            "events": {
+                "add_item:insales:compares": {
+                    "description": "Товар добавлен в сравнение",
+                    "data": "{ product_id, items: [...] }"
+                },
+                "remove_item:insales:compares": {
+                    "description": "Товар удален из сравнения",
+                    "data": "{ product_id, items: [...] }"
+                },
+                "update_items:insales:compares": {
+                    "description": "Список обновлен",
+                    "data": "{ items: [...] }"
+                }
+            },
+            "usage_priority": "data-атрибуты > события > методы"
+        },
+        "FavoritesProducts": {
+            "description": "Избранные товары",
+            "global_access": "window.FavoritesProducts",
+            "type": "class",
+            "declarative": true,
+            "data_attributes": {
+                "data-ui-favorites-add": {
+                    "description": "Добавить в избранное",
+                    "example": "<button data-ui-favorites-add=\"{{ product.id }}\">В избранное</button>",
+                    "no_js_needed": true
+                },
+                "data-ui-favorites-delete": {
+                    "description": "Удалить из избранного",
+                    "example": "<button data-ui-favorites-delete=\"{{ product.id }}\">Удалить</button>",
+                    "no_js_needed": true
+                },
+                "data-ui-favorites-trigger": {
+                    "description": "Переключатель (добавить/удалить)",
+                    "example": "<button data-ui-favorites-trigger=\"{{ product.id }}\"><i class=\"icon icon-heart\"></i></button>",
+                    "no_js_needed": true,
+                    "note": "Автоматически меняет состояние"
+                },
+                "data-ui-favorites-counter": {
+                    "description": "Счетчик избранных товаров",
+                    "example": "<span data-ui-favorites-counter></span>",
+                    "auto_updates": true
+                }
+            },
+            "methods": {
+                "add": {
+                    "description": "Добавить товар",
+                    "params": [{ "name": "product_id", "type": "number", "required": true }],
+                    "example": "FavoritesProducts.add(12345);",
+                    "note": "Обычно НЕ нужен - используйте data-ui-favorites-add"
+                },
+                "remove": {
+                    "description": "Удалить товар",
+                    "params": [{ "name": "product_id", "type": "number", "required": true }],
+                    "example": "FavoritesProducts.remove(12345);",
+                    "note": "Обычно НЕ нужен - используйте data-ui-favorites-delete"
+                },
+                "update": {
+                    "description": "Обновить состояние UI",
+                    "example": "FavoritesProducts.update();",
+                    "note": "Нужен после AJAX-загрузки товаров"
+                }
+            },
+            "events": {
+                "add_item:insales:favorites_products": {
+                    "description": "Товар добавлен в избранное",
+                    "data": "{ product_id, items: [...] }"
+                },
+                "remove_item:insales:favorites_products": {
+                    "description": "Товар удален из избранного",
+                    "data": "{ product_id, items: [...] }"
+                },
+                "update_items:insales:favorites_products": {
+                    "description": "Список обновлен",
+                    "data": "{ items: [...] }"
+                }
+            },
+            "usage_priority": "data-атрибуты > события > методы"
+        },
+        "AjaxSearch": {
+            "description": "Живой поиск по сайту",
+            "global_access": "window.AjaxSearch",
+            "type": "class",
+            "declarative": true,
+            "data_attributes": {
+                "data-search-field": {
+                    "required": true,
+                    "description": "Поле ввода поиска",
+                    "example": "<input type=\"text\" name=\"q\" data-search-field placeholder=\"Поиск\">",
+                    "note": "Поиск начинается автоматически при вводе"
+                },
+                "data-search-result": {
+                    "required": true,
+                    "description": "Блок для результатов поиска",
+                    "example": "<div data-search-result></div>",
+                    "auto_updates": true
+                }
+            },
+            "methods": {
+                "setConfig": {
+                    "description": "Настроить параметры поиска",
+                    "params": [
+                        { "name": "letters", "type": "number", "description": "С какого символа начинать поиск", "default": 3 },
+                        { "name": "delay", "type": "number", "description": "Задержка между запросами (мс)", "default": 300 },
+                        { "name": "hide_items_out_of_stock", "type": "boolean", "description": "Скрывать товары не в наличии", "default": false }
+                    ],
+                    "example": "AjaxSearch.setConfig({\n  letters: 3,\n  delay: 300,\n  hide_items_out_of_stock: true\n});"
+                }
+            },
+            "events": {
+                "before:insales:search": {
+                    "description": "Перед поиском"
+                },
+                "update:insales:search": {
+                    "description": "Результаты обновлены",
+                    "data": "{ products: [...], collections: [...], pages: [...] }"
+                },
+                "always:insales:search": {
+                    "description": "После поиска"
+                }
+            },
+            "usage_example": "<!-- Форма поиска -->\n<form action=\"/search\" method=\"get\">\n  <input type=\"hidden\" name=\"lang\" value=\"{{ language.locale }}\">\n  <input type=\"text\" name=\"q\" data-search-field placeholder=\"Поиск\">\n  <button type=\"submit\">Найти</button>\n  <div data-search-result></div>\n</form>"
+        },
+        "ajaxAPI": {
+            "description": "AJAX запросы к API InSales",
+            "global_access": "window.ajaxAPI",
+            "type": "object",
+            "declarative": false,
+            "methods": {
+                "cart": {
+                    "get": {
+                        "description": "Получить корзину",
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.cart.get().then(cart => console.log(cart));"
+                    },
+                    "add": {
+                        "description": "Добавить товар",
+                        "params": [
+                            { "name": "variant_id", "type": "number" },
+                            { "name": "quantity", "type": "number" },
+                            { "name": "comment", "type": "string", "optional": true }
+                        ],
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.cart.add(12345, 2);"
+                    },
+                    "update": {
+                        "description": "Обновить количество",
+                        "params": [
+                            { "name": "order_line_id", "type": "number" },
+                            { "name": "quantity", "type": "number" }
+                        ],
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.cart.update(123, 3);"
+                    },
+                    "remove": {
+                        "description": "Удалить позицию",
+                        "params": [{ "name": "order_line_id", "type": "number" }],
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.cart.remove(123);"
+                    },
+                    "clear": {
+                        "description": "Очистить корзину",
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.cart.clear();"
+                    },
+                    "coupon": {
+                        "description": "Применить купон",
+                        "params": [{ "name": "coupon", "type": "string" }],
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.cart.coupon('SALE2024');"
+                    }
+                },
+                "product": {
+                    "get": {
+                        "description": "Получить товар",
+                        "params": [{ "name": "product_id", "type": "number" }],
+                        "returns": "Promise<Object>",
+                        "example": "ajaxAPI.product.get(12345).then(product => console.log(product));"
+                    }
+                }
+            },
+            "note": "Обычно НЕ нужен - используйте Cart, Products и другие модули"
+        },
+        "Shop": {
+            "description": "Утилиты магазина",
+            "global_access": "window.Shop",
+            "type": "object",
+            "declarative": false,
+            "methods": {
+                "money_format": {
+                    "description": "Форматировать цену",
+                    "params": [{ "name": "price", "type": "number" }],
+                    "returns": "string",
+                    "example": "Shop.money_format(1234.56); // '1 234,56 ₽'"
+                },
+                "moneyWithCurrency": {
+                    "description": "Цена с валютой",
+                    "params": [{ "name": "price", "type": "number" }],
+                    "returns": "string",
+                    "example": "Shop.moneyWithCurrency(1234.56);"
+                }
+            }
+        },
+        "Template": {
+            "description": "Шаблонизатор",
+            "global_access": "window.Template",
+            "type": "object",
+            "declarative": false,
+            "methods": {
+                "render": {
+                    "description": "Рендер шаблона",
+                    "params": [
+                        { "name": "data", "type": "object" },
+                        { "name": "template", "type": "string" }
+                    ],
+                    "returns": "string",
+                    "example": "Template.render({ name: 'Товар' }, '<div>{{name}}</div>');"
+                }
+            },
+            "note": "Редко нужен - обычно используется внутри компонентов"
+        }
+    },
+    "ui_components": {
+        "description": "UI компоненты работают через data-атрибуты и шаблоны",
+        "ajax_products": {
+            "name": "AJAX Products",
+            "description": "Загрузка товаров через AJAX",
+            "declarative": true,
+            "main_attributes": {
+                "data-ajax-products": {
+                    "description": "Обертка компонента",
+                    "example": "<div data-ajax-products>...</div>"
+                },
+                "data-ajax-products-list": {
+                    "required": true,
+                    "description": "Список товаров с настройками",
+                    "example": "<div data-ajax-products-list='{\n  \"collection\": \"new\",\n  \"limit\": 20,\n  \"imageResizingRules\": [...]\n}'></div>",
+                    "settings": {
+                        "collection": "Handle категории",
+                        "limit": "Количество товаров",
+                        "imageResizingRules": "Правила ресайза изображений",
+                        "switchImages": "Загружать 2 изображения (hover)",
+                        "shortDescriptionWordsCount": "Лимит слов в описании"
+                    }
+                }
+            },
+            "initialization": {
+                "method": "event",
+                "code": "const nodes = document.querySelectorAll('[data-ajax-products-list]');\nnodes.forEach(node => {\n  EventBus.publish('ui-ajax-products:load-products-list', node);\n});",
+                "note": "Публикуйте событие для каждого списка"
+            },
+            "events": {
+                "ui-ajax-products:load-products-list": {
+                    "description": "Инициализация загрузки",
+                    "publish": true
+                },
+                "init-products:ui-ajax-products": {
+                    "description": "Товары загружены и отрисованы",
+                    "subscribe": true,
+                    "example": "EventBus.subscribe('init-products:ui-ajax-products', data => {\n  // Инициализация слайдера\n  FavoritesProducts.update();\n  Compare.update();\n});"
+                }
+            },
+            "templates_required": true,
+            "templates": [
+                "data-ajax-products-list-item-template",
+                "data-ajax-products-list-item-image-template"
+            ]
+        },
+        "ajax_product": {
+            "name": "AJAX Product",
+            "description": "Загрузка одного товара через AJAX",
+            "declarative": true,
+            "main_attributes": {
+                "data-ajax-product": {
+                    "required": true,
+                    "description": "Обертка с настройками",
+                    "example": "<div data-ajax-product='{\n  \"productId\": \"12345\",\n  \"productData\": [\"variants\", \"images\", \"properties\"],\n  \"initOnLoadPage\": true\n}'></div>",
+                    "settings": {
+                        "productId": "ID товара",
+                        "productData": "Массив данных для загрузки",
+                        "initOnLoadPage": "Загружать при загрузке страницы",
+                        "imageResizingRules": "Правила ресайза",
+                        "videoBeforeImage": "Видео перед изображениями",
+                        "videoLinksDetails": "Детали видео"
+                    }
+                }
+            },
+            "product_data_options": [
+                "variants",
+                "short_description",
+                "description",
+                "price_kinds",
+                "first_image",
+                "images",
+                "properties",
+                "characteristics",
+                "option_names",
+                "bundle_info",
+                "video_links"
+            ],
+            "events": {
+                "ui-ajax-product:load-product": {
+                    "description": "Инициализация загрузки",
+                    "publish": true
+                },
+                "init-product:ui-ajax-product": {
+                    "description": "Товар загружен",
+                    "subscribe": true
+                }
+            },
+            "templates_required": true
+        },
+        "ajax_filters": {
+            "name": "AJAX Filters",
+            "description": "Фильтры товаров через AJAX",
+            "declarative": true,
+            "main_attributes": {
+                "data-ajax-filter": {
+                    "required": true,
+                    "description": "Форма фильтров",
+                    "example": "<form data-ajax-filter='{\n  \"useImages\": false,\n  \"visibleItemsSize\": 5\n}' action=\"{{ collection.url }}\" method=\"get\">...</form>",
+                    "settings": {
+                        "useImages": "Использовать изображения для свойств",
+                        "visibleItemsSize": "Количество видимых значений"
+                    }
+                },
+                "data-ajax-filter-items": {
+                    "required": true,
+                    "description": "Контейнер для фильтров",
+                    "example": "<div data-ajax-filter-items></div>"
+                }
+            },
+            "events": {
+                "init-filter:ui-ajax-filter": {
+                    "description": "Фильтры инициализированы"
+                }
+            },
+            "templates_required": true,
+            "templates": [
+                "data-ajax-filter-template-price",
+                "data-ajax-filter-template-item",
+                "data-ajax-filter-template-usual",
+                "data-ajax-filter-template-color",
+                "data-ajax-filter-template-numeric"
+            ]
+        },
+        "accessories": {
+            "name": "Product Accessories",
+            "description": "Опции товара (аксессуары)",
+            "declarative": true,
+            "main_attributes": {
+                "data-product-accessories": {
+                    "required": true,
+                    "description": "Контейнер опций (внутри data-product-id)",
+                    "example": "<div data-product-accessories></div>"
+                }
+            },
+            "events": {
+                "accessories-rendered:insales:ui_accessories": {
+                    "description": "Опции отрисованы"
+                },
+                "accessory_value_changed:insales:ui_accessories": {
+                    "description": "Опция изменена"
+                },
+                "prices-calculated:insales:ui_accessories": {
+                    "description": "Цены пересчитаны"
+                }
+            },
+            "templates_required": true
+        },
+        "feedback_form": {
+            "name": "Feedback Form",
+            "description": "Форма обратной связи",
+            "declarative": true,
+            "main_attributes": {
+                "data-feedback-form-wrapper": {
+                    "required": true,
+                    "description": "Обертка формы",
+                    "example": "<form data-feedback-form-wrapper method=\"post\" action=\"/client_account/feedback\">...</form>"
+                },
+                "data-feedback-form-field": {
+                    "description": "Поле формы",
+                    "example": "<input name=\"name\" data-feedback-form-field='{\"isRequired\": true, \"errorMessage\": \"Ошибка\"}'>",
+                    "field_types": ["name", "from", "phone", "content", "subject", "agree"]
+                },
+                "data-feedback-form-success": {
+                    "description": "Сообщение об успехе",
+                    "example": "<div data-feedback-form-success='{\"showTime\": 10000}'>Отправлено</div>"
+                },
+                "data-feedback-form-recaptcha": {
+                    "description": "Google reCAPTCHA",
+                    "example": "<div data-feedback-form-recaptcha='{\"isRequired\": true}'></div>"
+                },
+                "data-feedback-form-yandex-captcha": {
+                    "description": "Yandex SmartCaptcha",
+                    "example": "<div data-feedback-form-yandex-captcha='{\"isRequired\": true}'></div>"
+                }
+            },
+            "events": {
+                "send-feedback:insales:ui_feedback": {
+                    "description": "Форма отправлена"
+                },
+                "error-feedback:insales:ui_feedback": {
+                    "description": "Ошибка отправки"
+                },
+                "show-modal-feedback:insales:ui_feedback": {
+                    "description": "Показать модальное окно"
+                }
+            },
+            "no_js_needed": true
+        },
+        "reviews_form": {
+            "name": "Reviews Form",
+            "description": "Форма отзыва к товару",
+            "declarative": true,
+            "main_attributes": {
+                "data-reviews-form-wrapper": {
+                    "required": true,
+                    "description": "Обертка формы отзыва",
+                    "example": "<form data-reviews-form-wrapper='{\n  \"reviews_moderated\": true,\n  \"url\": \"{{ product.url }}\"\n}'>...</form>"
+                },
+                "data-reviews-form-field": {
+                    "description": "Поле формы",
+                    "field_types": ["review[author]", "review[email]", "review[content]", "review[rating]", "review[image_attributes][image]"]
+                }
+            },
+            "events": {
+                "send-review:insales:ui_reviews": {
+                    "description": "Отзыв отправлен"
+                },
+                "error-reviews:insales:ui_reviews": {
+                    "description": "Ошибка отправки"
+                }
+            },
+            "no_js_needed": true
+        },
+        "comments_form": {
+            "name": "Comments Form",
+            "description": "Форма комментария к статье",
+            "declarative": true,
+            "main_attributes": {
+                "data-comments-form-wrapper": {
+                    "required": true,
+                    "description": "Обертка формы комментария",
+                    "example": "<form data-comments-form-wrapper='{\n  \"reviews_moderated\": true,\n  \"url\": \"{{ article.url }}\"\n}'>...</form>"
+                },
+                "data-comments-form-field": {
+                    "description": "Поле формы",
+                    "field_types": ["comment[author]", "comment[email]", "comment[content]"]
+                }
+            },
+            "events": {
+                "send-comment:insales:ui_comments": {
+                    "description": "Комментарий отправлен"
+                },
+                "error-comments:insales:ui_comments": {
+                    "description": "Ошибка отправки"
+                }
+            },
+            "no_js_needed": true
+        },
+        "quick_checkout": {
+            "name": "Quick Checkout",
+            "description": "Быстрый заказ / заявка",
+            "declarative": true,
+            "main_attributes": {
+                "data-quick-checkout": {
+                    "required": true,
+                    "description": "Кнопка быстрого заказа",
+                    "example": "<button data-quick-checkout='[data-product-id=\"12345\"]'>Купить в 1 клик</button>",
+                    "variants": {
+                        "with_product": "data-quick-checkout='[data-product-id=\"12345\"]'",
+                        "fake_order": "data-quick-checkout='fake_order'",
+                        "service_form": "data-quick-checkout-modal-handle=\"service\""
+                    }
+                }
+            },
+            "no_js_needed": true,
+            "note": "Форма отдается сервером, только активация через кнопку"
+        },
+        "trigger_events": {
+            "name": "Trigger Events",
+            "description": "Публикация событий по клику",
+            "declarative": true,
+            "main_attributes": {
+                "data-trigger-click": {
+                    "required": true,
+                    "description": "Публиковать событие при клике",
+                    "example": "<button data-trigger-click=\"my-button:insales:site\">Кнопка</button>",
+                    "usage": "EventBus.subscribe('my-button:insales:site', data => {\n  console.log('Клик', data.event_target);\n});"
+                }
+            },
+            "no_js_needed": false,
+            "note": "Требует подписки на событие в JS"
+        }
+    },
+    "best_practices": {
+        "declarative_first": {
+            "title": "Приоритет декларативному подходу",
+            "rules": [
+                "Всегда используйте data-атрибуты вместо JavaScript где возможно",
+                "Пишите минимум JS кода - библиотека создана для этого",
+                "Подписывайтесь на события вместо вызова методов",
+                "Используйте шаблоны для динамического контента"
+            ]
+        },
+        "no_imports": {
+            "title": "Не используйте import",
+            "wrong": "import { Cart } from 'common-js'; // ❌ НЕПРАВИЛЬНО",
+            "correct": "// ✅ ПРАВИЛЬНО - модули уже доступны глобально\nCart.add(12345, 1);",
+            "note": "Все модули доступны через window после подключения библиотеки"
+        },
+        "event_driven": {
+            "title": "Событийная архитектура",
+            "description": "Используйте EventBus для коммуникации между компонентами",
+            "example": "// Подписка на добавление в корзину\nEventBus.subscribe('add_items:insales:cart', data => {\n  console.log('Товар добавлен', data);\n  // Показать уведомление\n  // Обновить счетчик\n});"
+        },
+        "minimal_js_examples": {
+            "title": "Примеры без JavaScript",
+            "examples": [
+                {
+                    "task": "Добавить товар в корзину",
+                    "html": "<form data-product-id=\"{{ product.id }}\">\n  <button type=\"submit\" data-item-add>В корзину</button>\n</form>",
+                    "js_needed": false,
+                    "note": "Работает полностью без JS"
+                },
+                {
+                    "task": "Удалить из корзины",
+                    "html": "<button data-item-delete>Удалить</button>",
+                    "js_needed": false
+                },
+                {
+                    "task": "Добавить в избранное",
+                    "html": "<button data-ui-favorites-trigger=\"{{ product.id }}\">\n  <i class=\"icon icon-heart\"></i>\n</button>",
+                    "js_needed": false
+                },
+                {
+                    "task": "Быстрый заказ",
+                    "html": "<button data-quick-checkout='[data-product-id=\"{{ product.id }}\"]'>\n  Купить в 1 клик\n</button>",
+                    "js_needed": false
+                }
+            ]
+        },
+        "when_js_needed": {
+            "title": "Когда нужен JavaScript",
+            "cases": [
+                {
+                    "case": "Реакция на события",
+                    "example": "EventBus.subscribe('add_items:insales:cart', data => {\n  // Показать уведомление\n  showNotification('Товар добавлен');\n});"
+                },
+                {
+                    "case": "Обновление UI после AJAX-загрузки",
+                    "example": "EventBus.subscribe('init-products:ui-ajax-products', data => {\n  FavoritesProducts.update();\n  Compare.update();\n  // Инициализация слайдера\n});"
+                },
+                {
+                    "case": "Кастомная логика",
+                    "example": "EventBus.subscribe('change_variant:insales:product', data => {\n  // Кастомная обработка смены варианта\n});"
+                }
+            ]
+        }
+    },
+    "common_patterns": {
+        "product_card": {
+            "title": "Карточка товара",
+            "html": "<form data-product-id=\"{{ product.id }}\" action=\"{{ cart_url }}\" method=\"post\">\n  <input type=\"hidden\" name=\"variant_id\" value=\"{{ product.variants.first.id }}\">\n  \n  <!-- Цена -->\n  <div class=\"price\">\n    <span data-product-card-price></span>\n    <span data-product-card-old-price></span>\n  </div>\n  \n  <!-- Варианты -->\n  <select name=\"variant_id\" data-product-variants></select>\n  \n  <!-- Количество -->\n  <div data-quantity>\n    <button data-quantity-change=\"-\">-</button>\n    <input name=\"quantity\" value=\"1\">\n    <button data-quantity-change=\"+\">+</button>\n  </div>\n  \n  <!-- Кнопки -->\n  <button type=\"submit\" data-item-add>В корзину</button>\n  <button data-ui-favorites-trigger=\"{{ product.id }}\">\n    <i class=\"icon icon-heart\"></i>\n  </button>\n</form>",
+            "js_needed": false,
+            "note": "Полностью работает без JavaScript"
+        },
+        "cart_page": {
+            "title": "Страница корзины",
+            "html": "<form data-cart-form action=\"{{ cart_url }}\" method=\"post\">\n  {% for item in cart.order_lines %}\n  <div data-item-id=\"{{ item.id }}\">\n    <div>{{ item.title }}</div>\n    <input name=\"order_line[{{ item.id }}][quantity]\" value=\"{{ item.quantity }}\">\n    <span data-product-card-price></span>\n    <button data-item-delete>Удалить</button>\n  </div>\n  {% endfor %}\n  \n  <div>Итого: <span data-cart-total-price></span></div>\n  <button type=\"submit\">Оформить заказ</button>\n  <button data-cart-clear>Очистить корзину</button>\n</form>",
+            "js_needed": false
+        },
+        "ajax_products_list": {
+            "title": "AJAX список товаров",
+            "html": "<div data-ajax-products>\n  <div data-ajax-products-list='{\n    \"collection\": \"new\",\n    \"limit\": 12,\n    \"imageResizingRules\": [\n      {\"size\":\"600\", \"format\":\"webp\", \"resizing_type\":\"fit_width\", \"quality\":\"90\"}\n    ]\n  }'></div>\n  \n  <template data-ajax-products-list-item-template>\n    <div data-ajax-products-list-item>\n      <form data-ajax-products-list-item-form>\n        <a data-ajax-products-list-item-link data-ajax-products-list-item-title></a>\n        <div data-ajax-products-list-item-image></div>\n        <span data-ajax-products-list-item-price-min></span>\n        <button type=\"submit\" data-item-add>В корзину</button>\n      </form>\n    </div>\n  </template>\n  \n  <template data-ajax-products-list-item-image-template>\n    <picture data-ajax-products-list-item-picture>\n      <img data-ajax-products-image-resizing-rules-index=\"0\">\n    </picture>\n  </template>\n</div>",
+            "js": "const nodes = document.querySelectorAll('[data-ajax-products-list]');\nnodes.forEach(node => {\n  EventBus.publish('ui-ajax-products:load-products-list', node);\n});\n\n// После загрузки\nEventBus.subscribe('init-products:ui-ajax-products', data => {\n  FavoritesProducts.update();\n  Compare.update();\n});",
+            "js_needed": true,
+            "note": "Требует инициализации через EventBus"
+        },
+        "live_search": {
+            "title": "Живой поиск",
+            "html": "<form action=\"/search\" method=\"get\">\n  <input type=\"hidden\" name=\"lang\" value=\"{{ language.locale }}\">\n  <input type=\"text\" name=\"q\" data-search-field placeholder=\"Поиск\">\n  <button type=\"submit\">Найти</button>\n  <div data-search-result></div>\n</form>",
+            "js_needed": false,
+            "note": "Работает автоматически"
+        }
+    },
+    "troubleshooting": {
+        "import_error": {
+            "problem": "Ошибка: Cannot find module 'common-js'",
+            "solution": "НЕ используйте import! Все модули доступны глобально через window",
+            "correct_usage": "// Просто используйте модули напрямую\nCart.add(12345, 1);\nEventBus.subscribe('add_items:insales:cart', callback);"
+        },
+        "lodash_error": {
+            "problem": "Ошибка: _ is not defined",
+            "solution": "Lodash НЕ глобальный. Используйте нативный JavaScript или jQuery",
+            "alternatives": [
+                "Array.prototype.map/filter/reduce вместо _.map/_.filter",
+                "Object.keys/values/entries вместо _.keys/_.values",
+                "jQuery методы: $.each, $.map, $.extend"
+            ]
+        },
+        "data_attribute_not_working": {
+            "problem": "data-атрибут не работает",
+            "checklist": [
+                "Проверьте что библиотека подключена: {% include_insales_scripts \"common-js@v2\" %}",
+                "Убедитесь что атрибут написан правильно (регистр важен)",
+                "Для товаров: data-атрибуты должны быть внутри data-product-id",
+                "Для корзины: data-атрибуты должны быть внутри data-cart-form",
+                "Проверьте консоль браузера на ошибки"
+            ]
+        },
+        "ajax_products_not_loading": {
+            "problem": "AJAX товары не загружаются",
+            "solution": "Нужно опубликовать событие инициализации",
+            "code": "const nodes = document.querySelectorAll('[data-ajax-products-list]');\nnodes.forEach(node => {\n  EventBus.publish('ui-ajax-products:load-products-list', node);\n});"
+        }
+    },
+    "migration_from_old_approach": {
+        "title": "Миграция со старого подхода",
+        "before": {
+            "description": "Старый подход с импортами (НЕПРАВИЛЬНО)",
+            "code": "import { Cart } from 'common-js';\nimport { Products } from 'common-js';\n\nCart.add(12345, 1);"
+        },
+        "after": {
+            "description": "Новый подход - глобальные модули (ПРАВИЛЬНО)",
+            "code": "// Модули уже доступны глобально\n// Просто используйте их:\n\nCart.add(12345, 1);\nProducts.getInfo(12345);\nEventBus.subscribe('add_items:insales:cart', callback);"
+        },
+        "best_approach": {
+            "description": "Лучший подход - декларативный (ИДЕАЛЬНО)",
+            "html": "<!-- БЕЗ JavaScript -->\n<form data-product-id=\"{{ product.id }}\">\n  <button type=\"submit\" data-item-add>В корзину</button>\n</form>",
+            "js": "// Только если нужна реакция на событие\nEventBus.subscribe('add_items:insales:cart', data => {\n  showNotification('Товар добавлен');\n});"
+        }
+    },
+    "quick_reference": {
+        "title": "Быстрая справка",
+        "most_used_attributes": [
+            "data-product-id - инициализация товара",
+            "data-item-add - добавить в корзину",
+            "data-cart-form - форма корзины",
+            "data-item-delete - удалить из корзины",
+            "data-ui-favorites-trigger - избранное",
+            "data-compare-trigger - сравнение",
+            "data-search-field - поиск",
+            "data-quick-checkout - быстрый заказ"
+        ],
+        "most_used_events": [
+            "add_items:insales:cart - товар добавлен",
+            "change_variant:insales:product - вариант изменен",
+            "update:insales:search - результаты поиска",
+            "init-products:ui-ajax-products - AJAX товары загружены"
+        ],
+        "global_modules_list": [
+            "Cart - корзина",
+            "Products - товары",
+            "EventBus - события",
+            "Compare - сравнение",
+            "FavoritesProducts - избранное",
+            "AjaxSearch - поиск",
+            "ajaxAPI - AJAX запросы",
+            "Shop - утилиты",
+            "Template - шаблоны"
+        ]
+    }
+}