@maxisoft/instantcms-mcp 1.2.3

package/dist/data/components.js

@@ -0,0 +1,2818 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.components = void 0;
+const components_source_js_1 = require("../generated/components-source.js");
+const curatedComponents = [
+    {
+        name: 'cmsModel',
+        class: 'cmsModel',
+        description: 'Базовый класс для работы с базой данных. Query builder с fluent interface. Все модели контроллеров наследуют этот класс.',
+        access: "$this->model — в контроллере. cmsCore::getModel('controller_name') — глобально.",
+        methods: [
+            {
+                name: 'filterEqual',
+                signature: 'filterEqual(string $field, mixed $value): static',
+                description: 'Фильтр WHERE field = value',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле таблицы', required: true },
+                    { name: '$value', type: 'mixed', description: 'Значение для сравнения', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->filterEqual('is_pub', 1)->filterEqual('user_id', 5)->get('articles');`,
+            },
+            {
+                name: 'filterNotEqual',
+                signature: 'filterNotEqual(string $field, mixed $value): static',
+                description: 'Фильтр WHERE field != value',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле таблицы', required: true },
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->filterNotEqual('status', 'deleted')->get('items');`,
+            },
+            {
+                name: 'filterIn',
+                signature: 'filterIn(string $field, array $values): static',
+                description: 'Фильтр WHERE field IN (values)',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле', required: true },
+                    { name: '$values', type: 'array', description: 'Массив значений', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->filterIn('id', [1, 2, 3])->get('items');`,
+            },
+            {
+                name: 'filterLike',
+                signature: 'filterLike(string $field, string $value): static',
+                description: 'Фильтр WHERE field LIKE %value%',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле', required: true },
+                    { name: '$value', type: 'string', description: 'Строка для поиска', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->filterLike('title', 'поиск')->get('items');`,
+            },
+            {
+                name: 'filterGt',
+                signature: 'filterGt(string $field, mixed $value): static',
+                description: 'Фильтр WHERE field > value',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле', required: true },
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->filterGt('rating', 3)->get('items');`,
+            },
+            {
+                name: 'filterLt',
+                signature: 'filterLt(string $field, mixed $value): static',
+                description: 'Фильтр WHERE field < value',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле', required: true },
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->filterLt('date_expire', date('Y-m-d H:i:s'))->get('items');`,
+            },
+            {
+                name: 'orderBy',
+                signature: "orderBy(string $field, string $order = 'asc'): static",
+                description: 'Сортировка результатов',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле для сортировки', required: true },
+                    { name: '$order', type: 'string', description: "'asc' или 'desc'", default: 'asc' },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->orderBy('date_pub', 'desc')->get('items');`,
+            },
+            {
+                name: 'limit',
+                signature: 'limit(int $offset, int $count): static',
+                description: 'LIMIT для запроса. Если один параметр — только COUNT.',
+                parameters: [
+                    {
+                        name: '$offset',
+                        type: 'int',
+                        description: 'Смещение (или количество, если один аргумент)',
+                        required: true,
+                    },
+                    { name: '$count', type: 'int', description: 'Количество записей', required: false },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->limit(10)->get('items');
+$page_items = $this->model->limit(0, 20)->get('items');`,
+            },
+            {
+                name: 'limitPage',
+                signature: 'limitPage(int $page, int $perpage): static',
+                description: 'LIMIT для постраничной навигации',
+                parameters: [
+                    { name: '$page', type: 'int', description: 'Номер страницы (с 1)', required: true },
+                    { name: '$perpage', type: 'int', description: 'Записей на страницу', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->limitPage($page, 15)->get('items');`,
+            },
+            {
+                name: 'get',
+                signature: 'get(string $table): array',
+                description: 'Получить все записи по условиям фильтрации',
+                parameters: [
+                    {
+                        name: '$table',
+                        type: 'string',
+                        description: 'Имя таблицы без префикса',
+                        required: true,
+                    },
+                ],
+                return_type: 'array',
+                example: `$items = $this->model->filterEqual('is_pub', 1)->orderBy('id', 'desc')->limit(10)->get('myaddon_items');`,
+            },
+            {
+                name: 'getItem',
+                signature: 'getItem(string $table): array|false',
+                description: 'Получить одну запись (LIMIT 1)',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Имя таблицы', required: true },
+                ],
+                return_type: 'array|false',
+                example: `$item = $this->model->filterEqual('id', $id)->getItem('myaddon_items');
+if (!$item) { return cmsCore::error404(); }`,
+            },
+            {
+                name: 'getItemByField',
+                signature: 'getItemByField(string $table, string $field, mixed $value): array|false',
+                description: 'Получить запись по полю. Shortcut для filterEqual()->getItem()',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$field', type: 'string', description: 'Поле', required: true },
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                ],
+                return_type: 'array|false',
+                example: `$item = $this->model->getItemByField('myaddon_items', 'slug', $slug);`,
+            },
+            {
+                name: 'getCount',
+                signature: 'getCount(string $table): int',
+                description: 'Получить количество записей по условиям фильтра',
+                parameters: [{ name: '$table', type: 'string', description: 'Таблица', required: true }],
+                return_type: 'int',
+                example: `$total = $this->model->filterEqual('user_id', $user_id)->getCount('myaddon_items');`,
+            },
+            {
+                name: 'insert',
+                signature: 'insert(string $table, array $data): int',
+                description: 'Вставка записи. Возвращает ID вставленной записи.',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    {
+                        name: '$data',
+                        type: 'array',
+                        description: "Данные для вставки ['field' => value]",
+                        required: true,
+                    },
+                ],
+                return_type: 'int',
+                example: `$id = $this->model->insert('myaddon_items', [
+    'title'    => $data['title'],
+    'user_id'  => $this->cms_user->id,
+    'date_pub' => date('Y-m-d H:i:s'),
+    'is_pub'   => 1
+]);`,
+            },
+            {
+                name: 'update',
+                signature: 'update(string $table, int $id, array $data): bool',
+                description: 'Обновление записи по ID',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$id', type: 'int', description: 'ID записи', required: true },
+                    { name: '$data', type: 'array', description: 'Данные для обновления', required: true },
+                ],
+                return_type: 'bool',
+                example: `$this->model->update('myaddon_items', $id, [
+    'title'  => $data['title'],
+    'is_pub' => $data['is_pub']
+]);`,
+            },
+            {
+                name: 'updateFiltered',
+                signature: 'updateFiltered(string $table, array $data): bool',
+                description: 'Обновление записей по условиям фильтра',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$data', type: 'array', description: 'Данные для обновления', required: true },
+                ],
+                return_type: 'bool',
+                example: `// Скрыть все записи пользователя
+$this->model->filterEqual('user_id', $user_id)->updateFiltered('myaddon_items', ['is_pub' => 0]);`,
+            },
+            {
+                name: 'delete',
+                signature: "delete(string $table, int $id, string $id_field = 'id'): bool",
+                description: 'Удаление записи по ID',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$id', type: 'int', description: 'ID записи', required: true },
+                    { name: '$id_field', type: 'string', description: 'Поле ID', default: 'id' },
+                ],
+                return_type: 'bool',
+                example: `$this->model->delete('myaddon_items', $id);`,
+            },
+            {
+                name: 'deleteFiltered',
+                signature: 'deleteFiltered(string $table): bool',
+                description: 'Удаление записей по условиям фильтра',
+                parameters: [{ name: '$table', type: 'string', description: 'Таблица', required: true }],
+                return_type: 'bool',
+                example: `$this->model->filterEqual('user_id', $user_id)->deleteFiltered('myaddon_items');`,
+            },
+            {
+                name: 'useCache',
+                signature: 'useCache(string $key): static',
+                description: 'Кэширование результата следующего запроса',
+                parameters: [{ name: '$key', type: 'string', description: 'Ключ кэша', required: true }],
+                return_type: 'static',
+                example: `$items = $this->model->useCache('myaddon.items.list')->get('myaddon_items');`,
+            },
+            {
+                name: 'select',
+                signature: 'select(string $fields): static',
+                description: 'Указать поля для SELECT',
+                parameters: [
+                    { name: '$fields', type: 'string', description: 'SQL-строка полей', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->select('id, title, date_pub')->get('myaddon_items');`,
+            },
+            {
+                name: 'join',
+                signature: 'join(string $type, string $table, string $on): static',
+                description: 'JOIN таблиц',
+                parameters: [
+                    {
+                        name: '$type',
+                        type: 'string',
+                        description: "'left', 'inner', 'right'",
+                        required: true,
+                    },
+                    { name: '$table', type: 'string', description: 'Таблица для JOIN', required: true },
+                    { name: '$on', type: 'string', description: 'ON условие', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model
+    ->join('left', 'cms_users u', 'u.id = i.user_id')
+    ->select('i.*, u.login as user_login')
+    ->get('myaddon_items i');`,
+            },
+            {
+                name: 'groupBy',
+                signature: 'groupBy(string $field): static',
+                description: 'GROUP BY для агрегации',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле группировки', required: true },
+                ],
+                return_type: 'static',
+                example: `$stats = $this->model->select('user_id, COUNT(*) as cnt')->groupBy('user_id')->get('myaddon_items');`,
+            },
+            {
+                name: 'increment',
+                signature: 'increment(string $table, int $id, string $field, int $step = 1): bool',
+                description: 'Инкремент поля в записи',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$id', type: 'int', description: 'ID записи', required: true },
+                    { name: '$field', type: 'string', description: 'Поле для инкремента', required: true },
+                    { name: '$step', type: 'int', description: 'Шаг инкремента', default: '1' },
+                ],
+                return_type: 'bool',
+                example: `$this->model->increment('myaddon_items', $id, 'views');`,
+            },
+            {
+                name: 'decrement',
+                signature: 'decrement(string $table, int $id, string $field, int $step = 1): bool',
+                description: 'Декремент поля в записи',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$id', type: 'int', description: 'ID записи', required: true },
+                    { name: '$field', type: 'string', description: 'Поле для декремента', required: true },
+                    { name: '$step', type: 'int', description: 'Шаг декремента', default: '1' },
+                ],
+                return_type: 'bool',
+                example: `$this->model->decrement('myaddon_items', $id, 'count');`,
+            },
+            {
+                name: 'distinctSelect',
+                signature: 'distinctSelect(string $fields): static',
+                description: 'DISTINCT SELECT для уникальных значений',
+                parameters: [{ name: '$fields', type: 'string', description: 'Поля', required: true }],
+                return_type: 'static',
+                example: `$items = $this->model->distinctSelect('DISTINCT user_id')->get('myaddon_items');`,
+            },
+            {
+                name: 'having',
+                signature: 'having(string $field, string $operator, mixed $value): static',
+                description: 'Условие HAVING для GROUP BY',
+                parameters: [
+                    { name: '$field', type: 'string', description: 'Поле', required: true },
+                    {
+                        name: '$operator',
+                        type: 'string',
+                        description: 'Оператор: >, <, =, >=, <=',
+                        required: true,
+                    },
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                ],
+                return_type: 'static',
+                example: `$stats = $this->model->select('user_id, COUNT(*) as cnt')->groupBy('user_id')->having('cnt', '>', 5)->get('myaddon_items');`,
+            },
+            {
+                name: 'resetFilters',
+                signature: 'resetFilters(): void',
+                description: 'Сброс всех фильтров WHERE',
+                parameters: [],
+                return_type: 'void',
+                example: `$this->model->resetFilters()->limit(10)->get('myaddon_items');`,
+            },
+            {
+                name: 'enableMultiInsert',
+                signature: 'enableMultiInsert(): void',
+                description: 'Включить режим множественной вставки (batch insert)',
+                parameters: [],
+                return_type: 'void',
+                example: `$this->model->enableMultiInsert()->insert('myaddon_items', $batch);`,
+            },
+            {
+                name: 'getJoinedTables',
+                signature: 'getJoinedTables(): array',
+                description: 'Получить список присоединённых таблиц',
+                parameters: [],
+                return_type: 'array',
+                example: `$tables = $this->model->getJoinedTables();`,
+            },
+            {
+                name: 'joinInner',
+                signature: 'joinInner(string $table, string $on): static',
+                description: 'INNER JOIN таблицы',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$on', type: 'string', description: 'ON условие', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->joinInner('cms_users', 'cms_users.id = i.user_id')->get('myaddon_items i');`,
+            },
+            {
+                name: 'joinLeft',
+                signature: 'joinLeft(string $table, string $on): static',
+                description: 'LEFT JOIN таблицы',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Таблица', required: true },
+                    { name: '$on', type: 'string', description: 'ON условие', required: true },
+                ],
+                return_type: 'static',
+                example: `$items = $this->model->joinLeft('cms_users', 'cms_users.id = i.user_id')->get('myaddon_items i');`,
+            },
+        ],
+    },
+    {
+        name: 'cmsController / cmsFrontend / cmsBackend',
+        class: 'cmsController',
+        description: 'Базовые классы контроллеров. cmsFrontend — для фронтенда, cmsBackend — для админ-панели.',
+        access: "$this — внутри контроллера. cmsCore::getController('name') — глобально.",
+        methods: [
+            {
+                name: 'href_to',
+                signature: "href_to(string $action = '', mixed ...$params): string",
+                description: 'Генерация URL в рамках текущего контроллера',
+                parameters: [
+                    {
+                        name: '$action',
+                        type: 'string',
+                        description: 'Действие контроллера',
+                        required: false,
+                        default: "''",
+                    },
+                    { name: '$params', type: 'mixed', description: 'Параметры URL', required: false },
+                ],
+                return_type: 'string',
+                example: `$url = $this->href_to('view', $item['id']);
+// Результат: /myaddon/view/123`,
+            },
+            {
+                name: 'redirect',
+                signature: 'redirect(string $url, int $code = 302): void',
+                description: 'HTTP редирект',
+                parameters: [
+                    { name: '$url', type: 'string', description: 'URL для редиректа', required: true },
+                    { name: '$code', type: 'int', description: 'HTTP код', default: '302' },
+                ],
+                return_type: 'void',
+                example: `return $this->redirect($this->href_to());`,
+            },
+            {
+                name: 'renderJSON',
+                signature: 'renderJSON(array $data): void',
+                description: 'Ответ в формате JSON (для AJAX запросов)',
+                parameters: [
+                    { name: '$data', type: 'array', description: 'Данные ответа', required: true },
+                ],
+                return_type: 'void',
+                example: `return $this->renderJSON(['success' => true, 'id' => $new_id]);`,
+            },
+            {
+                name: 'getForm',
+                signature: 'getForm(string $form_name, array $data = []): cmsForm',
+                description: 'Получить объект формы из файла forms/{form_name}.php',
+                parameters: [
+                    { name: '$form_name', type: 'string', description: 'Имя файла формы', required: true },
+                    { name: '$data', type: 'array', description: 'Данные для инициализации', default: '[]' },
+                ],
+                return_type: 'cmsForm',
+                example: `$form = $this->getForm('item_form', ['id' => $item_id]);`,
+            },
+            {
+                name: 'makeForm',
+                signature: 'makeForm(string $form_name, array $data = []): cmsForm',
+                description: 'Создать и инициализировать форму. Проксирует хук form_make.',
+                parameters: [
+                    { name: '$form_name', type: 'string', description: 'Имя формы', required: true },
+                    { name: '$data', type: 'array', description: 'Данные', default: '[]' },
+                ],
+                return_type: 'cmsForm',
+                example: `$form = $this->makeForm('options', $this->options);
+$form_data = $form->render();`,
+            },
+            {
+                name: 'loadLanguage',
+                signature: "loadLanguage(string $lang = ''): void",
+                description: 'Загрузить языковой файл контроллера',
+                parameters: [
+                    {
+                        name: '$lang',
+                        type: 'string',
+                        description: 'Код языка (по умолчанию из конфига)',
+                        default: "''",
+                    },
+                ],
+                return_type: 'void',
+                example: `// В конструкторе или __construct
+$this->loadLanguage();
+// Теперь доступны константы из languages/{lang}/lang.php`,
+            },
+            {
+                name: 'cmsCore::getController',
+                signature: 'cmsCore::getController(string $name): cmsController',
+                description: 'Получить экземпляр контроллера по имени',
+                parameters: [
+                    { name: '$name', type: 'string', description: 'Имя контроллера', required: true },
+                ],
+                return_type: 'cmsController',
+                example: `$activity = cmsCore::getController('activity');
+$activity->addEntry('myaddon', 'create', ['subject_id' => $id]);`,
+            },
+        ],
+    },
+    {
+        name: 'cmsTemplate',
+        class: 'cmsTemplate',
+        description: 'Движок шаблонов. Singleton. Управляет рендерингом, CSS/JS, блоками страницы.',
+        access: '$this->cms_template — в контроллере. cmsTemplate::getInstance() — глобально.',
+        methods: [
+            {
+                name: 'render',
+                signature: 'render(string $tpl_file, array $data = []): string',
+                description: 'Рендер шаблонного файла .tpl.php и вывод на страницу',
+                parameters: [
+                    {
+                        name: '$tpl_file',
+                        type: 'string',
+                        description: 'Имя файла шаблона (без .tpl.php)',
+                        required: true,
+                    },
+                    { name: '$data', type: 'array', description: 'Переменные для шаблона', default: '[]' },
+                ],
+                return_type: 'string',
+                example: `return $this->cms_template->render('index', [
+    'items'   => $items,
+    'total'   => $total,
+    'page'    => $page,
+    'perpage' => $perpage
+]);`,
+            },
+            {
+                name: 'renderInternal',
+                signature: 'renderInternal(cmsController $ctrl, string $tpl, array $data = []): string',
+                description: 'Рендер шаблона из директории конкретного контроллера (для хуков и виджетов)',
+                parameters: [
+                    {
+                        name: '$ctrl',
+                        type: 'cmsController',
+                        description: 'Контроллер-владелец шаблона',
+                        required: true,
+                    },
+                    { name: '$tpl', type: 'string', description: 'Имя шаблона', required: true },
+                    { name: '$data', type: 'array', description: 'Переменные', default: '[]' },
+                ],
+                return_type: 'string',
+                example: `return $this->cms_template->renderInternal($this, 'list', ['items' => $items]);`,
+            },
+            {
+                name: 'fetch',
+                signature: 'fetch(string $tpl_file, array $data = []): string',
+                description: 'Рендер шаблона в строку (без вывода)',
+                parameters: [
+                    { name: '$tpl_file', type: 'string', description: 'Путь к шаблону', required: true },
+                    { name: '$data', type: 'array', description: 'Переменные', default: '[]' },
+                ],
+                return_type: 'string',
+                example: `$html = $this->cms_template->fetch('myaddon/block', ['item' => $item]);
+echo $html;`,
+            },
+            {
+                name: 'setTitle',
+                signature: 'setTitle(string $title): void',
+                description: 'Установить заголовок страницы (<title>)',
+                parameters: [
+                    { name: '$title', type: 'string', description: 'Заголовок страницы', required: true },
+                ],
+                return_type: 'void',
+                example: `$this->cms_template->setTitle('Название страницы | ' . cmsConfig::get('sitename'));`,
+            },
+            {
+                name: 'addHeadCSS',
+                signature: 'addHeadCSS(string $file, bool $no_merge = false): void',
+                description: 'Добавить CSS файл в <head>',
+                parameters: [
+                    { name: '$file', type: 'string', description: 'URL CSS файла', required: true },
+                    {
+                        name: '$no_merge',
+                        type: 'bool',
+                        description: 'Не объединять с другими CSS',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'void',
+                example: `$this->cms_template->addHeadCSS('/static/myaddon/style.css');`,
+            },
+            {
+                name: 'addHeadJS',
+                signature: 'addHeadJS(string $file, bool $no_merge = false): void',
+                description: 'Добавить JS файл в <head>',
+                parameters: [
+                    { name: '$file', type: 'string', description: 'URL JS файла', required: true },
+                    { name: '$no_merge', type: 'bool', description: 'Не объединять', default: 'false' },
+                ],
+                return_type: 'void',
+                example: `$this->cms_template->addHeadJS('/static/myaddon/app.js');`,
+            },
+            {
+                name: 'addBottom',
+                signature: 'addBottom(string $html): void',
+                description: 'Добавить HTML перед закрывающим </body>',
+                parameters: [
+                    { name: '$html', type: 'string', description: 'HTML для вставки', required: true },
+                ],
+                return_type: 'void',
+                example: `$this->cms_template->addBottom('<script>initMyPlugin();</script>');`,
+            },
+            {
+                name: 'renderJSON',
+                signature: 'renderJSON(array $data): void',
+                description: 'Вернуть JSON ответ и завершить выполнение',
+                parameters: [{ name: '$data', type: 'array', description: 'Данные', required: true }],
+                return_type: 'void',
+                example: `$this->cms_template->renderJSON(['success' => true, 'message' => 'OK']);`,
+            },
+        ],
+    },
+    {
+        name: 'cmsCache',
+        class: 'cmsCache',
+        description: 'Кэширование данных. Поддерживает файловый кэш, Memcache, Redis.',
+        access: 'cmsCache::getInstance()',
+        methods: [
+            {
+                name: 'get',
+                signature: 'get(string $key): mixed|false',
+                description: 'Получить данные из кэша. false если не найдено или устарело.',
+                parameters: [{ name: '$key', type: 'string', description: 'Ключ кэша', required: true }],
+                return_type: 'mixed|false',
+                example: `$cache = cmsCache::getInstance();
+$data = $cache->get('myaddon.list');
+if ($data === false) {
+    $data = $this->model->get('items');
+    $cache->set('myaddon.list', $data, 300);
+}`,
+            },
+            {
+                name: 'set',
+                signature: 'set(string $key, mixed $data, int $ttl = 0): bool',
+                description: 'Сохранить данные в кэш',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Ключ', required: true },
+                    { name: '$data', type: 'mixed', description: 'Данные', required: true },
+                    {
+                        name: '$ttl',
+                        type: 'int',
+                        description: 'Время жизни в секундах (0 = бессрочно)',
+                        default: '0',
+                    },
+                ],
+                return_type: 'bool',
+                example: `cmsCache::getInstance()->set('myaddon.count', $count, 3600);`,
+            },
+            {
+                name: 'clean',
+                signature: 'clean(string $key): bool',
+                description: 'Удалить ключ из кэша',
+                parameters: [
+                    {
+                        name: '$key',
+                        type: 'string',
+                        description: 'Ключ или префикс для очистки',
+                        required: true,
+                    },
+                ],
+                return_type: 'bool',
+                example: `// Очищать кэш при изменении данных
+cmsCache::getInstance()->clean('myaddon.list');
+cmsCache::getInstance()->clean('myaddon.count');`,
+            },
+        ],
+    },
+    {
+        name: 'cmsRequest',
+        class: 'cmsRequest',
+        description: 'Обработка HTTP-запросов. GET/POST параметры, проверки типа запроса.',
+        access: '$this->request — в контроллере.',
+        methods: [
+            {
+                name: 'get',
+                signature: 'get(string $key, mixed $default = null): mixed',
+                description: 'Получить параметр из GET',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Имя параметра', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        default: 'null',
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$page = $this->request->get('page', 1);
+$sort = $this->request->get('sort', 'date');`,
+            },
+            {
+                name: 'post',
+                signature: 'post(string $key, mixed $default = null): mixed',
+                description: 'Получить параметр из POST',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Имя параметра', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        default: 'null',
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$title = $this->request->post('title', '');
+$is_pub = $this->request->post('is_pub', 0);`,
+            },
+            {
+                name: 'isPost',
+                signature: 'isPost(): bool',
+                description: 'Проверить, является ли запрос POST',
+                parameters: [],
+                return_type: 'bool',
+                example: `if ($this->request->isPost()) {
+    // Обработать форму
+    $data = $form->parse($this->request->data('post'));
+}`,
+            },
+            {
+                name: 'isAjax',
+                signature: 'isAjax(): bool',
+                description: 'Проверить, является ли запрос AJAX',
+                parameters: [],
+                return_type: 'bool',
+                example: `if ($this->request->isAjax()) {
+    return $this->renderJSON(['success' => true]);
+}`,
+            },
+            {
+                name: 'data',
+                signature: 'data(string $type): array',
+                description: 'Получить все данные POST или GET',
+                parameters: [
+                    { name: '$type', type: 'string', description: "'post' или 'get'", required: true },
+                ],
+                return_type: 'array',
+                example: `$form_data = $form->parse($this->request->data('post'));`,
+            },
+        ],
+    },
+    {
+        name: 'cmsEventsManager',
+        class: 'cmsEventsManager',
+        description: 'Система хуков и событий. Диспетчер событий InstantCMS.',
+        access: 'cmsEventsManager:: (статические методы)',
+        methods: [
+            {
+                name: 'hook',
+                signature: 'cmsEventsManager::hook(string $event, mixed $data, mixed $default = null, mixed $request = null): mixed',
+                description: 'Запустить хук. Данные последовательно проходят через всех слушателей.',
+                parameters: [
+                    { name: '$event', type: 'string', description: 'Имя события', required: true },
+                    { name: '$data', type: 'mixed', description: 'Данные для передачи', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        default: 'null',
+                    },
+                    {
+                        name: '$request',
+                        type: 'mixed',
+                        description: 'Дополнительный контекст',
+                        default: 'null',
+                    },
+                ],
+                return_type: 'mixed',
+                example: `// Простой хук
+$items = cmsEventsManager::hook('myaddon_before_list', $items);
+
+// Хук с дополнительными данными
+$item = cmsEventsManager::hook('content_before_item', $item, $item, ['ctype' => $ctype]);`,
+            },
+            {
+                name: 'hookAll',
+                signature: 'cmsEventsManager::hookAll(string $event, mixed $data, mixed $default = null): array',
+                description: 'Запустить хук и собрать результаты от всех слушателей в массив',
+                parameters: [
+                    { name: '$event', type: 'string', description: 'Имя события', required: true },
+                    { name: '$data', type: 'mixed', description: 'Данные', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        default: 'null',
+                    },
+                ],
+                return_type: 'array',
+                example: `// Собрать пункты меню от всех дополнений
+$menu_items = cmsEventsManager::hookAll('menu_admin', []);`,
+            },
+        ],
+    },
+    {
+        name: 'cmsCore (утилиты)',
+        class: 'cmsCore',
+        description: 'Главный singleton CMS. Содержит утилиты для получения компонентов.',
+        access: 'cmsCore:: (статические методы)',
+        methods: [
+            {
+                name: 'cmsCore::getModel',
+                signature: 'cmsCore::getModel(string $controller): cmsModel',
+                description: 'Получить модель контроллера',
+                parameters: [
+                    { name: '$controller', type: 'string', description: 'Имя контроллера', required: true },
+                ],
+                return_type: 'cmsModel',
+                example: `$content_model = cmsCore::getModel('content');
+$items = $content_model->filterEqual('is_pub', 1)->get('con_articles');`,
+            },
+            {
+                name: 'cmsCore::error404',
+                signature: 'cmsCore::error404(): void',
+                description: 'Показать страницу 404',
+                parameters: [],
+                return_type: 'void',
+                example: `if (!$item) { return cmsCore::error404(); }`,
+            },
+            {
+                name: 'cmsConfig::get',
+                signature: 'cmsConfig::get(string $key, mixed $default = null): mixed',
+                description: 'Получить значение из конфигурации сайта',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Ключ конфига', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        default: 'null',
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$sitename = cmsConfig::get('sitename');
+$template = cmsConfig::get('template', 'default');
+$db_prefix = cmsConfig::get('db_prefix', 'cms_');`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsWidget — базовый класс виджетов
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsWidget',
+        class: 'cmsWidget',
+        description: 'Базовый класс всех виджетов для публичных страниц. Виджеты размещаются в позициях шаблона через панель виджетов. Файл: widgets/{widget_name}/widget.php',
+        access: 'Наследование: class widget{Name}{WidgetName} extends cmsWidget',
+        methods: [
+            {
+                name: 'run',
+                signature: 'run(): array|false',
+                description: 'Основной метод виджета. Должен вернуть массив переменных для шаблона или false для пропуска рендеринга.',
+                parameters: [],
+                return_type: 'array|false',
+                example: `class widgetCatalogList extends cmsWidget {
+
+    // Отключить кэш для динамического контента:
+    public $is_cacheable = false;
+
+    public function run() {
+
+        $limit = $this->getOption('limit', 5);
+
+        $controller = cmsCore::getController('catalog');
+        $items = $controller->model
+            ->filterEqual('is_pub', 1)
+            ->orderBy('date_pub', 'desc')
+            ->limit($limit)
+            ->get('catalog_items');
+
+        if (!$items) {
+            return false;  // Виджет не выводится
+        }
+
+        // Шаблон: /templates/{theme}/controllers/catalog/list.tpl.php
+        return [
+            'items' => $items,
+            'limit' => $limit
+        ];
+    }
+}`,
+            },
+            {
+                name: 'getOption',
+                signature: 'getOption(string $key, mixed $default = false): mixed',
+                description: "Получить значение настройки виджета. Поддерживает вложенные ключи через ':' (например 'options:ctype_id').",
+                parameters: [
+                    {
+                        name: '$key',
+                        type: 'string',
+                        description: "Имя опции или вложенный путь через ':'",
+                        required: true,
+                    },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$limit   = $this->getOption('limit', 10);
+$ctype   = $this->getOption('ctype_id', 0);
+$dataset = $this->getOption('options:dataset', 'all');  // вложенный ключ`,
+            },
+            {
+                name: 'getOptions',
+                signature: 'getOptions(): array',
+                description: 'Получить все настройки виджета в виде массива',
+                parameters: [],
+                return_type: 'array',
+                example: `$all_options = $this->getOptions();
+// Передача всех опций в метод контроллера:
+return $this->controller_tags->getTagsWidgetParams($this->getOptions());`,
+            },
+            {
+                name: 'disableCache',
+                signature: 'disableCache(): void',
+                description: 'Отключить кэширование виджета в коде. Альтернатива: свойство public $is_cacheable = false.',
+                parameters: [],
+                return_type: 'void',
+                example: `public function run() {
+    $this->disableCache(); // или: public $is_cacheable = false;
+    // ...
+}`,
+            },
+            {
+                name: 'setTemplate',
+                signature: 'setTemplate(string $template): void',
+                description: 'Изменить имя шаблона виджета (по умолчанию = имя виджета)',
+                parameters: [
+                    {
+                        name: '$template',
+                        type: 'string',
+                        description: 'Имя шаблона без .tpl.php',
+                        required: true,
+                    },
+                ],
+                return_type: 'void',
+                example: `// По умолчанию шаблон = имя виджета ('list')
+// Чтобы использовать другой шаблон:
+$this->setTemplate('list_compact');
+// Ищет: /templates/{theme}/controllers/{name}/list_compact.tpl.php`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsBackend — базовый класс бэкенд-контроллеров
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsBackend',
+        class: 'cmsBackend',
+        description: 'Базовый класс всех бэкенд-контроллеров. Файл backend.php: class backend{Name} extends cmsBackend. Содержит getBackendMenu() и before(). Экшены — в отдельных файлах backend/actions/.',
+        access: 'Наследование: class backend{Name} extends cmsBackend',
+        methods: [
+            {
+                name: 'getBackendMenu',
+                signature: 'getBackendMenu(): array',
+                description: 'Возвращает пункты меню левой панели в бэкенде. Поддерживает иконки, счётчики, подменю.',
+                parameters: [],
+                return_type: 'array',
+                example: `public function getBackendMenu() {
+    return [
+        // Простой пункт
+        [
+            'title'   => LANG_CATALOG_CP_ITEMS,
+            'url'     => href_to($this->root_url, 'items'),
+            'options' => ['icon' => 'list']
+        ],
+        // Пункт со счётчиком
+        [
+            'title'   => LANG_CATALOG_CP_PENDING,
+            'counter' => $this->model->getPendingCount(),
+            'url'     => href_to($this->root_url, 'pending'),
+            'options' => ['icon' => 'clock']
+        ],
+        // Родительский пункт с подменю
+        [
+            'title'        => LANG_CATALOG_CP_PRICES,
+            'url'          => href_to($this->root_url, 'prices'),
+            'childs_count' => 2,
+            'options'      => ['icon' => 'money-bill']
+        ],
+        // Дочерние пункты (level 2)
+        [
+            'title' => LANG_CATALOG_CP_PRICES_BASIC,
+            'level' => 2,
+            'url'   => href_to($this->root_url, 'prices', 'basic')
+        ],
+        [
+            'title' => LANG_CATALOG_CP_PRICES_VIP,
+            'level' => 2,
+            'url'   => href_to($this->root_url, 'prices', 'vip')
+        ],
+        // Настройки
+        [
+            'title'   => LANG_OPTIONS,
+            'url'     => href_to($this->root_url, 'options'),
+            'options' => ['icon' => 'cog']
+        ]
+    ];
+}`,
+            },
+            {
+                name: 'before',
+                signature: 'before(string $action_name): bool',
+                description: 'Вызывается перед каждым экшеном бэкенда. Для дополнительных проверок доступа. Обязательно вызывать parent::before().',
+                parameters: [
+                    {
+                        name: '$action_name',
+                        type: 'string',
+                        description: 'Имя текущего экшена',
+                        required: true,
+                    },
+                ],
+                return_type: 'bool',
+                example: `public function before($action_name) {
+    if (!parent::before($action_name)) {
+        return false;
+    }
+    // Добавить заголовок безопасности
+    $this->cms_core->response->setHeader('X-Frame-Options', 'DENY');
+    return true;
+}`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // trait listgrid — для бэкенд экшенов-списков
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'trait listgrid',
+        class: 'icms\\traits\\controllers\\actions\\listgrid',
+        description: 'Трейт для бэкенд экшенов, отображающих список с гридом. Подключается в backend/actions/*.php. Логика настраивается через свойства в __construct().',
+        access: 'use icms\\traits\\controllers\\actions\\listgrid; в классе action{Name}X extends cmsAction',
+        methods: [
+            {
+                name: 'Свойства трейта listgrid',
+                signature: 'Properties',
+                description: 'Свойства для настройки трейта в __construct()',
+                parameters: [],
+                return_type: 'void',
+                example: `class actionCatalogItems extends cmsAction {
+
+    use icms\\traits\\controllers\\actions\\listgrid;
+
+    public function __construct($controller, $params = []) {
+        parent::__construct($controller, $params);
+
+        // ОБЯЗАТЕЛЬНЫЕ:
+        $this->table_name = 'catalog_items';    // основная таблица
+        $this->grid_name  = 'items';            // имя грида (файл backend/grids/grid_items.php)
+        $this->title      = LANG_CATALOG_CP_ITEMS; // заголовок страницы
+
+        // ТУЛБАР — кнопки над списком:
+        $this->tool_buttons = [
+            [
+                'class' => 'add',                // CSS класс кнопки
+                'title' => LANG_CATALOG_CP_ADD,
+                'href'  => $this->cms_template->href_to('items', 'add')
+            ],
+            [
+                'class' => 'btn btn-secondary',
+                'title' => LANG_EXPORT,
+                'href'  => $this->cms_template->href_to('items', 'export'),
+                'icon'  => 'download'
+            ]
+        ];
+
+        // ОПЦИОНАЛЬНЫЕ:
+        // Хук для расширения тулбара другими дополнениями:
+        $this->toolbar_hook = 'catalog_items_toolbar';
+
+        // Коллбэк для дополнительных JOIN-ов / фильтров модели:
+        $this->list_callback = function (\\cmsModel $model) {
+            return $model->joinLeft('users u', 'u.id = t.user_id', ['u.nickname as user_nickname']);
+        };
+
+        // Коллбэк для постобработки записей:
+        $this->items_callback = function ($items) {
+            foreach ($items as &$item) {
+                $item['status_label'] = $item['is_pub'] ? 'Активен' : 'Скрыт';
+            }
+            return $items;
+        };
+
+        // Передача управления вложенным экшенам:
+        // URL /admin/catalog/items/add → запустит action items_add
+        $this->external_action_prefix = 'items_';
+
+        // Кол-во записей на страницу (по умолчанию 30):
+        $this->default_perpage = 20;
+    }
+}`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // trait formItem — для бэкенд экшенов-форм
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'trait formItem',
+        class: 'icms\\traits\\controllers\\actions\\formItem',
+        description: 'Трейт для бэкенд экшенов добавления/редактирования. Один экшен обрабатывает и add, и edit. Логика через свойства в __construct().',
+        access: 'use icms\\traits\\controllers\\actions\\formItem; в классе action{Name}X extends cmsAction',
+        methods: [
+            {
+                name: 'Свойства трейта formItem',
+                signature: 'Properties',
+                description: 'Свойства для настройки трейта в __construct()',
+                parameters: [],
+                return_type: 'void',
+                example: `class actionCatalogItemsAdd extends cmsAction {
+
+    use icms\\traits\\controllers\\actions\\formItem;
+
+    public function __construct($controller, $params = []) {
+        parent::__construct($controller, $params);
+
+        $list_url = $this->cms_template->href_to('items');
+
+        // ОБЯЗАТЕЛЬНЫЕ:
+        $this->table_name  = 'catalog_items';  // таблица БД
+        $this->form_name   = 'item';           // форма (файл backend/forms/form_item.php)
+        $this->success_url = $list_url;        // редирект после сохранения
+
+        // ЗАГОЛОВОК — строка или массив:
+        $this->title = [
+            'add'  => LANG_CATALOG_CP_ADD,
+            'edit' => '{title}'   // {title} заменяется значением поля title записи
+        ];
+
+        // ХЛЕБНЫЕ КРОШКИ:
+        $this->breadcrumbs = [
+            [LANG_CATALOG_CP_ITEMS, $list_url],
+            isset($params[0]) ? '{title}' : LANG_CATALOG_CP_ADD
+        ];
+
+        // ТУЛБАР — кнопки Сохранить/Отменить:
+        $this->use_default_tool_buttons = true;
+        // Или кастомные кнопки:
+        // $this->tool_buttons = [...];
+
+        // ДЕФОЛТНЫЕ ЗНАЧЕНИЯ для новой записи:
+        $this->default_item = [
+            'is_pub'     => 1,
+            'date_pub'   => date('Y-m-d H:i:s'),
+            'sort_order' => 0
+        ];
+
+        // ПАРАМЕТРЫ ФОРМЫ (передаются в form->init()):
+        // $this->form_opts = [$this->controller->getOptions()];
+
+        // КОЛЛБЭКИ:
+        $this->add_callback = function($id, $data) {
+            // После добавления записи
+            cmsCache::getInstance()->clean('catalog');
+        };
+
+        $this->update_callback = function($data) {
+            // После обновления записи
+            cmsCache::getInstance()->clean('catalog');
+        };
+
+        // ПОЛЕ ЗАГОЛОВКА для копирования (добавляет " (1)"):
+        $this->title_field = 'title';
+
+        // КЛЮЧ КЭША для сброса после сохранения:
+        $this->cache_key = 'catalog';
+
+        // МЕТОДЫ МОДЕЛИ (по умолчанию insert/update):
+        // $this->form_add_method  = 'insert';
+        // $this->form_edit_method = 'update';
+    }
+}`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Grid Definition — структура файла грида
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'Grid Definition (backend/grids/)',
+        class: 'function grid_{name}',
+        description: 'Определение грида в файле backend/grids/grid_{name}.php. ФУНКЦИЯ, не класс! Возвращает массив options/columns/actions.',
+        access: 'Файл: backend/grids/grid_{name}.php. Функция: grid_{name}($controller, $model=null)',
+        methods: [
+            {
+                name: 'options',
+                signature: 'options: array',
+                description: 'Настройки отображения и поведения грида',
+                parameters: [],
+                return_type: 'array',
+                example: `$options = [
+    'is_sortable'   => true,   // Сортировка по клику на заголовок столбца
+    'is_filter'     => true,   // Показать панель фильтрации
+    'is_pagination' => true,   // Пагинация (кол-во задаётся в экшене)
+    'is_draggable'  => false,  // Drag&drop строк для изменения порядка
+    'is_selectable' => false,  // Чекбоксы для массовых операций
+    'order_by'      => 'id',   // Поле сортировки по умолчанию
+    'order_to'      => 'desc', // Направление: 'asc' или 'desc'
+    'show_id'       => true    // Показать колонку ID
+
+    // Для drag&drop с сохранением порядка:
+    // 'is_draggable'  => true,
+    // 'drag_save_url' => href_to('admin', 'reorder', 'catalog_items'),
+];`,
+            },
+            {
+                name: 'columns',
+                signature: 'columns: array',
+                description: 'Определение столбцов грида. Ключ = имя поля в БД.',
+                parameters: [],
+                return_type: 'array',
+                example: `$columns = [
+    // Простой столбец
+    'id' => ['title' => 'ID', 'width' => 60],
+
+    // Со ссылкой на редактирование
+    'title' => [
+        'title'   => LANG_TITLE,
+        'href'    => href_to($controller->root_url, 'items', ['edit', '{id}'])
+    ],
+
+    // С JOIN-ом: указать order_by с алиасом таблицы
+    'user_nickname' => [
+        'title'     => LANG_USER,
+        'width'     => 150,
+        'href'      => href_to('users', '{user_id}'),
+        'order_by'  => 'u.nickname',   // алиас из JOIN
+        'filter'    => 'like',
+        'filter_by' => 'u.nickname'    // поле для фильтрации
+    ],
+
+    // Дата с форматированием
+    'date_pub' => [
+        'title'   => LANG_DATE_PUB,
+        'width'   => 150,
+        'filter'  => 'date',           // фильтр по диапазону дат
+        'handler' => function ($value) {
+            return html_date_time($value);
+        }
+    ],
+
+    // Флаг с inline-переключателем
+    'is_pub' => [
+        'title'       => LANG_IS_PUB,
+        'width'       => 60,
+        'flag'        => true,
+        'flag_toggle' => href_to($controller->root_url, 'toggle_item', ['{id}', 'catalog_items', 'is_pub'])
+    ],
+
+    // Фильтр по выпадающему списку
+    'status' => [
+        'title'  => LANG_STATUS,
+        'filter' => 'exact',
+        'filter_select' => [
+            'items' => function($name) {
+                return ['' => LANG_ALL, 0 => LANG_INACTIVE, 1 => LANG_ACTIVE];
+            }
+        ],
+        'handler' => function ($value, $row) {
+            return $value ? '<span class="text-success">'.LANG_ACTIVE.'</span>'
+                          : '<span class="text-muted">'.LANG_INACTIVE.'</span>';
+        }
+    ],
+
+    // Числовой диапазон
+    'price' => ['title' => LANG_PRICE, 'filter' => 'range'],
+
+    // Подсветка строки
+    'priority' => [
+        'title'         => LANG_PRIORITY,
+        'class_handler' => function($row) {
+            if ($row['priority'] > 5) return 'bg-warning';
+            if ($row['priority'] < 0) return 'bg-danger';
+        }
+    ],
+
+    // Редактируемое поле inline (inline editing)
+    'sort_order' => [
+        'title'    => LANG_ORDER,
+        'width'    => 80,
+        'editable' => true   // позволяет редактировать прямо в гриде
+    ]
+];
+
+// Типы фильтров: 'like', 'exact', 'date', 'range'`,
+            },
+            {
+                name: 'actions',
+                signature: 'actions: array',
+                description: 'Кнопки действий для каждой строки грида (правая колонка)',
+                parameters: [],
+                return_type: 'array',
+                example: `$actions = [
+    // Кнопка редактирования
+    [
+        'title' => LANG_EDIT,
+        'icon'  => 'pen',
+        'href'  => href_to($controller->root_url, 'items', ['edit', '{id}'])
+    ],
+
+    // Кнопка копирования записи
+    [
+        'title' => LANG_COPY,
+        'icon'  => 'copy',
+        'href'  => href_to($controller->root_url, 'items_add', ['{id}', 1])
+    ],
+
+    // Условная кнопка (показывается только при условии)
+    [
+        'title'   => LANG_APPROVE,
+        'icon'    => 'check',
+        'href'    => href_to($controller->root_url, 'items', ['approve', '{id}']),
+        'handler' => function ($item) {
+            return $item['is_pub'] == 0; // показать только если не опубликован
+        }
+    ],
+
+    // Кнопка с подтверждением и кастомным стилем
+    [
+        'title'   => LANG_DELETE,
+        'class'   => 'text-danger',       // CSS класс кнопки
+        'icon'    => 'times-circle',      // FontAwesome иконка (без fa-)
+        'confirm' => LANG_DELETE_CONFIRM, // текст подтверждения
+        'href'    => href_to($controller->root_url, 'items', ['delete', '{id}'])
+    ]
+];
+
+// Плейсхолдеры в href: {id}, {title}, {user_id} и любое другое поле строки`,
+            },
+            {
+                name: 'Пример полного грида',
+                signature: 'function grid_items($controller, $model = null): array',
+                description: 'Полный пример файла backend/grids/grid_items.php',
+                parameters: [],
+                return_type: 'array',
+                example: `<?php
+// Файл: backend/grids/grid_items.php
+// ВАЖНО: функция, не класс!
+
+function grid_items($controller) {
+
+    $options = [
+        'is_sortable'   => true,
+        'is_filter'     => true,
+        'is_pagination' => true,
+        'is_draggable'  => false,
+        'is_selectable' => false,
+        'order_by'      => 'id',
+        'order_to'      => 'desc',
+        'show_id'       => true
+    ];
+
+    $columns = [
+        'title' => [
+            'title'   => LANG_TITLE,
+            'filter'  => 'like',
+            'href'    => href_to($controller->root_url, 'items', ['edit', '{id}'])
+        ],
+        'date_pub' => [
+            'title'   => LANG_DATE_PUB,
+            'width'   => 150,
+            'filter'  => 'date',
+            'handler' => function ($value) { return html_date_time($value); }
+        ],
+        'is_pub' => [
+            'title'       => LANG_IS_PUB,
+            'width'       => 60,
+            'flag'        => true,
+            'flag_toggle' => href_to($controller->root_url, 'toggle_item', ['{id}', 'catalog_items', 'is_pub'])
+        ]
+    ];
+
+    $actions = [
+        [
+            'title' => LANG_EDIT,
+            'icon'  => 'pen',
+            'href'  => href_to($controller->root_url, 'items', ['edit', '{id}'])
+        ],
+        [
+            'title'   => LANG_DELETE,
+            'class'   => 'text-danger',
+            'icon'    => 'times-circle',
+            'confirm' => LANG_DELETE_CONFIRM,
+            'href'    => href_to($controller->root_url, 'items', ['delete', '{id}'])
+        ]
+    ];
+
+    return ['options' => $options, 'columns' => $columns, 'actions' => $actions];
+}`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsForm — базовый класс форм
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsForm',
+        class: 'cmsForm',
+        description: 'Базовый класс форм. Используется для бэкенд форм (backend/forms/) и опций виджетов. Метод init() возвращает массив fieldset → childs → поля.',
+        access: 'Наследование: class form{Name}Item extends cmsForm',
+        methods: [
+            {
+                name: 'init',
+                signature: 'init($do = null, ...$params): array',
+                description: "Определяет структуру формы. Принимает $do ('add'/'edit') и дополнительные параметры из form_opts. Возвращает массив fieldset-ов с полями.",
+                parameters: [
+                    {
+                        name: '$do',
+                        type: 'string',
+                        description: "'add' или 'edit' — тип операции",
+                        default: 'null',
+                    },
+                ],
+                return_type: 'array',
+                example: `class formCatalogItem extends cmsForm {
+
+    // $do = 'add' или 'edit' (передаётся из трейта formItem)
+    // $options = доп. параметры из $this->form_opts в экшене
+    public function init($do, $options = []) {
+
+        return [
+            // Секция (fieldset)
+            'basic' => [
+                'title'  => LANG_CP_BASIC,
+                'type'   => 'fieldset',
+                'childs' => [
+                    new fieldString('title', [
+                        'title' => LANG_TITLE,
+                        'rules' => [['required'], ['max_length', 255]]
+                    ]),
+                    new fieldHtml('content', [
+                        'title' => LANG_CONTENT
+                    ]),
+                    // Поле со встроенной валидацией через замыкание:
+                    new fieldString('slug', [
+                        'title' => LANG_SLUG,
+                        'rules' => [
+                            [function ($controller, $data, $value) {
+                                if (empty($value)) return true;
+                                // Уникальность слага:
+                                if (!empty($data['id'])) {
+                                    $controller->model->filterNotEqual('id', $data['id']);
+                                }
+                                $exists = $controller->model
+                                    ->filterEqual('slug', $value)
+                                    ->getCount('catalog_items');
+                                return $exists ? ERR_VALIDATE_UNIQUE : true;
+                            }]
+                        ]
+                    ]),
+                    new fieldCheckbox('is_pub', ['title' => LANG_IS_PUB, 'default' => 1]),
+                    new fieldDate('date_pub', [
+                        'title'   => LANG_DATE_PUB,
+                        'default' => date('Y-m-d H:i:s')
+                    ])
+                ]
+            ],
+            'media' => [
+                'title'  => LANG_MEDIA,
+                'type'   => 'fieldset',
+                'childs' => [
+                    new fieldImage('image', [
+                        'title'     => LANG_IMAGE,
+                        'max_width' => 1200,
+                        'max_size'  => 5120
+                    ])
+                ]
+            ]
+        ];
+    }
+}`,
+            },
+        ],
+    },
+    {
+        name: 'cmsTemplate',
+        class: 'cmsTemplate',
+        description: 'Движок шаблонов InstantCMS. Доступен как $this в .tpl.php файлах. Предоставляет методы для вывода контента, CSS/JS, виджетов, навигации и динамического layout.',
+        access: '$this — в .tpl.php файлах шаблона',
+        methods: [
+            {
+                name: 'title',
+                signature: 'title(): string',
+                description: 'Возвращает заголовок страницы. МЕТОД с (), не свойство!',
+                parameters: [],
+                return_type: 'string',
+                example: `<title><?= $this->title() ?></title>`,
+            },
+            {
+                name: 'body',
+                signature: 'body(): string',
+                description: 'Возвращает основной HTML-контент страницы (результат экшена контроллера).',
+                parameters: [],
+                return_type: 'string',
+                example: `<main class="content"><?= $this->body() ?></main>`,
+            },
+            {
+                name: 'head',
+                signature: 'head(bool $include_css_js = true, ...): string',
+                description: 'Возвращает теги для вставки в <head>: мета-теги, CSS, JS.',
+                parameters: [
+                    {
+                        name: '$include_css_js',
+                        type: 'bool',
+                        description: 'Включить CSS/JS теги (default: true)',
+                        required: false,
+                        default: 'true',
+                    },
+                ],
+                return_type: 'string',
+                example: `<head>
+    <meta charset="utf-8">
+    <title><?= $this->title() ?></title>
+    <?= $this->head(true) ?>
+</head>`,
+            },
+            {
+                name: 'bottom',
+                signature: 'bottom(): string',
+                description: 'Возвращает JS-скрипты для вставки перед </body>.',
+                parameters: [],
+                return_type: 'string',
+                example: `    <?= $this->bottom() ?>
+</body>`,
+            },
+            {
+                name: 'widgets',
+                signature: 'widgets(string $position): string',
+                description: 'Выводит виджеты на указанной позиции.',
+                parameters: [
+                    {
+                        name: '$position',
+                        type: 'string',
+                        description: 'Имя позиции: header, top, left-top, left-bottom, right-top, right-center, right-bottom, footer',
+                        required: true,
+                    },
+                ],
+                return_type: 'string',
+                example: `<?= $this->widgets('header') ?>
+<?= $this->widgets('right-top') ?>
+<?= $this->widgets('footer') ?>`,
+            },
+            {
+                name: 'hasWidgetsOn',
+                signature: 'hasWidgetsOn(string|array $positions): bool',
+                description: 'Проверяет наличие виджетов на позиции (или массиве позиций).',
+                parameters: [
+                    {
+                        name: '$positions',
+                        type: 'string|array',
+                        description: 'Позиция или массив позиций',
+                        required: true,
+                    },
+                ],
+                return_type: 'bool',
+                example: `<?php if ($this->hasWidgetsOn('right-top')): ?>
+    <aside class="sidebar">
+        <?= $this->widgets('right-top') ?>
+    </aside>
+<?php endif ?>`,
+            },
+            {
+                name: 'widgetsInHtml',
+                signature: "widgetsInHtml(string $position, string $wrapper = ''): void",
+                description: 'Выводит виджеты позиции в HTML-обёртке.',
+                parameters: [
+                    { name: '$position', type: 'string', description: 'Позиция виджетов', required: true },
+                    {
+                        name: '$wrapper',
+                        type: 'string',
+                        description: 'HTML-обёртка (класс или тег)',
+                        required: false,
+                    },
+                ],
+                return_type: 'void',
+                example: `<?php $this->widgetsInHtml('left-top', 'sidebar-section') ?>`,
+            },
+            {
+                name: 'breadcrumbs',
+                signature: 'breadcrumbs(): string',
+                description: 'Возвращает HTML хлебных крошек.',
+                parameters: [],
+                return_type: 'string',
+                example: `<nav aria-label="breadcrumb"><?= $this->breadcrumbs() ?></nav>`,
+            },
+            {
+                name: 'linkCSS',
+                signature: 'linkCSS(string $path): string',
+                description: 'Возвращает <link> тег для CSS файла из папки темы.',
+                parameters: [
+                    {
+                        name: '$path',
+                        type: 'string',
+                        description: 'Путь относительно папки темы',
+                        required: true,
+                    },
+                ],
+                return_type: 'string',
+                example: `<?= $this->linkCSS('css/main.css') ?>`,
+            },
+            {
+                name: 'linkJS',
+                signature: 'linkJS(string $path): string',
+                description: 'Возвращает <script> тег для JS файла из папки темы.',
+                parameters: [
+                    {
+                        name: '$path',
+                        type: 'string',
+                        description: 'Путь относительно папки темы',
+                        required: true,
+                    },
+                ],
+                return_type: 'string',
+                example: `<?= $this->linkJS('js/main.js') ?>`,
+            },
+            {
+                name: 'renderLayoutChild',
+                signature: 'renderLayoutChild(string $name, array $vars = []): void',
+                description: 'Рендерит фрагмент из layout_childs/. Используется при is_dynamic_layout=true. Файл: layout_childs/{name}.tpl.php',
+                parameters: [
+                    {
+                        name: '$name',
+                        type: 'string',
+                        description: 'Имя фрагмента (без .tpl.php): layout_childs/{name}.tpl.php',
+                        required: true,
+                    },
+                    {
+                        name: '$vars',
+                        type: 'array',
+                        description: 'Переменные для фрагмента',
+                        required: false,
+                    },
+                ],
+                return_type: 'void',
+                example: `// В main.tpl.php (is_dynamic_layout = true):
+<?php $this->renderLayoutChild('scheme', ['rows' => $rows]) ?>
+// Рендерит layout_childs/main_scheme.tpl.php`,
+            },
+            {
+                name: 'href_to',
+                signature: "href_to(string $action = '', array $params = []): string",
+                description: 'Формирует URL к экшену текущего контроллера.',
+                parameters: [
+                    {
+                        name: '$action',
+                        type: 'string',
+                        description: "Имя экшена ('' = index)",
+                        required: false,
+                    },
+                    { name: '$params', type: 'array', description: 'GET-параметры', required: false },
+                ],
+                return_type: 'string',
+                example: `<a href="<?= $this->href_to('view', ['id' => $item['id']]) ?>"><?= $item['title'] ?></a>
+<a href="<?= $this->href_to() ?>">← Назад</a>`,
+            },
+            {
+                name: 'addMainTplCSSName',
+                signature: 'addMainTplCSSName(string $name): void',
+                description: 'Добавляет CSS-класс к корневому элементу шаблона.',
+                parameters: [{ name: '$name', type: 'string', description: 'CSS-класс', required: true }],
+                return_type: 'void',
+                example: `<?php $this->addMainTplCSSName('page-catalog') ?>`,
+            },
+            {
+                name: 'onDemandPrint',
+                signature: 'onDemandPrint(): void',
+                description: 'Выводит on-demand ресурсы (CSS/JS), добавленные контроллерами в процессе выполнения. Обычно вставляется перед </head>.',
+                parameters: [],
+                return_type: 'void',
+                example: `<?= $this->onDemandPrint() ?>`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsUser — авторизация, сессии, работа с пользователем
+    // system/core/user.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsUser',
+        class: 'cmsUser',
+        description: 'Класс для работы с текущим пользователем. Singleton. Содержит данные авторизованного пользователя, группы, друзей, сессии и права доступа.',
+        access: 'cmsUser::getInstance() — глобально. $this->cms_user — в контроллере.',
+        methods: [
+            {
+                name: 'login',
+                signature: 'login(string $email, string $password, bool $remember = false, bool $complete_login = true, $model = null): int|array',
+                description: 'Авторизует пользователя по email и паролю. Возвращает ID пользователя или массив (если complete_login=false).',
+                parameters: [
+                    { name: '$email', type: 'string', description: 'Email пользователя', required: true },
+                    { name: '$password', type: 'string', description: 'Пароль', required: true },
+                    {
+                        name: '$remember',
+                        type: 'bool',
+                        description: 'Запомнить на 100 дней (cookie)',
+                        default: 'false',
+                    },
+                    {
+                        name: '$complete_login',
+                        type: 'bool',
+                        description: 'Завершить авторизацию сразу',
+                        default: 'true',
+                    },
+                ],
+                return_type: 'int|array',
+                example: `$user_id = cmsUser::login($email, $password);
+if (!$user_id) {
+    cmsUser::addSessionMessage('Неверный email или пароль', 'error');
+}`,
+            },
+            {
+                name: 'logout',
+                signature: 'logout(): bool',
+                description: 'Выход пользователя из системы. Удаляет сессию, online-запись, cookie авторизации.',
+                parameters: [],
+                return_type: 'bool',
+                example: `cmsUser::logout();
+$this->redirect(href_to('auth', 'login'));`,
+            },
+            {
+                name: 'isLogged',
+                signature: 'isLogged(): bool',
+                description: 'Проверяет, авторизован ли текущий пользователь',
+                parameters: [],
+                return_type: 'bool',
+                example: `if (!cmsUser::isLogged()) {
+    return $this->redirectToLogin();
+}`,
+            },
+            {
+                name: 'isAdmin',
+                signature: 'isAdmin(): bool',
+                description: 'Проверяет, является ли текущий пользователь администратором',
+                parameters: [],
+                return_type: 'bool',
+                example: `if (cmsUser::isAdmin()) {
+    // действия для админа
+}`,
+            },
+            {
+                name: 'get',
+                signature: 'get(string $key): mixed',
+                description: 'Получить свойство пользователя (id, email, nickname, groups и т.д.)',
+                parameters: [{ name: '$key', type: 'string', description: 'Имя свойства', required: true }],
+                return_type: 'mixed',
+                example: `$user_id = cmsUser::get('id');
+$groups = cmsUser::get('groups');`,
+            },
+            {
+                name: 'isInGroup',
+                signature: 'isInGroup(int $group_id): bool',
+                description: 'Проверяет членство пользователя в группе',
+                parameters: [{ name: '$group_id', type: 'int', description: 'ID группы', required: true }],
+                return_type: 'bool',
+                example: `if (!$this->cms_user->isInGroup(GUEST_GROUP_ID)) {
+    // не гость
+}`,
+            },
+            {
+                name: 'setUPS',
+                signature: 'setUPS(string $key, mixed $data, int $user_id = null): bool',
+                description: 'Устанавливает пользовательскую настройку (User Personal Setting)',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Ключ настройки', required: true },
+                    { name: '$data', type: 'mixed', description: 'Значение', required: true },
+                    {
+                        name: '$user_id',
+                        type: 'int',
+                        description: 'ID пользователя (по умолчанию текущий)',
+                        required: false,
+                    },
+                ],
+                return_type: 'bool',
+                example: `cmsUser::setUPS('notify_email', ['freq' => 'daily'], $user_id);`,
+            },
+            {
+                name: 'getUPS',
+                signature: 'getUPS(string $key, int $user_id = null): mixed',
+                description: 'Получает пользовательскую настройку',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Ключ настройки', required: true },
+                    { name: '$user_id', type: 'int', description: 'ID пользователя', required: false },
+                ],
+                return_type: 'mixed',
+                example: `$settings = cmsUser::getUPS('notify_email', $user_id);`,
+            },
+            {
+                name: 'addSessionMessage',
+                signature: "addSessionMessage(string $message, string $class = 'info', bool $is_keep = false): void",
+                description: 'Добавляет сообщение в сессию для отображения после редиректа',
+                parameters: [
+                    { name: '$message', type: 'string', description: 'Текст сообщения', required: true },
+                    {
+                        name: '$class',
+                        type: 'string',
+                        description: 'CSS-класс: info, success, warning, error',
+                        default: "'info'",
+                    },
+                    {
+                        name: '$is_keep',
+                        type: 'bool',
+                        description: 'Сохранить после показа',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'void',
+                example: `cmsUser::addSessionMessage('Профиль обновлён!', 'success');
+return $this->redirect(href_to('profile'));`,
+            },
+            {
+                name: 'getPermissionValue',
+                signature: 'getPermissionValue(string $subject, string $permission): mixed',
+                description: 'Получить значение разрешения для пользователя',
+                parameters: [
+                    {
+                        name: '$subject',
+                        type: 'string',
+                        description: 'Субъект (имя контроллера)',
+                        required: true,
+                    },
+                    { name: '$permission', type: 'string', description: 'Имя разрешения', required: true },
+                ],
+                return_type: 'mixed',
+                example: `$can_edit = cmsUser::getPermissionValue('catalog', 'edit');`,
+            },
+            {
+                name: 'isAllowed',
+                signature: 'isAllowed(string $subject, string $permission, mixed $value = true, bool $is_admin_strict = false): bool',
+                description: 'Проверяет, разрешено ли действие',
+                parameters: [
+                    { name: '$subject', type: 'string', description: 'Субъект', required: true },
+                    { name: '$permission', type: 'string', description: 'Разрешение', required: true },
+                    { name: '$value', type: 'mixed', description: 'Ожидаемое значение', default: 'true' },
+                    {
+                        name: '$is_admin_strict',
+                        type: 'bool',
+                        description: 'Не давать админу особые права',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'bool',
+                example: `if (!cmsUser::isAllowed('catalog', 'add_item')) {
+    cmsCore::error404();
+}`,
+            },
+            {
+                name: 'isDenied',
+                signature: 'isDenied(string $subject, string $permission, mixed $value = true, bool $is_admin_strict = false): bool',
+                description: 'Проверяет, запрещено ли действие',
+                parameters: [
+                    { name: '$subject', type: 'string', description: 'Субъект', required: true },
+                    { name: '$permission', type: 'string', description: 'Разрешение', required: true },
+                    { name: '$value', type: 'mixed', description: 'Проверяемое значение', default: 'true' },
+                    {
+                        name: '$is_admin_strict',
+                        type: 'bool',
+                        description: 'Строгая проверка',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'bool',
+                example: `if (cmsUser::isDenied('content', 'is_premium', 1)) {
+    return cmsCore::error404();
+}`,
+            },
+            {
+                name: 'autoLogin',
+                signature: 'autoLogin(string $auth_token): int',
+                description: 'Авторизует пользователя по cookie-токену. Вызывается автоматически при загрузке cmsUser.',
+                parameters: [
+                    {
+                        name: '$auth_token',
+                        type: 'string',
+                        description: '128-символьный SHA512 токен',
+                        required: true,
+                    },
+                ],
+                return_type: 'int',
+                example: `// Вызывается автоматически в конструкторе cmsUser`,
+            },
+            {
+                name: 'setCookie',
+                signature: "setCookie(string $key, string $value, int $time = 3600, string $path = '/', bool $http_only = true, string $domain = ''): bool",
+                description: "Устанавливает cookie с префиксом 'icms['",
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Имя cookie', required: true },
+                    { name: '$value', type: 'string', description: 'Значение', required: true },
+                    { name: '$time', type: 'int', description: 'Время жизни в секундах', default: '3600' },
+                    { name: '$path', type: 'string', description: 'Путь', default: "'/'" },
+                    {
+                        name: '$http_only',
+                        type: 'bool',
+                        description: 'Доступен только для PHP',
+                        default: 'true',
+                    },
+                    { name: '$domain', type: 'string', description: 'Домен', default: "''" },
+                ],
+                return_type: 'bool',
+                example: `cmsUser::setCookie('my_cookie', 'value', 86400);`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsPermissions — система прав доступа
+    // system/core/permissions.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsPermissions',
+        class: 'cmsPermissions',
+        description: 'Система разрешений и прав доступа. Проверяет membership в группах, лимиты, флаги.',
+        access: '$this->cms_user->perms — в контроллере. cmsUser::getInstance()->perms',
+        methods: [
+            {
+                name: 'getPermissionValue',
+                signature: 'getPermissionValue(string $subject, string $permission): mixed',
+                description: 'Возвращает значение конкретного разрешения для субъекта',
+                parameters: [
+                    {
+                        name: '$subject',
+                        type: 'string',
+                        description: 'Субъект (имя контроллера)',
+                        required: true,
+                    },
+                    {
+                        name: '$permission',
+                        type: 'string',
+                        description: 'Название разрешения',
+                        required: true,
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$value = $this->cms_user->perms->getPermissionValue('catalog', 'max_items');`,
+            },
+            {
+                name: 'isDenied',
+                signature: 'isDenied(string $subject, string $permission, mixed $value = true, bool $is_admin_strict = false): bool',
+                description: 'Проверяет запрет: принадлежит ли значение указанному',
+                parameters: [
+                    { name: '$subject', type: 'string', description: 'Субъект', required: true },
+                    { name: '$permission', type: 'string', description: 'Разрешение', required: true },
+                    { name: '$value', type: 'mixed', description: 'Запрещающее значение', default: 'true' },
+                    {
+                        name: '$is_admin_strict',
+                        type: 'bool',
+                        description: 'Не пропускать админа',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'bool',
+                example: `if ($this->cms_user->perms->isDenied('catalog', 'is_locked', 1)) {
+    return cmsCore::error404();
+}`,
+            },
+            {
+                name: 'isAllowed',
+                signature: 'isAllowed(string $subject, string $permission, mixed $value = true, bool $is_admin_strict = false): bool',
+                description: 'Проверяет разрешение: совпадает ли значение с ожидаемым',
+                parameters: [
+                    { name: '$subject', type: 'string', description: 'Субъект', required: true },
+                    { name: '$permission', type: 'string', description: 'Разрешение', required: true },
+                    { name: '$value', type: 'mixed', description: 'Ожидаемое значение', default: 'true' },
+                    {
+                        name: '$is_admin_strict',
+                        type: 'bool',
+                        description: 'Не пропускать админа',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'bool',
+                example: `if (!$this->cms_user->perms->isAllowed('catalog', 'add')) {
+    cmsUser::addSessionMessage('Нет прав на добавление', 'error');
+    $this->redirectBack();
+}`,
+            },
+            {
+                name: 'isPermittedLimitReached',
+                signature: 'isPermittedLimitReached(string $subject, string $permission, int $current_value = 0, bool $is_admin_strict = false): bool',
+                description: 'Проверяет, достигнут ли лимит (current >= limit)',
+                parameters: [
+                    { name: '$subject', type: 'string', description: 'Субъект', required: true },
+                    {
+                        name: '$permission',
+                        type: 'string',
+                        description: 'Лимит (например, max_items)',
+                        required: true,
+                    },
+                    { name: '$current_value', type: 'int', description: 'Текущее значение', default: '0' },
+                    {
+                        name: '$is_admin_strict',
+                        type: 'bool',
+                        description: 'Не пропускать админа',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'bool',
+                example: `if ($this->cms_user->perms->isPermittedLimitReached('catalog', 'max_images', $image_count)) {
+    cmsUser::addSessionMessage('Достигнут лимит загрузки изображений', 'warning');
+}`,
+            },
+            {
+                name: 'addRule',
+                signature: 'addRule(string $controller, array $rule): int|false',
+                description: 'Добавляет новое правило доступа в БД (статический метод)',
+                parameters: [
+                    { name: '$controller', type: 'string', description: 'Имя контроллера', required: true },
+                    {
+                        name: '$rule',
+                        type: 'array',
+                        description: 'Массив: name, type (flag/list/number), options',
+                        required: true,
+                    },
+                ],
+                return_type: 'int|false',
+                example: `cmsPermissions::addRule('catalog', [
+    'name'    => 'use_api',
+    'type'    => 'flag',
+    'options' => ''
+]);`,
+            },
+            {
+                name: 'getRulesList',
+                signature: 'getRulesList(string $controller): array',
+                description: 'Возвращает список всех доступных правил доступа для контроллера',
+                parameters: [
+                    { name: '$controller', type: 'string', description: 'Имя контроллера', required: true },
+                ],
+                return_type: 'array',
+                example: `$rules = cmsPermissions::getRulesList('catalog');`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsDatabase — прямые SQL операции
+    // system/core/database.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsDatabase',
+        class: 'cmsDatabase',
+        description: 'Низкоуровневый класс работы с MySQL. Прямые запросы, транзакции, работа с таблицами. Обычно используется через cmsModel.',
+        access: '$this->cms_core->db — в контроллере. cmsCore::getInstance()->db.',
+        methods: [
+            {
+                name: 'query',
+                signature: 'query(string $sql, array|string $params = false, bool $quiet = false): mixed',
+                description: 'Выполняет SQL запрос с подстановкой параметров через vsprintf',
+                parameters: [
+                    {
+                        name: '$sql',
+                        type: 'string',
+                        description: 'SQL запрос с %s плейсхолдерами',
+                        required: true,
+                    },
+                    {
+                        name: '$params',
+                        type: 'array|string',
+                        description: 'Параметры для подстановки',
+                        required: false,
+                    },
+                    {
+                        name: '$quiet',
+                        type: 'bool',
+                        description: 'Не выводить ошибку при неудаче',
+                        required: false,
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$result = $this->cms_core->db->query(
+    "SELECT * FROM {#}my_table WHERE id = %d AND is_active = %d",
+    [$id, 1]
+);`,
+            },
+            {
+                name: 'insert',
+                signature: 'insert(string $table, array $data, bool $skip_check_fields = false, bool $array_as_json = false, bool $ignore = false): int|bool',
+                description: 'INSERT запрос. Возвращает ID вставленной записи.',
+                parameters: [
+                    {
+                        name: '$table',
+                        type: 'string',
+                        description: 'Имя таблицы без префикса',
+                        required: true,
+                    },
+                    {
+                        name: '$data',
+                        type: 'array',
+                        description: 'Ассоциативный массив поле => значение',
+                        required: true,
+                    },
+                    {
+                        name: '$skip_check_fields',
+                        type: 'bool',
+                        description: 'Не проверять поля в таблице',
+                        default: 'false',
+                    },
+                    {
+                        name: '$array_as_json',
+                        type: 'bool',
+                        description: 'Массивы как JSON (иначе YAML)',
+                        default: 'false',
+                    },
+                    { name: '$ignore', type: 'bool', description: 'INSERT IGNORE', default: 'false' },
+                ],
+                return_type: 'int|bool',
+                example: `$id = $this->cms_core->db->insert('my_items', [
+    'title'    => $title,
+    'user_id'  => $this->cms_user->id,
+    'date_add' => date('Y-m-d H:i:s')
+]);`,
+            },
+            {
+                name: 'update',
+                signature: 'update(string $table, string $where, array $data, bool $skip_check_fields = false, bool $array_as_json = false): bool',
+                description: 'UPDATE запрос',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$where', type: 'string', description: 'WHERE условие', required: true },
+                    { name: '$data', type: 'array', description: 'Данные для обновления', required: true },
+                ],
+                return_type: 'bool',
+                example: `$this->cms_core->db->update(
+    'my_items',
+    'id = ' . (int)$id,
+    ['title' => $title, 'is_pub' => 1]
+);`,
+            },
+            {
+                name: 'delete',
+                signature: 'delete(string $table_name, string $where): bool',
+                description: 'DELETE запрос',
+                parameters: [
+                    { name: '$table_name', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$where', type: 'string', description: 'WHERE условие', required: true },
+                ],
+                return_type: 'bool',
+                example: `$this->cms_core->db->delete('my_items', 'id = ' . (int)$id);`,
+            },
+            {
+                name: 'getRow',
+                signature: "getRow(string $table, string $where = '1', string $fields = '*', string $order = ''): array|false",
+                description: 'Получает одну строку из таблицы',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$where', type: 'string', description: 'WHERE условие', default: "'1'" },
+                    { name: '$fields', type: 'string', description: 'Список полей', default: "'*'" },
+                    { name: '$order', type: 'string', description: 'ORDER BY', default: "''" },
+                ],
+                return_type: 'array|false',
+                example: `$item = $this->cms_core->db->getRow('my_items', 'id = ' . (int)$id);`,
+            },
+            {
+                name: 'getRows',
+                signature: "getRows(string $table_name, string $where = '1', string $fields = '*', string $order = 'id ASC'): array|false",
+                description: 'Получает все строки из таблицы',
+                parameters: [
+                    { name: '$table_name', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$where', type: 'string', description: 'WHERE условие', default: "'1'" },
+                    { name: '$fields', type: 'string', description: 'Список полей', default: "'*'" },
+                    { name: '$order', type: 'string', description: 'ORDER BY', default: "'id ASC'" },
+                ],
+                return_type: 'array|false',
+                example: `$items = $this->cms_core->db->getRows('my_items', 'is_pub = 1', '*', 'date_add DESC');`,
+            },
+            {
+                name: 'getField',
+                signature: "getField(string $table, string $where, string $field, string $order = ''): mixed",
+                description: 'Получает значение одного поля',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$where', type: 'string', description: 'WHERE условие', required: true },
+                    { name: '$field', type: 'string', description: 'Имя поля', required: true },
+                    { name: '$order', type: 'string', description: 'ORDER BY', default: "''" },
+                ],
+                return_type: 'mixed',
+                example: `$title = $this->cms_core->db->getField('my_items', 'id = ' . (int)$id, 'title');`,
+            },
+            {
+                name: 'getRowsCount',
+                signature: "getRowsCount(string $table, string $where = '1', int $limit = false): int|false",
+                description: 'Возвращает количество строк',
+                parameters: [
+                    { name: '$table', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$where', type: 'string', description: 'WHERE условие', default: "'1'" },
+                    { name: '$limit', type: 'int', description: 'Лимит', default: 'false' },
+                ],
+                return_type: 'int|false',
+                example: `$total = $this->cms_core->db->getRowsCount('my_items', 'is_pub = 1');`,
+            },
+            {
+                name: 'beginTransaction',
+                signature: 'beginTransaction(): cmsDatabase',
+                description: 'Начинает транзакцию',
+                parameters: [],
+                return_type: 'cmsDatabase',
+                example: `$this->cms_core->db->beginTransaction();
+// ... операции ...
+$this->cms_core->db->commit();`,
+            },
+            {
+                name: 'commit',
+                signature: 'commit(): cmsDatabase',
+                description: 'Фиксирует транзакцию',
+                parameters: [],
+                return_type: 'cmsDatabase',
+                example: `$this->cms_core->db->commit();`,
+            },
+            {
+                name: 'rollback',
+                signature: 'rollback(): cmsDatabase',
+                description: 'Откатывает транзакцию',
+                parameters: [],
+                return_type: 'cmsDatabase',
+                example: `$this->cms_core->db->rollback();`,
+            },
+            {
+                name: 'lastId',
+                signature: 'lastId(): int',
+                description: 'Возвращает ID последней вставленной записи',
+                parameters: [],
+                return_type: 'int',
+                example: `$id = $this->cms_core->db->lastId();`,
+            },
+            {
+                name: 'escape',
+                signature: 'escape(string|array $string): string|array',
+                description: 'Экранирует строку или массив для SQL',
+                parameters: [
+                    {
+                        name: '$string',
+                        type: 'string|array',
+                        description: 'Строка или массив',
+                        required: true,
+                    },
+                ],
+                return_type: 'string|array',
+                example: `$safe_value = $this->cms_core->db->escape($user_input);`,
+            },
+            {
+                name: 'prepareValue',
+                signature: 'prepareValue(string $field, mixed $value, bool $array_as_json = false): string',
+                description: 'Подготавливает значение поля для SQL запроса (экранирование, кавычки, NULL)',
+                parameters: [
+                    {
+                        name: '$field',
+                        type: 'string',
+                        description: 'Имя поля (для определения типа)',
+                        required: true,
+                    },
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                    {
+                        name: '$array_as_json',
+                        type: 'bool',
+                        description: 'Массив как JSON',
+                        default: 'false',
+                    },
+                ],
+                return_type: 'string',
+                example: `// Используется внутренне insert/update`,
+            },
+            {
+                name: 'autocommitOff',
+                signature: 'autocommitOff(): cmsDatabase',
+                description: 'Отключает автокоммит транзакций',
+                parameters: [],
+                return_type: 'cmsDatabase',
+                example: `$this->cms_core->db->autocommitOff();`,
+            },
+            {
+                name: 'autocommitOn',
+                signature: 'autocommitOn(): cmsDatabase',
+                description: 'Включает автокоммит транзакций',
+                parameters: [],
+                return_type: 'cmsDatabase',
+                example: `$this->cms_core->db->autocommitOn();`,
+            },
+            {
+                name: 'isTableExists',
+                signature: 'isTableExists(string $table_name): bool',
+                description: 'Проверяет существование таблицы',
+                parameters: [
+                    {
+                        name: '$table_name',
+                        type: 'string',
+                        description: 'Имя таблицы без префикса',
+                        required: true,
+                    },
+                ],
+                return_type: 'bool',
+                example: `if (!$this->cms_core->db->isTableExists('my_table')) {
+    // создать таблицу
+}`,
+            },
+            {
+                name: 'getTableFields',
+                signature: 'getTableFields(string $table_name, bool $use_cache = true): array',
+                description: 'Возвращает список полей таблицы',
+                parameters: [
+                    { name: '$table_name', type: 'string', description: 'Имя таблицы', required: true },
+                    { name: '$use_cache', type: 'bool', description: 'Использовать кэш', default: 'true' },
+                ],
+                return_type: 'array',
+                example: `$fields = $this->cms_core->db->getTableFields('my_items');`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsPaginator — пагинация
+    // system/core/paginator.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsPaginator',
+        class: 'cmsPaginator',
+        description: 'Генерация HTML пагинации. Создаёт массив страниц и URL для навигации.',
+        access: 'new cmsPaginator($total, $perpage, $current_page, $base_uri, $query = [])',
+        methods: [
+            {
+                name: 'setMaxPagesToShow',
+                signature: 'setMaxPagesToShow(int $max_show_pages): cmsPaginator',
+                description: 'Максимальное количество видимых страниц',
+                parameters: [
+                    {
+                        name: '$max_show_pages',
+                        type: 'int',
+                        description: 'Количество страниц',
+                        required: true,
+                    },
+                ],
+                return_type: 'cmsPaginator',
+                example: `$paginator = new cmsPaginator($total, 20, $page, $base_url)->setMaxPagesToShow(7);`,
+            },
+            {
+                name: 'setPageParamName',
+                signature: 'setPageParamName(string $page_param_name): cmsPaginator',
+                description: 'Имя GET параметра номера страницы',
+                parameters: [
+                    {
+                        name: '$page_param_name',
+                        type: 'string',
+                        description: 'Имя параметра',
+                        default: "'page'",
+                    },
+                ],
+                return_type: 'cmsPaginator',
+                example: `->setPageParamName('page_num')`,
+            },
+            {
+                name: 'getRendered',
+                signature: 'getRendered(): string',
+                description: 'Возвращает готовый HTML пагинации',
+                parameters: [],
+                return_type: 'string',
+                example: `<?= $paginator->getRendered() ?>`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsResponse — HTTP ответ
+    // system/core/response.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsResponse',
+        class: 'cmsResponse',
+        description: 'Управление HTTP ответом: заголовки, body, отправка файлов, JSON.',
+        access: '$this->cms_core->response — в контроллере. cmsResponse::getInstance() — глобально.',
+        methods: [
+            {
+                name: 'setContent',
+                signature: 'setContent(array|string $content): cmsResponse',
+                description: 'Устанавливает тело ответа',
+                parameters: [
+                    {
+                        name: '$content',
+                        type: 'array|string',
+                        description: 'HTML или массив для JSON',
+                        required: true,
+                    },
+                ],
+                return_type: 'cmsResponse',
+                example: `$this->cms_core->response->setContent('<h1>Hello</h1>');`,
+            },
+            {
+                name: 'setStatusCode',
+                signature: 'setStatusCode(int $status_code): cmsResponse',
+                description: 'Устанавливает HTTP статус-код',
+                parameters: [
+                    {
+                        name: '$status_code',
+                        type: 'int',
+                        description: 'Код (200, 404, 403 и т.д.)',
+                        required: true,
+                    },
+                ],
+                return_type: 'cmsResponse',
+                example: `$this->cms_core->response->setStatusCode(403);`,
+            },
+            {
+                name: 'setHeader',
+                signature: 'setHeader(string $name, string $value): cmsResponse',
+                description: 'Добавляет HTTP заголовок',
+                parameters: [
+                    { name: '$name', type: 'string', description: 'Имя заголовка', required: true },
+                    { name: '$value', type: 'string', description: 'Значение', required: true },
+                ],
+                return_type: 'cmsResponse',
+                example: `$this->cms_core->response->setHeader('X-Custom-Header', 'value');`,
+            },
+            {
+                name: 'send',
+                signature: 'send(bool $exit = true): void',
+                description: 'Отправляет заголовки и контент, завершает выполнение',
+                parameters: [
+                    { name: '$exit', type: 'bool', description: 'Вызывать exit()', default: 'true' },
+                ],
+                return_type: 'void',
+                example: `$this->cms_core->response->send();`,
+            },
+            {
+                name: 'sendFile',
+                signature: 'sendFile(string $file_path, array $headers = []): void',
+                description: 'Отправляет файл как HTTP ответ',
+                parameters: [
+                    { name: '$file_path', type: 'string', description: 'Путь к файлу', required: true },
+                    {
+                        name: '$headers',
+                        type: 'array',
+                        description: 'Дополнительные заголовки',
+                        default: '[]',
+                    },
+                ],
+                return_type: 'void',
+                example: `$this->cms_core->response->sendFile($file_path, [
+    'Content-Disposition' => 'attachment; filename="file.pdf"'
+]);`,
+            },
+            {
+                name: 'sendAndExit',
+                signature: 'sendAndExit(): void',
+                description: 'Отправляет ответ и завершает выполнение',
+                parameters: [],
+                return_type: 'void',
+                example: `$this->cms_core->response->sendAndExit();`,
+            },
+            {
+                name: 'getNonce',
+                signature: 'getNonce(): string',
+                description: 'Возвращает nonce для CSP (генерируется один раз)',
+                parameters: [],
+                return_type: 'string',
+                example: `$nonce = cmsResponse::getNonce();
+// Использовать в inline-скриптах: <script nonce="<?= $nonce ?>">`,
+            },
+            {
+                name: 'renderJSON',
+                signature: 'renderJSON(array $data): void',
+                description: 'Отправляет JSON ответ и завершает выполнение',
+                parameters: [
+                    { name: '$data', type: 'array', description: 'Данные для JSON', required: true },
+                ],
+                return_type: 'void',
+                example: `$this->cms_core->response->renderJSON(['success' => true, 'id' => $id]);`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsImages — работа с изображениями
+    // system/core/images.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsImages',
+        class: 'cmsImages',
+        description: 'Класс для работы с изображениями: ресайз, водяные знаки, превью, конвертация.',
+        access: 'cmsImages::getInstance() — глобально. cmsCore::getInstance()->images',
+        methods: [
+            {
+                name: 'resize',
+                signature: 'resize(string $source_file, string $dest_file, int $width, int $height, bool $is_update_exif = true): bool',
+                description: 'Изменяет размер изображения',
+                parameters: [
+                    { name: '$source_file', type: 'string', description: 'Исходный файл', required: true },
+                    { name: '$dest_file', type: 'string', description: 'Результат', required: true },
+                    { name: '$width', type: 'int', description: 'Новая ширина', required: true },
+                    { name: '$height', type: 'int', description: 'Новая высота', required: true },
+                    { name: '$is_update_exif', type: 'bool', description: 'Обновить EXIF', default: 'true' },
+                ],
+                return_type: 'bool',
+                example: `cmsImages::getInstance()->resize($src, $dst, 800, 600);`,
+            },
+            {
+                name: 'getHandledFilePath',
+                signature: 'getHandledFilePath(string $file_path, string $preset_name): string',
+                description: 'Возвращает путь к пресету изображения (автоматически создаёт превью)',
+                parameters: [
+                    { name: '$file_path', type: 'string', description: 'Путь к оригиналу', required: true },
+                    { name: '$preset_name', type: 'string', description: 'Имя пресета', required: true },
+                ],
+                return_type: 'string',
+                example: `$thumb_path = cmsImages::getInstance()->getHandledFilePath($img, 'small');`,
+            },
+            {
+                name: 'isImageFile',
+                signature: 'isImageFile(string $file_path): bool',
+                description: 'Проверяет, является ли файл изображением',
+                parameters: [
+                    { name: '$file_path', type: 'string', description: 'Путь к файлу', required: true },
+                ],
+                return_type: 'bool',
+                example: `if (cmsImages::getInstance()->isImageFile($path)) {
+    // это изображение
+}`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsMailer — отправка email
+    // system/core/mailer.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsMailer',
+        class: 'cmsMailer',
+        description: 'Отправка email. Поддерживает SMTP, шаблоны писем, вложения.',
+        access: 'cmsCore::getInstance()->mailer — в контроллере. new cmsMailer()',
+        methods: [
+            {
+                name: 'send',
+                signature: 'send(array $letter): bool',
+                description: 'Отправляет письмо. letter = [to, from, from_name, subject, body, attachments, is_html]',
+                parameters: [
+                    { name: '$letter', type: 'array', description: 'Массив данных письма', required: true },
+                ],
+                return_type: 'bool',
+                example: `return cmsCore::getInstance()->mailer->send([
+    'to'      => $email,
+    'subject' => 'Подтверждение регистрации',
+    'body'    => $html_content,
+    'is_html' => true
+]);`,
+            },
+            {
+                name: 'addLetter',
+                signature: 'addLetter(array $letter): cmsMailer',
+                description: 'Добавляет письмо в очередь на отправку',
+                parameters: [
+                    { name: '$letter', type: 'array', description: 'Массив письма', required: true },
+                ],
+                return_type: 'cmsMailer',
+                example: `cmsCore::getInstance()->mailer->addLetter([
+    'to'      => $email,
+    'subject' => 'Привет!',
+    'body'    => 'Добро пожаловать на сайт!'
+]);`,
+            },
+            {
+                name: 'queueSending',
+                signature: 'queueSending(): void',
+                description: 'Отправляет все письма из очереди',
+                parameters: [],
+                return_type: 'void',
+                example: `cmsCore::getInstance()->mailer->queueSending();`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsGrid — рендеринг гридов
+    // system/core/grid.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsGrid',
+        class: 'cmsGrid',
+        description: 'Класс для рендеринга табличных данных (используется в бэкенде для списков).',
+        access: 'new cmsGrid($options) — создание грида в бэкенде',
+        methods: [
+            {
+                name: 'setColumns',
+                signature: 'setColumns(array $columns): cmsGrid',
+                description: 'Устанавливает колонки грида',
+                parameters: [
+                    { name: '$columns', type: 'array', description: 'Массив колонок', required: true },
+                ],
+                return_type: 'cmsGrid',
+                example: `$grid = new cmsGrid($options);
+$grid->setColumns(['id', 'title', 'date_pub']);`,
+            },
+            {
+                name: 'render',
+                signature: 'render(array $rows): string',
+                description: 'Рендерит грид с данными, возвращает HTML',
+                parameters: [
+                    { name: '$rows', type: 'array', description: 'Массив строк данных', required: true },
+                ],
+                return_type: 'string',
+                example: `$html = $grid->render($items);`,
+            },
+            {
+                name: 'makeDataItem',
+                signature: 'makeDataItem(array $item): array',
+                description: 'Обрабатывает одну строку данных (фильтры, преобразования)',
+                parameters: [
+                    { name: '$item', type: 'array', description: 'Строка данных', required: true },
+                ],
+                return_type: 'array',
+                example: `$item = $grid->makeDataItem($row);`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsFormField — базовый класс полей формы
+    // system/core/formfield.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsFormField',
+        class: 'cmsFormField',
+        description: 'Базовый класс для всех типов полей форм. Поля используются в cmsForm.',
+        access: 'Используется автоматически cmsForm при рендеринге',
+        methods: [
+            {
+                name: 'getOptions',
+                signature: 'getOptions(): array',
+                description: 'Возвращает настройки поля',
+                parameters: [],
+                return_type: 'array',
+                example: `$opts = $form_field->getOptions();`,
+            },
+            {
+                name: 'parse',
+                signature: 'parse(array $data): mixed',
+                description: 'Парсит значение поля из данных формы',
+                parameters: [
+                    { name: '$data', type: 'array', description: 'POST/GET данные', required: true },
+                ],
+                return_type: 'mixed',
+                example: `$value = $field->parse($this->request->data('post'));`,
+            },
+            {
+                name: 'store',
+                signature: 'store(mixed $value, cmsModel $model): mixed',
+                description: 'Сохраняет значение поля в БД',
+                parameters: [
+                    { name: '$value', type: 'mixed', description: 'Значение', required: true },
+                    { name: '$model', type: 'cmsModel', description: 'Модель', required: true },
+                ],
+                return_type: 'mixed',
+                example: `$stored_value = $field->store($value, $this->model);`,
+            },
+            {
+                name: 'getInput',
+                signature: 'getInput(mixed $value): string',
+                description: 'Возвращает HTML input для поля',
+                parameters: [
+                    { name: '$value', type: 'mixed', description: 'Текущее значение', required: true },
+                ],
+                return_type: 'string',
+                example: `echo $field->getInput($item['field_value']);`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsRequest — HTTP запрос (дополнение)
+    // system/core/request.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsRequest (доп.)',
+        class: 'cmsRequest',
+        description: 'Дополнительные методы cmsRequest: работа с заголовками, IP, проверки типа устройства',
+        access: '$this->request — в контроллере',
+        methods: [
+            {
+                name: 'getClientIp',
+                signature: 'getClientIp(bool $safe = true): string',
+                description: 'Получить IP адрес клиента (с учётом прокси)',
+                parameters: [
+                    {
+                        name: '$safe',
+                        type: 'bool',
+                        description: 'Безопасный режим (не доверяет X-Forwarded)',
+                        default: 'true',
+                    },
+                ],
+                return_type: 'string',
+                example: `$ip = $this->request->getClientIp();`,
+            },
+            {
+                name: 'isMobile',
+                signature: 'isMobile(): bool',
+                description: 'Проверяет, мобильное ли устройство',
+                parameters: [],
+                return_type: 'bool',
+                example: `if ($this->request->isMobile()) {
+    // мобильная версия
+}`,
+            },
+            {
+                name: 'isSecure',
+                signature: 'isSecure(): bool',
+                description: 'Проверяет HTTPS соединение',
+                parameters: [],
+                return_type: 'bool',
+                example: `if (!$this->request->isSecure()) {
+    $this->redirect('https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
+}`,
+            },
+            {
+                name: 'getUserAgent',
+                signature: 'getUserAgent(): string',
+                description: 'Возвращает User-Agent браузера',
+                parameters: [],
+                return_type: 'string',
+                example: `$ua = $this->request->getUserAgent();`,
+            },
+            {
+                name: 'hasHeader',
+                signature: 'hasHeader(string $name): bool',
+                description: 'Проверяет наличие HTTP заголовка',
+                parameters: [
+                    { name: '$name', type: 'string', description: 'Имя заголовка', required: true },
+                ],
+                return_type: 'bool',
+                example: `if ($this->request->hasHeader('X-Requested-With')) {
+    // AJAX
+}`,
+            },
+            {
+                name: 'getHeader',
+                signature: 'getHeader(string $name, mixed $default = null): mixed',
+                description: 'Получить значение HTTP заголовка',
+                parameters: [
+                    { name: '$name', type: 'string', description: 'Имя заголовка', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        required: false,
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$token = $this->request->getHeader('Authorization');`,
+            },
+        ],
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // cmsConfig (доп.) — расширенные методы
+    // system/core/config.php
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+        name: 'cmsConfig (доп.)',
+        class: 'cmsConfig',
+        description: 'Дополнительные методы cmsConfig: пути, константы, управление конфигом',
+        access: "cmsConfig::getInstance() — глобально. cmsConfig::get('key') — статический доступ",
+        methods: [
+            {
+                name: 'get',
+                signature: 'get(string $key, mixed $default = null): mixed',
+                description: 'Получить значение конфига (статический шорткат)',
+                parameters: [
+                    { name: '$key', type: 'string', description: 'Ключ конфига', required: true },
+                    {
+                        name: '$default',
+                        type: 'mixed',
+                        description: 'Значение по умолчанию',
+                        required: false,
+                    },
+                ],
+                return_type: 'mixed',
+                example: `$template = cmsConfig::get('template', 'default');
+$db_prefix = cmsConfig::get('db_prefix');`,
+            },
+            {
+                name: 'getAll',
+                signature: 'getAll(): array',
+                description: 'Возвращает все конфигурационные настройки',
+                parameters: [],
+                return_type: 'array',
+                example: `$config = cmsConfig::getInstance()->getAll();`,
+            },
+            {
+                name: 'getControllersMapping',
+                signature: 'getControllersMapping(): array',
+                description: 'Возвращает маппинг контроллеров (для ремапа URL)',
+                parameters: [],
+                return_type: 'array',
+                example: `$map = cmsConfig::getControllersMapping();`,
+            },
+            {
+                name: 'isReady',
+                signature: 'isReady(): bool',
+                description: 'Проверяет, загружена ли конфигурация',
+                parameters: [],
+                return_type: 'bool',
+                example: `if (!cmsConfig::getInstance()->isReady()) {
+    // конфиг не загружен
+}`,
+            },
+            {
+                name: 'getUploadsPath',
+                signature: 'getUploadsPath(): string',
+                description: 'Возвращает абсолютный путь к папке загрузок',
+                parameters: [],
+                return_type: 'string',
+                example: `$upload_path = cmsConfig::getInstance()->getUploadsPath();`,
+            },
+            {
+                name: 'getCachePath',
+                signature: 'getCachePath(): string',
+                description: 'Возвращает абсолютный путь к папке кэша',
+                parameters: [],
+                return_type: 'string',
+                example: `$cache_path = cmsConfig::getInstance()->getCachePath();`,
+            },
+        ],
+    },
+];
+const curatedComponentsByClass = new Map(curatedComponents.map(component => [component.class, component]));
+const sourceComponentClasses = new Set(components_source_js_1.sourceComponents.map(component => component.class));
+exports.components = [
+    ...components_source_js_1.sourceComponents.map(source => {
+        const curated = curatedComponentsByClass.get(source.class);
+        const curatedMethods = new Map(curated?.methods.map(method => [method.name, method]) ?? []);
+        return {
+            name: source.name,
+            class: source.class,
+            description: curated?.description || source.description || `Класс ${source.class} InstantCMS`,
+            access: curated?.access || `Используйте ${source.class} согласно API InstantCMS`,
+            source: {
+                repository: 'https://github.com/instantsoft/icms2',
+                file: source.file,
+                extends: source.extends,
+            },
+            methods: source.methods.map(method => {
+                const documentation = curatedMethods.get(method.name);
+                return {
+                    ...method,
+                    description: documentation?.description || method.description,
+                    parameters: method.parameters.map(parameter => {
+                        const documented = documentation?.parameters.find(item => item.name === parameter.name);
+                        return documented ? { ...parameter, ...documented } : parameter;
+                    }),
+                    example: documentation?.example || '',
+                };
+            }),
+        };
+    }),
+    ...curatedComponents.filter(component => !sourceComponentClasses.has(component.class)),
+].sort((left, right) => left.name.localeCompare(right.name));