@reidelsaltres/pureper 0.1.157 → 0.1.162

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

@@ -0,0 +1,219 @@
+import Scope from './Scope.js';
+import Observable from '../api/Observer.js';
+import Rule, { RuleMatch, RuleResult } from './Rule.js';
+/**
+ * TemplateChangeEvent - событие изменения шаблона
+ */
+export interface TemplateChangeEvent {
+    oldValue: any;
+    newValue: any;
+    oldTemplate: string;
+    newTemplate: string;
+}
+/**
+ * FragmentChangeEvent - событие изменения конкретного фрагмента
+ */
+export interface FragmentChangeEvent {
+    fragmentId: string;
+    oldFragment: DocumentFragment | null;
+    newFragment: DocumentFragment;
+    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 - привязка фрагмента к DOM
+ */
+export interface FragmentBinding {
+    /** Уникальный ID фрагмента */
+    id: string;
+    /** Текущий HTML контент фрагмента */
+    html: string;
+    /** Кэшированный DocumentFragment */
+    fragment: DocumentFragment | null;
+    /** Секции, входящие в этот фрагмент */
+    sections: TemplateSection[];
+    /** Observable, от которых зависит фрагмент */
+    observables: Set<Observable<any>>;
+    /** Начальный маркер в DOM (комментарий) */
+    startMarker?: Comment;
+    /** Конечный маркер в DOM (комментарий) */
+    endMarker?: Comment;
+    /** Текущие DOM ноды между маркерами */
+    nodes: Node[];
+}
+/**
+ * PageTemplate - динамический шаблон страницы.
+ * Хранит обработанные Rule и поддерживает реактивное обновление.
+ *
+ * При изменении Observable обновляются только те фрагменты,
+ * которые зависят от изменённого Observable.
+ */
+export default class TemplateInstance {
+    private template;
+    private scope;
+    private sections;
+    /** Фрагменты шаблона (каждый обновляется независимо) */
+    private fragments;
+    /** Счётчик для генерации ID фрагментов */
+    private fragmentIdCounter;
+    /** Observers for template changes */
+    private changeObserver;
+    /** Observers for fragment changes */
+    private fragmentChangeObserver;
+    /** Группировка секций по Observable */
+    private observableTrackings;
+    /** Функции отписки от событий */
+    private eventUnbinders;
+    /** Кэшированный главный фрагмент */
+    private cachedFragment;
+    constructor(template: string, scope: Scope);
+    /**
+     * Получить текущий шаблон
+     */
+    getTemplate(): string;
+    /**
+     * Установить новый шаблон (вызывает событие изменения)
+     */
+    setTemplate(newTemplate: string): void;
+    /**
+     * Получить Scope
+     */
+    getScope(): Scope;
+    /**
+     * Подписаться на изменения шаблона
+     */
+    onTemplateChange(listener: (oldValue: any, newValue: any, oldTemplate: string, newTemplate: string) => void): () => void;
+    /**
+     * Подписаться на изменения фрагментов
+     */
+    onFragmentChange(listener: (event: FragmentChangeEvent) => void): () => void;
+    /**
+     * Добавить секцию шаблона
+     */
+    addSection(section: TemplateSection): void;
+    /**
+     * Получить все секции
+     */
+    getSections(): TemplateSection[];
+    /**
+     * Создать новый фрагмент и вернуть его ID
+     */
+    createFragmentBinding(html: string, sections?: TemplateSection[]): string;
+    /**
+     * Получить привязку фрагмента по ID
+     */
+    getFragmentBinding(id: string): FragmentBinding | undefined;
+    /**
+     * Получить все фрагменты
+     */
+    getAllFragments(): Map<string, FragmentBinding>;
+    /**
+     * Подписаться на Observable и автоматически пересоздавать секцию.
+     * Обновляются только фрагменты, зависящие от изменённого Observable.
+     */
+    trackObservable(observable: Observable<any>, section: TemplateSection, rebuild: (section: TemplateSection) => RuleResult): () => void;
+    /**
+     * Перестроить только те фрагменты, которые зависят от Observable
+     */
+    private rebuildFragmentsForObservable;
+    /**
+     * Заменить фрагмент в DOM между маркерами
+     */
+    private replaceFragmentInDOM;
+    /**
+     * Создать DocumentFragment из HTML строки
+     */
+    private createFragmentFromHtml;
+    /**
+     * Отписаться от вложенных Observable в секции (но не от главного)
+     */
+    private unsubscribeSectionNested;
+    /**
+     * Отписаться от всех Observable в секции
+     */
+    private unsubscribeSection;
+    /**
+     * Создать DocumentFragment из текущего шаблона (весь шаблон).
+     * Кэширует фрагмент - повторные вызовы возвращают тот же фрагмент.
+     * После appendChild фрагмент будет пустым, но ссылки на элементы остаются валидными.
+     */
+    createFragment(): DocumentFragment;
+    /**
+     * Инвалидировать кэш фрагмента (для пересоздания)
+     */
+    invalidateFragment(): void;
+    /**
+     * Создать и вставить все фрагменты в контейнер с маркерами
+     */
+    createAllFragmentsWithMarkers(container: Element): void;
+    /**
+     * Получить DocumentFragment для конкретного фрагмента
+     */
+    getFragmentById(id: string): DocumentFragment | null;
+    /**
+     * Получить кэшированный DocumentFragment (deprecated)
+     * @deprecated Используйте getFragmentById
+     */
+    getFragment(): DocumentFragment | null;
+    /**
+     * Пересоздать все фрагменты
+     */
+    rebuildAllFragments(): void;
+    /**
+     * Пересоздать fragment (deprecated)
+     * @deprecated Используйте rebuildAllFragments или конкретный фрагмент
+     */
+    rebuildFragment(): DocumentFragment;
+    /**
+     * Очистить все подписки
+     */
+    dispose(): void;
+    /**
+     * Привязать refs к элементам
+     * @param root - DOM элемент для поиска refs. Если не указан, создаётся фрагмент из шаблона
+     */
+    bindRefs(): void;
+    /**
+     * Обработать инжекции (@injection[head/tail])
+     * Должен вызываться после bindRefs
+     */
+    processInjections(root: Element | DocumentFragment): void;
+    /**
+     * Привязать события к элементам из кэшированного фрагмента
+     */
+    bindEvents(): void;
+    /**
+     * Привязать события к одному элементу
+     */
+    private bindEventsToElement;
+    /**
+     * Отвязать все события
+     */
+    unbindEvents(): void;
+    /**
+     * Отвязать refs (установить null)
+     */
+    unbindRefs(): void;
+}
+//# sourceMappingURL=TemplateInstance.old.d.ts.map

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

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