@saolabs/client 1.0.0 → 1.0.2

package/dist/src/core/services/BlockManager.d.ts

@@ -1,4 +1,4 @@
-import type { BlockInterface, BlockManagerInterface, BlockOutletInterface } from "../contracts/BlockInterface";
+import type { BlockInterface, BlockManagerInterface, BlockOutletInterface } from "../contracts/BlockInterface.js";
 /**
  * BlockManager — manages all block slots in a layout view.
  *
@@ -39,16 +39,87 @@ export declare class BlockManagerService implements BlockManagerInterface {
      * viewId:blockName), and inserts block content between outlet markers.
      */
     mountAll(): void;
+    /**
+     * Mount only blocks owned by one Page/Layout controller. Nested layout
+     * chains call this from outer to inner, so an inner outlet exists before
+     * the next owner is mounted and retained layouts are not rebuilt.
+     */
+    mountViewBlocks(viewId: string): void;
+    /** Hydration counterpart of mountViewBlocks(). */
+    hydrateViewBlocks(viewId: string): void;
     /**
      * Mount a single block's content into an outlet.
-     * Content is rendered and inserted between the outlet's open/close markers.
+     * Clear nội dung cũ trước, render content mới GIỮA outlet markers
+     * (cùng insertion model với Reactive — RUNTIME_CONTRACT.md §2).
      */
     private mountBlockIntoOutlet;
+    /**
+     * Hydrate version của mountAll — dùng khi SSR.
+     * KHÁC mountAll: KHÔNG clearOutlet (giữ DOM server), KHÔNG insertBefore.
+     * Chạy block factory ở HYDRATE mode → Html/Output/Reactive con CLAIM
+     * DOM server đã render sẵn giữa cặp marker của outlet.
+     *
+     * Tiền đề: page ctrl.initMode === HYDRATE khi gọi (để this.html() trong
+     * factory tạo element claim DOM thay vì tạo mới).
+     */
+    mountAllHydrate(): void;
+    /**
+     * Claim block content vào outlet (hydrate). Chạy factory, gọi render() đệ quy
+     * trên children để claim DOM, KHÔNG chèn node mới. Track children cho lifecycle.
+     */
+    private hydrateBlockIntoOutlet;
+    /** Tìm outlet theo tên (outlet key = `${layoutViewId}-ob-${name}`) */
+    private findOutletByName;
+    /**
+     * Detach block content của một page (rời trang, vào PageCache):
+     * gỡ DOM giữa markers của từng outlet vào DocumentFragment, lấy children
+     * đang track ra khỏi manager (KHÔNG destroy — instance sống trong cache).
+     *
+     * Trả Map<outletName, {fragment, children}> để restore sau này.
+     */
+    detachPageContent(viewId: string): Map<string, {
+        fragment: DocumentFragment;
+        children: any[];
+    }>;
+    /**
+     * Restore block content của một page từ PageCache vào outlets hiện tại.
+     * Tiền đề: layout đang mount trùng với layout lúc detach (ViewManager guard).
+     */
+    restorePageContent(viewId: string, contents: Map<string, {
+        fragment: DocumentFragment;
+        children: any[];
+    }>): void;
+    /** Start toàn bộ block content đang mounted (gọi sau mountAll) */
+    startAll(): void;
+    /** Stop toàn bộ block content (trước khi swap page) */
+    stopAll(): void;
+    /**
+     * Gỡ mọi dấu vết của một view (page bị destroy):
+     * clear outlet đang chứa content của nó + xoá block đăng ký.
+     */
+    unmountView(viewId: string): void;
+    /**
+     * Gỡ outlets của một layout khỏi registry mà KHÔNG destroy — layout pause
+     * vào PageCache. Nếu để lại, mountAll/findOutletByName có thể đụng outlet
+     * (trùng tên) của layout đang detached. Re-register khi resume qua
+     * addOutlet (ViewManager.reregisterLayoutOutlets).
+     */
+    detachOutletsOfView(viewId: string): void;
+    /**
+     * Gỡ outlets của một layout bị destroy — XOÁ THẬT, khác hẳn
+     * `detachOutletsOfView` ở ngay trên (layout chỉ pause vào PageCache và sẽ
+     * được re-register, nên KHÔNG được destroy ở đó).
+     * `destroy()` idempotent nên gọi ở đây an toàn kể cả khi teardown cây
+     * element đã destroy outlet trước đó.
+     */
+    removeOutletsOfView(viewId: string): void;
     /**
      * Clear content from a specific outlet (for page swap).
      * Removes all DOM nodes between a named outlet's markers.
      */
     clearOutlet(name: string): void;
+    private outletKey;
+    private clearOutletInstance;
     /**
      * Clear all outlets (for full layout teardown).
      */

package/dist/src/core/services/BlockManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockManager.d.ts","sourceRoot":"","sources":["../../../../src/core/services/BlockManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,oBAAoB,EAAsB,MAAM,6BAA6B,CAAC;AAKnI;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,YAAW,qBAAqB;IAC7D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAChD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAa;IAC5D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IACtD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,EAAE,CAAC,CAAa;IAExE,2DAA2D;IAC3D,OAAO,CAAC,eAAe,CAAiC;;IAIxD,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQhC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ9E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAe3E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAM1D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIxD;;;;;;OAMG;IACH,QAAQ,IAAI,IAAI;IAchB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA2B/B;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAQlB;AAED,eAAO,MAAM,YAAY,qBAA4B,CAAC;AACtD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"BlockManager.d.ts","sourceRoot":"","sources":["../../../../src/core/services/BlockManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,oBAAoB,EAAsB,MAAM,gCAAgC,CAAC;AAKtI;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,YAAW,qBAAqB;IAC7D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAChD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAa;IAC5D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IACtD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,EAAE,CAAC,CAAa;IAExE,2DAA2D;IAC3D,OAAO,CAAC,eAAe,CAAiC;;IAIxD,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQhC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ9E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAe3E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAM1D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIxD;;;;;;OAMG;IACH,QAAQ,IAAI,IAAI;IAYhB;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUrC,kDAAkD;IAClD,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUvC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAyD5B;;;;;;;;OAQG;IACH,eAAe,IAAI,IAAI;IAUvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAyB9B,sEAAsE;IACtE,OAAO,CAAC,gBAAgB;IASxB;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAyB/F;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,GAAG,IAAI;IAehH,kEAAkE;IAClE,QAAQ,IAAI,IAAI;IAQhB,uDAAuD;IACvD,OAAO,IAAI,IAAI;IAQf;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAoBjC;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQzC;;;;;;OAMG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUzC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAQlB;AAED,eAAO,MAAM,YAAY,qBAA4B,CAAC;AACtD,eAAe,YAAY,CAAC"}

package/dist/src/core/services/BlockManager.js

@@ -83,95 +83,317 @@ export class BlockManagerService {
      * viewId:blockName), and inserts block content between outlet markers.
      */
     mountAll() {
-        for (const [name, block] of this.activeBlocks) {
-            // Try to find an outlet that matches this block name
-            for (const [outletKey, outlet] of this.blockOutlets) {
-                if (outletKey.endsWith(`:${name}`) || outlet.name === name) {
-                    if (block.contentRenderFactory) {
-                        this.mountBlockIntoOutlet(block, outlet);
-                    }
-                    break;
-                }
+        // Mount block content vào outlet cùng tên; outlet không có block active → clear về rỗng
+        for (const [, outlet] of this.blockOutlets) {
+            const block = this.activeBlocks.get(outlet.name);
+            if (block && block.contentRenderFactory) {
+                this.mountBlockIntoOutlet(block, outlet);
+            }
+            else {
+                this.clearOutletInstance(outlet);
             }
         }
     }
+    /**
+     * Mount only blocks owned by one Page/Layout controller. Nested layout
+     * chains call this from outer to inner, so an inner outlet exists before
+     * the next owner is mounted and retained layouts are not rebuilt.
+     */
+    mountViewBlocks(viewId) {
+        for (const [, block] of this.blocks) {
+            if (block.viewId !== viewId || !block.contentRenderFactory)
+                continue;
+            const outlet = this.findOutletByName(block.name);
+            if (!outlet)
+                continue;
+            this.activeBlocks.set(block.name, block);
+            this.mountBlockIntoOutlet(block, outlet);
+        }
+    }
+    /** Hydration counterpart of mountViewBlocks(). */
+    hydrateViewBlocks(viewId) {
+        for (const [, block] of this.blocks) {
+            if (block.viewId !== viewId || !block.contentRenderFactory)
+                continue;
+            const outlet = this.findOutletByName(block.name);
+            if (!outlet)
+                continue;
+            this.activeBlocks.set(block.name, block);
+            this.hydrateBlockIntoOutlet(block, outlet);
+        }
+    }
     /**
      * Mount a single block's content into an outlet.
-     * Content is rendered and inserted between the outlet's open/close markers.
+     * Clear nội dung cũ trước, render content mới GIỮA outlet markers
+     * (cùng insertion model với Reactive — RUNTIME_CONTRACT.md §2).
      */
     mountBlockIntoOutlet(block, outlet) {
-        if (!outlet.parentElement?.element)
-            return;
-        const parentEl = outlet.parentElement.element;
+        if (!outlet.openTag.parentNode)
+            return; // outlet chưa nằm trong DOM
+        // Clear nội dung cũ (page trước) trước khi mount page mới
+        this.clearOutletInstance(outlet);
         const children = [];
-        // Render block content using the factory
-        const content = block.contentRenderFactory(block.ctx);
-        if (!Array.isArray(content))
-            return;
-        // Insert each child between outlet markers
-        for (const child of content) {
+        const insertBeforeClose = (node) => {
+            outlet.closeTag.parentNode?.insertBefore(node, outlet.closeTag);
+        };
+        // Render block content using the factory — elements thuộc về PAGE ctrl
+        const content = block.contentRenderFactory(outlet.parentElement);
+        // Marker `s:b:` của chính block phải bao quanh content — Blade emit cặp này
+        // trong @block (ViewStorageManager::getMarkerOpenTag), nên thiếu nó ở đây là
+        // DOM sau SPA nav khác DOM từ server: hydrate lần sau không tìm ra block để
+        // claim, và cổng tests/e2e/ssr-csr-parity thấy marker lệch một phía.
+        // Block dựng sẵn openTag/closeTag trong constructor; chỗ chèn là ở đây, cùng
+        // insertion model với content (RUNTIME_CONTRACT.md §2).
+        insertBeforeClose(block.openTag);
+        // Content không phải mảng vẫn phải đóng marker — block rỗng ở server là cặp
+        // marker liền nhau, không phải không có marker.
+        for (const child of Array.isArray(content) ? content : []) {
+            if (child === null || child === undefined)
+                continue;
             if (typeof child === 'string' || typeof child === 'number') {
-                const textNode = document.createTextNode(String(child));
-                parentEl.insertBefore(textNode, outlet.closeTag);
+                insertBeforeClose(document.createTextNode(String(child)));
             }
-            else if (child && typeof child === 'object') {
-                if ('element' in child) {
-                    // HtmlInterface, TextInterface
-                    parentEl.insertBefore(child.element, outlet.closeTag);
+            else if (child instanceof Node) {
+                insertBeforeClose(child);
+            }
+            else if (typeof child === 'object') {
+                if ('element' in child && child.element) {
+                    insertBeforeClose(child.element);
                     children.push(child);
                     child.render();
                 }
                 else if ('openTag' in child) {
-                    // Reactive, Fragment, Output — set parent, render
+                    // Marker-based: đặt markers đúng vị trí trước, render sau (idempotent)
                     if ('parent' in child) {
                         child.parent = outlet.parentElement;
                     }
                     if ('parentElement' in child) {
                         child.parentElement = outlet.parentElement;
                     }
+                    insertBeforeClose(child.openTag);
+                    insertBeforeClose(child.closeTag);
                     children.push(child);
                     child.render();
                 }
             }
         }
-        // Track mounted children for cleanup
-        this.mountedChildren.set(outlet.name, children);
+        insertBeforeClose(block.closeTag);
+        // Track mounted children for lifecycle (start/stop/destroy)
+        this.mountedChildren.set(this.outletKey(outlet), children);
     }
     /**
-     * Clear content from a specific outlet (for page swap).
-     * Removes all DOM nodes between a named outlet's markers.
+     * Hydrate version của mountAll — dùng khi SSR.
+     * KHÁC mountAll: KHÔNG clearOutlet (giữ DOM server), KHÔNG insertBefore.
+     * Chạy block factory ở HYDRATE mode → Html/Output/Reactive con CLAIM
+     * DOM server đã render sẵn giữa cặp marker của outlet.
+     *
+     * Tiền đề: page ctrl.initMode === HYDRATE khi gọi (để this.html() trong
+     * factory tạo element claim DOM thay vì tạo mới).
      */
-    clearOutlet(name) {
-        // Find outlet by name
-        for (const [key, outlet] of this.blockOutlets) {
-            if (outlet.name === name) {
-                // Destroy tracked children first
-                const children = this.mountedChildren.get(name) || [];
-                if (children) {
-                    for (const child of children) {
-                        if ('destroy' in child && typeof child.destroy === 'function') {
-                            child.destroy();
-                        }
-                    }
-                    this.mountedChildren.delete(name);
+    mountAllHydrate() {
+        for (const [, outlet] of this.blockOutlets) {
+            const block = this.activeBlocks.get(outlet.name);
+            if (block && block.contentRenderFactory) {
+                this.hydrateBlockIntoOutlet(block, outlet);
+            }
+            // outlet không có block active → để nguyên DOM server (thường rỗng)
+        }
+    }
+    /**
+     * Claim block content vào outlet (hydrate). Chạy factory, gọi render() đệ quy
+     * trên children để claim DOM, KHÔNG chèn node mới. Track children cho lifecycle.
+     */
+    hydrateBlockIntoOutlet(block, outlet) {
+        const children = [];
+        const content = block.contentRenderFactory(outlet.parentElement);
+        if (!Array.isArray(content))
+            return;
+        for (const child of content) {
+            if (child === null || child === undefined)
+                continue;
+            if (typeof child === 'string' || typeof child === 'number')
+                continue; // text: giữ server
+            if (child instanceof Node)
+                continue;
+            if (typeof child === 'object') {
+                if ('element' in child && child.element) {
+                    children.push(child);
+                    child.render(); // HYDRATE: Html claim DOM, không chèn
+                }
+                else if ('openTag' in child) {
+                    if ('parent' in child)
+                        child.parent = outlet.parentElement;
+                    if ('parentElement' in child)
+                        child.parentElement = outlet.parentElement;
+                    children.push(child);
+                    child.render(); // HYDRATE: Output/Reactive claim markers
                 }
-                // Remove any remaining DOM nodes between markers
+            }
+        }
+        this.mountedChildren.set(this.outletKey(outlet), children);
+    }
+    /** Tìm outlet theo tên (outlet key = `${layoutViewId}-ob-${name}`) */
+    findOutletByName(name) {
+        let found = null;
+        for (const [, outlet] of this.blockOutlets) {
+            if (outlet.name === name)
+                found = outlet;
+        }
+        // Nearest/deepest outlet is registered last while mounting a nested chain.
+        return found;
+    }
+    /**
+     * Detach block content của một page (rời trang, vào PageCache):
+     * gỡ DOM giữa markers của từng outlet vào DocumentFragment, lấy children
+     * đang track ra khỏi manager (KHÔNG destroy — instance sống trong cache).
+     *
+     * Trả Map<outletName, {fragment, children}> để restore sau này.
+     */
+    detachPageContent(viewId) {
+        const result = new Map();
+        for (const [name, block] of Array.from(this.activeBlocks)) {
+            if (block.viewId !== viewId)
+                continue;
+            const fragment = document.createDocumentFragment();
+            const outlet = this.findOutletByName(name);
+            if (outlet && outlet.openTag.parentNode) {
                 let current = outlet.openTag.nextSibling;
                 while (current && current !== outlet.closeTag) {
                     const next = current.nextSibling;
-                    current.remove();
+                    fragment.appendChild(current); // appendChild tự remove khỏi DOM
                     current = next;
                 }
-                break;
             }
+            const outletKey = outlet ? this.outletKey(outlet) : name;
+            const children = this.mountedChildren.get(outletKey) ?? [];
+            this.mountedChildren.delete(outletKey);
+            this.activeBlocks.delete(name); // page rời đi — không còn active ở outlet này
+            result.set(name, { fragment, children });
+        }
+        return result;
+    }
+    /**
+     * Restore block content của một page từ PageCache vào outlets hiện tại.
+     * Tiền đề: layout đang mount trùng với layout lúc detach (ViewManager guard).
+     */
+    restorePageContent(viewId, contents) {
+        for (const [name, { fragment, children }] of contents) {
+            const outlet = this.findOutletByName(name);
+            if (outlet && outlet.closeTag.parentNode) {
+                outlet.closeTag.parentNode.insertBefore(fragment, outlet.closeTag);
+            }
+            if (outlet)
+                this.mountedChildren.set(this.outletKey(outlet), children);
+            // Re-activate block của page này (blocks map còn giữ — pause không xoá)
+            const block = this.blocks.get(name + viewId);
+            if (block) {
+                this.activeBlocks.set(name, block);
+            }
+        }
+    }
+    /** Start toàn bộ block content đang mounted (gọi sau mountAll) */
+    startAll() {
+        for (const [, children] of this.mountedChildren) {
+            for (const child of children) {
+                if (child && typeof child.start === 'function')
+                    child.start();
+            }
+        }
+    }
+    /** Stop toàn bộ block content (trước khi swap page) */
+    stopAll() {
+        for (const [, children] of this.mountedChildren) {
+            for (const child of children) {
+                if (child && typeof child.stop === 'function')
+                    child.stop();
+            }
+        }
+    }
+    /**
+     * Gỡ mọi dấu vết của một view (page bị destroy):
+     * clear outlet đang chứa content của nó + xoá block đăng ký.
+     */
+    unmountView(viewId) {
+        for (const [name, block] of this.activeBlocks) {
+            if (block.viewId === viewId) {
+                this.clearOutlet(name);
+                this.activeBlocks.delete(name);
+            }
+        }
+        for (const [key, block] of this.blocks) {
+            if (block.viewId === viewId) {
+                // destroy TRƯỚC khi rời Map. Block KHÔNG nằm trong ctrl.elements
+                // nên teardown cây element không bao giờ chạm tới nó — đây là chỗ
+                // DUY NHẤT gỡ được record marker toàn cục của nó. Thiếu dòng này
+                // thì MarkerRegistry (singleton, sống qua navigate) tăng đúng 1
+                // record mỗi lần điều hướng, vĩnh viễn.
+                block.destroy?.();
+                this.blocks.delete(key);
+            }
+        }
+    }
+    /**
+     * Gỡ outlets của một layout khỏi registry mà KHÔNG destroy — layout pause
+     * vào PageCache. Nếu để lại, mountAll/findOutletByName có thể đụng outlet
+     * (trùng tên) của layout đang detached. Re-register khi resume qua
+     * addOutlet (ViewManager.reregisterLayoutOutlets).
+     */
+    detachOutletsOfView(viewId) {
+        for (const [key, outlet] of this.blockOutlets) {
+            if (outlet.ctx?.viewId === viewId) {
+                this.blockOutlets.delete(key);
+            }
+        }
+    }
+    /**
+     * Gỡ outlets của một layout bị destroy — XOÁ THẬT, khác hẳn
+     * `detachOutletsOfView` ở ngay trên (layout chỉ pause vào PageCache và sẽ
+     * được re-register, nên KHÔNG được destroy ở đó).
+     * `destroy()` idempotent nên gọi ở đây an toàn kể cả khi teardown cây
+     * element đã destroy outlet trước đó.
+     */
+    removeOutletsOfView(viewId) {
+        for (const [key, outlet] of this.blockOutlets) {
+            if (outlet.ctx?.viewId === viewId) {
+                this.mountedChildren.delete(this.outletKey(outlet));
+                outlet.destroy?.();
+                this.blockOutlets.delete(key);
+            }
+        }
+    }
+    /**
+     * Clear content from a specific outlet (for page swap).
+     * Removes all DOM nodes between a named outlet's markers.
+     */
+    clearOutlet(name) {
+        const outlet = this.findOutletByName(name);
+        if (outlet)
+            this.clearOutletInstance(outlet);
+    }
+    outletKey(outlet) {
+        return String(outlet.id ?? `${outlet.ctx?.viewId ?? ''}:${outlet.name}`);
+    }
+    clearOutletInstance(outlet) {
+        const key = this.outletKey(outlet);
+        const children = this.mountedChildren.get(key) ?? [];
+        for (const child of children) {
+            if ('destroy' in child && typeof child.destroy === 'function')
+                child.destroy();
+        }
+        this.mountedChildren.delete(key);
+        let current = outlet.openTag.nextSibling;
+        while (current && current !== outlet.closeTag) {
+            const next = current.nextSibling;
+            current.remove();
+            current = next;
         }
     }
     /**
      * Clear all outlets (for full layout teardown).
      */
     clearAllOutlets() {
-        for (const [key, outlet] of this.blockOutlets) {
-            this.clearOutlet(outlet.name);
+        for (const [, outlet] of this.blockOutlets) {
+            this.clearOutletInstance(outlet);
         }
     }
     /**

package/dist/src/core/services/BlockManager.js.map

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

package/dist/src/core/services/DomService.js

@@ -1,13 +1,13 @@
-import { app } from "../hellpers/app";
+import { app } from "../helpers/app.js";
 export class DomService {
     constructor() {
         this.container = document.createElement('template');
     }
     parse(html) {
         this.container.innerHTML = html;
-        const content = this.container.content;
+        const nodes = Array.from(this.container.content.childNodes);
         this.container.innerHTML = ''; // Clear template content to free memory
-        return Array.from(content.childNodes);
+        return nodes;
     }
     create(tagName, options) {
         return document.createElement(tagName, options);

package/dist/src/core/services/DomService.js.map

@@ -1 +1 @@
-{"version":3,"file":"DomService.js","sourceRoot":"","sources":["../../../../src/core/services/DomService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAGtC,MAAM,OAAO,UAAU;IAEnB;QACI,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAY;QACd,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,wCAAwC;QACvE,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,CAAC,OAAe,EAAE,OAAgC;QACpD,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CAGJ;AAID,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;AACnC,eAAe,GAAG,CAAC"}
+{"version":3,"file":"DomService.js","sourceRoot":"","sources":["../../../../src/core/services/DomService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAGxC,MAAM,OAAO,UAAU;IAEnB;QACI,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAY;QACd,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,wCAAwC;QACvE,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,CAAC,OAAe,EAAE,OAAgC;QACpD,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CAGJ;AAID,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;AACnC,eAAe,GAAG,CAAC"}

package/dist/src/core/services/HeadService.d.ts

@@ -0,0 +1,24 @@
+import type { HeadLinkOptions, HeadServiceInterface, HeadTagOptions } from "../contracts/HeadServiceInterface.js";
+/**
+ * HeadService — the single place that writes to `<head>` (title, meta, link,
+ * JSON-LD). Independent of any View: callable from anywhere via `app('Head')`
+ * / `App.Head`. Reuses whatever the server already rendered there (SSR's
+ * `<title>`, `<meta name="description">`, ...) instead of creating
+ * duplicates, and snapshots the pre-managed value so `resetPage()` can put it
+ * back — the fix for tags leaking from one SPA-navigated page into the next.
+ */
+export declare class HeadServiceImpl implements HeadServiceInterface {
+    private managed;
+    setTitle(title: string, options?: HeadTagOptions): void;
+    setMeta(name: string, content: string, options?: HeadTagOptions): void;
+    setMetaProperty(property: string, content: string, options?: HeadTagOptions): void;
+    setLink(rel: string, href: string, options?: HeadLinkOptions): void;
+    setJsonLd(id: string, data: Record<string, any>, options?: HeadTagOptions): void;
+    unset(key: string): void;
+    resetPage(): void;
+    /** Find-or-create an element by `identAttrs`, snapshot `valueAttr` once, then apply the new value. */
+    private setAttrTag;
+}
+export declare const HeadService: HeadServiceImpl;
+export default HeadService;
+//# sourceMappingURL=HeadService.d.ts.map

package/dist/src/core/services/HeadService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadService.d.ts","sourceRoot":"","sources":["../../../../src/core/services/HeadService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAgB,MAAM,sCAAsC,CAAC;AAQhI;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,oBAAoB;IACxD,OAAO,CAAC,OAAO,CAA4C;IAE3D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI;IAa3D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI;IAI1E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI;IAItF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAMvE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI;IA6BpF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOxB,SAAS,IAAI,IAAI;IAQjB,sGAAsG;IACtG,OAAO,CAAC,UAAU;CA6BrB;AAED,eAAO,MAAM,WAAW,iBAAwB,CAAC;AACjD,eAAe,WAAW,CAAC"}