@reidelsaltres/pureper 0.1.160 → 0.1.162

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

@@ -2,13 +2,13 @@ import Scope from './Scope.js';
 import Observable from '../api/Observer.js';
 import Rule, { RuleMatch, RuleResult } from './Rule.js';
 /**
- * TemplateChangeEvent - событие изменения шаблона
+ * FragmentChangeEvent - событие изменения конкретного фрагмента
  */
-export interface TemplateChangeEvent {
-    oldValue: any;
-    newValue: any;
-    oldTemplate: string;
-    newTemplate: string;
+export interface FragmentChangeEvent {
+    fragmentId: string;
+    oldNodes: Node[];
+    newNodes: Node[];
+    affectedObservables: Observable<any>[];
 }
 /**
  * TemplateSection - секция шаблона, связанная с Rule
@@ -29,93 +29,213 @@ export interface TemplateSection {
         observable: Observable<any>;
         unsubscribe: () => void;
     }>;
+    /** ID фрагмента, к которому принадлежит секция */
+    fragmentId?: string;
 }
 /**
- * PageTemplate - динамический шаблон страницы.
- * Хранит обработанные Rule и поддерживает реактивное обновление.
+ * 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 - динамический шаблон страницы.
  *
- * При изменении Observable все зависимые секции обновляются
- * одновременно в одном событии onTemplateChange.
+ * Поддерживает:
+ * - Множество мелких фрагментов, каждый обновляется независимо
+ * - Множество container bindings
+ * - Автоматическое обновление DOM при изменении Observable
+ * - bind/unbind для refs и events
  */
 export default class TemplateInstance {
-    private template;
     private scope;
     private sections;
-    private fragment;
-    /** Observers for template changes */
-    private changeObserver;
+    /** Все фрагменты шаблона */
+    private fragments;
+    /** ID корневого фрагмента */
+    private rootFragmentId;
+    /** Счётчик для генерации ID фрагментов */
+    private fragmentIdCounter;
+    /** Observers for fragment changes */
+    private fragmentChangeObserver;
     /** Группировка секций по Observable */
     private observableTrackings;
-    constructor(template: string, scope: Scope);
+    /** Привязки к контейнерам */
+    private containerBindings;
+    constructor(scope: Scope);
     /**
-     * Получить текущий шаблон
+     * Получить Scope
      */
-    getTemplate(): string;
+    getScope(): Scope;
     /**
-     * Установить новый шаблон (вызывает событие изменения)
+     * Получить все секции
      */
-    setTemplate(newTemplate: string): void;
+    getSections(): TemplateSection[];
     /**
-     * Получить Scope
+     * Получить все фрагменты
      */
-    getScope(): Scope;
+    getAllFragments(): Map<string, FragmentBinding>;
     /**
-     * Подписаться на изменения шаблона
+     * Получить фрагмент по ID
      */
-    onTemplateChange(listener: (oldValue: any, newValue: any, oldTemplate: string, newTemplate: string) => void): () => void;
+    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.
      */
-    getSections(): TemplateSection[];
+    insertAppendedFragment(fragmentId: string): void;
     /**
-     * Подписаться на Observable и автоматически пересоздавать секцию.
-     * Все секции, зависящие от одного Observable, обновляются разом.
+     * Привязать события только для нового фрагмента
+     */
+    private bindEventsForNewFragment;
+    /**
+     * Подписаться на изменения фрагментов
+     */
+    onFragmentChange(listener: (event: FragmentChangeEvent) => void): () => void;
+    /**
+     * Подписаться на Observable и автоматически пересоздавать секцию
      */
     trackObservable(observable: Observable<any>, section: TemplateSection, rebuild: (section: TemplateSection) => RuleResult): () => void;
     /**
-     * Перестроить все секции, зависящие от Observable, за один раз
+     * Привязать к контейнеру.
+     * Вставляет DOM, вызывает bindRefs, processInjections и bindEvents.
      */
-    private rebuildAllSectionsForObservable;
+    bind(container: Element): void;
     /**
-     * Отписаться от вложенных Observable в секции (но не от главного)
+     * Отвязать от контейнера.
+     * Отвязывает refs и events, но оставляет DOM.
      */
-    private unsubscribeSectionNested;
+    unbind(container: Element): void;
     /**
-     * Отписаться от всех Observable в секции
+     * Привязать refs к элементам.
+     * Если есть контейнеры - привязывает для них.
+     * Если нет - создаёт временный DocumentFragment и привязывает refs из него.
      */
-    private unsubscribeSection;
+    bindRefs(): void;
     /**
-     * Создать DocumentFragment из текущего шаблона
+     * Привязать refs из DocumentFragment (без контейнера)
      */
-    createFragment(): DocumentFragment;
+    private bindRefsForFragment;
     /**
-     * Получить кэшированный DocumentFragment
+     * Отвязать refs (для всех контейнеров)
      */
-    getFragment(): DocumentFragment | null;
+    unbindRefs(): void;
+    /**
+     * Привязать события (для всех контейнеров)
+     */
+    bindEvents(): void;
     /**
-     * Пересоздать fragment
+     * Отвязать события (для всех контейнеров)
      */
-    rebuildFragment(): DocumentFragment;
+    unbindEvents(): void;
     /**
-     * Очистить все подписки
+     * Очистить все подписки и bindings
      */
     dispose(): void;
     /**
-     * Привязать refs после вставки в DOM
+     * Вставить все фрагменты в контейнер с маркерами
      */
-    bindRefs(root: Element | DocumentFragment): void;
+    private insertFragmentsIntoContainer;
     /**
-     * Обработать инжекции (@injection[head/tail])
-     * Должен вызываться после bindRefs
+     * Рекурсивно вставить фрагмент и его дочерние
      */
-    processInjections(root: Element | DocumentFragment): void;
+    private insertFragmentRecursive;
     /**
-     * Отвязать refs (установить null)
+     * Создать ноды из HTML строки
      */
-    unbindRefs(): void;
+    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

@@ -1 +1 @@
-{"version":3,"file":"TemplateInstance.d.ts","sourceRoot":"","sources":["../../../src/foundation/engine/TemplateInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,UAAgC,MAAM,oBAAoB,CAAC;AAClE,OAAO,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,EAAE,GAAG,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,qCAAqC;IACrC,IAAI,EAAE,IAAI,CAAC;IACX,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,2CAA2C;IAC3C,aAAa,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;CAClF;AAcD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAiC;IAEjD,qCAAqC;IACrC,OAAO,CAAC,cAAc,CAA+C;IAErE,uCAAuC;IACvC,OAAO,CAAC,mBAAmB,CAAkD;gBAEjE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IAK1C;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAU7C;;OAEG;IACI,QAAQ,IAAI,KAAK;IAIxB;;OAEG;IACI,gBAAgB,CACnB,QAAQ,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GAC3F,MAAM,IAAI;IAQb;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIjD;;OAEG;IACI,WAAW,IAAI,eAAe,EAAE;IAIvC;;;OAGG;IACI,eAAe,CAClB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,EAC3B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,UAAU,GAClD,MAAM,IAAI;IAsCb;;OAEG;IACH,OAAO,CAAC,+BAA+B;IA0CvC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACI,cAAc,IAAI,gBAAgB;IAYzC;;OAEG;IACI,WAAW,IAAI,gBAAgB,GAAG,IAAI;IAI7C;;OAEG;IACI,eAAe,IAAI,gBAAgB;IAK1C;;OAEG;IACI,OAAO,IAAI,IAAI;IAetB;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;IAWvD;;;OAGG;IACI,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI;IA+BhE;;OAEG;IACI,UAAU,IAAI,IAAI;CAU5B"}
+{"version":3,"file":"TemplateInstance.d.ts","sourceRoot":"","sources":["../../../src/foundation/engine/TemplateInstance.ts"],"names":[],"mappings":"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"}