@maxisoft/instantcms-mcp 1.2.3

package/dist/tools/grid-tool.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldGrid = scaffoldGrid;
+function scaffoldGrid(opts) {
+    const name = opts.addon_name.toLowerCase().replace(/[^a-z0-9_]/g, '_');
+    const gridName = opts.grid_name || 'items';
+    const GridName = gridName.split('_').map(capitalize).join('');
+    const files = {};
+    const ctrl = `package/system/controllers/${name}`;
+    const gridFile = `${ctrl}/backend/grids/grid_${gridName}.php`;
+    files[gridFile] = generateGrid(name, gridName, opts.columns, opts.options, opts.actions);
+    files[`${ctrl}/manifest.xml`] = generateManifest(name, GridName);
+    return {
+        addon_name: name,
+        grid_name: gridName,
+        function_name: `grid_${gridName}`,
+        file_path: gridFile,
+        files,
+        columns_count: opts.columns.length,
+        options: opts.options || {},
+        structure_notes: [
+            `Грид: ${gridFile}`,
+            `Функция: grid_${gridName}($controller)`,
+            `Используйте в listgrid trait: $this->grid_name = '${gridName}'`,
+        ],
+    };
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function generateGrid(name, gridName, columns, options, actions) {
+    const opts = options || {};
+    const isDraggable = opts.is_draggable ?? false;
+    const isSortable = opts.is_sortable ?? true;
+    const isFilter = opts.is_filter ?? true;
+    const isPagination = opts.is_pagination ?? true;
+    const isSelectable = opts.is_selectable ?? false;
+    const orderBy = opts.order_by || 'id';
+    const orderTo = opts.order_to || 'desc';
+    const showId = opts.show_id ?? true;
+    let gridOptions = `[
+        'is_sortable'   => ${isSortable},
+        'is_filter'     => ${isFilter},
+        'is_pagination' => ${isPagination},
+        'is_draggable'  => ${isDraggable},
+        'is_selectable' => ${isSelectable},
+        'order_by'      => '${orderBy}',
+        'order_to'      => '${orderTo}',
+    `;
+    if (opts.filter_button_title) {
+        gridOptions += `,
+        'filter_button_title' => '${opts.filter_button_title}'`;
+    }
+    gridOptions += `
+    ]`;
+    const columnsCode = generateColumns(columns, name, showId);
+    const actionsCode = generateActions(actions || getDefaultActions(name));
+    return `<?php
+
+// ВАЖНО: грид — это ФУНКЦИЯ, а не класс!
+// Имя функции = grid_ + значение $this->grid_name из экшена
+
+function grid_${gridName}($controller) {
+
+    ${opts.is_collapsible
+        ? `$columns_state = $controller->cms_user->getAttribute('grid_columns_state', [], 'grid_${name}');
+
+    $is_collapsed = !empty($columns_state['collapsed']);`
+        : ''}
+
+    ${columnsCode}
+
+    ${actionsCode}
+
+    return [
+        'options' => ${gridOptions},
+        'columns' => $columns,
+        'actions' => $actions,
+    ];
+}
+`;
+}
+function generateColumns(columns, name, showId) {
+    let code = `    $columns = [
+`;
+    for (const column of columns) {
+        if (column.name === 'id' && !showId) {
+            continue;
+        }
+        code += `        '${column.name}' => [
+`;
+        code += `            'title'   => LANG_${name.toUpperCase()}_${column.name.toUpperCase().replace(/_/g, '_')},
+`;
+        if (column.width) {
+            code += `            'width'   => ${column.width},
+`;
+        }
+        if (column.show !== undefined) {
+            code += `            'show'    => ${column.show},
+`;
+        }
+        if (column.filter) {
+            code += `            'filter'  => '${column.filter}',
+`;
+        }
+        if (column.href) {
+            code += `            'href'    => '${column.href}',
+`;
+        }
+        if (column.flag) {
+            code += `            'flag'    => true,
+`;
+        }
+        if (column.flag_toggle) {
+            code += `            'flag_toggle' => '${column.flag_toggle}',
+`;
+        }
+        if (column.handler) {
+            code += `            'handler' => function ($value) {
+                return ${column.handler};
+            },
+`;
+        }
+        if (column.order_by !== undefined) {
+            code += `            'order_by' => ${column.order_by},
+`;
+        }
+        code += `        ],
+`;
+    }
+    code += `    ];
+`;
+    return code;
+}
+function generateActions(actions) {
+    let code = `    $actions = [
+`;
+    for (const action of actions) {
+        code += `        [
+            'title' => LANG_${action.title.toUpperCase().replace(/[^A-Z]/g, '_')},
+`;
+        if (action.icon) {
+            code += `            'icon'  => '${action.icon}',
+`;
+        }
+        if (action.class) {
+            code += `            'class' => '${action.class}',
+`;
+        }
+        if (action.confirm) {
+            code += `            'confirm' => LANG_${action.confirm.toUpperCase().replace(/[^A-Z]/g, '_')},
+`;
+        }
+        code += `            'href'  => '${action.href}',
+`;
+        code += `        ],
+`;
+    }
+    code += `    ];
+`;
+    return code;
+}
+function getDefaultActions(_name) {
+    return [
+        {
+            title: 'EDIT',
+            href: `href_to($controller->root_url, 'items', ['edit', '{id}'])`,
+            icon: 'pen',
+        },
+        {
+            title: 'DELETE',
+            href: `href_to($controller->root_url, 'items', ['delete', '{id}'])`,
+            icon: 'times-circle',
+            class: 'text-danger',
+            confirm: 'DELETE_CONFIRM',
+        },
+    ];
+}
+function generateManifest(name, GridName) {
+    return `<?xml version="1.0" encoding="utf-8"?>
+<addon>
+    <name>${name}</name>
+    <title>${GridName}</title>
+    <version>1.0.0</version>
+    <files>
+        <file>backend/grids/grid_${GridName.toLowerCase()}.php</file>
+    </files>
+</addon>`;
+}

package/dist/tools/hooks-tool.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listHooks = listHooks;
+exports.getHookDetails = getHookDetails;
+exports.searchHooks = searchHooks;
+const hooks_js_1 = require("../data/hooks.js");
+const pagination_js_1 = require("../utils/pagination.js");
+function listHooks(category, type, pageOptions = {}) {
+    let filtered = hooks_js_1.hooks;
+    if (category) {
+        filtered = filtered.filter(h => h.category === category);
+    }
+    if (type) {
+        filtered = filtered.filter(h => h.type === type || h.type.includes(type));
+    }
+    const page = (0, pagination_js_1.paginate)(filtered, pageOptions);
+    return {
+        total: filtered.length,
+        categories: hooks_js_1.hookCategories,
+        page: page.page,
+        hooks: page.items.map(h => ({
+            name: h.name,
+            type: h.type,
+            category: h.category,
+            description: h.description,
+            parameters_count: h.parameters.length,
+            return_type: h.return_type,
+            source: h.source,
+        })),
+    };
+}
+function getHookDetails(hookName) {
+    const lower = hookName.toLowerCase();
+    const exact = hooks_js_1.hooks.filter(h => h.name.toLowerCase() === lower);
+    const partial = hooks_js_1.hooks.filter(h => h.name.toLowerCase().includes(lower));
+    const matches = exact.length > 0 ? exact : partial;
+    if (matches.length === 0) {
+        // Поиск похожих
+        const lower = hookName.toLowerCase();
+        const similar = hooks_js_1.hooks
+            .filter(h => h.name.includes(lower.split('_')[0]) || h.category === lower)
+            .slice(0, 5)
+            .map(h => h.name);
+        return {
+            code: 'HOOK_NOT_FOUND',
+            error: `Хук "${hookName}" не найден`,
+            similar_hooks: similar,
+            tip: 'Используйте list_hooks для просмотра всех доступных хуков',
+        };
+    }
+    if (matches.length > 1) {
+        return {
+            code: 'AMBIGUOUS_HOOK',
+            error: `Запрос "${hookName}" соответствует нескольким хукам`,
+            candidates: matches.slice(0, 20).map(h => h.name),
+        };
+    }
+    const [hook] = matches;
+    const className = buildClassName(hook);
+    return {
+        name: hook.name,
+        type: hook.type,
+        category: hook.category,
+        description: hook.description,
+        parameters: hook.parameters,
+        return_type: hook.return_type,
+        since: hook.since,
+        source: hook.source,
+        implementation: {
+            file_path: `hooks/${hook.name}.php`,
+            class_name: className,
+            usage_note: hook.type === 'filter'
+                ? 'ОБЯЗАТЕЛЬНО вернуть модифицированные данные через return'
+                : 'Можно не возвращать данные, но рекомендуется return $data для цепочки',
+        },
+        example: hook.example,
+        manifest_xml: `<hook controller="{your_addon_name}" name="${hook.name}" />`,
+    };
+}
+function searchHooks(query) {
+    const lower = query.trim().toLowerCase();
+    const results = hooks_js_1.hooks.filter(h => h.name.includes(lower) ||
+        h.description.toLowerCase().includes(lower) ||
+        h.category.includes(lower) ||
+        h.parameters.some(p => p.name.toLowerCase().includes(lower) || p.description.toLowerCase().includes(lower)));
+    return {
+        query,
+        total: results.length,
+        results: results.map(h => ({
+            name: h.name,
+            type: h.type,
+            category: h.category,
+            description: h.description,
+        })),
+    };
+}
+function buildClassName(hook) {
+    // on{AddonName}{HookNameCamelCase}
+    const hookCamel = hook.name
+        .split('_')
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+    return `on{AddonName}${hookCamel}`;
+}