@maxisoft/instantcms-mcp 1.2.3

package/dist/tools/filter-tool.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * @fileoverview Content filtering system scaffolding tool for InstantCMS
+ * Generates filter classes, forms, hooks, and optional saved filters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterTypeEnum = void 0;
+exports.scaffoldFilter = scaffoldFilter;
+const zod_1 = require("zod");
+const scaffold_1 = require("../types/scaffold");
+/**
+ * Available filter field types
+ */
+exports.FilterTypeEnum = zod_1.z.enum([
+    'text',
+    'select',
+    'multiselect',
+    'checkbox',
+    'range',
+    'date',
+    'daterange',
+]);
+/**
+ * Normalizes filter field with defaults
+ */
+function normalizeField(f) {
+    return {
+        field: f.field,
+        type: f.type,
+        label: f.label || f.field,
+        options: f.options || [],
+        placeholder: f.placeholder || '',
+    };
+}
+/**
+ * Generates the main filter class
+ */
+function generateFilterClass(name, Name, fields) {
+    const filterInit = fields
+        .map(f => {
+        return `        '${f.field}' => [
+            'type' => '${f.type}',
+            'label' => '${f.label}',
+            'options' => [${(f.options || []).map(o => `'${o.value}' => '${o.label}'`).join(', ')}],
+        ]`;
+    })
+        .join(',\n');
+    const applyConditions = fields
+        .map(f => {
+        switch (f.type) {
+            case 'text':
+                return `        if (!empty($filters['${f.field}'])) {
+            $where[] = "${f.field} LIKE '%" . db::escapeLike($filters['${f.field}']) . "%'";
+        }`;
+            case 'select':
+                return `        if (!empty($filters['${f.field}'])) {
+            $where[] = "${f.field} = '" . db::escape($filters['${f.field}']) . "'";
+        }`;
+            case 'multiselect':
+                return `        if (!empty($filters['${f.field}']) && is_array($filters['${f.field}'])) {
+            $ids = array_map('intval', $filters['${f.field}']);
+            $where[] = "${f.field} IN (" . implode(',', $ids) . ")";
+        }`;
+            case 'checkbox':
+                return `        if (isset($filters['${f.field}'])) {
+            $where[] = "${f.field} = " . (int)$filters['${f.field}'];
+        }`;
+            case 'range':
+                return `        if (!empty($filters['${f.field}_from'])) {
+            $where[] = "${f.field} >= " . (float)$filters['${f.field}_from'];
+        }
+        if (!empty($filters['${f.field}_to'])) {
+            $where[] = "${f.field} <= " . (float)$filters['${f.field}_to'];
+        }`;
+            case 'date':
+                return `        if (!empty($filters['${f.field}'])) {
+            $where[] = "DATE(${f.field}) = '" . db::escape($filters['${f.field}']) . "'";
+        }`;
+            case 'daterange':
+                return `        if (!empty($filters['${f.field}_from'])) {
+            $where[] = "${f.field} >= '" . db::escape($filters['${f.field}_from']) . "'";
+        }
+        if (!empty($filters['${f.field}_to'])) {
+            $where[] = "${f.field} <= '" . db::escape($filters['${f.field}_to']) . "'";
+        }`;
+            default:
+                return '';
+        }
+    })
+        .join('\n');
+    return `<?php
+// InstantCMS 2. ${name}/filters.php
+
+class ${Name}Filter {
+    private static $instance = null;
+    private $filters = [];
+
+    private function __construct() {
+        $this->filters = $this->getDefaultFilters();
+    }
+
+    public static function getInstance() {
+        if (self::$instance === null) {
+            self::$instance = new self();
+        }
+        return self::$instance;
+    }
+
+    public function getDefaultFilters() {
+        return [
+${filterInit}
+        ];
+    }
+
+    public function apply($model, $filters = []) {
+        if (empty($filters)) {
+            return $model;
+        }
+
+        $where = [];
+${applyConditions}
+
+        if (!empty($where)) {
+            $model->where(implode(' AND ', $where));
+        }
+
+        return $model;
+    }
+
+    public function getFromRequest($request) {
+        $filters = [];
+        foreach ($this->filters as $field => $config) {
+            $value = $request->get($field);
+            if ($value !== null && $value !== '') {
+                $filters[$field] = $value;
+            }
+        }
+        return $filters;
+    }
+
+    public function validate($filters) {
+        $errors = [];
+
+        foreach ($filters as $field => $value) {
+            if (!isset($this->filters[$field])) {
+                continue;
+            }
+
+            $config = $this->filters[$field];
+
+            switch ($config['type']) {
+                case 'text':
+                    if (strlen($value) > 255) {
+                        $errors[$field] = 'Слишком длинное значение';
+                    }
+                    break;
+                case 'select':
+                    if (!isset($config['options'][$value])) {
+                        $errors[$field] = 'Недопустимое значение';
+                    }
+                    break;
+                case 'multiselect':
+                    if (!is_array($value)) {
+                        $errors[$field] = 'Ожидался массив';
+                    }
+                    break;
+                case 'range':
+                case 'daterange':
+                    if (!is_numeric($value) && !strtotime($value)) {
+                        $errors[$field] = 'Недопустимое значение';
+                    }
+                    break;
+            }
+        }
+
+        return $errors;
+    }
+}`;
+}
+/**
+ * Generates the filter form class
+ */
+function generateFilterForm(name, Name, fields) {
+    const formFields = fields
+        .map(f => {
+        const placeholder = f.placeholder ? `, 'placeholder' => '${f.placeholder}'` : '';
+        switch (f.type) {
+            case 'text':
+                return `        $form->addField('${f.field}', new fieldString('${f.label}', [${placeholder}]));`;
+            case 'select': {
+                const opts = (f.options || []).length > 0
+                    ? `['options' => [${(f.options || []).map(o => `'${o.value}' => '${o.label}'`).join(', ')}]]`
+                    : '';
+                return `        $form->addField('${f.field}', new fieldList('${f.label}', ${opts}));`;
+            }
+            case 'multiselect': {
+                const multiOpts = (f.options || []).length > 0
+                    ? `['options' => [${(f.options || []).map(o => `'${o.value}' => '${o.label}'`).join(', ')}]]`
+                    : '';
+                return `        $form->addField('${f.field}', new fieldList('${f.label}', ['is_multiple' => true${multiOpts ? ', ' + multiOpts : ''}]));`;
+            }
+            case 'checkbox':
+                return `        $form->addField('${f.field}', new fieldCheckbox('${f.label}'));`;
+            case 'range':
+                return `        $form->addField('${f.field}_from', new fieldNumber('${f.label} (от)'));
+        $form->addField('${f.field}_to', new fieldNumber('${f.label} (до)'));`;
+            case 'date':
+                return `        $form->addField('${f.field}', new fieldDate('${f.label}'));`;
+            case 'daterange':
+                return `        $form->addField('${f.field}_from', new fieldDate('${f.label} (от)'));
+        $form->addField('${f.field}_to', new fieldDate('${f.label} (до)'));`;
+            default:
+                return '';
+        }
+    })
+        .join('\n');
+    return `<?php
+// InstantCMS 2. ${name}/filter.form.php
+
+class ${Name}FilterForm {
+    public function __construct($form) {
+${formFields}
+    }
+
+    public static function create($form) {
+        return new self($form);
+    }
+}`;
+}
+/**
+ * Generates hook handlers for filter integration
+ */
+function generateFilterHooks(name, Name, _fields) {
+    return `<?php
+// InstantCMS 2. system/hooks/${name}/filter.hooks.php
+
+class on${Name}FilterHook {
+    public function onBeforeLoadModel($model) {
+        $request = cmsCore::getInstance()->request;
+        $filters = ${Name}Filter::getInstance()->getFromRequest($request);
+
+        if (!empty($filters)) {
+            ${Name}Filter::getInstance()->apply($model, $filters);
+
+            // Сохраняем в сессию
+            cmsUser::sessionPut('${name}_filters', $filters);
+        }
+    }
+
+    public function onBeforeRender($controller) {
+        $filters = cmsUser::sessionGet('${name}_filters', []);
+        $controller->renderTemplate('filter', [
+            'filters' => ${Name}Filter::getInstance()->getDefaultFilters(),
+            'values' => $filters,
+        ]);
+    }
+}`;
+}
+/**
+ * Generates saved filters feature
+ */
+function generateSavedFilters(name, Name, _fields) {
+    return `<?php
+// InstantCMS 2. ${name}/saved_filters.php
+
+class ${Name}SavedFilters {
+    public static function save($user_id, $name, $filters) {
+        $model = cmsModel::getInstance();
+
+        $model->insert('saved_filters', [
+            'user_id' => $user_id,
+            'name' => $name,
+            'filters' => json_encode($filters),
+            'created_at' => date('Y-m-d H:i:s'),
+        ]);
+    }
+
+    public static function load($user_id, $filter_id) {
+        $model = cmsModel::getInstance();
+        return $model->getItemById('saved_filters', $filter_id, false, function ($item) {
+            $item['filters'] = json_decode($item['filters'], true);
+            return $item;
+        });
+    }
+
+    public static function getAll($user_id) {
+        $model = cmsModel::getInstance();
+        return $model->get('saved_filters', function ($item) {
+            $item['filters'] = json_decode($item['filters'], true);
+            return $item;
+        }, [
+            'user_id' => $user_id,
+        ]);
+    }
+
+    public static function delete($user_id, $filter_id) {
+        $model = cmsModel::getInstance();
+        return $model->delete('saved_filters', $filter_id, ['user_id' => $user_id]);
+    }
+}`;
+}
+/**
+ * Generates a complete filtering system for an InstantCMS addon
+ *
+ * @param opts - Configuration options for the filter system
+ * @returns Object containing generated files and metadata
+ *
+ * @example
+ * ```typescript
+ * const result = scaffoldFilter({
+ *   addon_name: 'catalog',
+ *   fields: [
+ *     { field: 'price', type: 'range', label: 'Цена' },
+ *     { field: 'category_id', type: 'select', label: 'Категория' }
+ *   ],
+ *   options: { use_ajax: true, save_filters: true }
+ * });
+ * ```
+ */
+function scaffoldFilter(opts) {
+    const { lowercase, UpperCamelCase } = (0, scaffold_1.normalizeAddonName)(opts.addon_name);
+    const files = {};
+    const filterFields = opts.fields.map(normalizeField);
+    files[`${lowercase}/filters.php`] = generateFilterClass(lowercase, UpperCamelCase, filterFields);
+    files[`${lowercase}/filter.form.php`] = generateFilterForm(lowercase, UpperCamelCase, filterFields);
+    files[`system/hooks/${lowercase}/filter.hooks.php`] = generateFilterHooks(lowercase, UpperCamelCase, filterFields);
+    if (opts.options?.save_filters) {
+        files[`${lowercase}/saved_filters.php`] = generateSavedFilters(lowercase, UpperCamelCase, filterFields);
+    }
+    return {
+        addon_name: lowercase,
+        filters_count: filterFields.length,
+        options: opts.options || {},
+        files,
+        filters: filterFields.map(f => ({
+            field: f.field,
+            type: f.type,
+            label: f.label,
+        })),
+    };
+}

package/dist/tools/form-tool.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldForm = scaffoldForm;
+function scaffoldForm(opts) {
+    const name = opts.addon_name.toLowerCase().replace(/[^a-z0-9_]/g, '_');
+    const Name = name.split('_').map(capitalize).join('');
+    const formName = opts.form_name || 'item';
+    const FormName = formName.split('_').map(capitalize).join('');
+    const files = {};
+    const ctrl = `package/system/controllers/${name}`;
+    const formFile = `${ctrl}/backend/forms/form_${formName}.php`;
+    files[formFile] = generateForm(opts.fields, Name, FormName, opts.options);
+    files[`${ctrl}/manifest.xml`] = generateManifest(name, Name);
+    if (opts.options?.use_separate_save) {
+        files[`${ctrl}/backend/forms/form_${formName}_save.php`] = generateFormSave(Name, FormName);
+    }
+    return {
+        addon_name: name,
+        form_name: formName,
+        form_class: `form${Name}${FormName}`,
+        file_path: formFile,
+        files,
+        form_fields: opts.fields.map(f => ({
+            name: f.name,
+            type: f.type,
+            class: getFieldClass(f.type),
+        })),
+        structure_notes: [
+            `Форма: ${formFile}`,
+            `Класс: form${Name}${FormName}`,
+            `Используйте в экшене: $this->getForm('${formName}')`,
+        ],
+    };
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function generateForm(fields, Name, FormName, options) {
+    let formCode = `<?php
+
+class form${Name}${FormName} extends cmsForm {
+
+    public function init($do = 'add') {
+
+        $is_edit = ($do === 'edit');
+
+        return [`;
+    if (options?.use_tabs) {
+        formCode += generateTabsForm(fields);
+    }
+    else {
+        formCode += generateBasicForm(fields);
+    }
+    formCode += `
+        ];
+    }
+
+`;
+    if (options?.use_separate_save) {
+        formCode += generateSaveMethod(Name, FormName);
+    }
+    formCode += `}
+`;
+    return formCode;
+}
+function generateBasicForm(fields) {
+    const basicFields = fields.filter(f => !f.is_system);
+    const systemFields = fields.filter(f => f.is_system);
+    let code = `
+            'basic' => [
+                'title'  => LANG_CP_BASIC,
+                'type'   => 'fieldset',
+                'childs' => [`;
+    for (const field of basicFields) {
+        const fieldClass = getFieldClass(field.type);
+        const fieldTitle = field.title || capitalize(field.name.replace(/_/g, ' '));
+        let fieldOptions = { title: fieldTitle };
+        if (field.rules && field.rules.length > 0) {
+            fieldOptions.rules = field.rules.map(r => {
+                if (typeof r === 'string') {
+                    const [rule, ...args] = r.split(':');
+                    return [rule, ...args.map(a => (isNaN(Number(a)) ? a : Number(a)))];
+                }
+                return r;
+            });
+        }
+        else if (field.type === 'varchar') {
+            fieldOptions.rules = [['max_length', 255]];
+        }
+        if (field.options) {
+            fieldOptions = { ...fieldOptions, ...field.options };
+        }
+        const optionsStr = formatFieldOptions(fieldOptions);
+        code += `
+                    new ${fieldClass}('${field.name}', ${optionsStr}),`;
+    }
+    code += `
+                ],
+            ],`;
+    if (systemFields.length > 0) {
+        code += `
+            'system' => [
+                'title'  => LANG_SYSTEM,
+                'type'   => 'fieldset',
+                'childs' => [`;
+        for (const field of systemFields) {
+            const fieldClass = getFieldClass(field.type);
+            const fieldTitle = field.title || capitalize(field.name.replace(/_/g, ' '));
+            const fieldOptions = formatFieldOptions({ title: fieldTitle, ...field.options });
+            code += `
+                    new ${fieldClass}('${field.name}', ${fieldOptions}),`;
+        }
+        code += `
+                ],
+            ],`;
+    }
+    return code;
+}
+function generateTabsForm(fields) {
+    const tabGroups = {};
+    for (const field of fields) {
+        const group = field.options?.tab || 'basic';
+        if (!tabGroups[group]) {
+            tabGroups[group] = [];
+        }
+        tabGroups[group].push(field);
+    }
+    let code = '';
+    for (const [tabName, tabFields] of Object.entries(tabGroups)) {
+        const tabTitle = tabName === 'basic' ? LANG_CP_BASIC : capitalize(tabName.replace(/_/g, ' '));
+        code += `
+            '${tabName}' => [
+                'title'  => '${tabTitle}',
+                'type'   => 'fieldset',
+                'childs' => [`;
+        for (const field of tabFields) {
+            const fieldClass = getFieldClass(field.type);
+            const fieldTitle = field.title || capitalize(field.name.replace(/_/g, ' '));
+            let fieldOptions = { title: fieldTitle };
+            if (field.rules && field.rules.length > 0) {
+                fieldOptions.rules = field.rules;
+            }
+            else if (field.type === 'varchar') {
+                fieldOptions.rules = [['max_length', 255]];
+            }
+            if (field.options) {
+                fieldOptions = { ...fieldOptions, ...field.options };
+            }
+            const optionsStr = formatFieldOptions(fieldOptions);
+            code += `
+                    new ${fieldClass}('${field.name}', ${optionsStr}),`;
+        }
+        code += `
+                ],
+            ],`;
+    }
+    return code;
+}
+function generateSaveMethod(Name, _FormName) {
+    return `
+
+    public function save($item, $do, $is_update) {
+
+        if ($is_update) {
+            cmsEventsManager::hook('${Name.toLowerCase()}_before_update', $item, $this->request);
+        } else {
+            cmsEventsManager::hook('${Name.toLowerCase()}_before_add', $item, $this->request);
+        }
+
+        return $item;
+    }
+`;
+}
+function generateFormSave(Name, FormName) {
+    return `<?php
+
+class form${Name}${FormName}Save extends cmsForm {
+
+    public function init() {
+        return [
+            'basic' => [
+                'title'  => LANG_CP_BASIC,
+                'type'   => 'fieldset',
+                'childs' => [
+                    new fieldCheckbox('is_approved', [
+                        'title'   => LANG_APPROVED,
+                        'default' => 1,
+                    ]),
+                    new fieldNumber('sorder', [
+                        'title'   => LANG_SORT_ORDER,
+                        'default' => 0,
+                    ]),
+                ],
+            ],
+        ];
+    }
+
+}`;
+}
+function generateManifest(name, Name) {
+    return `<?xml version="1.0" encoding="utf-8"?>
+<addon>
+    <name>${name}</name>
+    <title>${Name}</title>
+    <version>1.0.0</version>
+    <files>
+        <file>backend/forms/form_item.php</file>
+    </files>
+</addon>`;
+}
+function getFieldClass(type) {
+    const map = {
+        varchar: 'fieldString',
+        text: 'fieldText',
+        html: 'fieldHtml',
+        int: 'fieldNumber',
+        tinyint: 'fieldNumber',
+        decimal: 'fieldNumber',
+        float: 'fieldNumber',
+        bool: 'fieldCheckbox',
+        boolean: 'fieldCheckbox',
+        date: 'fieldDate',
+        datetime: 'fieldDate',
+        timestamp: 'fieldDate',
+        time: 'fieldTime',
+        select: 'fieldList',
+        enum: 'fieldList',
+        radio: 'fieldRadio',
+        checkbox: 'fieldCheckbox',
+        file: 'fieldFile',
+        image: 'fieldImage',
+        images: 'fieldImages',
+        video: 'fieldVideo',
+        audio: 'fieldAudio',
+        user: 'fieldUser',
+        users: 'fieldUsers',
+        parent: 'fieldParent',
+        slug: 'fieldSlug',
+        tags: 'fieldTags',
+        price: 'fieldPrice',
+        theme: 'fieldTheme',
+    };
+    return map[type] || 'fieldString';
+}
+function formatFieldOptions(options) {
+    const lines = [];
+    for (const [key, value] of Object.entries(options)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (typeof value === 'string') {
+            lines.push(`'${key}' => '${value}'`);
+        }
+        else if (typeof value === 'boolean') {
+            lines.push(`'${key}' => ${value}`);
+        }
+        else if (typeof value === 'number') {
+            lines.push(`'${key}' => ${value}`);
+        }
+        else if (Array.isArray(value)) {
+            lines.push(`'${key}' => ${JSON.stringify(value)}`);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            lines.push(`'${key}' => ${JSON.stringify(value)}`);
+        }
+    }
+    if (lines.length === 0) {
+        return '{}';
+    }
+    return `[\n                        ${lines.join(',\n                        ')}\n                    ]`;
+}
+const LANG_CP_BASIC = 'LANG_CP_BASIC';
+const LANG_SYSTEM = 'LANG_SYSTEM'; // eslint-disable-line @typescript-eslint/no-unused-vars
+const LANG_APPROVED = 'LANG_APPROVED'; // eslint-disable-line @typescript-eslint/no-unused-vars
+const LANG_SORT_ORDER = 'LANG_SORT_ORDER'; // eslint-disable-line @typescript-eslint/no-unused-vars