@saolabs/client 1.0.0 → 1.1.0

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

@@ -1,8 +1,10 @@
-import { InitModes } from "../contracts/common";
-import { generateUUID } from "../hellpers/utils";
+import { InitModes } from "../contracts/common.js";
+import { generateUUID } from "../helpers/utils.js";
+import { activateView, claimHydratedView, commitView, mountChildrenBeforeAnchor } from "../helpers/view.js";
+import markerRegistry from "../services/MarkerRegistry.js";
 export class Component {
-    constructor({ ctx, parent = null, id = null, stateKeys = [], data = {}, dataFactory = null, path = null, type = 'default', condition = null, initMode = InitModes.CREATE, }) {
-        this.oneType = 'Component';
+    constructor({ ctx, parent = null, id = null, stateKeys = [], data = {}, dataFactory = null, path = null, type = 'default', condition = null, initMode = InitModes.CREATE, listeners = {}, }) {
+        this.saoType = 'Component';
         this.domChildren = []; // For compatibility with HtmlInterface; Component itself doesn't have a single root element
         this.viewRef = null;
         this.path = null; // For dynamic imports
@@ -11,19 +13,64 @@ export class Component {
         this.initMode = InitModes.CREATE; // Default initialization mode
         this.subscribeFn = () => { };
         this.unsubscribeFn = () => { };
+        /**
+         * 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.
+         */
+        this.listeners = {};
         this.dataFactory = null;
+        /** Registry guard */
+        this.__destroyed__ = false;
+        this._isStarted = false;
+        this.unsubscribeData = null;
+        this.unsubscribeCondition = null;
+        /** 'when' type: trạng thái mounted hiện tại của child */
+        this._childMounted = false;
         this.ctx = ctx;
         this.parent = parent;
         this.stateKeys = stateKeys;
         this.data = data || {};
-        this.openTag = document.createComment(`component-start`);
-        this.closeTag = document.createComment(`component-end`);
-        this.id = `${ctx.viewId}-${id ?? generateUUID(10)}`; // Unique ID for debugging
+        // id khớp server: Blade emit @startMarker('component', '{hash}') →
+        // <!--s:c:{parentViewId}-{hash}-s--> (MarkerRegistryDirectiveService)
+        this.id = `${ctx.viewId}-${id ?? generateUUID(10)}`;
         this.dataFactory = dataFactory;
         this.path = path;
         this.type = type;
         this.condition = condition;
+        this.listeners = listeners || {};
         this.initMode = initMode ?? InitModes.CREATE;
+        if (this.initMode === InitModes.HYDRATE) {
+            // ── Hydrate: claim cặp marker component server đã render ─────
+            const claimed = this.claimSSRMarkers();
+            if (claimed) {
+                this.openTag = claimed.open;
+                this.closeTag = claimed.close;
+            }
+            else {
+                // Partial hydration fallback (server không render vùng này)
+                this.openTag = markerRegistry.createMarkerStart('component', this.id);
+                this.closeTag = markerRegistry.createMarkerEnd('component', this.id);
+            }
+        }
+        else {
+            // Format chuẩn s:c:{id}-s/-e — PHẢI khớp server để SSR/CSR cùng kết quả
+            this.openTag = markerRegistry.createMarkerStart('component', this.id);
+            this.closeTag = markerRegistry.createMarkerEnd('component', this.id);
+        }
+    }
+    /**
+     * 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
+     */
+    claimSSRMarkers() {
+        return markerRegistry.claim('component', this.id, this.parent?.element ?? null);
     }
     mergeData(newData) {
         this.data = { ...this.data, ...newData };
@@ -37,6 +84,9 @@ export class Component {
     setStateKeys(stateKeys) {
         this.stateKeys = stateKeys;
     }
+    setListeners(listeners) {
+        this.listeners = listeners || {};
+    }
     setParentElement(parent) {
         this.parent = parent;
     }
@@ -46,20 +96,291 @@ export class Component {
     setParent(parent) {
         this.parent = parent;
     }
+    /**
+     * 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() {
+        if (this.__destroyed__)
+            return;
+        // ── Hydrate path: markers đã có trong SSR DOM ──────────────────
+        if (this.initMode === InitModes.HYDRATE) {
+            if (this.openTag.parentNode) {
+                // Điều kiện đánh giá với state ĐÃ commit (hydrateView commit trước
+                // render) → kết quả khớp server-rendered output.
+                if (this.type === 'when' && this.condition && !this.condition.checker()) {
+                    this.initMode = InitModes.CREATE;
+                    return; // server cũng không render child (điều kiện falsy)
+                }
+                if (this.type === 'if') {
+                    const viewManager = this.ctx.App?.View;
+                    if (!viewManager?.exists?.(this.path ?? '')) {
+                        this.initMode = InitModes.CREATE;
+                        return;
+                    }
+                }
+                this.guardChildMount(() => this.hydrateChild());
+                this.initMode = InitModes.CREATE; // re-render sau này dùng CSR flow
+                return;
+            }
+            // Partial hydration fallback: server không render component này → CSR
+            this.initMode = InitModes.CREATE;
+        }
+        // 1. Markers
+        if (!this.openTag.parentNode) {
+            const parentEl = this.parent?.element;
+            if (!parentEl)
+                return;
+            parentEl.appendChild(this.openTag);
+            parentEl.appendChild(this.closeTag);
+        }
+        // 2. Điều kiện theo type
+        if (this.type === 'when' && this.condition) {
+            const shouldMount = !!this.condition.checker();
+            if (!shouldMount) {
+                this.unmountChild();
+                return;
+            }
+        }
+        if (this.type === 'if') {
+            const viewManager = this.ctx.App?.View;
+            if (!viewManager?.exists?.(this.path ?? '')) {
+                return; // @includeIf: view không tồn tại → bỏ qua, không lỗi
+            }
+        }
+        this.guardChildMount(() => this.mountChild());
+    }
+    /**
+     * 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).
+     */
+    guardChildMount(mount) {
+        try {
+            mount();
+        }
+        catch (err) {
+            const result = this.ctx.handleError(err, { phase: 'render', path: this.path ?? '' });
+            if (!result.handled)
+                throw err;
+            this.mountFallback(result.fallback);
+        }
+    }
+    /** Dọn DOM dở dang của lần render lỗi rồi chèn fallback giữa cặp marker. */
+    mountFallback(fallback) {
+        let current = this.openTag.nextSibling;
+        while (current && current !== this.closeTag) {
+            const next = current.nextSibling;
+            current.parentNode?.removeChild(current);
+            current = next;
+        }
+        if (fallback === null || fallback === undefined)
+            return;
+        mountChildrenBeforeAnchor(this.closeTag, Array.isArray(fallback) ? fallback : [fallback], this.parent);
+    }
+    /**
+     * 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-->.
+     */
+    discoverChildViewId() {
+        let current = this.openTag.nextSibling;
+        while (current && current !== this.closeTag) {
+            if (current.nodeType === Node.COMMENT_NODE) {
+                const parsed = markerRegistry.parseComment(current.nodeValue ?? '');
+                if (parsed && parsed.tag === 'view' && !parsed.isClose)
+                    return parsed.id;
+            }
+            else if (current.nodeType === Node.ELEMENT_NODE) {
+                const walker = document.createTreeWalker(current, NodeFilter.SHOW_COMMENT);
+                let node;
+                while ((node = walker.nextNode())) {
+                    const parsed = markerRegistry.parseComment(node.nodeValue ?? '');
+                    if (parsed && parsed.tag === 'view' && !parsed.isClose)
+                        return parsed.id;
+                }
+            }
+            current = current.nextSibling;
+        }
+        return null;
+    }
+    /**
+     * 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.
+     */
+    hydrateChild() {
+        if (this._childMounted && this.viewRef)
+            return;
+        // Không có marker view của server giữa cặp marker component → server
+        // KHÔNG render view con ở đây. Hydrate tiếp thì child giữ viewId do
+        // client sinh ('c…'), rồi đi tìm class "{c…}-{id}" và marker
+        // "s:v:c…" không tồn tại → dựng cây mới CẠNH cây server, tức nhân đôi
+        // DOM. Dọn phần server bỏ lại rồi đi đường CSR — giống nhánh
+        // "partial hydration fallback" ở render() khi marker component vắng.
+        const ssrViewId = this.discoverChildViewId();
+        if (!ssrViewId) {
+            this.unmountChild();
+            this.mountChild();
+            return;
+        }
+        const childView = this.resolveChildView();
+        if (!childView)
+            return;
+        const childCtrl = childView.__ctrl__;
+        // Ghi đè viewId = viewId server (trước render — Wrapper/Html/Output của
+        // child claim theo marker/class prefix bằng viewId này)
+        childCtrl.viewId = ssrViewId;
+        // Commit state TRƯỚC render (factory @if/@foreach sinh đúng cây khớp SSR);
+        // flush ngay khi chưa subscribe → discard pending, không phá DOM claim.
+        childCtrl.initMode = InitModes.HYDRATE;
+        commitView(childCtrl, true);
+        const wrapper = childCtrl.render();
+        if (wrapper && typeof wrapper === 'object' && 'openTag' in wrapper && this.parent) {
+            claimHydratedView(childCtrl, this.parent, wrapper);
+        }
+        childCtrl.initMode = InitModes.CREATE;
+        this.finishChildMount(childCtrl);
+    }
+    /** Tạo + mount child view giữa markers (nếu chưa có) */
+    mountChild() {
+        if (this._childMounted && this.viewRef) {
+            if (this.dataFactory) {
+                const ctrl = this.viewRef.__ctrl__;
+                ctrl.updateData(this.dataFactory(this.parent));
+                ctrl.states.__.flushNow();
+            }
+            return;
+        }
+        const childView = this.resolveChildView();
+        if (!childView)
+            return;
+        const childCtrl = childView.__ctrl__;
+        // Render child tree giữa markers
+        const wrapper = childCtrl.render();
+        if (wrapper && typeof wrapper === 'object' && 'openTag' in wrapper) {
+            const insertBeforeClose = (node) => {
+                this.closeTag.parentNode?.insertBefore(node, this.closeTag);
+            };
+            insertBeforeClose(wrapper.openTag);
+            insertBeforeClose(wrapper.closeTag);
+            // Wrapper render idempotent qua mountChildrenBeforeAnchor
+            mountChildrenBeforeAnchor(wrapper.closeTag, wrapper.render(), this.parent);
+        }
+        // mount(): nội dung child đã nằm giữa markers → fire mounting/mounted + acquire asset
+        childCtrl.mount();
+        commitView(childCtrl);
+        this.markChildMounted(childCtrl);
+    }
+    /** Resolve one child instance and establish ownership before either DOM strategy. */
+    resolveChildView() {
+        const viewManager = this.ctx.App?.View;
+        if (!viewManager || !this.path) {
+            console.error(`[Component] Không resolve được view "${this.path}" — App.View chưa sẵn sàng.`);
+            return null;
+        }
+        const data = this.dataFactory ? this.dataFactory(this.parent) : this.data;
+        // Sync: render tree không await được (xem ViewManager.resolveViewSync).
+        const childView = viewManager.resolveViewSync(this.path, data ?? {}, false);
+        if (!childView) {
+            console.error(`[Component] View "${this.path}" không tồn tại trong registry.`);
+            return null;
+        }
+        this.viewRef = childView;
+        const childCtrl = childView.__ctrl__;
+        childCtrl.ownerComponent = this;
+        childCtrl.setParent(this.ctx);
+        this.ctx.addChild(childCtrl);
+        childCtrl.setParentElement(this.parent);
+        return childView;
+    }
+    /** Hydration mounts after commit/claim; CSR commits immediately after mount. */
+    finishChildMount(childCtrl) {
+        childCtrl.mount();
+        this.markChildMounted(childCtrl);
+    }
+    markChildMounted(childCtrl) {
+        this._childMounted = true;
+        if (this._isStarted)
+            activateView(childCtrl);
+    }
+    /** Gỡ child (when=false hoặc destroy) */
+    unmountChild() {
+        if (this.viewRef) {
+            this.viewRef.__ctrl__.destroy();
+            this.viewRef = null;
+        }
+        // Clear mọi node giữa markers
+        let current = this.openTag.nextSibling;
+        while (current && current !== this.closeTag) {
+            const next = current.nextSibling;
+            current.remove();
+            current = next;
+        }
+        this._childMounted = false;
+    }
+    /**
+     * Start — kích hoạt child + subscribe:
+     *   - stateKeys: props reactive — đổi → dataFactory mới → child.updateData()
+     *   - condition (type 'when'): đổi → mount/unmount child
+     */
     start() {
+        if (this._isStarted || this.__destroyed__)
+            return;
+        this._isStarted = true;
+        if (this.viewRef) {
+            activateView(this.viewRef.__ctrl__);
+        }
+        if (this.stateKeys.length > 0) {
+            this.unsubscribeData = this.ctx.states.__.subscribe(this.stateKeys, () => {
+                if (this.viewRef && this.dataFactory) {
+                    this.viewRef.__ctrl__.updateData(this.dataFactory(this.parent));
+                }
+            });
+        }
+        if (this.type === 'when' && this.condition && this.condition.stateKeys.length > 0) {
+            this.unsubscribeCondition = this.ctx.states.__.subscribe(this.condition.stateKeys, () => {
+                this.render(); // re-evaluate checker → mount/unmount
+            });
+        }
     }
     stop() {
-    }
-    render() {
-        // To be implemented by specific components
+        if (!this._isStarted)
+            return;
+        this._isStarted = false;
+        if (this.unsubscribeData) {
+            this.unsubscribeData();
+            this.unsubscribeData = null;
+        }
+        if (this.unsubscribeCondition) {
+            this.unsubscribeCondition();
+            this.unsubscribeCondition = null;
+        }
+        this.viewRef?.__ctrl__.stop();
     }
     destroy() {
-        // To be implemented by specific components
+        if (this.__destroyed__)
+            return;
+        this.stop();
+        this.__destroyed__ = true;
+        this.ctx.releaseElement?.(this);
+        this.unmountChild();
+        this.openTag.remove();
+        this.closeTag.remove();
+        this.parent = null;
     }
-    get isOneElement() {
+    get isSaoElement() {
         return true;
     }
-    set isOneElement(value) {
+    set isSaoElement(value) {
         // No-op, just for type compatibility
     }
     get isOneComponent() {

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

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

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

@@ -0,0 +1,95 @@
+/**
+ * ForeachSlotCache — keyed slot manager cho @foreach reconciliation.
+ *
+ * # Cơ chế
+ * Mỗi item được identify bằng một cache key:
+ *   - Có @key(expr)   → key = giá trị expr (field keying, vd `item.id`)
+ *   - Không có @key   → key = object reference của item (identity keying)
+ * Duplicate keys (primitive lists `['a','b','a']`, refs lặp) được phân biệt
+ * bằng occurrence index trong pass — key thứ n trùng nhau map vào slot thứ n.
+ *
+ * # Reuse contract
+ * Slot chỉ được REUSE khi cache key khớp VÀ item ref không đổi
+ * (`slot.item === item`). Ref đổi → recreate, vì compiled output đóng gói
+ * `item` trực tiếp vào closure (`() => item.name`) — reuse với ref cũ sẽ
+ * hiển thị data cũ. Field key vì vậy chủ yếu mang lại: bookkeeping đúng cho
+ * duplicate/primitive items + ý định tường minh của developer.
+ *
+ * # Pass protocol (một chu kỳ render)
+ *   1. `beginPass()`  — reset occurrence counters + tập slot touched
+ *   2. `claim(key, item)` mỗi item theo thứ tự list:
+ *        hit  (slot.item === item) → dùng lại, slot được mark touched
+ *        miss → caller tạo elements rồi `store(key, occ, item, elements)`
+ *   3. `prunePass(onRemove)` — slot KHÔNG được touch trong pass = item đã rời
+ *      list → callback destroy + gỡ khỏi cache. (Trước đây bước này là dead
+ *      code — cache không bao giờ gỡ entry → element của item bị xoá leak.)
+ *      Slot bị `store()` GHI ĐÈ (cùng key, ref mới) cũng đi qua đây: nó rơi khỏi
+ *      `_map` ngay lúc ghi đè nên prunePass không còn thấy → phải giữ tạm trong
+ *      `_evicted`. Thiếu bước này thì refresh list từ server (`@key` giữ nguyên,
+ *      ref đổi) KHÔNG destroy elements cũ → view con của @include bị tái dùng
+ *      trong DOM đã detach và biến mất khỏi trang.
+ *
+ * # Quan hệ với Reactive
+ * Reactive type 'foreach' giữ một instance; cửa sổ `_currentForeachCache`
+ * chỉ mở quanh CHÍNH childrenFactory call (không mở trong child.render() —
+ * tránh nested @foreach ghi nhầm vào cache của loop ngoài).
+ *
+ * @see Reactive.renderForeach()
+ * @see ViewController.__foreach()
+ */
+/** Một slot tương ứng với một item trong foreach list. */
+export interface ForeachSlot {
+    /** Reference tới item gốc — điều kiện reuse là ref không đổi */
+    item: any;
+    /** Saola elements sinh ra bởi item factory — Html, Output, Reactive, ... */
+    elements: any[];
+    /** Compiler opt-in: closures are refreshed within this occurrence's scope. */
+    registry?: Map<string, any>;
+    identity?: number;
+}
+/** Kết quả claim: slot khi reuse được, occ để store khi phải tạo mới. */
+export interface ForeachClaim {
+    slot: ForeachSlot | null;
+    occ: number;
+}
+export declare class ForeachSlotCache {
+    readonly refreshedElements: Set<any>;
+    private nextIdentity;
+    /** Initial SSR indexes, then monotonically allocated identities for new rows. */
+    allocateIdentity(index: number): number;
+    /** Map key → danh sách slot theo occurrence (duplicate keys) */
+    private _map;
+    /** Occurrence counter của pass hiện tại */
+    private _passOcc;
+    /** Slots được claim-hit hoặc store trong pass hiện tại */
+    private _touched;
+    /** Slots bị store() ghi đè trong pass hiện tại — prunePass destroy rồi clear */
+    private _evicted;
+    /** Tổng số slot đang cache (mọi occurrence). */
+    get size(): number;
+    /** Bắt đầu một chu kỳ render — reset counters + touched set. */
+    beginPass(): void;
+    /**
+     * Claim slot cho (key, item) theo thứ tự list.
+     * Trả slot khi reuse được (key khớp + ref không đổi); ngược lại slot=null
+     * và caller phải store(key, occ, ...) sau khi tạo elements.
+     */
+    claim(key: any, item: any, reconcile?: boolean): ForeachClaim;
+    /**
+     * Lưu slot mới tại (key, occ) — ghi đè slot cũ nếu ref đã đổi.
+     * Slot bị ghi đè KHÔNG còn nằm trong `_map` nên prunePass duyệt `_map` sẽ
+     * không thấy nó nữa → phải chuyển sang `_evicted` để vẫn được destroy.
+     */
+    store(key: any, occ: number, item: any, elements: any[], registry?: Map<string, any>): ForeachSlot;
+    /**
+     * Kết thúc pass: mọi slot không được touch = item đã rời list (hoặc bị
+     * thay bằng ref mới) → gọi onRemove(slot) để destroy elements, gỡ khỏi cache.
+     */
+    prunePass(onRemove: (slot: ForeachSlot) => void): void;
+    /**
+     * Xoá toàn bộ cache — dùng khi Reactive bị destroy.
+     * KHÔNG tự gọi destroy() trên elements — caller phải làm trước.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ForeachSlotCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ForeachSlotCache.d.ts","sourceRoot":"","sources":["../../../../src/core/elements/ForeachSlotCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IACxB,gEAAgE;IAChE,IAAI,EAAE,GAAG,CAAC;IACV,4EAA4E;IAC5E,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,iBAAiB,WAAkB;IAC5C,OAAO,CAAC,YAAY,CAAK;IAEzB,iFAAiF;IACjF,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKvC,gEAAgE;IAChE,OAAO,CAAC,IAAI,CAAsC;IAClD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAA+B;IAC/C,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAqB;IAErC,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAIjB;IAED,gEAAgE;IAChE,SAAS,IAAI,IAAI;IAOjB;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,UAAQ,GAAG,YAAY;IAY3D;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW;IAgBlG;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAwBtD;;;OAGG;IACH,KAAK,IAAI,IAAI;CAQhB"}

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

@@ -0,0 +1,149 @@
+/**
+ * ForeachSlotCache — keyed slot manager cho @foreach reconciliation.
+ *
+ * # Cơ chế
+ * Mỗi item được identify bằng một cache key:
+ *   - Có @key(expr)   → key = giá trị expr (field keying, vd `item.id`)
+ *   - Không có @key   → key = object reference của item (identity keying)
+ * Duplicate keys (primitive lists `['a','b','a']`, refs lặp) được phân biệt
+ * bằng occurrence index trong pass — key thứ n trùng nhau map vào slot thứ n.
+ *
+ * # Reuse contract
+ * Slot chỉ được REUSE khi cache key khớp VÀ item ref không đổi
+ * (`slot.item === item`). Ref đổi → recreate, vì compiled output đóng gói
+ * `item` trực tiếp vào closure (`() => item.name`) — reuse với ref cũ sẽ
+ * hiển thị data cũ. Field key vì vậy chủ yếu mang lại: bookkeeping đúng cho
+ * duplicate/primitive items + ý định tường minh của developer.
+ *
+ * # Pass protocol (một chu kỳ render)
+ *   1. `beginPass()`  — reset occurrence counters + tập slot touched
+ *   2. `claim(key, item)` mỗi item theo thứ tự list:
+ *        hit  (slot.item === item) → dùng lại, slot được mark touched
+ *        miss → caller tạo elements rồi `store(key, occ, item, elements)`
+ *   3. `prunePass(onRemove)` — slot KHÔNG được touch trong pass = item đã rời
+ *      list → callback destroy + gỡ khỏi cache. (Trước đây bước này là dead
+ *      code — cache không bao giờ gỡ entry → element của item bị xoá leak.)
+ *      Slot bị `store()` GHI ĐÈ (cùng key, ref mới) cũng đi qua đây: nó rơi khỏi
+ *      `_map` ngay lúc ghi đè nên prunePass không còn thấy → phải giữ tạm trong
+ *      `_evicted`. Thiếu bước này thì refresh list từ server (`@key` giữ nguyên,
+ *      ref đổi) KHÔNG destroy elements cũ → view con của @include bị tái dùng
+ *      trong DOM đã detach và biến mất khỏi trang.
+ *
+ * # Quan hệ với Reactive
+ * Reactive type 'foreach' giữ một instance; cửa sổ `_currentForeachCache`
+ * chỉ mở quanh CHÍNH childrenFactory call (không mở trong child.render() —
+ * tránh nested @foreach ghi nhầm vào cache của loop ngoài).
+ *
+ * @see Reactive.renderForeach()
+ * @see ViewController.__foreach()
+ */
+export class ForeachSlotCache {
+    constructor() {
+        this.refreshedElements = new Set();
+        this.nextIdentity = 0;
+        /** Map key → danh sách slot theo occurrence (duplicate keys) */
+        this._map = new Map();
+        /** Occurrence counter của pass hiện tại */
+        this._passOcc = new Map();
+        /** Slots được claim-hit hoặc store trong pass hiện tại */
+        this._touched = new Set();
+        /** Slots bị store() ghi đè trong pass hiện tại — prunePass destroy rồi clear */
+        this._evicted = [];
+    }
+    /** Initial SSR indexes, then monotonically allocated identities for new rows. */
+    allocateIdentity(index) {
+        const identity = Math.max(index, this.nextIdentity);
+        this.nextIdentity = identity + 1;
+        return identity;
+    }
+    /** Tổng số slot đang cache (mọi occurrence). */
+    get size() {
+        let n = 0;
+        for (const slots of this._map.values())
+            n += slots.length;
+        return n;
+    }
+    /** Bắt đầu một chu kỳ render — reset counters + touched set. */
+    beginPass() {
+        this.refreshedElements.clear();
+        this._passOcc = new Map();
+        this._touched = new Set();
+        this._evicted = [];
+    }
+    /**
+     * Claim slot cho (key, item) theo thứ tự list.
+     * Trả slot khi reuse được (key khớp + ref không đổi); ngược lại slot=null
+     * và caller phải store(key, occ, ...) sau khi tạo elements.
+     */
+    claim(key, item, reconcile = false) {
+        const occ = this._passOcc.get(key) ?? 0;
+        this._passOcc.set(key, occ + 1);
+        const slot = this._map.get(key)?.[occ] ?? null;
+        if (slot && (slot.item === item || (reconcile && slot.registry))) {
+            this._touched.add(slot);
+            return { slot, occ };
+        }
+        return { slot: null, occ };
+    }
+    /**
+     * Lưu slot mới tại (key, occ) — ghi đè slot cũ nếu ref đã đổi.
+     * Slot bị ghi đè KHÔNG còn nằm trong `_map` nên prunePass duyệt `_map` sẽ
+     * không thấy nó nữa → phải chuyển sang `_evicted` để vẫn được destroy.
+     */
+    store(key, occ, item, elements, registry) {
+        const slot = { item, elements, registry };
+        let slots = this._map.get(key);
+        if (!slots) {
+            slots = [];
+            this._map.set(key, slots);
+        }
+        const evicted = slots[occ];
+        if (evicted && !this._touched.has(evicted)) {
+            this._evicted.push(evicted);
+        }
+        slots[occ] = slot;
+        this._touched.add(slot);
+        return slot;
+    }
+    /**
+     * Kết thúc pass: mọi slot không được touch = item đã rời list (hoặc bị
+     * thay bằng ref mới) → gọi onRemove(slot) để destroy elements, gỡ khỏi cache.
+     */
+    prunePass(onRemove) {
+        // Slot bị ghi đè: đã rời `_map` lúc store() nên chỉ cần destroy.
+        for (const slot of this._evicted)
+            onRemove(slot);
+        this._evicted = [];
+        for (const [key, slots] of this._map) {
+            let hasRemoval = false;
+            for (const slot of slots) {
+                if (slot && !this._touched.has(slot)) {
+                    onRemove(slot);
+                    hasRemoval = true;
+                }
+            }
+            if (hasRemoval) {
+                const kept = slots.filter(s => s && this._touched.has(s));
+                if (kept.length) {
+                    this._map.set(key, kept);
+                }
+                else {
+                    this._map.delete(key);
+                }
+            }
+        }
+    }
+    /**
+     * Xoá toàn bộ cache — dùng khi Reactive bị destroy.
+     * KHÔNG tự gọi destroy() trên elements — caller phải làm trước.
+     */
+    clear() {
+        this.nextIdentity = 0;
+        this.refreshedElements.clear();
+        this._map.clear();
+        this._passOcc = new Map();
+        this._touched = new Set();
+        this._evicted = [];
+    }
+}
+//# sourceMappingURL=ForeachSlotCache.js.map