@reidelsaltres/pureper 0.1.157 → 0.1.162

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

@@ -0,0 +1,96 @@
+import Scope from './Scope.js';
+import Expression from './Expression.js';
+import TemplateInstance, { TemplateSection } from './TemplateInstance.js';
+import Rule, { SyntaxRule, AttributeRule } from './Rule.js';
+import Observable from '../api/Observer.js';
+import ExpressionRule from './rules/syntax/ExpressionRule.js';
+import IfRule from './rules/syntax/IfRule.js';
+import ForRule from './rules/syntax/ForRule.js';
+import RefRule from './rules/attribute/RefRule.js';
+import EventRule from './rules/attribute/EventRule.js';
+import InjectionRule from './rules/attribute/InjectionRule.js';
+/**
+ * TemplateEngineOptions - настройки TemplateEngine
+ */
+export interface TemplateEngineOptions {
+    /** Оставлять синтаксис атрибутивных Rule в финальном HTML */
+    showAttributeRule?: boolean;
+    /** Включить предупреждения отладки */
+    debugWarnings?: boolean;
+}
+/**
+ * ProcessResult - результат обработки шаблона
+ */
+export interface ProcessResult {
+    output: string;
+    observables: Observable<any>[];
+    sections: TemplateSection[];
+    /** ID созданного фрагмента (если был создан) */
+    fragmentId?: string;
+}
+/**
+ * TemplateEngine - главный класс шаблонизатора.
+ * Обрабатывает HTML-шаблон с Rule и создаёт TemplateInstance.
+ */
+export default class TemplateEngine {
+    private readonly scope;
+    private readonly options;
+    private readonly syntaxRules;
+    private readonly attributeRules;
+    constructor(scope: Scope | object, options?: TemplateEngineOptions);
+    /**
+     * Зарегистрировать стандартные правила
+     */
+    private registerDefaultRules;
+    /**
+     * Добавить пользовательское правило
+     */
+    addRule(rule: Rule): void;
+    /**
+     * Получить Scope
+     */
+    getScope(): Scope;
+    /**
+     * Обработать шаблон и вернуть TemplateInstance
+     */
+    parse(template: string): TemplateInstance;
+    /**
+     * Обработать шаблон с созданием фрагментов
+     */
+    private processTemplateWithFragments;
+    /**
+     * Обработать шаблон (внутренний метод, используется Rule для рекурсии)
+     */
+    processTemplate(template: string, scope: Scope): ProcessResult;
+    /**
+     * Обработать одно правило
+     */
+    private processRule;
+    /**
+     * Удалить синтаксис атрибутивных Rule из финального HTML
+     */
+    private removeAttributeSyntax;
+    /**
+     * Добавить новый шаблон в существующий TemplateInstance.
+     * Обрабатывает шаблон и добавляет результат как новый фрагмент.
+     * Если instance привязан к контейнерам, DOM обновится автоматически.
+     *
+     * @param instance - существующий TemplateInstance
+     * @param template - новый шаблон для добавления
+     * @param customScope - опциональный scope для нового шаблона
+     * @returns ID созданного фрагмента
+     */
+    appendTemplate(instance: TemplateInstance, template: string, customScope?: Scope | object): string;
+    /**
+     * Статический метод для быстрой обработки
+     */
+    static process(template: string, scope: object, options?: TemplateEngineOptions): string;
+    /**
+     * Создать TemplateInstance из шаблона
+     */
+    static create(template: string, scope: object, options?: TemplateEngineOptions): TemplateInstance;
+}
+export { Scope, Expression, TemplateInstance, Rule, SyntaxRule, AttributeRule };
+export { ExpressionRule, IfRule, ForRule, RefRule, EventRule, InjectionRule };
+export * from './exceptions/TemplateExceptions.js';
+//# sourceMappingURL=TemplateEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../../src/foundation/engine/TemplateEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC,OAAO,gBAAgB,EAAE,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,IAAI,EAAE,EAAyB,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAG5C,OAAO,cAAc,MAAM,kCAAkC,CAAC;AAC9D,OAAO,MAAM,MAAM,0BAA0B,CAAC;AAC9C,OAAO,OAAO,MAAM,2BAA2B,CAAC;AAChD,OAAO,OAAO,MAAM,8BAA8B,CAAC;AACnD,OAAO,SAAS,MAAM,gCAAgC,CAAC;AACvD,OAAO,aAAa,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAE1C,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAYlE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAUhC;;OAEG;IACI,QAAQ,IAAI,KAAK;IAIxB;;OAEG;IACI,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAwBhD;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,aAAa;IAyCrE;;OAEG;IACH,OAAO,CAAC,WAAW;IA8CnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;;;;;;;OASG;IACI,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM;IAiCzG;;OAEG;WACW,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM;IAM/F;;OAEG;WACW,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,gBAAgB;CAI3G;AAGD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAC9E,cAAc,oCAAoC,CAAC"}

package/out/foundation/engine/TemplateEngine.js

@@ -0,0 +1,235 @@
+import Scope from './Scope.js';
+import Expression from './Expression.js';
+import EscapeHandler from './EscapeHandler.js';
+import TemplateInstance from './TemplateInstance.js';
+import Rule, { SyntaxRule, AttributeRule } from './Rule.js';
+// Import rules
+import ExpressionRule from './rules/syntax/ExpressionRule.js';
+import IfRule from './rules/syntax/IfRule.js';
+import ForRule from './rules/syntax/ForRule.js';
+import RefRule from './rules/attribute/RefRule.js';
+import EventRule from './rules/attribute/EventRule.js';
+import InjectionRule from './rules/attribute/InjectionRule.js';
+/**
+ * TemplateEngine - главный класс шаблонизатора.
+ * Обрабатывает HTML-шаблон с Rule и создаёт TemplateInstance.
+ */
+export default class TemplateEngine {
+    scope;
+    options;
+    syntaxRules = [];
+    attributeRules = [];
+    constructor(scope, options) {
+        this.scope = scope instanceof Scope ? scope : Scope.from(scope);
+        this.options = {
+            showAttributeRule: false,
+            debugWarnings: true,
+            ...options
+        };
+        // Register default rules (sorted by priority)
+        this.registerDefaultRules();
+    }
+    /**
+     * Зарегистрировать стандартные правила
+     */
+    registerDefaultRules() {
+        // Syntax rules
+        this.syntaxRules.push(new ForRule());
+        this.syntaxRules.push(new IfRule());
+        this.syntaxRules.push(new ExpressionRule());
+        // Attribute rules
+        this.attributeRules.push(new RefRule());
+        this.attributeRules.push(new EventRule());
+        this.attributeRules.push(new InjectionRule());
+        // Sort by priority
+        this.syntaxRules.sort((a, b) => a.priority - b.priority);
+        this.attributeRules.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Добавить пользовательское правило
+     */
+    addRule(rule) {
+        if (rule.type === 'syntax') {
+            this.syntaxRules.push(rule);
+            this.syntaxRules.sort((a, b) => a.priority - b.priority);
+        }
+        else {
+            this.attributeRules.push(rule);
+            this.attributeRules.sort((a, b) => a.priority - b.priority);
+        }
+    }
+    /**
+     * Получить Scope
+     */
+    getScope() {
+        return this.scope;
+    }
+    /**
+     * Обработать шаблон и вернуть TemplateInstance
+     */
+    parse(template) {
+        const templateInstance = new TemplateInstance(this.scope);
+        const result = this.processTemplateWithFragments(template, this.scope, templateInstance, null);
+        // Устанавливаем корневой фрагмент
+        if (result.fragmentId) {
+            templateInstance.setRootFragment(result.fragmentId);
+        }
+        // Add sections and track observables
+        for (const section of result.sections) {
+            templateInstance.addSection(section);
+            // Track observables
+            for (const observable of section.result.observables || []) {
+                templateInstance.trackObservable(observable, section, (s) => {
+                    return this.processTemplate(s.sourceTemplate, this.scope);
+                });
+            }
+        }
+        return templateInstance;
+    }
+    /**
+     * Обработать шаблон с созданием фрагментов
+     */
+    processTemplateWithFragments(template, scope, instance, parentFragmentId) {
+        const result = this.processTemplate(template, scope);
+        // Создаём фрагмент для этого результата
+        const fragmentId = instance.createFragment(result.output, template, result.sections, parentFragmentId);
+        return {
+            ...result,
+            fragmentId
+        };
+    }
+    /**
+     * Обработать шаблон (внутренний метод, используется Rule для рекурсии)
+     */
+    processTemplate(template, scope) {
+        const allObservables = [];
+        const allSections = [];
+        // Step 1: Handle @@ escape sequences
+        let processed = EscapeHandler.process(template, (escaped) => {
+            let result = escaped;
+            // Step 2: Process syntax rules (in priority order)
+            for (const rule of this.syntaxRules) {
+                result = this.processRule(rule, result, scope, allObservables, allSections);
+            }
+            // Step 3: Process attribute rules
+            for (const rule of this.attributeRules) {
+                // Skip injection - processed last
+                if (rule.name === 'injection')
+                    continue;
+                result = this.processRule(rule, result, scope, allObservables, allSections);
+            }
+            return result;
+        });
+        // Step 4: Process injection rules last
+        const injectionRule = this.attributeRules.find(r => r.name === 'injection');
+        if (injectionRule) {
+            processed = this.processRule(injectionRule, processed, scope, allObservables, allSections);
+        }
+        // Step 5: Handle showAttributeRule option
+        if (!this.options.showAttributeRule) {
+            processed = this.removeAttributeSyntax(processed);
+        }
+        return {
+            output: processed,
+            observables: allObservables,
+            sections: allSections
+        };
+    }
+    /**
+     * Обработать одно правило
+     */
+    processRule(rule, template, scope, observables, sections) {
+        const matches = rule.find(template);
+        // Sort matches by position (reverse to process from end)
+        matches.sort((a, b) => b.start - a.start);
+        let result = template;
+        for (const match of matches) {
+            try {
+                const ruleResult = rule.execute(match, scope, this);
+                // Track observables
+                if (ruleResult.observables) {
+                    observables.push(...ruleResult.observables);
+                }
+                // Create section
+                const section = {
+                    rule,
+                    match,
+                    result: ruleResult,
+                    sourceTemplate: match.fullMatch,
+                    children: [],
+                    subscriptions: []
+                };
+                sections.push(section);
+                // Replace in template
+                result = result.slice(0, match.start) + ruleResult.output + result.slice(match.end);
+            }
+            catch (error) {
+                console.error(`[TemplateEngine] Error processing rule "${rule.name}":`, error);
+                // Continue processing other rules
+            }
+        }
+        return result;
+    }
+    /**
+     * Удалить синтаксис атрибутивных Rule из финального HTML
+     */
+    removeAttributeSyntax(template) {
+        // Remove @[ref], @on[...], @injection[...] patterns that weren't processed
+        return template
+            .replace(/@\[ref\]\s*=\s*["'][^"']*["']/gi, '')
+            .replace(/@on\[[a-zA-Z]+\]\s*=\s*["'][^"']*["']/gi, '')
+            .replace(/@injection\[(head|tail)\]\s*=\s*["'][^"']*["']/gi, '');
+    }
+    /**
+     * Добавить новый шаблон в существующий TemplateInstance.
+     * Обрабатывает шаблон и добавляет результат как новый фрагмент.
+     * Если instance привязан к контейнерам, DOM обновится автоматически.
+     *
+     * @param instance - существующий TemplateInstance
+     * @param template - новый шаблон для добавления
+     * @param customScope - опциональный scope для нового шаблона
+     * @returns ID созданного фрагмента
+     */
+    appendTemplate(instance, template, customScope) {
+        const scope = customScope
+            ? (customScope instanceof Scope ? customScope : Scope.from(customScope))
+            : instance.getScope();
+        // Обрабатываем шаблон
+        const result = this.processTemplate(template, scope);
+        // Создаём фрагмент
+        const fragmentId = instance.createFragment(result.output, template, result.sections, null // без родителя - это отдельный фрагмент
+        );
+        // Добавляем секции и отслеживаем Observable
+        for (const section of result.sections) {
+            instance.addSection(section);
+            for (const observable of section.result.observables || []) {
+                instance.trackObservable(observable, section, (s) => {
+                    return this.processTemplate(s.sourceTemplate, scope);
+                });
+            }
+        }
+        // Вставляем в привязанные контейнеры
+        instance.insertAppendedFragment(fragmentId);
+        return fragmentId;
+    }
+    /**
+     * Статический метод для быстрой обработки
+     */
+    static process(template, scope, options) {
+        const engine = new TemplateEngine(scope, options);
+        const TemplateInstance = engine.parse(template);
+        return TemplateInstance.getTemplate();
+    }
+    /**
+     * Создать TemplateInstance из шаблона
+     */
+    static create(template, scope, options) {
+        const engine = new TemplateEngine(scope, options);
+        return engine.parse(template);
+    }
+}
+// Re-export useful types
+export { Scope, Expression, TemplateInstance, Rule, SyntaxRule, AttributeRule };
+export { ExpressionRule, IfRule, ForRule, RefRule, EventRule, InjectionRule };
+export * from './exceptions/TemplateExceptions.js';
+//# sourceMappingURL=TemplateEngine.js.map

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

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

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

@@ -0,0 +1,241 @@
+import Scope from './Scope.js';
+import Observable from '../api/Observer.js';
+import Rule, { RuleMatch, RuleResult } from './Rule.js';
+/**
+ * FragmentChangeEvent - событие изменения конкретного фрагмента
+ */
+export interface FragmentChangeEvent {
+    fragmentId: string;
+    oldNodes: Node[];
+    newNodes: Node[];
+    affectedObservables: Observable<any>[];
+}
+/**
+ * TemplateSection - секция шаблона, связанная с Rule
+ */
+export interface TemplateSection {
+    /** Rule который создал эту секцию */
+    rule: Rule;
+    /** Оригинальный match */
+    match: RuleMatch;
+    /** Текущий результат */
+    result: RuleResult;
+    /** Исходный шаблон секции (для пересоздания) */
+    sourceTemplate: string;
+    /** Дочерние секции */
+    children: TemplateSection[];
+    /** Observable подписки для отслеживания */
+    subscriptions: Array<{
+        observable: Observable<any>;
+        unsubscribe: () => void;
+    }>;
+    /** ID фрагмента, к которому принадлежит секция */
+    fragmentId?: string;
+}
+/**
+ * FragmentBinding - привязка фрагмента
+ */
+export interface FragmentBinding {
+    /** Уникальный ID фрагмента */
+    id: string;
+    /** Текущий HTML контент фрагмента (с placeholder-ами для дочерних) */
+    html: string;
+    /** Исходный шаблон (до обработки) */
+    sourceTemplate: string;
+    /** Секции, входящие в этот фрагмент */
+    sections: TemplateSection[];
+    /** Observable, от которых зависит фрагмент */
+    observables: Set<Observable<any>>;
+    /** ID родительского фрагмента (null для корневого) */
+    parentId: string | null;
+    /** ID дочерних фрагментов (placeholder-ы) */
+    childIds: string[];
+}
+/**
+ * ContainerBinding - привязка к DOM-контейнеру
+ */
+export interface ContainerBinding {
+    /** DOM-контейнер */
+    container: Element;
+    /** Маркеры фрагментов в этом контейнере: fragmentId -> { start, end, nodes } */
+    markers: Map<string, {
+        startMarker: Comment;
+        endMarker: Comment;
+        nodes: Node[];
+    }>;
+    /** Функции отписки событий для этого контейнера */
+    eventUnbinders: Array<() => void>;
+}
+/**
+ * TemplateInstance - динамический шаблон страницы.
+ *
+ * Поддерживает:
+ * - Множество мелких фрагментов, каждый обновляется независимо
+ * - Множество container bindings
+ * - Автоматическое обновление DOM при изменении Observable
+ * - bind/unbind для refs и events
+ */
+export default class TemplateInstance {
+    private scope;
+    private sections;
+    /** Все фрагменты шаблона */
+    private fragments;
+    /** ID корневого фрагмента */
+    private rootFragmentId;
+    /** Счётчик для генерации ID фрагментов */
+    private fragmentIdCounter;
+    /** Observers for fragment changes */
+    private fragmentChangeObserver;
+    /** Группировка секций по Observable */
+    private observableTrackings;
+    /** Привязки к контейнерам */
+    private containerBindings;
+    constructor(scope: Scope);
+    /**
+     * Получить Scope
+     */
+    getScope(): Scope;
+    /**
+     * Получить все секции
+     */
+    getSections(): TemplateSection[];
+    /**
+     * Получить все фрагменты
+     */
+    getAllFragments(): Map<string, FragmentBinding>;
+    /**
+     * Получить фрагмент по ID
+     */
+    getFragmentBinding(id: string): FragmentBinding | undefined;
+    /**
+     * Получить финальный HTML (собранный из всех фрагментов)
+     */
+    getTemplate(): string;
+    /**
+     * Создать новый фрагмент и вернуть его ID
+     */
+    createFragment(html: string, sourceTemplate: string, sections?: TemplateSection[], parentId?: string | null): string;
+    /**
+     * Установить корневой фрагмент
+     */
+    setRootFragment(id: string): void;
+    /**
+     * Добавить секцию шаблона
+     */
+    addSection(section: TemplateSection): void;
+    /**
+     * Вставить добавленный фрагмент во все привязанные контейнеры.
+     * Вызывается после appendTemplate.
+     */
+    insertAppendedFragment(fragmentId: string): void;
+    /**
+     * Привязать события только для нового фрагмента
+     */
+    private bindEventsForNewFragment;
+    /**
+     * Подписаться на изменения фрагментов
+     */
+    onFragmentChange(listener: (event: FragmentChangeEvent) => void): () => void;
+    /**
+     * Подписаться на Observable и автоматически пересоздавать секцию
+     */
+    trackObservable(observable: Observable<any>, section: TemplateSection, rebuild: (section: TemplateSection) => RuleResult): () => void;
+    /**
+     * Привязать к контейнеру.
+     * Вставляет DOM, вызывает bindRefs, processInjections и bindEvents.
+     */
+    bind(container: Element): void;
+    /**
+     * Отвязать от контейнера.
+     * Отвязывает refs и events, но оставляет DOM.
+     */
+    unbind(container: Element): void;
+    /**
+     * Привязать refs к элементам.
+     * Если есть контейнеры - привязывает для них.
+     * Если нет - создаёт временный DocumentFragment и привязывает refs из него.
+     */
+    bindRefs(): void;
+    /**
+     * Привязать refs из DocumentFragment (без контейнера)
+     */
+    private bindRefsForFragment;
+    /**
+     * Отвязать refs (для всех контейнеров)
+     */
+    unbindRefs(): void;
+    /**
+     * Привязать события (для всех контейнеров)
+     */
+    bindEvents(): void;
+    /**
+     * Отвязать события (для всех контейнеров)
+     */
+    unbindEvents(): void;
+    /**
+     * Очистить все подписки и bindings
+     */
+    dispose(): void;
+    /**
+     * Вставить все фрагменты в контейнер с маркерами
+     */
+    private insertFragmentsIntoContainer;
+    /**
+     * Рекурсивно вставить фрагмент и его дочерние
+     */
+    private insertFragmentRecursive;
+    /**
+     * Создать ноды из HTML строки
+     */
+    private createNodesFromHtml;
+    /**
+     * Собрать HTML из фрагмента (рекурсивно заменяя placeholder-ы)
+     */
+    private buildHtmlFromFragment;
+    /**
+     * Привязать refs для конкретного контейнера
+     */
+    private bindRefsForContainer;
+    /**
+     * Обработать инжекции для конкретного контейнера.
+     * Находит элементы с data-injection-* атрибутами и перемещает их в целевые элементы.
+     */
+    private processInjectionsForContainer;
+    /**
+     * Отвязать refs для конкретного контейнера
+     */
+    private unbindRefsForContainer;
+    /**
+     * Привязать события для конкретного контейнера
+     */
+    private bindEventsForContainer;
+    /**
+     * Привязать события к одному элементу
+     */
+    private bindEventsToElement;
+    /**
+     * Перестроить фрагменты при изменении Observable
+     */
+    private rebuildFragmentsForObservable;
+    /**
+     * Обновить фрагмент во всех контейнерах
+     */
+    private updateFragmentInAllContainers;
+    /**
+     * Отвязать события от нод
+     */
+    private unbindEventsFromNodes;
+    /**
+     * Отписаться от вложенных Observable в секции
+     */
+    private unsubscribeSectionNested;
+    /**
+     * Отписаться от всех Observable в секции
+     */
+    private unsubscribeSection;
+    /**
+     * @deprecated Используйте bind(container)
+     */
+    createDOMFragment(): DocumentFragment;
+}
+//# sourceMappingURL=TemplateInstance.d.ts.map

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

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