@saolabs/client 1.0.0 → 1.0.2

package/dist/src/core/elements/Block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,KAAM,YAAW,cAAc;IACxC,OAAO,EAAE,aAAa,CAAW;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAC1C,oBAAoB,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAElB,WAAW,EAAE,IAAI,EAAE,CAAM;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAE3C,SAAgB,UAAU,QAAQ;IAClC,SAAgB,YAAY,SAAS;gBAEzB,EACR,GAAG,EACH,IAAI,EACJ,MAAa,EACb,oBAA2D,EAC3D,EAAS,EACT,QAAmB,EACtB,EAAE;QACC,GAAG,EAAE,uBAAuB,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;QAC1C,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACvB;IAaD,2BAA2B;IAC3B,IAAI,IAAI,IAAI;IAQZ,yDAAyD;IACzD,MAAM,IAAI,IAAI;IASd,KAAK,CAAC,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,GAAG,GAAG;IAM3E,OAAO,IAAI,IAAI;IAGf,OAAO,IAAI,IAAI;IAGf,MAAM,IAAI,IAAI;IAIb,yDAAyD;IACzD,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;CAI/D"}
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAa,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEzF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAGvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,KAAM,YAAW,cAAc;IACxC,OAAO,EAAE,aAAa,CAAW;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,uBAAuB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC7B,wEAAwE;IACxE,OAAO,CAAC,SAAS,CAAuB;IACxC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAC1C,oBAAoB,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,IAAI,EAAE,CAAM;IACzB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAE3C,SAAgB,UAAU,QAAQ;IAClC,SAAgB,YAAY,SAAS;gBAEzB,EACR,GAAG,EACH,IAAI,EACJ,MAAa,EACb,oBAA2D,EAC3D,EAAS,EACT,QAAmB,EACtB,EAAE;QACC,GAAG,EAAE,uBAAuB,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;QAC1C,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACvB;IAyBD,2BAA2B;IAC3B,IAAI,IAAI,IAAI;IAQZ,yDAAyD;IACzD,MAAM,IAAI,IAAI;IASd,KAAK,CAAC,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,GAAG,GAAG;IAM3E,OAAO,IAAI,IAAI;IAGf,OAAO,IAAI,IAAI;IAYf,MAAM,IAAI,IAAI;IAId,yDAAyD;IACzD,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;CAI9D"}

package/dist/src/core/elements/Block.js

@@ -1,5 +1,6 @@
-import { generateUUID } from "../hellpers/utils";
-import markerRegistry from "../services/MarkerRegistry";
+import { InitModes } from "../contracts/common.js";
+import { generateUUID } from "../helpers/utils.js";
+import markerRegistry from "../services/MarkerRegistry.js";
 /**
  * Block — a named mounting slot used in layout views.
  *
@@ -20,23 +21,37 @@ import markerRegistry from "../services/MarkerRegistry";
  */
 export class Block {
     constructor({ ctx, name, viewId = null, contentRenderFactory = (parentElement) => [], id = null, initMode = 'create' }) {
-        this.oneType = 'Block';
+        this.saoType = 'Block';
         this.viewId = null;
+        /** Key trả về bởi markerRegistry.register — destroy() dùng để gỡ lại */
+        this.markerKey = null;
         this.fragment = null;
         this.contentRenderFactory = null;
         this.domChildren = [];
         this.parentElement = null;
         this.isOneBlock = true;
-        this.isOneElement = false;
-        this.id = `${this.viewId}-${id ?? generateUUID(10)}`; // Unique ID for debugging
+        this.isSaoElement = false;
+        this.id = id ?? generateUUID(10); // Unique ID for debugging
         this.ctx = ctx;
         this.name = name;
         this.viewId = viewId ?? ctx.viewId; // Associate block with current viewId
         this.initMode = initMode;
         this.contentRenderFactory = contentRenderFactory || ((parentElement) => []);
-        markerRegistry.register('block', this.id, { name, viewId }); // Register block in marker registry
-        this.openTag = markerRegistry.createMarkerStart('block', this.id);
-        this.closeTag = markerRegistry.createMarkerEnd('block', this.id);
+        // Hydrate: claim cặp marker server qua index O(1) của MarkerRegistry.
+        // (Bản cũ dùng chung một TreeWalker không reset nên chỉ block ĐẦU TIÊN
+        // claim được, các block sau lặng lẽ tạo marker mới.)
+        const claimed = (this.initMode === InitModes.HYDRATE)
+            ? markerRegistry.claim('block', this.id)
+            : null;
+        if (claimed) {
+            this.openTag = claimed.open;
+            this.closeTag = claimed.close;
+        }
+        else {
+            this.openTag = markerRegistry.createMarkerStart('block', this.id);
+            this.closeTag = markerRegistry.createMarkerEnd('block', this.id);
+            this.markerKey = markerRegistry.register('block', this.id, { name, viewId }); // Register block in marker registry
+        }
     }
     /** Initialize the block */
     init() {
@@ -64,7 +79,16 @@ export class Block {
         // Unmount logic (e.g. hide or remove DOM nodes, stop reactions)
     }
     destroy() {
-        // Cleanup logic (e.g. remove DOM nodes, clear caches)
+        // MarkerRegistry là singleton toàn cục — không gỡ thì record sống qua navigate.
+        if (this.markerKey) {
+            markerRegistry.remove(this.markerKey);
+            this.markerKey = null;
+        }
+        // openTag/closeTag nay NẰM TRONG DOM (BlockManager.mountBlockIntoOutlet chèn
+        // chúng quanh content). Bỏ lại comment mồ côi thì lần hydrate sau
+        // markerRegistry.claim('block', id) có thể bắt trúng cặp cũ và claim nhầm vùng.
+        this.openTag.remove();
+        this.closeTag.remove();
     }
     update() {
         // Update logic (e.g. re-render content on state change)

package/dist/src/core/elements/Block.js.map

@@ -1 +1 @@
-{"version":3,"file":"Block.js","sourceRoot":"","sources":["../../../../src/core/elements/Block.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,cAAc,MAAM,4BAA4B,CAAC;AAGxD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,KAAK;IAkBd,YAAY,EACR,GAAG,EACH,IAAI,EACJ,MAAM,GAAG,IAAI,EACb,oBAAoB,GAAG,CAAC,aAA4B,EAAE,EAAE,CAAC,EAAE,EAC3D,EAAE,GAAG,IAAI,EACT,QAAQ,GAAG,QAAQ,EAQtB;QA/BD,YAAO,GAAkB,OAAO,CAAC;QAIjC,WAAM,GAAkB,IAAI,CAAC;QAC7B,aAAQ,GAA6B,IAAI,CAAC;QAC1C,yBAAoB,GAA8B,IAAI,CAAC;QAIvD,gBAAW,GAAW,EAAE,CAAC;QAEzB,kBAAa,GAAyB,IAAI,CAAC;QAE3B,eAAU,GAAG,IAAI,CAAC;QAClB,iBAAY,GAAG,KAAK,CAAC;QAiBjC,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0BAA0B;QAChF,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,sCAAsC;QAC1E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,IAAI,CAAC,CAAC,aAA4B,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3F,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,oCAAoC;QACjG,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAErE,CAAC;IAED,2BAA2B;IAC3B,IAAI;QACA,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC9B,uBAAuB;QAC3B,CAAC;aAAM,CAAC;YACJ,sBAAsB;QAC1B,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,MAAM;QAEF,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAAE,OAAO;QAEvC,qCAAqC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAc,CAAC,CAAC;IAEnE,CAAC;IAED,KAAK,CAAC,QAAiC,EAAE,aAA4B;QACjE,IAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,aAAa,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO;QACH,gEAAgE;IACpE,CAAC;IACD,OAAO;QACH,sDAAsD;IAC1D,CAAC;IACD,MAAM;QACF,wDAAwD;IAC5D,CAAC;IAEA,yDAAyD;IACzD,gBAAgB,CAAC,aAAmC;QACjD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;CAEJ"}
+{"version":3,"file":"Block.js","sourceRoot":"","sources":["../../../../src/core/elements/Block.ts"],"names":[],"mappings":"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"}

package/dist/src/core/elements/BlockOutlet.d.ts

@@ -1,10 +1,10 @@
-import type { BlockOutletInterface } from "../contracts/BlockInterface";
-import { InitMode } from "../contracts/common";
-import type { HtmlInterface } from "../contracts/ElementInterface";
-import type { ViewControllerInterface } from "../contracts/ViewControllerInterface";
-import type { OneObjectType } from "../types/utils";
+import type { BlockOutletInterface } from "../contracts/BlockInterface.js";
+import { InitMode } from "../contracts/common.js";
+import type { HtmlInterface } from "../contracts/ElementInterface.js";
+import type { ViewControllerInterface } from "../contracts/ViewControllerInterface.js";
+import type { SaoObjectType } from "../types/utils.js";
 export declare class BlockOutlet implements BlockOutletInterface {
-    oneType: OneObjectType;
+    saoType: SaoObjectType;
     id: string;
     name: string;
     openTag: Comment;
@@ -20,14 +20,25 @@ export declare class BlockOutlet implements BlockOutletInterface {
         id?: string | null;
         initMode?: InitMode;
     });
+    /**
+     * Tìm cặp marker outlet từ server-rendered HTML (format chuẩn §5.1):
+     *   open:  s:bo:{id}-s   close: s:bo:{id}-e
+     * Tra index của MarkerRegistry, chặn trong parentElement nếu có.
+     */
+    private claimSSRMarkers;
     hydrate(): void;
+    /** Registry guard */
+    __destroyed__: boolean;
+    /** Key trả về bởi markerRegistry.register — destroy() dùng để gỡ lại */
+    private markerKey;
+    /** Render — idempotent: markers đã trong DOM thì giữ nguyên (same-layout reuse) */
     render(): void;
     destroy(): void;
     start(): void;
     stop(): void;
     setParentElement(parentElement: HtmlInterface | null): void;
-    get isOneElement(): boolean;
-    set isOneElement(value: boolean);
+    get isSaoElement(): boolean;
+    set isSaoElement(value: boolean);
     get isOneBlockOutlet(): boolean;
     set isOneBlockOutlet(value: boolean);
 }

package/dist/src/core/elements/BlockOutlet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockOutlet.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/BlockOutlet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAGpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,qBAAa,WAAY,YAAW,oBAAoB;IACpD,OAAO,EAAE,aAAa,CAAiB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;IACpC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAC3C,GAAG,EAAE,uBAAuB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAY;gBAClB,EAAE,GAAG,EAAE,aAAoB,EAAE,IAAI,EAAE,EAAS,EAAE,QAAmB,EAAE,EAAE;QAAE,GAAG,EAAE,uBAAuB,CAAC;QAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;IAc9M,OAAO,IAAI,IAAI;IAIf,MAAM,IAAI,IAAI;IAYd,OAAO,IAAI,IAAI;IAMf,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAK3D,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;CACJ"}
+{"version":3,"file":"BlockOutlet.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/BlockOutlet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAa,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAGvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,qBAAa,WAAY,YAAW,oBAAoB;IACpD,OAAO,EAAE,aAAa,CAAiB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;IACpC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAC3C,GAAG,EAAE,uBAAuB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAoB;gBAC1B,EAAE,GAAG,EAAE,aAAoB,EAAE,IAAI,EAAE,EAAS,EAAE,QAA2B,EAAE,EAAE;QAAE,GAAG,EAAE,uBAAuB,CAAC;QAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE;IA4BtN;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB,OAAO,IAAI,IAAI;IAIf,qBAAqB;IACd,aAAa,EAAE,OAAO,CAAS;IACtC,wEAAwE;IACxE,OAAO,CAAC,SAAS,CAAuB;IAExC,mFAAmF;IACnF,MAAM,IAAI,IAAI;IAUd,OAAO,IAAI,IAAI;IAmBf,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAK3D,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;CACJ"}

package/dist/src/core/elements/BlockOutlet.js

@@ -1,34 +1,78 @@
-import { generateUUID } from "../hellpers/utils";
-import markerRegistry from "../services/MarkerRegistry";
+import { InitModes } from "../contracts/common.js";
+import { generateUUID } from "../helpers/utils.js";
+import markerRegistry from "../services/MarkerRegistry.js";
 export class BlockOutlet {
-    constructor({ ctx, parentElement = null, name, id = null, initMode = 'create' }) {
-        this.oneType = 'BlockOutlet';
+    constructor({ ctx, parentElement = null, name, id = null, initMode = InitModes.CREATE }) {
+        this.saoType = 'BlockOutlet';
         this.parent = null;
         this.parentElement = null;
-        this.initMode = 'create';
-        this.id = `${ctx.viewId}-${id ?? generateUUID(10)}`; // Unique ID for debugging
+        this.initMode = InitModes.CREATE;
+        /** Registry guard */
+        this.__destroyed__ = false;
+        /** Key trả về bởi markerRegistry.register — destroy() dùng để gỡ lại */
+        this.markerKey = null;
+        this.id = id ?? generateUUID(10); // Unique ID for debugging
         this.ctx = ctx;
         this.name = name;
         this.parent = parentElement;
         this.parentElement = parentElement;
         this.initMode = initMode;
-        markerRegistry.register('blockoutlet', this.id, { name, viewId: ctx.viewId }); // Register this outlet in the MarkerRegistry
-        this.openTag = markerRegistry.createMarkerStart('blockoutlet', this.id);
-        this.closeTag = markerRegistry.createMarkerEnd('blockoutlet', this.id);
+        if (this.initMode === InitModes.HYDRATE) {
+            // Claim cặp marker server <!--s:bo:{id}-s--> ... <!--s:bo:{id}-e-->
+            const claimed = this.claimSSRMarkers();
+            if (claimed) {
+                this.openTag = claimed.open;
+                this.closeTag = claimed.close;
+            }
+            else {
+                this.openTag = markerRegistry.createMarkerStart('blockoutlet', this.id);
+                this.closeTag = markerRegistry.createMarkerEnd('blockoutlet', this.id);
+                this.markerKey = markerRegistry.register('blockoutlet', this.id, { name, viewId: ctx.viewId });
+            }
+        }
+        else {
+            this.openTag = markerRegistry.createMarkerStart('blockoutlet', this.id);
+            this.closeTag = markerRegistry.createMarkerEnd('blockoutlet', this.id);
+            this.markerKey = markerRegistry.register('blockoutlet', this.id, { name, viewId: ctx.viewId }); // Register this outlet in the MarkerRegistry
+        }
+    }
+    /**
+     * Tìm cặp marker outlet từ server-rendered HTML (format chuẩn §5.1):
+     *   open:  s:bo:{id}-s   close: s:bo:{id}-e
+     * Tra index của MarkerRegistry, chặn trong parentElement nếu có.
+     */
+    claimSSRMarkers() {
+        return markerRegistry.claim('blockoutlet', this.id, this.parentElement?.element ?? null);
     }
     hydrate() {
         // Hydration logic if needed (e.g. reattach event listeners)
     }
+    /** Render — idempotent: markers đã trong DOM thì giữ nguyên (same-layout reuse) */
     render() {
+        if (this.__destroyed__)
+            return;
+        if (this.openTag.parentNode)
+            return; // đã đặt — không đặt lại
         if (!this.parentElement || !this.parentElement.element)
             return;
         const parentEl = this.parentElement.element;
-        // Place markers
         parentEl.appendChild(this.openTag);
-        // Register this outlet in the MarkerRegistry for block mounting
         parentEl.appendChild(this.closeTag);
     }
     destroy() {
+        this.__destroyed__ = true;
+        this.ctx.releaseElement?.(this);
+        if (this.markerKey) {
+            markerRegistry.remove(this.markerKey);
+            this.markerKey = null;
+        }
+        // Clear nội dung giữa markers (block content nếu còn)
+        let current = this.openTag.nextSibling;
+        while (current && current !== this.closeTag) {
+            const next = current.nextSibling;
+            current.remove();
+            current = next;
+        }
         // Remove markers from DOM
         this.openTag.remove();
         this.closeTag.remove();
@@ -43,10 +87,10 @@ export class BlockOutlet {
         this.parent = parentElement;
         this.parentElement = parentElement;
     }
-    get isOneElement() {
+    get isSaoElement() {
         return true;
     }
-    set isOneElement(value) {
+    set isSaoElement(value) {
         // No-op setter to satisfy OneElement interface
     }
     get isOneBlockOutlet() {

package/dist/src/core/elements/BlockOutlet.js.map

@@ -1 +1 @@
-{"version":3,"file":"BlockOutlet.js","sourceRoot":"","sources":["../../../../src/core/elements/BlockOutlet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,cAAc,MAAO,4BAA4B,CAAC;AAGzD,MAAM,OAAO,WAAW;IAUpB,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAiI;QAT9M,YAAO,GAAkB,aAAa,CAAC;QAKvC,WAAM,GAAyB,IAAI,CAAC;QACpC,kBAAa,GAAyB,IAAI,CAAC;QAE3C,aAAQ,GAAa,QAAQ,CAAC;QAE1B,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,0BAA0B;QAC/E,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,cAAc,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,6CAA6C;QAE5H,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,eAAe,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACH,4DAA4D;IAChE,CAAC;IAED,MAAM;QACF,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO;YAAE,OAAO;QAE/D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAE5C,gBAAgB;QAChB,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,gEAAgE;QAChE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAExC,CAAC;IAED,OAAO;QACH,0BAA0B;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACD,kEAAkE;IACtE,CAAC;IAED,IAAI;QACA,sEAAsE;IAC1E,CAAC;IAED,gBAAgB,CAAC,aAAmC;QAChD,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,YAAY,CAAC,KAAc;QAC3B,+CAA+C;IACnD,CAAC;IAED,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAc;QAC/B,+FAA+F;IACnG,CAAC;CACJ"}
+{"version":3,"file":"BlockOutlet.js","sourceRoot":"","sources":["../../../../src/core/elements/BlockOutlet.ts"],"names":[],"mappings":"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"}

package/dist/src/core/elements/Component.d.ts

@@ -1,11 +1,11 @@
-import { InitMode } from "../contracts/common";
-import { ComponentInterface } from "../contracts/ComponentInterface";
-import { HtmlInterface } from "../contracts/ElementInterface";
-import { ViewControllerInterface } from "../contracts/ViewControllerInterface";
-import { ViewInterface } from "../contracts/ViewInterface";
-import { OneObjectType } from "../types/utils";
+import { InitMode } from "../contracts/common.js";
+import { ComponentInterface } from "../contracts/ComponentInterface.js";
+import { HtmlInterface } from "../contracts/ElementInterface.js";
+import { ViewControllerInterface } from "../contracts/ViewControllerInterface.js";
+import { ViewInterface } from "../contracts/ViewInterface.js";
+import { SaoObjectType } from "../types/utils.js";
 export declare class Component implements ComponentInterface {
-    oneType: OneObjectType;
+    saoType: SaoObjectType;
     ctx: ViewControllerInterface;
     parent: HtmlInterface | null;
     domChildren: Node[];
@@ -24,8 +24,20 @@ export declare class Component implements ComponentInterface {
     initMode: InitMode;
     subscribeFn: () => void;
     unsubscribeFn: () => void;
+    /**
+     * Listener khai báo tại thẻ cha: `<mycomp @edit(openEditor(event))>`.
+     *
+     * Con gọi `emit('edit', payload)` → ViewController.emit tra Ở ĐÂY, không đi
+     * qua event bus: không rò sang instance khác, không phải gỡ đăng ký.
+     *
+     * Đọc lúc phát chứ không copy vào data con: mỗi lần cha render lại,
+     * `ViewController.include()` thay bảng này bằng closure mới, nên handler
+     * luôn nhìn thấy biến vòng lặp / prop của LƯỢT RENDER hiện tại — kể cả khi
+     * component không có prop reactive nào để kích hoạt updateData.
+     */
+    listeners: Record<string, (...args: any[]) => any>;
     dataFactory: ((parentElement: HtmlInterface | null) => Record<string, any>) | null;
-    constructor({ ctx, parent, id, stateKeys, data, dataFactory, path, type, condition, initMode, }: {
+    constructor({ ctx, parent, id, stateKeys, data, dataFactory, path, type, condition, initMode, listeners, }: {
         ctx: ViewControllerInterface;
         parent?: HtmlInterface | null;
         id?: string | null;
@@ -39,7 +51,13 @@ export declare class Component implements ComponentInterface {
             checker: () => any;
         } | null;
         initMode?: InitMode;
+        listeners?: Record<string, (...args: any[]) => any>;
     });
+    /**
+     * Tìm cặp marker component từ server-rendered HTML (format chuẩn §5.1):
+     *   open: s:c:{id}-s   close: s:c:{id}-e
+     */
+    private claimSSRMarkers;
     mergeData(newData: Record<string, any>): void;
     setDataFactory(factory: (parentElement: HtmlInterface | null) => Record<string, any>): void;
     setCondition(condition: {
@@ -47,15 +65,69 @@ export declare class Component implements ComponentInterface {
         checker: () => any;
     }): void;
     setStateKeys(stateKeys: string[]): void;
+    setListeners(listeners: Record<string, (...args: any[]) => any>): void;
     setParentElement(parent: HtmlInterface | null): void;
     setView(view: ViewInterface): void;
     setParent(parent: HtmlInterface | null): void;
+    /** Registry guard */
+    __destroyed__: boolean;
+    private _isStarted;
+    private unsubscribeData;
+    private unsubscribeCondition;
+    /** 'when' type: trạng thái mounted hiện tại của child */
+    private _childMounted;
+    /**
+     * Render — @include (RUNTIME_CONTRACT.md §2):
+     *   1. Đặt component markers (idempotent — caller có thể đã đặt đúng vị trí)
+     *   2. Resolve child view từ registry (App.View)
+     *   3. Render child wrapper GIỮA markers, liên kết parent ↔ child
+     *   4. commitData cho child (start sẽ do lifecycle cascade gọi)
+     *
+     * Hydrate mode (markers claim được từ SSR): child view được tạo với đúng
+     * viewId server đã dùng (discover từ marker view bên trong) → toàn bộ cây
+     * con CLAIM DOM server thay vì tạo mới — SSR/CSR cho cùng kết quả.
+     */
+    render(): void;
+    /**
+     * Error boundary cho subtree con (@include). Boundary được tìm từ ctx —
+     * controller CHỨA @include này, không phải view con — nên onError của một
+     * view không bắt lỗi render của chính nó (giống React ErrorBoundary).
+     * Không boundary nào xử lý → rethrow, giữ nguyên hành vi cũ (bubble lên
+     * try/catch của renderPageView).
+     */
+    private guardChildMount;
+    /** Dọn DOM dở dang của lần render lỗi rồi chèn fallback giữa cặp marker. */
+    private mountFallback;
+    /**
+     * Discover viewId server đã dùng cho child view: quét comment giữa cặp
+     * marker component, tìm marker view mở đầu tiên <!--s:v:{id}-s-->.
+     */
+    private discoverChildViewId;
+    /**
+     * Hydrate child view — thứ tự chuẩn hydration (như ViewManager.hydrateView):
+     * discover viewId → tạo instance → commit state → flush discard →
+     * render claim DOM → mount() (hook + asset). KHÔNG chèn node mới.
+     */
+    private hydrateChild;
+    /** Tạo + mount child view giữa markers (nếu chưa có) */
+    private mountChild;
+    /** Resolve one child instance and establish ownership before either DOM strategy. */
+    private resolveChildView;
+    /** Hydration mounts after commit/claim; CSR commits immediately after mount. */
+    private finishChildMount;
+    private markChildMounted;
+    /** Gỡ child (when=false hoặc destroy) */
+    private unmountChild;
+    /**
+     * Start — kích hoạt child + subscribe:
+     *   - stateKeys: props reactive — đổi → dataFactory mới → child.updateData()
+     *   - condition (type 'when'): đổi → mount/unmount child
+     */
     start(): void;
     stop(): void;
-    render(): void;
     destroy(): void;
-    get isOneElement(): boolean;
-    set isOneElement(value: boolean);
+    get isSaoElement(): boolean;
+    set isSaoElement(value: boolean);
     get isOneComponent(): boolean;
     set isOneComponent(value: boolean);
 }

package/dist/src/core/elements/Component.d.ts.map

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