@maxisoft/instantcms-mcp 1.2.3

package/dist/tools/component-tool.js

@@ -0,0 +1,415 @@
+"use strict";
+/**
+ * @fileoverview Component scaffolding tool for InstantCMS
+ * Generates complete components with backend, frontend, model, and routes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.componentToolSchema = void 0;
+exports.scaffoldComponent = scaffoldComponent;
+const zod_1 = require("zod");
+const scaffold_1 = require("../types/scaffold");
+/**
+ * Generates component manifest
+ */
+function generateManifest(name, Name, controllers, options) {
+    return `<?php
+// InstantCMS 2. manifest.json
+
+return [
+    'type' => 'component',
+    'name' => '${name}',
+    'title' => '${Name}',
+    'description' => '${Name} component',
+    'icon' => 'component_${name}',
+    'version' => '1.0.0',
+    'category' => 'content',
+    'files' => [
+        'backend.php',
+        'frontend.php',
+        'model.php',
+        'routes.php',
+    ],
+    'controllers' => ['${controllers.map(c => c.name).join("', '")}'],
+    'options' => [
+        'frontend' => ${options.with_frontend},
+        'admin' => ${options.with_admin},
+    ],
+    'dependencies' => [],
+];`;
+}
+/**
+ * Generates backend controller
+ */
+function generateBackend(name, Name, _controllers, _options) {
+    return `<?php
+// InstantCMS 2. ${name}/backend.php
+
+class ${Name}Backend extends cmsBackend {
+
+    protected $useOptions = true;
+    protected $showTaxonomy = true;
+
+    public function __construct($request) {
+        parent::__construct($request);
+
+        cmsTemplate::getInstance()->addChainLinks(
+            'Настройки',
+            $this->cms_config->href_to('controllers', '${name}')
+        );
+    }
+
+    public function getBackendMenu() {
+        return [
+            [
+                'title' => '${Name}',
+                'url' => $this->cms_config->href_to(''),
+                'options' => ['icon' => 'component_${name}'],
+            ],
+            [
+                'title' => 'Настройки',
+                'url' => $this->cms_config->href_to('options'),
+                'icon' => 'settings',
+            ],
+        ];
+    }
+
+    public function validateVariants($${name}_item) {
+        return true;
+    }
+
+    public function getContentDescription($item) {
+        return '';
+    }
+
+    public function actionToggleEnabled($${name}_item) {
+        return $this->redirectToAction('index');
+    }
+}`;
+}
+/**
+ * Generates frontend controller
+ */
+function generateFrontend(name, Name, controllers) {
+    const firstController = controllers[0]?.name || 'index';
+    return `<?php
+// InstantCMS 2. ${name}/frontend.php
+
+class ${Name}Frontend extends cmsFrontend {
+
+    protected $useOptions = false;
+
+    public function __construct($request) {
+        parent::__construct($request);
+
+        $this->setContext('${Name}', '${firstController}');
+    }
+
+    public function routes() {
+        return include __DIR__ . '/routes.php';
+    }
+
+    public function beforeWallPost($item, $user) {
+        return $item;
+    }
+
+    public function getSeoPatterns() {
+        return [
+            'index' => [
+                'title' => '{${name}_page}.title | {site.name}',
+                'description' => '{${name}_page}.description',
+                'keywords' => '{${name}_page}.keywords',
+            ],
+        ];
+    }
+
+    public function getTagCategory() {
+        return [
+            'name' => '${name}',
+            'title' => '${Name}',
+        ];
+    }
+}`;
+}
+/**
+ * Generates model class
+ */
+function generateModel(name, Name, _controllers) {
+    return `<?php
+// InstantCMS 2. ${name}/model.php
+
+class ${Name}Model extends cmsModel {
+
+    public $table = '${name}';
+    public $cat_table = '${name}_cats';
+
+    public function __construct() {
+        parent::__construct();
+
+        $this->useCategories = true;
+        $this->cats_table = $this->cat_table;
+    }
+
+    public function get${Name}($id, $field = 'id') {
+        return $this->getItem($this->table, function ($item) {
+            $item['user'] = cmsModel::getInstance('users')->getUser($item['user_id']);
+            return $item;
+        }, [$field => $id]);
+    }
+
+    public function get${Name}s($filters = [], $order = 'id DESC', $page = 1, $perpage = 20) {
+        $this->filterColumns($filters);
+
+        return $this->get($this->table, function ($item) {
+            $item['user'] = cmsModel::getInstance('users')->getUser($item['user_id']);
+            return $item;
+        }, $filters, $order, $page, $perpage);
+    }
+
+    public function getCategories() {
+        return $this->get($this->cat_table, function ($item) {
+            return $item;
+        }, [], 'ordering ASC');
+    }
+
+    public function add${Name}($data) {
+        $data['user_id'] = cmsUser::getInstance()->id;
+        $data['date_pub'] = date('Y-m-d H:i:s');
+
+        return $this->insert($this->table, $data);
+    }
+
+    public function update${Name}($id, $data) {
+        $data['updated_at'] = date('Y-m-d H:i:s');
+
+        return $this->update($this->table, $id, $data);
+    }
+
+    public function delete${Name}($id) {
+        return $this->delete($this->table, $id, [
+            'images' => ['path' => 'upload/${name}/', 'field' => 'image'],
+        ]);
+    }
+
+    public function countItems($category_id = null) {
+        $this->filterIsNull('is_deleted');
+
+        if ($category_id) {
+            $this->filterEqual('category_id', $category_id);
+        }
+
+        return $this->getCount($this->table);
+    }
+}`;
+}
+/**
+ * Generates routes configuration
+ */
+function generateRoutes(name, Name, controllers) {
+    const routes = controllers
+        .map(c => {
+        return `    '${c.name}' => [
+        '/' => ['${Name}Frontend', 'actionIndex', '{${c.name}_page}'],
+        '/{slug}' => ['${Name}Frontend', 'actionView', '{slug}'],
+    ],`;
+    })
+        .join('\n');
+    return `<?php
+// InstantCMS 2. ${name}/routes.php
+
+return [
+${routes}
+];`;
+}
+/**
+ * Generates backend index controller
+ */
+function generateBackendIndex(name, Name) {
+    return `<?php
+// InstantCMS 2. ${name}/backend/index.php
+
+class ${Name}Backend extends cmsBackend {
+
+    public function actionIndex() {
+        $grid = $this->loadDataGrid('${name}');
+
+        $this->renderTemplate('index', [
+            'grid' => $grid,
+        ]);
+    }
+
+    public function actionAdd() {
+        $form = $this->getForm('${name}');
+
+        if ($this->request->has('submit')) {
+            $data = $form->parse($this->request, ['submit']);
+
+            if ($form->validate($this, $data)) {
+                $id = $this->model->add${Name}($data);
+
+                cmsUser::addSessionMessage('Запись добавлена', 'success');
+                $this->redirectToAction('edit', $id);
+            }
+        }
+
+        $this->renderTemplate('form', [
+            'form' => $form,
+        ]);
+    }
+
+    public function actionEdit($id) {
+        $item = $this->model->get${Name}($id);
+
+        if (!$item) {
+            cmsCore::error404();
+        }
+
+        $form = $this->getForm('${name}');
+
+        if ($this->request->has('submit')) {
+            $data = $form->parse($this->request, ['submit']);
+
+            if ($form->validate($this, $data)) {
+                $this->model->update${Name}($id, $data);
+
+                cmsUser::addSessionMessage('Запись сохранена', 'success');
+                $this->redirectToAction('edit', $id);
+            }
+        }
+
+        $this->renderTemplate('form', [
+            'item' => $item,
+            'form' => $form,
+        ]);
+    }
+
+    public function actionDelete($id) {
+        $this->model->delete${Name}($id);
+
+        cmsUser::addSessionMessage('Запись удалена', 'success');
+        $this->redirectToAction('index');
+    }
+}`;
+}
+/**
+ * Generates menu configuration
+ */
+function generateMenu(name, Name, controllers) {
+    const firstController = controllers[0]?.name || name;
+    return `<?php
+// InstantCMS 2. ${name}/menu.php
+
+return [
+    'url' => href_to('${firstController}'),
+    'title' => '${Name}',
+    'icon' => 'component_${name}',
+    'visibility' => ['0' => 'all', '1' => 'auth', '2' => 'nonauth'],
+];`;
+}
+/**
+ * Generates controller configuration
+ */
+function generateConfig(name, _Name, controllers) {
+    return `<?php
+// InstantCMS 2. system/config/controllers/${name}.php
+
+return [
+    'enabled' => true,
+    'controllers' => ['${controllers.map(c => c.name).join("', '")}'],
+    'options' => [
+        'is_premod' => false,
+        'is_tags' => true,
+        'is_rs' => true,
+        'hits_to_top' => true,
+        'profile_on' => true,
+        'pub_days' => 0,
+        'front_edit' => false,
+    ],
+];`;
+}
+/**
+ * Generates a complete component for InstantCMS
+ *
+ * @param opts - Configuration options for the component
+ * @returns Object containing generated files and metadata
+ *
+ * @example
+ * ```typescript
+ * const result = scaffoldComponent({
+ *   addon_name: 'board',
+ *   controllers: [{ name: 'index', actions: ['index', 'view', 'add', 'edit'], use_model: true }],
+ *   options: { with_frontend: true, with_model: true }
+ * });
+ * ```
+ */
+function scaffoldComponent(opts) {
+    const { lowercase, UpperCamelCase } = (0, scaffold_1.normalizeAddonName)(opts.addon_name);
+    const files = {};
+    const options = {
+        with_frontend: opts.options?.with_frontend ?? true,
+        with_admin: opts.options?.with_admin ?? true,
+        with_model: opts.options?.with_model ?? true,
+        with_routes: opts.options?.with_routes ?? true,
+        with_menu: opts.options?.with_menu ?? true,
+    };
+    const controllers = opts.controllers || [
+        { name: 'index', actions: ['index', 'view'], use_model: true },
+    ];
+    files[`${lowercase}/manifest.json`] = generateManifest(lowercase, UpperCamelCase, controllers, options);
+    files[`${lowercase}/backend.php`] = generateBackend(lowercase, UpperCamelCase, controllers, options);
+    if (options.with_frontend) {
+        files[`${lowercase}/frontend.php`] = generateFrontend(lowercase, UpperCamelCase, controllers);
+    }
+    if (options.with_model || controllers.some(c => c.use_model)) {
+        files[`${lowercase}/model.php`] = generateModel(lowercase, UpperCamelCase, controllers);
+    }
+    if (options.with_routes) {
+        files[`${lowercase}/routes.php`] = generateRoutes(lowercase, UpperCamelCase, controllers);
+    }
+    files[`${lowercase}/backend/index.php`] = generateBackendIndex(lowercase, UpperCamelCase);
+    if (options.with_menu) {
+        files[`${lowercase}/menu.php`] = generateMenu(lowercase, UpperCamelCase, controllers);
+    }
+    files[`system/config/controllers/${lowercase}.php`] = generateConfig(lowercase, UpperCamelCase, controllers);
+    return {
+        addon_name: lowercase,
+        files,
+        controllers_count: controllers.length,
+        options,
+    };
+}
+exports.componentToolSchema = {
+    name: 'scaffold_component',
+    description: 'Генерация полного компонента InstantCMS с backend, frontend, model',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            addon_name: { type: 'string', description: 'Имя компонента' },
+            controllers: zod_1.z
+                .array(zod_1.z.object({
+                name: zod_1.z.string().describe('Имя контроллера'),
+                actions: zod_1.z.array(zod_1.z.string()).describe('Экшены'),
+                use_model: zod_1.z.boolean().optional().describe('Использовать модель'),
+            }))
+                .optional()
+                .describe('Контроллеры'),
+            options: zod_1.z
+                .object({
+                with_frontend: zod_1.z.boolean().optional().describe('С frontend'),
+                with_admin: zod_1.z.boolean().optional().describe('С админкой'),
+                with_model: zod_1.z.boolean().optional().describe('С моделью'),
+                with_routes: zod_1.z.boolean().optional().describe('С роутами'),
+                with_menu: zod_1.z.boolean().optional().describe('С меню'),
+            })
+                .optional()
+                .describe('Опции'),
+        },
+        required: ['addon_name'],
+    },
+    inputExamples: [
+        {
+            addon_name: 'board',
+            controllers: [{ name: 'index', actions: ['index', 'view', 'add', 'edit'], use_model: true }],
+            options: { with_frontend: true, with_model: true },
+        },
+    ],
+};

package/dist/tools/controllers-tool.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeController = analyzeController;
+exports.listControllers = listControllers;
+exports.getControllerActionsList = getControllerActionsList;
+exports.listSystemTraits = listSystemTraits;
+const controllers_map_js_1 = require("../data/controllers-map.js");
+function analyzeController(name, type) {
+    const controller = (0, controllers_map_js_1.getController)(name, type);
+    if (!controller) {
+        const suggestions = controllers_map_js_1.controllersMap.controllers
+            .filter(c => c.name.includes(name.toLowerCase()))
+            .slice(0, 5)
+            .map(c => ({ name: c.name, type: c.type }));
+        return {
+            error: `Контроллер "${name}" не найден`,
+            suggestions,
+        };
+    }
+    const traits = new Set();
+    for (const action of controller.actions) {
+        for (const trait of action.traits) {
+            traits.add(trait);
+        }
+    }
+    return {
+        name: controller.name,
+        className: controller.className,
+        type: controller.type,
+        extends: controller.extends,
+        filePath: controller.filePath,
+        actions: {
+            count: controller.actions.length,
+            list: controller.actions.map(a => ({
+                name: a.name,
+                className: a.className,
+                filePath: a.filePath,
+                hasParams: a.hasParams,
+                params: a.params,
+                visibility: a.visibility,
+            })),
+        },
+        traits: Array.from(traits),
+        hasBackendFolder: controller.hasBackendFolder,
+        hasModel: controller.hasModel,
+        modelFile: controller.modelFile,
+    };
+}
+function listControllers(filter) {
+    let controllers = controllers_map_js_1.controllersMap.controllers;
+    if (filter === 'frontend') {
+        controllers = controllers.filter(c => c.type === 'frontend');
+    }
+    else if (filter === 'backend') {
+        controllers = controllers.filter(c => c.type === 'backend');
+    }
+    const byType = {
+        frontend: [],
+        backend: [],
+    };
+    for (const ctrl of controllers) {
+        byType[ctrl.type].push({
+            name: ctrl.name,
+            className: ctrl.className,
+            actionsCount: ctrl.actions.length,
+            hasBackend: ctrl.hasBackendFolder,
+            hasModel: ctrl.hasModel,
+        });
+    }
+    return {
+        total: controllers.length,
+        byType,
+        allControllers: controllers.map(c => ({
+            name: c.name,
+            type: c.type,
+            extends: c.extends,
+            actionsCount: c.actions.length,
+            hasBackendFolder: c.hasBackendFolder,
+            hasModel: c.hasModel,
+        })),
+    };
+}
+function getControllerActionsList(name, type) {
+    const controller = (0, controllers_map_js_1.getController)(name, type);
+    if (!controller) {
+        return { error: `Контроллер "${name}" не найден` };
+    }
+    return {
+        controller: controller.name,
+        type: controller.type,
+        actions: controller.actions.map(a => ({
+            name: a.name,
+            className: a.className,
+            filePath: a.filePath,
+            visibility: a.visibility,
+            hasParams: a.hasParams,
+            params: a.params,
+            traits: a.traits,
+        })),
+    };
+}
+function listSystemTraits() {
+    const allTraits = {};
+    for (const controller of controllers_map_js_1.controllersMap.controllers) {
+        for (const action of controller.actions) {
+            for (const trait of action.traits) {
+                const parts = trait.split('\\');
+                const namespace = parts.slice(0, -1).join('\\');
+                const traitName = parts[parts.length - 1];
+                if (!allTraits[namespace]) {
+                    allTraits[namespace] = new Set();
+                }
+                allTraits[namespace].add(traitName);
+            }
+        }
+    }
+    const result = {};
+    for (const [ns, traits] of Object.entries(allTraits)) {
+        result[ns] = Array.from(traits).sort();
+    }
+    return {
+        namespaces: Object.keys(result).length,
+        traits: result,
+    };
+}