@maxisoft/instantcms-mcp 1.2.3

package/dist/__tests__/scaffold-addon-roundtrip.test.js

@@ -0,0 +1,287 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fc = __importStar(require("fast-check"));
+const ini_1 = require("ini");
+const fast_xml_parser_1 = require("fast-xml-parser");
+const scaffold_tool_js_1 = require("../tools/scaffold-tool.js");
+const addon_tool_js_1 = require("../tools/addon-tool.js");
+const xmlParser = new fast_xml_parser_1.XMLParser({ parseTagValue: false, trimValues: false });
+const addonTypes = ['basic', 'with_admin', 'with_hooks', 'with_routes', 'with_widget'];
+function extractFiles(result) {
+    return result.files;
+}
+function safePhrasing(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9_]/g, '')
+        .slice(0, 40);
+}
+describe('scaffoldAddon round-trip', () => {
+    test.each(addonTypes)('тип %s: manifest.xml парсится через XMLParser', type => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: `t_${type}_${Math.random().toString(36).slice(2, 6)}`,
+            title: `Title ${type}`,
+            type,
+        });
+        const files = extractFiles(result);
+        const xmlFile = Object.keys(files).find(p => p.endsWith('manifest.xml'));
+        expect(xmlFile).toBeDefined();
+        const parsed = xmlParser.parse(files[xmlFile]);
+        expect(parsed).toBeDefined();
+    });
+    test.each(addonTypes)('тип %s: manifest.ru.ini парсится через ini', type => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: `ini_${type}_${Math.random().toString(36).slice(2, 6)}`,
+            title: `Title ${type}`,
+            type,
+        });
+        const files = extractFiles(result);
+        const iniFile = '[pkg] manifest.ru.ini';
+        expect(files[iniFile]).toBeDefined();
+        const parsed = (0, ini_1.parse)(files[iniFile]);
+        expect(parsed.info.title).toMatch(/Title/);
+        expect(parsed.version.major).toMatch(/^\d+$/);
+    });
+    test('все 5 типов проходят validateAddon без errors', () => {
+        for (const type of addonTypes) {
+            const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+                name: `v_${type}_${safePhrasing(type)}`,
+                title: `Title for ${type}`,
+                type,
+            });
+            const files = extractFiles(result);
+            const validation = (0, addon_tool_js_1.validateAddon)(files);
+            expect(validation.errors).toEqual([]);
+            expect(validation.is_valid).toBe(true);
+        }
+    });
+    test('PHP class names соответствуют файлам и регистру', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'names_test', title: 'Names Test', type: 'basic' });
+        const files = extractFiles(result);
+        // frontend.php определяет class names_test extends cmsFrontend.
+        expect(files['package/system/controllers/names_test/frontend.php']).toMatch(/class\s+names_test\s+extends\s+cmsFrontend/);
+        // model.php определяет class modelNamesTest extends cmsModel.
+        expect(files['package/system/controllers/names_test/model.php']).toMatch(/class\s+modelNamesTest\s+extends\s+cmsModel/);
+    });
+    test('manifest.xml содержит имя контроллера в теге <name>', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'ctlname', title: 'Ctl Name', type: 'basic' });
+        const files = extractFiles(result);
+        const xml = files['package/system/controllers/ctlname/manifest.xml'];
+        expect(xml).toContain('<name>ctlname</name>');
+    });
+    test('manifest.ru.ini содержит правильный тип контроллера', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'inichk', title: 'Ini Check', type: 'basic' });
+        const iniText = extractFiles(result)['[pkg] manifest.ru.ini'];
+        const parsed = (0, ini_1.parse)(iniText);
+        expect(parsed.install.type).toBe('controller');
+        expect(parsed.install.name).toBe('inichk');
+    });
+    test('injection-пейлоады в title не ломают generated PHP и сериализуются безопасно', () => {
+        const xss = '</title><script>alert(1)</script>';
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: 'injtest',
+            title: xss,
+            type: 'basic',
+        });
+        const files = extractFiles(result);
+        // 1. manifest.xml экранирует спецсимволы XML.
+        const xml = files['package/system/controllers/injtest/manifest.xml'];
+        expect(xml).not.toContain('<script>alert(1)</script>');
+        expect(xml).toContain('&lt;script&gt;');
+        // 2. INI: строки квотятся — ini-парсер восстанавливает исходник (включая < и >).
+        const iniText = files['[pkg] manifest.ru.ini'];
+        const parsedIni = (0, ini_1.parse)(iniText);
+        expect(parsedIni.info.title).toBe(xss);
+        // В ini-файле строка double-quoted, ini-парсер корректно восстанавливает.
+        // 3. PHP LANG-файл: PHP-строка в одинарных кавычках содержит апострофы экранированными,
+        //    а < > — как литералы (PHP их интерпретирует корректно внутри строки).
+        const php = files['package/system/languages/ru/controllers/injtest/injtest.php'];
+        expect(php).toContain("define('LANG_INJTEST_TITLE'");
+        // Исходная строка восстановима через unescape апострофов — но в этом случае
+        // апострофов в `xss` нет, поэтому просто проверим наличие строки как литерала.
+        expect(php).toContain(xss);
+    });
+    test('PHP LANG-файл корректно сериализует title с апострофами и backslash', () => {
+        const tricky = `Title with 'quotes' and \\backslash`;
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'qesc', title: tricky, type: 'basic' });
+        const files = extractFiles(result);
+        const php = files['package/system/languages/ru/controllers/qesc/qesc.php'];
+        // PHP-строки экранируют апострофы через \' и backslash через \\.
+        expect(php).toContain("\\'quotes\\'");
+        expect(php).toContain('\\\\backslash');
+    });
+    test('author URL должен быть URL; невалидный формат → throw', () => {
+        expect(() => (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: 'authtest',
+            title: 'Auth',
+            type: 'basic',
+            author_url: 'not a url',
+        })).not.toThrow(); // валидация author_url делается на уровне Zod registry, не внутри функции
+        // Внутри scaffoldAddon author_url квотируется как строка, но финальный URL
+        // в manifest.ru.ini парсится через ini.
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: 'authtest',
+            title: 'Auth',
+            type: 'basic',
+            author_url: 'https://example.com/path',
+        });
+        const files = extractFiles(result);
+        const iniText = files['[pkg] manifest.ru.ini'];
+        const parsed = (0, ini_1.parse)(iniText);
+        expect(parsed.author.url).toBe('https://example.com/path');
+    });
+    test('with_hooks: каждый запрошенный хук попадает в manifest.xml', () => {
+        const requestedHooks = ['user_registered', 'content_after_add_approve'];
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: 'hkok',
+            title: 'Hooks',
+            type: 'with_hooks',
+            hooks: requestedHooks,
+        });
+        const files = extractFiles(result);
+        const xml = files['package/system/controllers/hkok/manifest.xml'];
+        expect(xml).toContain('user_registered');
+        expect(xml).toContain('content_after_add_approve');
+        // Также должны быть файлы хуков.
+        const hookFiles = Object.keys(files).filter(p => p.includes('/hooks/'));
+        expect(hookFiles.length).toBeGreaterThanOrEqual(requestedHooks.length);
+    });
+    test('with_admin: присутствует backend.php', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'admn', title: 'Admin', type: 'with_admin' });
+        const files = extractFiles(result);
+        expect(files['package/system/controllers/admn/backend.php']).toBeDefined();
+    });
+    test('with_widget: присутствует widget файлы', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'wdgt', title: 'Widget', type: 'with_widget' });
+        const files = extractFiles(result);
+        const widgetFile = Object.keys(files).find(p => p.includes('/widgets/'));
+        expect(widgetFile).toBeDefined();
+    });
+    test('with_routes: присутствует routes.php или эквивалент', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'rts', title: 'Routes', type: 'with_routes' });
+        const files = extractFiles(result);
+        const routesFile = Object.keys(files).find(p => p.endsWith('routes.php') || p.includes('/routes/'));
+        expect(routesFile).toBeDefined();
+    });
+    test('description передаётся в manifest.ru.ini', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: 'desc',
+            title: 'Desc',
+            description: 'Custom description for the addon',
+            type: 'basic',
+        });
+        const files = extractFiles(result);
+        const iniText = files['[pkg] manifest.ru.ini'];
+        const parsed = (0, ini_1.parse)(iniText);
+        expect(parsed.info.description).toBe('Custom description for the addon');
+    });
+    test('version из строки X.Y.Z попадает в [version] секцию', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({
+            name: 'ver',
+            title: 'Ver',
+            version: '3.2.1',
+            type: 'basic',
+        });
+        const files = extractFiles(result);
+        const iniText = files['[pkg] manifest.ru.ini'];
+        const parsed = (0, ini_1.parse)(iniText);
+        expect(parsed.version.major).toBe('3');
+        expect(parsed.version.minor).toBe('2');
+        expect(parsed.version.build).toBe('1');
+    });
+    test('плохие name бросают понятную ошибку', () => {
+        const cases = [
+            '', // empty
+            'a', // 1 char — regex требует минимум 2
+            '1abc', // не начинается с буквы
+            'ABC', // uppercase не разрешён
+            'with-dash', // dash не разрешён
+            'a'.repeat(65), // > 64
+            '../bad', // path traversal
+        ];
+        for (const name of cases) {
+            expect(() => (0, scaffold_tool_js_1.scaffoldAddon)({ name, title: 'Bad', type: 'basic' })).toThrow();
+        }
+    });
+    test('плохие version бросают ошибку', () => {
+        const cases = ['latest', '1.0', '1.0.0-beta', 'v1.0.0', '1', '1.0.0.0'];
+        for (const version of cases) {
+            expect(() => (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'vrb', title: 'V', version, type: 'basic' })).toThrow();
+        }
+    });
+    test('property-based: имя из regex и валидный title всегда дают файл-мап', () => {
+        // Не используем faker.random — нам нужно уложиться в regex.
+        fc.assert(fc.property(fc.stringMatching(/^[a-z][a-z0-9_]{1,63}$/), fc.string({ minLength: 1, maxLength: 100 }), (name, title) => {
+            const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name, title, type: 'basic' });
+            const files = extractFiles(result);
+            // Базовые обязательные файлы.
+            expect(files['[pkg] manifest.ru.ini']).toBeDefined();
+            expect(files['[pkg] install.sql']).toBeDefined();
+            expect(files[`package/system/controllers/${name}/frontend.php`]).toBeDefined();
+            expect(files[`package/system/controllers/${name}/model.php`]).toBeDefined();
+            return true;
+        }), { numRuns: 30 });
+    });
+    test('property-based: title с управляющими символами и Unicode не ломает вывод', () => {
+        fc.assert(fc.property(fc.stringMatching(/^[a-z][a-z0-9_]{1,20}$/), fc.string({ minLength: 1, maxLength: 200 }), (name, title) => {
+            const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name, title, type: 'basic' });
+            const files = extractFiles(result);
+            // Просто проверим, что manifest.ru.ini парсится.
+            const iniText = files['[pkg] manifest.ru.ini'];
+            const parsed = (0, ini_1.parse)(iniText);
+            // ini-парсер не должен потерять данные; обратный unescape через
+            // стандартное деквотирование.
+            expect(parsed.info.title).toBeDefined();
+            return true;
+        }), { numRuns: 30 });
+    });
+    test('install.sql CREATE TABLE содержит правильное имя таблицы', () => {
+        const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name: 'sql', title: 'SQL', type: 'basic' });
+        const files = extractFiles(result);
+        const sql = files['[pkg] install.sql'];
+        expect(sql).toContain('CREATE TABLE');
+        expect(sql).toContain('cms_sql_items');
+    });
+    test('property-based: каждый тип не падает на базовом вводе', () => {
+        fc.assert(fc.property(fc.stringMatching(/^[a-z][a-z0-9_]{1,30}$/), fc.constantFrom(...addonTypes), fc.string({ minLength: 1, maxLength: 50 }), (name, type, title) => {
+            const result = (0, scaffold_tool_js_1.scaffoldAddon)({ name, title, type });
+            const files = extractFiles(result);
+            expect(typeof files).toBe('object');
+            expect(Object.keys(files).length).toBeGreaterThan(0);
+            return true;
+        }), { numRuns: 30 });
+    });
+});

package/dist/__tests__/serialization.test.js

@@ -0,0 +1,170 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fc = __importStar(require("fast-check"));
+const ini_1 = require("ini");
+const fast_xml_parser_1 = require("fast-xml-parser");
+const yaml_1 = require("yaml");
+const serialization_js_1 = require("../utils/serialization.js");
+const xmlParser = new fast_xml_parser_1.XMLParser({ parseTagValue: false, trimValues: false });
+/**
+ * Конвертирует значение, экранированное escapeXml, в экранированный текстовый узел,
+ * который XML-парсер может вернуть в виде исходной строки.
+ */
+function wrapXmlText(value) {
+    return `<r>${(0, serialization_js_1.escapeXml)(value)}</r>`;
+}
+describe('serialization property-based', () => {
+    test('escapeXml: round-trip через XML-парсер сохраняет произвольную строку', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 500 }), raw => {
+            const parsed = xmlParser.parse(wrapXmlText(raw));
+            return parsed.r === raw;
+        }), { numRuns: 200 });
+    });
+    test('escapeXml: спецсимволы всегда экранированы', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), raw => {
+            const escaped = (0, serialization_js_1.escapeXml)(raw);
+            return !escaped.includes('<') && !escaped.includes('>');
+        }), { numRuns: 100 });
+    });
+    test('escapeXml: кавычки не появляются как голые после экранирования', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), raw => {
+            const escaped = (0, serialization_js_1.escapeXml)(raw);
+            const inner = escaped
+                .replace(/&lt;/g, '<')
+                .replace(/&gt;/g, '>')
+                .replace(/&quot;/g, '"')
+                .replace(/&apos;/g, "'")
+                .replace(/&amp;/g, '&');
+            return inner === raw;
+        }), { numRuns: 100 });
+    });
+    test('escapeXml: текущая реализация НЕ идемпотентна на &amp; (известное ограничение)', () => {
+        // escapeXml экранирует амперсанд ПОСЛЕ, что приводит к двойному экранированию.
+        // Это документированное поведение — пользователи должны передавать сырой текст.
+        expect((0, serialization_js_1.escapeXml)('&amp;')).toBe('&amp;amp;');
+        expect((0, serialization_js_1.escapeXml)('a&amp;b')).toBe('a&amp;amp;b');
+    });
+    test('escapeXml: XSS- и XXE-пейлоады становятся безопасным текстом', () => {
+        const xss = '<script>alert(1)</script>';
+        const xxe = '<!ENTITY xxe SYSTEM "file:///etc/passwd">';
+        expect((0, serialization_js_1.escapeXml)(xss)).toContain('&lt;script&gt;');
+        expect((0, serialization_js_1.escapeXml)(xss)).not.toContain('<script>');
+        expect((0, serialization_js_1.escapeXml)(xxe)).toContain('&lt;!ENTITY');
+        expect((0, serialization_js_1.escapeXml)(xxe)).not.toContain('<!');
+    });
+    test('quoteIni: round-trip через ini-парсер сохраняет значение', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }).filter(s => !s.includes('\0')), raw => {
+            const iniText = `[s]\nk=${(0, serialization_js_1.quoteIni)(raw)}\n`;
+            const parsed = (0, ini_1.parse)(iniText);
+            return parsed.s.k === raw;
+        }), { numRuns: 200 });
+    });
+    test('quoteIni: переводы строк заменяются на пробел', () => {
+        fc.assert(fc.property(fc.string({ minLength: 1, maxLength: 100 }), fc.array(fc.constantFrom('\n', '\r', '\r\n'), { maxLength: 5 }), (raw, breaks) => {
+            const withBreaks = breaks.join(raw);
+            const quoted = (0, serialization_js_1.quoteIni)(withBreaks);
+            // Внутри кавычек не должно быть сырых \n или \r.
+            const inner = quoted.slice(1, -1);
+            return !inner.includes('\n') && !inner.includes('\r');
+        }), { numRuns: 100 });
+    });
+    test('quoteIni: обратный слэш и кавычка экранируются — round-trip даёт исходник', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 100 }).filter(s => !s.includes('\0')), raw => {
+            const quoted = (0, serialization_js_1.quoteIni)(raw);
+            const iniText = `[s]\nk=${quoted}\n`;
+            const parsed = (0, ini_1.parse)(iniText);
+            return parsed.s.k === raw;
+        }), { numRuns: 200 });
+    });
+    test('quotePhp: экранирует апострофы и обратные слэши', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), raw => {
+            const quoted = (0, serialization_js_1.quotePhp)(raw);
+            // Должно начинаться с апострофа и заканчиваться апострофом.
+            if (!quoted.startsWith("'") || !quoted.endsWith("'"))
+                return false;
+            const inner = quoted.slice(1, -1);
+            // Внутри не должно быть неэкранированных апострофов.
+            for (let i = 0; i < inner.length; i += 1) {
+                if (inner[i] === "'" && (i === 0 || inner[i - 1] !== '\\')) {
+                    return false;
+                }
+            }
+            return true;
+        }), { numRuns: 200 });
+    });
+    test('quotePhp: SQL-injection-строки корректно проходят через функцию без потери', () => {
+        const payloads = [
+            "'; DROP TABLE users; --",
+            "admin'--",
+            "' OR '1'='1",
+            "\\'; DROP TABLE x; --",
+        ];
+        for (const payload of payloads) {
+            const quoted = (0, serialization_js_1.quotePhp)(payload);
+            // Из PHP-строки можно реконструировать исходник через стандартный unescape.
+            const reconstructed = quoted.slice(1, -1).replace(/\\'/g, "'").replace(/\\\\/g, '\\');
+            expect(reconstructed).toBe(payload);
+        }
+    });
+    test('quoteYaml: для строк результат парсится обратно в исходное значение', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), raw => {
+            const quoted = (0, serialization_js_1.quoteYaml)(raw);
+            const parsed = (0, yaml_1.parse)(quoted);
+            return parsed === raw;
+        }), { numRuns: 200 });
+    });
+    test('quoteYaml: числа сериализуются как валидный YAML scalar (int или string-of-int)', () => {
+        // Текущая реализация сознательно использует JSON.stringify(String(value)),
+        // поэтому числа становятся строкой. Зафиксируем это документированное поведение,
+        // чтобы изменение подсветилось при рефакторинге.
+        fc.assert(fc.property(fc.integer(), raw => {
+            const quoted = (0, serialization_js_1.quoteYaml)(raw);
+            const parsed = (0, yaml_1.parse)(quoted);
+            // Парсер YAML для "0" даст 0 (int). Для 1.5 — может дать number или "1.5".
+            // Главное — значение должно быть распарсено без ошибки и соответствовать String(raw).
+            return String(parsed) === String(raw);
+        }), { numRuns: 50 });
+    });
+    test('quoteYaml: всегда возвращает валидный double-quoted YAML scalar', () => {
+        fc.assert(fc.property(fc.string({ maxLength: 200 }), raw => {
+            const quoted = (0, serialization_js_1.quoteYaml)(raw);
+            // JSON-строка является валидным YAML double-quoted scalar.
+            // При парсинге через yaml-драйвер значение должно быть raw.
+            const parsed = (0, yaml_1.parse)(quoted);
+            return parsed === raw;
+        }), { numRuns: 100 });
+    });
+});

package/dist/__tests__/source-knowledge-parsers.test.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const hooks_parser_js_1 = require("../tools/parser/hooks-parser.js");
+const components_parser_js_1 = require("../tools/parser/components-parser.js");
+describe('source-backed knowledge parsers', () => {
+    const fixtureRoot = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'instantcms-knowledge-'));
+    beforeAll(() => {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(fixtureRoot, 'system/core'), { recursive: true });
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(fixtureRoot, 'system/controllers/demo/actions'), { recursive: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(fixtureRoot, 'system/controllers/demo/actions/index.php'), `<?php
+$data = cmsEventsManager::hook('demo_before_save', [$item, $user]);
+cmsEventsManager::hookAll('demo_after_save', $item);
+$controller->runHook('demo_before_save', [$item]);`);
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(fixtureRoot, 'system/core/demo.php'), `<?php
+/** Demo API */
+class cmsDemo {
+    /** @return string */
+    public function hello(string $name) { return $name; }
+    protected function hidden() {}
+}`);
+    });
+    afterAll(() => (0, node_fs_1.rmSync)(fixtureRoot, { recursive: true, force: true }));
+    test('discovers, merges and sorts literal hook calls', () => {
+        const hooks = (0, hooks_parser_js_1.discoverHooks)(fixtureRoot);
+        expect(hooks.map(hook => hook.name)).toEqual(['demo_after_save', 'demo_before_save']);
+        expect(hooks.find(hook => hook.name === 'demo_before_save')).toMatchObject({
+            inferredType: 'filter',
+            occurrences: 2,
+            parameters: ['$item', '$user'],
+        });
+        expect((0, hooks_parser_js_1.generateHooksSource)(fixtureRoot)).toContain('system/controllers/demo/actions/index.php');
+    });
+    test('exports public core methods and excludes protected methods', () => {
+        const generated = (0, components_parser_js_1.generateComponentsSource)(fixtureRoot);
+        expect(generated).toContain('cmsDemo');
+        expect(generated).toContain('hello');
+        expect(generated).not.toContain('hidden');
+    });
+});

package/dist/__tests__/template-development.test.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const template_development_tool_js_1 = require("../tools/template-development-tool.js");
+describe('template development workflows', () => {
+    test('scaffolds a complete template and layout scheme', () => {
+        const result = (0, template_development_tool_js_1.scaffoldCompleteTemplate)({
+            name: 'studio_theme',
+            title: 'Studio Theme',
+            inherit: ['modern'],
+        });
+        expect(result.files['manifest.php']).toContain("'inherit' => ['modern']");
+        expect(result.files['manifest.php']).toContain("'has_options'                => false");
+        expect(result.files['main.tpl.php']).toContain("linkJS('js/main.js')");
+        expect(result.files['widgets/wrapper.tpl.php']).toContain('html($widget->title)');
+        expect(result.layout_scheme?.summary.positions).toEqual(expect.arrayContaining(['header', 'content', 'right-top', 'footer']));
+    });
+    test('analyzes template structure, positions and overrides', () => {
+        const result = (0, template_development_tool_js_1.analyzeInstantCmsTemplate)({
+            'manifest.php': '<?php return [];',
+            'main.tpl.php': "<?= $this->widgets('header') ?><?= $this->body() ?>",
+            'controllers/content/view.tpl.php': "<?= html($item['title']) ?>",
+        });
+        expect(result.is_valid).toBe(true);
+        expect(result.widget_positions).toContain('header');
+        expect(result.overrides).toContain('controllers/content/view.tpl.php');
+    });
+    test('discovers and analyzes a theme inside a complete project map', () => {
+        const result = (0, template_development_tool_js_1.analyzeInstantCmsTemplate)({
+            'templates/studio_theme/manifest.php': '<?php return [];',
+            'templates/studio_theme/main.tpl.php': '<?= $this->body() ?>',
+        });
+        expect(result.theme).toBe('studio_theme');
+        expect(result.is_valid).toBe(true);
+    });
+    test('requires an explicit selection when a project contains multiple themes', () => {
+        const result = (0, template_development_tool_js_1.analyzeInstantCmsTemplate)({
+            'templates/first/manifest.php': '<?php return [];',
+            'templates/second/manifest.php': '<?php return [];',
+        });
+        expect(result.is_valid).toBe(false);
+        expect(result.diagnostics.some(item => item.code === 'MULTIPLE_TEMPLATES_FOUND')).toBe(true);
+    });
+    test('creates frontend and backend overrides from an upstream path', () => {
+        const result = (0, template_development_tool_js_1.scaffoldTemplateOverride)({
+            theme: 'studio_theme',
+            source_path: 'templates/modern/controllers/content/backend/items.tpl.php',
+            source_content: '<?php echo $this->renderGrid($grid);',
+        });
+        expect(result.target_path).toBe('templates/studio_theme/controllers/content/backend/items.tpl.php');
+        expect(result.files['controllers/content/backend/items.tpl.php']).toBeDefined();
+    });
+    test('validates layout YAML and reports duplicate positions', () => {
+        const result = (0, template_development_tool_js_1.validateLayoutScheme)(`layout:\n  rows:\n    - cols:\n        - position: sidebar\n        - position: sidebar\n`);
+        expect(result.is_valid).toBe(true);
+        expect(result.diagnostics.some(item => item.code === 'DUPLICATE_LAYOUT_POSITION')).toBe(true);
+        expect((0, template_development_tool_js_1.validateLayoutScheme)('rows: []').is_valid).toBe(false);
+    });
+    test('marks an override when its upstream source changed or disappeared', () => {
+        const result = (0, template_development_tool_js_1.checkTemplateOverrideCompatibility)({
+            'controllers/content/view.tpl.php': 'custom',
+            'controllers/users/index.tpl.php': 'custom users',
+        }, {
+            'templates/modern/controllers/content/view.tpl.php': 'old',
+            'templates/modern/controllers/users/index.tpl.php': 'old users',
+        }, { 'templates/modern/controllers/content/view.tpl.php': 'new' });
+        expect(result.requires_review).toBe(2);
+        expect(result.results).toEqual(expect.arrayContaining([
+            expect.objectContaining({
+                path: 'controllers/content/view.tpl.php',
+                status: 'upstream_changed',
+            }),
+            expect.objectContaining({
+                path: 'controllers/users/index.tpl.php',
+                status: 'missing_upstream',
+            }),
+        ]));
+    });
+});