@maxisoft/instantcms-mcp 1.2.3

package/dist/tools/layout-tool.js

@@ -0,0 +1,548 @@
+"use strict";
+/**
+ * InstantCMS Layout Scheme Generator
+ *
+ * Generates YAML import files for the "modern" template widget layout scheme.
+ * Based on Bootstrap 4 grid system (modern template uses Bootstrap 4).
+ *
+ * YAML format: layout.rows + layout.cols + widgets sections.
+ * Compatible with InstantCMS v2.x export/import via Admin → Templates → Layout.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.layoutPresets = void 0;
+exports.scaffoldLayoutScheme = scaffoldLayoutScheme;
+exports.listLayoutPresets = listLayoutPresets;
+// ─────────────────────────────────────────────────────────────────────────────
+// HELPERS
+// ─────────────────────────────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function _yamlNull() {
+    return 'null';
+}
+/** Wrap value in YAML double quotes */
+function yamlQ(s) {
+    if (s === null || s === undefined)
+        return 'null';
+    return (0, serialization_js_1.quoteYaml)(s);
+}
+/** YAML unquoted scalar (for simple strings without special chars) */
+function yamlBare(s) {
+    if (s === null || s === undefined)
+        return 'null';
+    return (0, serialization_js_1.quoteYaml)(s);
+}
+/** Serialize JSON options as single-quoted YAML string */
+function yamlJsonOpts(obj) {
+    const json = JSON.stringify(obj);
+    return (0, serialization_js_1.quoteYaml)(json);
+}
+/** YAML literal block scalar for multiline strings (wrapper field) */
+function yamlLiteral(s, indent) {
+    const lines = s
+        .split('\n')
+        .map(l => `${indent}    ${l}`)
+        .join('\n');
+    return `|\n${lines}`;
+}
+function indent(level) {
+    return '  '.repeat(level);
+}
+function scaffoldLayoutScheme(opts) {
+    const template = opts.template || 'modern';
+    const rows = opts.rows || [];
+    // ── Pass 1: assign IDs and collect all positions ──────────────────────────
+    let rowIdCounter = 1;
+    let colIdCounter = 1;
+    let rowOrderCounter = 1;
+    let colOrderCounter = 1;
+    const rowMetas = [];
+    // Map from position_name → col meta (for parent_col resolution)
+    const positionToCol = new Map();
+    for (const rowDef of rows) {
+        const rowId = rowIdCounter++;
+        const ordering = rowOrderCounter++;
+        const colMetas = [];
+        for (const colDef of rowDef.cols || []) {
+            const colId = colIdCounter++;
+            const colOrder = colOrderCounter++;
+            const position = colDef.position || `pos_${colId}`;
+            const cm = {
+                id: colId,
+                rowId,
+                def: colDef,
+                ordering: colOrder,
+                position,
+            };
+            colMetas.push(cm);
+            positionToCol.set(position, cm);
+        }
+        rowMetas.push({ id: rowId, def: rowDef, ordering, cols: colMetas });
+    }
+    // ── Pass 2: generate YAML ─────────────────────────────────────────────────
+    const lines = ['---'];
+    // layout:
+    lines.push('layout:');
+    // layout.rows:
+    lines.push(`${indent(1)}rows:`);
+    for (const rm of rowMetas) {
+        const rd = rm.def;
+        // Resolve parent_id: look up position → col → id
+        let parentId = 'null';
+        if (rd.parent_col) {
+            const parentCol = positionToCol.get(rd.parent_col);
+            if (parentCol) {
+                parentId = `"${parentCol.id}"`;
+            }
+            else {
+                parentId = 'null'; // unresolved reference
+            }
+        }
+        // Build options JSON
+        const rowOptions = {
+            no_gutters: rd.no_gutters ? 1 : null,
+            vertical_align: '',
+            horizontal_align: '',
+            container: rd.container !== undefined ? rd.container : 'container',
+            container_tag: rd.container_tag || 'div',
+            container_tag_class: rd.container_class || '',
+            parrent_tag: rd.outer_tag || '',
+            parrent_tag_class: rd.outer_class || '',
+        };
+        // row tag
+        const rowTag = rd.tag !== undefined ? rd.tag : null;
+        lines.push(`${indent(2)}${rm.id}:`);
+        lines.push(`${indent(3)}id: ${yamlQ(rm.id)}`);
+        lines.push(`${indent(3)}parent_id: ${parentId}`);
+        // Title: simple bare string (YAML handles spaces)
+        lines.push(`${indent(3)}title: ${yamlBare(rd.title)}`);
+        lines.push(`${indent(3)}tag: ${rowTag === null ? 'null' : yamlBare(String(rowTag))}`);
+        lines.push(`${indent(3)}template: ${yamlBare(template)}`);
+        lines.push(`${indent(3)}ordering: ${yamlQ(rm.ordering)}`);
+        lines.push(`${indent(3)}nested_position: ${rd.parent_col ? yamlBare(rd.nested_position || 'after') : 'null'}`);
+        const rowClass = rd.class !== undefined ? rd.class : null;
+        lines.push(`${indent(3)}class: ${rowClass === null ? 'null' : yamlBare(rowClass)}`);
+        lines.push(`${indent(3)}options: ${yamlJsonOpts(rowOptions)}`);
+    }
+    // layout.cols:
+    lines.push(`${indent(1)}cols:`);
+    for (const rm of rowMetas) {
+        for (const cm of rm.cols) {
+            const cd = cm.def;
+            const colType = cd.type || 'typical';
+            // Build options JSON
+            const colOptions = {
+                cut_before: cd.cut_before ? 1 : null,
+                default_col_class: cd.col || '',
+                md_col_class: cd.col_md || '',
+                lg_col_class: cd.col_lg || '',
+                xl_col_class: cd.col_xl || '',
+                col_class: cd.col_class || '',
+                default_order: cd.order || 0,
+                sm_order: cd.sm_order || 0,
+                md_order: cd.md_order || 0,
+                lg_order: cd.lg_order || 0,
+                xl_order: cd.xl_order || 0,
+            };
+            lines.push(`${indent(2)}${cm.id}:`);
+            lines.push(`${indent(3)}id: ${yamlQ(cm.id)}`);
+            lines.push(`${indent(3)}row_id: ${yamlQ(rm.id)}`);
+            lines.push(`${indent(3)}title: ${yamlBare(cd.title)}`);
+            lines.push(`${indent(3)}name: ${yamlBare(cm.position)}`);
+            lines.push(`${indent(3)}type: ${yamlBare(colType)}`);
+            lines.push(`${indent(3)}ordering: ${yamlQ(cm.ordering)}`);
+            lines.push(`${indent(3)}tag: ${yamlBare(cd.tag || 'div')}`);
+            const colClass = cd.class !== undefined ? cd.class : null;
+            lines.push(`${indent(3)}class: ${colClass === null ? 'null' : yamlBare(colClass)}`);
+            // wrapper: null or block literal
+            if (cd.wrapper && cd.wrapper !== 'null') {
+                lines.push(`${indent(3)}wrapper: ${yamlLiteral(cd.wrapper, indent(3))}`);
+            }
+            else {
+                lines.push(`${indent(3)}wrapper: null`);
+            }
+            lines.push(`${indent(3)}options: ${yamlJsonOpts(colOptions)}`);
+        }
+    }
+    // widgets:
+    lines.push('widgets:');
+    lines.push(`${indent(1)}widgets_bind_pages: [ ]`);
+    lines.push(`${indent(1)}widgets_bind: [ ]`);
+    lines.push('');
+    const yaml = lines.join('\n');
+    // ── Summary ───────────────────────────────────────────────────────────────
+    const allPositions = rowMetas.flatMap(r => r.cols.map(c => c.position));
+    const notes = [];
+    // Detect unresolved parent_col refs
+    for (const rm of rowMetas) {
+        const rd = rm.def;
+        if (rd.parent_col && !positionToCol.has(rd.parent_col)) {
+            notes.push(`⚠ Строка "${rd.title}": parent_col "${rd.parent_col}" не найдена среди позиций`);
+        }
+    }
+    if (notes.length === 0) {
+        notes.push('✓ Схема сгенерирована без ошибок');
+    }
+    const usageNotes = `
+ИМПОРТ СХЕМЫ В INSTANTCMS
+===========================
+1. Откройте: Панель управления → Оформление → Шаблоны → Modern → Схема
+2. Нажмите кнопку "Импорт"
+3. Вставьте или загрузите YAML файл
+4. Подтвердите импорт — схема заменит текущую
+
+СТРУКТУРА ПОЗИЦИЙ
+=================
+${allPositions.map(p => `  • ${p}`).join('\n')}
+
+BOOTSTRAP 4 КЛАССЫ (шаблон modern)
+=====================================
+Контейнеры: container, container-fluid
+Колонки: col, col-sm-6, col-md-4, col-lg-3, col-xl-2, col-auto
+Флекс: d-flex, flex-nowrap, align-items-center, justify-content-between
+Отступы: py-3, mt-auto, mb-0
+Порядок: order-1, order-md-2
+
+ВЛОЖЕННЫЕ РЯДЫ
+===============
+Для вложения ряда внутрь колонки используйте parent_col = position_name колонки.
+Вложенный ряд будет выведен ВНУТРИ позиции этой колонки (после виджетов).
+nested_position: "after" — после виджетов позиции.
+`.trim();
+    return {
+        yaml,
+        summary: {
+            template,
+            rows_count: rowMetas.length,
+            cols_count: rowMetas.reduce((n, r) => n + r.cols.length, 0),
+            positions: allPositions,
+            notes,
+        },
+        usage_notes: usageNotes,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// PRESETS — готовые шаблоны типовых схем
+// ─────────────────────────────────────────────────────────────────────────────
+exports.layoutPresets = {
+    simple: {
+        description: 'Простая схема: шапка, контент (основной + правый сайдбар), подвал',
+        scheme: {
+            template: 'modern',
+            rows: [
+                {
+                    title: 'Шапка',
+                    outer_tag: 'header',
+                    outer_class: '',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Шапка',
+                            position: 'pos_header',
+                            tag: 'div',
+                            col: 'col-sm-12',
+                        },
+                    ],
+                },
+                {
+                    title: 'Контент',
+                    tag: 'main',
+                    outer_tag: '',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Тело страницы',
+                            position: 'pos_content',
+                            tag: 'article',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg',
+                        },
+                        {
+                            title: 'Правая колонка',
+                            position: 'pos_sidebar_right',
+                            tag: 'aside',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg-4',
+                        },
+                    ],
+                },
+                {
+                    title: 'Футер',
+                    tag: 'div',
+                    outer_tag: 'footer',
+                    outer_class: '',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Футер',
+                            position: 'pos_footer',
+                            tag: 'div',
+                            col: 'col-sm-12',
+                        },
+                    ],
+                },
+            ],
+        },
+    },
+    with_sidebar_left: {
+        description: 'Схема с левым сайдбаром: шапка, три колонки (лево / контент / право), подвал',
+        scheme: {
+            template: 'modern',
+            rows: [
+                {
+                    title: 'Шапка',
+                    outer_tag: 'header',
+                    container: 'container',
+                    cols: [{ title: 'Шапка', position: 'pos_header', tag: 'div', col: 'col-sm-12' }],
+                },
+                {
+                    title: 'Контент',
+                    tag: 'main',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Левая колонка',
+                            position: 'pos_sidebar_left',
+                            tag: 'aside',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg-3',
+                            order: 1,
+                        },
+                        {
+                            title: 'Тело страницы',
+                            position: 'pos_content',
+                            tag: 'article',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg',
+                            order: 2,
+                        },
+                        {
+                            title: 'Правая колонка',
+                            position: 'pos_sidebar_right',
+                            tag: 'aside',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg-4',
+                            order: 3,
+                        },
+                    ],
+                },
+                {
+                    title: 'Футер',
+                    tag: 'div',
+                    outer_tag: 'footer',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Футер левый',
+                            position: 'pos_footer_left',
+                            tag: 'div',
+                            col_md: 'col-md-6',
+                        },
+                        {
+                            title: 'Футер правый',
+                            position: 'pos_footer_right',
+                            tag: 'div',
+                            col_md: 'col-md-6',
+                        },
+                    ],
+                },
+            ],
+        },
+    },
+    modern_full: {
+        description: 'Полная схема modern: хедер (топ бар + лого/меню + навбар), блок-баннер, контент (лево/тело/право), перед футером, футер',
+        scheme: {
+            template: 'modern',
+            rows: [
+                {
+                    title: 'Хедер',
+                    outer_tag: 'header',
+                    outer_class: '',
+                    container: '',
+                    cols: [
+                        {
+                            title: 'Верхний ряд',
+                            position: 'pos_header_top',
+                            tag: 'div',
+                            type: 'custom',
+                            wrapper: '<div class="icms-header__top">\n    <div class="container d-flex justify-content-end flex-nowrap align-items-center">\n        {position}\n    </div>\n</div>',
+                        },
+                    ],
+                },
+                {
+                    title: 'Лого и меню пользователя',
+                    parent_col: 'pos_header_top',
+                    nested_position: 'after',
+                    outer_tag: 'div',
+                    outer_class: 'icms-header__middle',
+                    container: 'container',
+                    container_class: 'd-flex justify-content-between align-items-center flex-nowrap',
+                    cols: [
+                        {
+                            title: 'Лого, поиск, меню',
+                            position: 'pos_logo',
+                            tag: 'div',
+                            type: 'custom',
+                            wrapper: '{position}',
+                            col: 'col',
+                        },
+                        {
+                            title: 'Меню пользователя',
+                            position: 'pos_user_menu',
+                            tag: 'div',
+                            type: 'custom',
+                            wrapper: '<div class="ml-auto d-flex align-items-center">\n    {position}\n</div>',
+                        },
+                    ],
+                },
+                {
+                    title: 'Навбар',
+                    parent_col: 'pos_header_top',
+                    nested_position: 'after',
+                    outer_tag: 'div',
+                    outer_class: 'icms-header__bottom border-bottom icms-navbar',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Позиция меню',
+                            position: 'pos_nav',
+                            tag: 'div',
+                            type: 'custom',
+                            wrapper: '{position}',
+                            col: 'col',
+                        },
+                    ],
+                },
+                {
+                    title: 'Ряд во всю ширину',
+                    outer_tag: 'section',
+                    outer_class: '',
+                    container: '',
+                    no_gutters: true,
+                    cols: [
+                        {
+                            title: 'Позиция во всю ширину',
+                            position: 'con_wide',
+                            tag: 'div',
+                            type: 'custom',
+                            wrapper: '{position}',
+                            col: 'col-sm',
+                        },
+                    ],
+                },
+                {
+                    title: 'Перед контентом',
+                    tag: 'div',
+                    container: 'container',
+                    no_gutters: true,
+                    cols: [
+                        {
+                            title: 'Перед телом страницы',
+                            position: 'pos_before_content',
+                            tag: 'div',
+                            class: 'mb-3 mb-md-4',
+                            col: 'col-sm-12',
+                        },
+                    ],
+                },
+                {
+                    title: 'Контент',
+                    tag: 'main',
+                    container: 'container',
+                    cols: [
+                        {
+                            title: 'Левая колонка',
+                            position: 'pos_sidebar_left',
+                            tag: 'aside',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg-3',
+                            order: 1,
+                        },
+                        {
+                            title: 'Тело страницы',
+                            position: 'pos_content',
+                            tag: 'article',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg',
+                            order: 2,
+                        },
+                        {
+                            title: 'Правая колонка',
+                            position: 'pos_sidebar_right',
+                            tag: 'aside',
+                            class: 'mb-3 mb-md-4',
+                            col_lg: 'col-lg-4',
+                            order: 3,
+                        },
+                    ],
+                },
+                {
+                    title: 'Над футером',
+                    tag: 'div',
+                    class: 'py-5 mb-n3',
+                    outer_tag: 'section',
+                    outer_class: 'icms-footer__middle mt-auto',
+                    container: 'container',
+                    container_class: 'border-bottom',
+                    cols: [
+                        {
+                            title: 'Левый',
+                            position: 'pos_prefooter_left',
+                            tag: 'div',
+                            class: 'mb-3',
+                            col_md: 'col-md-3',
+                        },
+                        {
+                            title: 'Средний',
+                            position: 'pos_prefooter_center',
+                            tag: 'div',
+                            class: 'mb-3',
+                            col_md: 'col-md',
+                        },
+                        {
+                            title: 'Правый',
+                            position: 'pos_prefooter_right',
+                            tag: 'div',
+                            class: 'mb-3',
+                            col_md: 'col-md',
+                        },
+                    ],
+                },
+                {
+                    title: 'Футер',
+                    tag: 'div',
+                    class: 'align-items-center flex-wrap',
+                    outer_tag: 'footer',
+                    outer_class: 'icms-footer__bottom',
+                    container: 'container',
+                    container_class: 'py-2',
+                    no_gutters: true,
+                    cols: [
+                        {
+                            title: 'Футер',
+                            position: 'pos_footer',
+                            tag: 'div',
+                            class: 'mt-2 mt-sm-0 mb-1 mb-sm-0',
+                            col_md: 'col-md-6',
+                        },
+                        {
+                            title: 'Меню',
+                            position: 'pos_footer_menu',
+                            tag: 'div',
+                            col_md: 'col-md-6',
+                        },
+                    ],
+                },
+            ],
+        },
+    },
+};
+/** Returns a list of available preset names with descriptions */
+function listLayoutPresets() {
+    return Object.entries(exports.layoutPresets).map(([name, preset]) => ({
+        name,
+        description: preset.description,
+        rows_count: preset.scheme.rows.length,
+        positions: preset.scheme.rows.flatMap(r => (r.cols || []).map(c => c.position || '(auto)')),
+    }));
+}
+const serialization_js_1 = require("../utils/serialization.js");

package/dist/tools/maria-tool.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mariaExecuteQuery = mariaExecuteQuery;
+exports.mariaListTables = mariaListTables;
+exports.mariaDescribeTable = mariaDescribeTable;
+exports.mariaGetDatabaseInfo = mariaGetDatabaseInfo;
+exports.mariaShowIndexes = mariaShowIndexes;
+exports.mariaSearchTables = mariaSearchTables;
+exports.mariaGetTableData = mariaGetTableData;
+const mariadb_js_1 = require("./mariadb.js");
+async function mariaExecuteQuery(sql) {
+    const result = await (0, mariadb_js_1.executeQuery)(sql);
+    if (result.error) {
+        return {
+            success: false,
+            error: result.error,
+            query: result.query,
+            executionTime: result.executionTime,
+        };
+    }
+    return {
+        success: true,
+        columns: result.columns,
+        rows: result.rows,
+        rowCount: result.rowCount,
+        query: result.query,
+        executionTime: result.executionTime,
+    };
+}
+async function mariaListTables() {
+    const tables = await (0, mariadb_js_1.listTables)();
+    return {
+        tables,
+        count: tables.length,
+    };
+}
+async function mariaDescribeTable(tableName) {
+    const info = await (0, mariadb_js_1.getTableInfo)(tableName);
+    if (!info) {
+        return {
+            error: `Table "${tableName}" not found`,
+        };
+    }
+    return {
+        name: info.name,
+        comment: info.comment,
+        rowCount: info.rowCount,
+        columns: info.columns.map(c => ({
+            name: c.name,
+            type: c.type,
+            nullable: c.nullable,
+            key: c.key,
+            default: c.default,
+            extra: c.extra,
+            comment: c.comment,
+        })),
+        indexes: info.indexes.map(i => ({
+            name: i.name,
+            type: i.type,
+            columns: i.columns,
+            unique: i.unique,
+        })),
+    };
+}
+async function mariaGetDatabaseInfo() {
+    return await (0, mariadb_js_1.getDatabaseInfo)();
+}
+async function mariaShowIndexes(tableName) {
+    const result = await (0, mariadb_js_1.showIndexes)(tableName);
+    return {
+        table: tableName,
+        indexes: result.rows,
+        columnCount: result.columns.length,
+        executionTime: result.executionTime,
+        error: result.error,
+    };
+}
+async function mariaSearchTables(pattern) {
+    const tables = await (0, mariadb_js_1.listTables)();
+    const matching = tables.filter(t => t.toLowerCase().includes(pattern.toLowerCase()));
+    return {
+        pattern,
+        matched: matching,
+        count: matching.length,
+    };
+}
+async function mariaGetTableData(tableName, options) {
+    const limit = options?.limit || 20;
+    const offset = options?.offset || 0;
+    const orderBy = options?.orderBy || 'id';
+    const orderDir = options?.orderDir || 'DESC';
+    let sql = `SELECT * FROM \`${tableName}\``;
+    const params = [];
+    if (options?.filter) {
+        const filterConditions = [];
+        for (const [key, value] of Object.entries(options.filter)) {
+            filterConditions.push(`\`${key}\` = ?`);
+            params.push(value);
+        }
+        if (filterConditions.length > 0) {
+            sql += ` WHERE ${filterConditions.join(' AND ')}`;
+        }
+    }
+    sql += ` ORDER BY \`${orderBy}\` ${orderDir} LIMIT ? OFFSET ?`;
+    params.push(limit, offset);
+    const result = await (0, mariadb_js_1.executeQuery)(sql);
+    if (result.error) {
+        return {
+            error: result.error,
+            query: result.query,
+        };
+    }
+    return {
+        table: tableName,
+        columns: result.columns,
+        rows: result.rows,
+        rowCount: result.rowCount,
+        pagination: {
+            limit,
+            offset,
+            orderBy,
+            orderDir,
+        },
+        query: result.query,
+        executionTime: result.executionTime,
+    };
+}