@reidelsaltres/pureper 0.1.156 → 0.1.160

package/out/foundation/engine/Expression.d.ts

@@ -0,0 +1,83 @@
+import Scope from './Scope.js';
+import Observable from '../api/Observer.js';
+/**
+ * Expression - класс для выполнения JS-кода в контексте Scope.
+ * Поддерживает:
+ * - Простые выражения: value, user.name
+ * - Вызовы функций: doSomething()
+ * - Сложный JS-код: encodeURIComponent(JSON.stringify(subject))
+ * - Код с return: const f = ""; return f;
+ * - Async/await: await fetchData()
+ *
+ * Для Observable автоматически разворачивает значения:
+ *   user.name -> user.getObject().name (если user - Observable)
+ */
+export default class Expression {
+    private readonly code;
+    private readonly isAsync;
+    private readonly hasReturn;
+    constructor(code: string);
+    /**
+     * Определить, содержит ли код await
+     */
+    private detectAsync;
+    /**
+     * Определить, содержит ли код return
+     */
+    private detectReturn;
+    /**
+     * Получить исходный код выражения
+     */
+    getCode(): string;
+    /**
+     * Найти все Observable, используемые в выражении.
+     * Например, для "user.name + user.age" вернёт [Observable(user)]
+     */
+    findObservables(scope: Scope): Observable<any>[];
+    /**
+     * Извлечь идентификаторы верхнего уровня из выражения.
+     * "user.name + count" -> ["user", "count"]
+     */
+    private extractIdentifiers;
+    /**
+     * Трансформировать код, разворачивая Observable.
+     * "user.name" -> "user.getObject().name" (если user - Observable)
+     */
+    transformCode(scope: Scope): string;
+    /**
+     * Выполнить выражение в контексте Scope.
+     * @param scope - Scope с переменными и функциями
+     * @param extraVars - дополнительные переменные (например, event для @on)
+     * @returns результат выполнения
+     */
+    execute(scope: Scope, extraVars?: Record<string, any>): any;
+    /**
+     * Выполнить выражение асинхронно
+     */
+    executeAsync(scope: Scope, extraVars?: Record<string, any>): Promise<any>;
+    /**
+     * Выполнить в контексте (синхронно)
+     */
+    private executeInContext;
+    /**
+     * Выполнить в контексте (асинхронно)
+     */
+    private executeInContextAsync;
+    /**
+     * Проверить, является ли выражение асинхронным
+     */
+    isAsyncExpression(): boolean;
+    /**
+     * Выполнить выражение (авто-выбор sync/async)
+     */
+    eval(scope: Scope, extraVars?: Record<string, any>): any | Promise<any>;
+    /**
+     * Статический метод для быстрого выполнения
+     */
+    static evaluate(code: string, scope: Scope, extraVars?: Record<string, any>): any;
+    /**
+     * Статический метод для асинхронного выполнения
+     */
+    static evaluateAsync(code: string, scope: Scope, extraVars?: Record<string, any>): Promise<any>;
+}
+//# sourceMappingURL=Expression.d.ts.map

package/out/foundation/engine/Expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Expression.d.ts","sourceRoot":"","sources":["../../../src/foundation/engine/Expression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,UAA4B,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,IAAI,EAAE,MAAM;IAMxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACI,OAAO,IAAI,MAAM;IAIxB;;;OAGG;IACI,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE;IAmBvD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;;OAGG;IACI,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IA6B1C;;;;;OAKG;IACI,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAkBlE;;OAEG;IACU,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAiBtF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;YACW,qBAAqB;IAgCnC;;OAEG;IACI,iBAAiB,IAAI,OAAO;IAInC;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAO9E;;OAEG;WACW,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAKxF;;OAEG;WACiB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAI/G"}

package/out/foundation/engine/Expression.js

@@ -0,0 +1,256 @@
+import { isObservable } from '../api/Observer.js';
+/**
+ * Expression - класс для выполнения JS-кода в контексте Scope.
+ * Поддерживает:
+ * - Простые выражения: value, user.name
+ * - Вызовы функций: doSomething()
+ * - Сложный JS-код: encodeURIComponent(JSON.stringify(subject))
+ * - Код с return: const f = ""; return f;
+ * - Async/await: await fetchData()
+ *
+ * Для Observable автоматически разворачивает значения:
+ *   user.name -> user.getObject().name (если user - Observable)
+ */
+export default class Expression {
+    code;
+    isAsync;
+    hasReturn;
+    constructor(code) {
+        this.code = code.trim();
+        this.isAsync = this.detectAsync(this.code);
+        this.hasReturn = this.detectReturn(this.code);
+    }
+    /**
+     * Определить, содержит ли код await
+     */
+    detectAsync(code) {
+        // Simple check for await keyword (not in string)
+        return /\bawait\s+/.test(code);
+    }
+    /**
+     * Определить, содержит ли код return
+     */
+    detectReturn(code) {
+        // Check for return keyword followed by space, semicolon, or end
+        return /\breturn\s+/.test(code) || /\breturn;/.test(code) || /\breturn$/.test(code);
+    }
+    /**
+     * Получить исходный код выражения
+     */
+    getCode() {
+        return this.code;
+    }
+    /**
+     * Найти все Observable, используемые в выражении.
+     * Например, для "user.name + user.age" вернёт [Observable(user)]
+     */
+    findObservables(scope) {
+        const context = scope.getVariables();
+        const observables = [];
+        const seen = new Set();
+        // Извлекаем идентификаторы из выражения
+        const identifiers = this.extractIdentifiers(this.code);
+        for (const id of identifiers) {
+            const value = context[id];
+            if (isObservable(value) && !seen.has(value)) {
+                seen.add(value);
+                observables.push(value);
+            }
+        }
+        return observables;
+    }
+    /**
+     * Извлечь идентификаторы верхнего уровня из выражения.
+     * "user.name + count" -> ["user", "count"]
+     */
+    extractIdentifiers(code) {
+        const identifiers = [];
+        // Regex для идентификаторов (не после точки)
+        const regex = /(?<![.\w])([a-zA-Z_$][a-zA-Z0-9_$]*)/g;
+        // Список встроенных глобальных объектов, которые нужно игнорировать
+        const builtins = new Set([
+            'true', 'false', 'null', 'undefined', 'NaN', 'Infinity',
+            'Math', 'Date', 'JSON', 'Array', 'Object', 'String', 'Number', 'Boolean',
+            'parseInt', 'parseFloat', 'isNaN', 'isFinite',
+            'encodeURIComponent', 'decodeURIComponent', 'encodeURI', 'decodeURI',
+            'console', 'window', 'document', 'this',
+            'if', 'else', 'for', 'while', 'do', 'switch', 'case', 'break', 'continue',
+            'return', 'function', 'const', 'let', 'var', 'new', 'typeof', 'instanceof',
+            'in', 'of', 'async', 'await', 'try', 'catch', 'finally', 'throw'
+        ]);
+        let match;
+        while ((match = regex.exec(code)) !== null) {
+            const id = match[1];
+            if (!builtins.has(id) && !identifiers.includes(id)) {
+                identifiers.push(id);
+            }
+        }
+        return identifiers;
+    }
+    /**
+     * Трансформировать код, разворачивая Observable.
+     * "user.name" -> "user.getObject().name" (если user - Observable)
+     */
+    transformCode(scope) {
+        const context = scope.getVariables();
+        let transformedCode = this.code;
+        // Находим Observable переменные
+        const observableVars = new Set();
+        for (const [key, value] of Object.entries(context)) {
+            if (isObservable(value)) {
+                observableVars.add(key);
+            }
+        }
+        if (observableVars.size === 0) {
+            return transformedCode;
+        }
+        // Трансформируем: user.name -> user.getObject().name
+        // и user (само по себе) -> user.getObject()
+        for (const varName of observableVars) {
+            // user.property -> user.getObject().property
+            const propRegex = new RegExp(`\\b${varName}\\.(?!getObject|setObject|subscribe|unsubscribe|getObserver|getMutationObserver|subscribeMutation|unsubscribeMutation)`, 'g');
+            transformedCode = transformedCode.replace(propRegex, `${varName}.getObject().`);
+            // Если просто user без вызова метода, не трансформируем (может быть намеренно)
+        }
+        return transformedCode;
+    }
+    /**
+     * Выполнить выражение в контексте Scope.
+     * @param scope - Scope с переменными и функциями
+     * @param extraVars - дополнительные переменные (например, event для @on)
+     * @returns результат выполнения
+     */
+    execute(scope, extraVars) {
+        const context = scope.getVariables();
+        if (extraVars) {
+            Object.assign(context, extraVars);
+        }
+        try {
+            // Трансформируем код для автоматического разворачивания Observable
+            const transformedCode = this.transformCode(scope);
+            return this.executeInContext(context, transformedCode);
+        }
+        catch (error) {
+            console.error(`[Expression] Error executing: ${this.code}`);
+            console.error(error);
+            return undefined;
+        }
+    }
+    /**
+     * Выполнить выражение асинхронно
+     */
+    async executeAsync(scope, extraVars) {
+        const context = scope.getVariables();
+        if (extraVars) {
+            Object.assign(context, extraVars);
+        }
+        try {
+            const transformedCode = this.transformCode(scope);
+            return await this.executeInContextAsync(context, transformedCode);
+        }
+        catch (error) {
+            console.error(`[Expression] Error executing async: ${this.code}`);
+            console.error(error);
+            return undefined;
+        }
+    }
+    /**
+     * Выполнить в контексте (синхронно)
+     */
+    executeInContext(context, codeOverride) {
+        const keys = Object.keys(context);
+        const values = Object.values(context);
+        const codeToExecute = codeOverride ?? this.code;
+        let functionBody;
+        if (this.hasReturn) {
+            // Code contains return, wrap in function directly
+            functionBody = codeToExecute;
+        }
+        else {
+            // No return, add implicit return
+            functionBody = `return (${codeToExecute})`;
+        }
+        try {
+            // Create function with context variables as parameters
+            const fn = new Function(...keys, functionBody);
+            return fn.apply(null, values);
+        }
+        catch (syntaxError) {
+            // If implicit return fails, try without it (for statements)
+            if (!this.hasReturn) {
+                try {
+                    const fn = new Function(...keys, codeToExecute);
+                    return fn.apply(null, values);
+                }
+                catch {
+                    throw syntaxError;
+                }
+            }
+            throw syntaxError;
+        }
+    }
+    /**
+     * Выполнить в контексте (асинхронно)
+     */
+    async executeInContextAsync(context, codeOverride) {
+        const keys = Object.keys(context);
+        const values = Object.values(context);
+        const codeToExecute = codeOverride ?? this.code;
+        let functionBody;
+        if (this.hasReturn) {
+            functionBody = codeToExecute;
+        }
+        else {
+            functionBody = `return (${codeToExecute})`;
+        }
+        try {
+            // Create async function
+            const AsyncFunction = Object.getPrototypeOf(async function () { }).constructor;
+            const fn = new AsyncFunction(...keys, functionBody);
+            return await fn.apply(null, values);
+        }
+        catch (syntaxError) {
+            if (!this.hasReturn) {
+                try {
+                    const AsyncFunction = Object.getPrototypeOf(async function () { }).constructor;
+                    const fn = new AsyncFunction(...keys, codeToExecute);
+                    return await fn.apply(null, values);
+                }
+                catch {
+                    throw syntaxError;
+                }
+            }
+            throw syntaxError;
+        }
+    }
+    /**
+     * Проверить, является ли выражение асинхронным
+     */
+    isAsyncExpression() {
+        return this.isAsync;
+    }
+    /**
+     * Выполнить выражение (авто-выбор sync/async)
+     */
+    eval(scope, extraVars) {
+        if (this.isAsync) {
+            return this.executeAsync(scope, extraVars);
+        }
+        return this.execute(scope, extraVars);
+    }
+    /**
+     * Статический метод для быстрого выполнения
+     */
+    static evaluate(code, scope, extraVars) {
+        const expr = new Expression(code);
+        return expr.eval(scope, extraVars);
+    }
+    /**
+     * Статический метод для асинхронного выполнения
+     */
+    static async evaluateAsync(code, scope, extraVars) {
+        const expr = new Expression(code);
+        return await expr.executeAsync(scope, extraVars);
+    }
+}
+//# sourceMappingURL=Expression.js.map

package/out/foundation/engine/Expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Expression.js","sourceRoot":"","sources":["../../../src/foundation/engine/Expression.ts"],"names":[],"mappings":"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"}

package/out/foundation/engine/Rule.d.ts

@@ -0,0 +1,83 @@
+import Scope from './Scope.js';
+/**
+ * RuleMatch - результат поиска Rule в шаблоне
+ */
+export interface RuleMatch {
+    /** Полное совпадение включая синтаксис Rule */
+    fullMatch: string;
+    /** Начальная позиция в исходной строке */
+    start: number;
+    /** Конечная позиция в исходной строке */
+    end: number;
+    /** Дополнительные данные специфичные для Rule */
+    data?: Record<string, any>;
+}
+/**
+ * RuleResult - результат выполнения Rule
+ */
+export interface RuleResult {
+    /** HTML-результат для замены */
+    output: string;
+    /** Использованные Observable для отслеживания */
+    observables?: any[];
+    /** Дочерние Rule (для вложенных структур) */
+    children?: Rule[];
+}
+/**
+ * RuleType - тип Rule
+ */
+export type RuleType = 'syntax' | 'attribute';
+/**
+ * Rule - базовый абстрактный класс для всех правил шаблонизатора.
+ */
+export default abstract class Rule {
+    /** Уникальное имя правила */
+    abstract readonly name: string;
+    /** Тип правила: syntax или attribute */
+    abstract readonly type: RuleType;
+    /** Приоритет выполнения (меньше = раньше) */
+    readonly priority: number;
+    /**
+     * Найти все вхождения этого Rule в шаблоне.
+     * @param template - исходный шаблон
+     * @returns массив найденных совпадений
+     */
+    abstract find(template: string): RuleMatch[];
+    /**
+     * Выполнить Rule и вернуть результат.
+     * @param match - найденное совпадение
+     * @param scope - текущий Scope
+     * @param engine - ссылка на TemplateEngine (для рекурсивной обработки)
+     */
+    abstract execute(match: RuleMatch, scope: Scope, engine?: any): RuleResult | Promise<RuleResult>;
+    /**
+     * Проверить, поддерживает ли Rule Observable значения
+     */
+    supportsObservable(): boolean;
+}
+/**
+ * SyntaxRule - базовый класс для синтаксических правил.
+ * Синтаксические правила могут быть в любом месте шаблона (кроме атрибутов).
+ */
+export declare abstract class SyntaxRule extends Rule {
+    readonly type: RuleType;
+}
+/**
+ * AttributeRule - базовый класс для атрибутивных правил.
+ * Атрибутивные правила работают только внутри HTML-тегов.
+ */
+export declare abstract class AttributeRule extends Rule {
+    readonly type: RuleType;
+    /**
+     * Получить элемент, к которому применяется атрибут.
+     * @param template - шаблон
+     * @param attributePosition - позиция атрибута
+     * @returns информация об элементе
+     */
+    protected findParentElement(template: string, attributePosition: number): {
+        tagName: string;
+        tagStart: number;
+        tagEnd: number;
+    } | null;
+}
+//# sourceMappingURL=Rule.d.ts.map

package/out/foundation/engine/Rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../../src/foundation/engine/Rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,IAAI;IAC9B,6BAA6B;IAC7B,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,wCAAwC;IACxC,kBAAyB,IAAI,EAAE,QAAQ,CAAC;IAExC,6CAA6C;IAC7C,SAAgB,QAAQ,EAAE,MAAM,CAAO;IAEvC;;;;OAIG;aACa,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAEnD;;;;;OAKG;aACa,OAAO,CACnB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,GAAG,GACb,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAEnC;;OAEG;IACI,kBAAkB,IAAI,OAAO;CAGvC;AAED;;;GAGG;AACH,8BAAsB,UAAW,SAAQ,IAAI;IACzC,SAAgB,IAAI,EAAE,QAAQ,CAAY;CAC7C;AAED;;;GAGG;AACH,8BAAsB,aAAc,SAAQ,IAAI;IAC5C,SAAgB,IAAI,EAAE,QAAQ,CAAe;IAE7C;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CACvB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,GAC1B;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAqClE"}

package/out/foundation/engine/Rule.js

@@ -0,0 +1,69 @@
+/**
+ * Rule - базовый абстрактный класс для всех правил шаблонизатора.
+ */
+export default class Rule {
+    /** Приоритет выполнения (меньше = раньше) */
+    priority = 100;
+    /**
+     * Проверить, поддерживает ли Rule Observable значения
+     */
+    supportsObservable() {
+        return true;
+    }
+}
+/**
+ * SyntaxRule - базовый класс для синтаксических правил.
+ * Синтаксические правила могут быть в любом месте шаблона (кроме атрибутов).
+ */
+export class SyntaxRule extends Rule {
+    type = 'syntax';
+}
+/**
+ * AttributeRule - базовый класс для атрибутивных правил.
+ * Атрибутивные правила работают только внутри HTML-тегов.
+ */
+export class AttributeRule extends Rule {
+    type = 'attribute';
+    /**
+     * Получить элемент, к которому применяется атрибут.
+     * @param template - шаблон
+     * @param attributePosition - позиция атрибута
+     * @returns информация об элементе
+     */
+    findParentElement(template, attributePosition) {
+        // Find opening < before attribute
+        let tagStart = attributePosition;
+        while (tagStart > 0 && template[tagStart] !== '<') {
+            tagStart--;
+        }
+        if (template[tagStart] !== '<') {
+            return null;
+        }
+        // Extract tag name
+        let nameEnd = tagStart + 1;
+        while (nameEnd < template.length && /[a-zA-Z0-9_-]/.test(template[nameEnd])) {
+            nameEnd++;
+        }
+        const tagName = template.slice(tagStart + 1, nameEnd);
+        // Find closing >
+        let tagEnd = attributePosition;
+        let inString = false;
+        let stringChar = '';
+        while (tagEnd < template.length) {
+            const ch = template[tagEnd];
+            if (!inString && (ch === '"' || ch === "'")) {
+                inString = true;
+                stringChar = ch;
+            }
+            else if (inString && ch === stringChar) {
+                inString = false;
+            }
+            else if (!inString && ch === '>') {
+                break;
+            }
+            tagEnd++;
+        }
+        return { tagName, tagStart, tagEnd: tagEnd + 1 };
+    }
+}
+//# sourceMappingURL=Rule.js.map

package/out/foundation/engine/Rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../../src/foundation/engine/Rule.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAgB,IAAI;IAO9B,6CAA6C;IAC7B,QAAQ,GAAW,GAAG,CAAC;IAqBvC;;OAEG;IACI,kBAAkB;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,OAAgB,UAAW,SAAQ,IAAI;IACzB,IAAI,GAAa,QAAQ,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,OAAgB,aAAc,SAAQ,IAAI;IAC5B,IAAI,GAAa,WAAW,CAAC;IAE7C;;;;;OAKG;IACO,iBAAiB,CACvB,QAAgB,EAChB,iBAAyB;QAEzB,kCAAkC;QAClC,IAAI,QAAQ,GAAG,iBAAiB,CAAC;QACjC,OAAO,QAAQ,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;YAChD,QAAQ,EAAE,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,mBAAmB;QACnB,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC3B,OAAO,OAAO,GAAG,QAAQ,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC1E,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAEtD,iBAAiB;QACjB,IAAI,MAAM,GAAG,iBAAiB,CAAC;QAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,OAAO,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1C,QAAQ,GAAG,IAAI,CAAC;gBAChB,UAAU,GAAG,EAAE,CAAC;YACpB,CAAC;iBAAM,IAAI,QAAQ,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;gBACvC,QAAQ,GAAG,KAAK,CAAC;YACrB,CAAC;iBAAM,IAAI,CAAC,QAAQ,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACjC,MAAM;YACV,CAAC;YACD,MAAM,EAAE,CAAC;QACb,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IACrD,CAAC;CACJ"}

package/out/foundation/engine/Scope.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Scope - класс для работы с контекстом переменных и функций.
+ * Поддерживает объединение нескольких Scope, извлечение полей из объектов и классов.
+ */
+export default class Scope {
+    private variables;
+    private readonly debugWarnings;
+    constructor(options?: {
+        debugWarnings?: boolean;
+    });
+    /**
+     * Получить все переменные Scope как Record
+     */
+    getVariables(): Record<string, any>;
+    /**
+     * Установить переменную в Scope
+     */
+    set(key: string, value: any): void;
+    /**
+     * Получить переменную из Scope
+     */
+    get(key: string): any;
+    /**
+     * Проверить наличие переменной
+     */
+    has(key: string): boolean;
+    /**
+     * Удалить переменную из Scope
+     */
+    delete(key: string): boolean;
+    /**
+     * Объединить другой Scope или объект в текущий Scope.
+     * При конфликте имён выводится предупреждение, последнее значение имеет приоритет.
+     */
+    merge(source: Scope | Record<string, any> | object): Scope;
+    /**
+     * Создать дочерний (локальный) Scope на основе текущего.
+     * Изменения в дочернем Scope не влияют на родительский.
+     */
+    createChild(localVariables?: Record<string, any>): Scope;
+    /**
+     * Извлечь поля и методы из объекта или экземпляра класса.
+     * Пропускает нативные DOM/браузерные прототипы.
+     */
+    extractFromObject(obj: object): Record<string, any>;
+    /**
+     * Статический метод для создания Scope из объекта
+     */
+    static from(source: object | Record<string, any>, options?: {
+        debugWarnings?: boolean;
+    }): Scope;
+    /**
+     * Статический метод для объединения нескольких Scope/объектов
+     */
+    static combine(...sources: (Scope | Record<string, any> | object)[]): Scope;
+}
+//# sourceMappingURL=Scope.d.ts.map

package/out/foundation/engine/Scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scope.d.ts","sourceRoot":"","sources":["../../../src/foundation/engine/Scope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;IACtB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE;IAIjD;;OAEG;IACI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI1C;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAOzC;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAI5B;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQnC;;;OAGG;IACI,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,KAAK;IAejE;;;OAGG;IACI,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK;IAa/D;;;OAGG;IACI,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAoD1D;;OAEG;WACW,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK;IAMtG;;OAEG;WACW,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK;CAOrF"}