@toolbox-web/grid 2.7.0 → 2.7.1

package/umd/plugins/master-detail.umd.js

@@ -1,2 +1,2 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("../../core/internal/sanitize"),require("../../core/plugin/base-plugin"),require("../../core/plugin/expander-column")):"function"==typeof define&&define.amd?define(["exports","../../core/internal/sanitize","../../core/plugin/base-plugin","../../core/plugin/expander-column"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TbwGridPlugin_masterDetail={},e.TbwGrid,e.TbwGrid,e.TbwGrid)}(this,function(e,t,i,n){"use strict";function s(e,t){return e.has(t)?e.delete(t):e.add(t),e}function a(e,t,i,n){const s=document.createElement("div");s.className="master-detail-row",s.setAttribute("data-detail-for",String(t)),s.setAttribute("role","row");const a=document.createElement("div");a.className="master-detail-cell",a.setAttribute("role","cell"),a.style.gridColumn=`1 / ${n+1}`;const r=i(e,t);return"string"==typeof r?a.innerHTML=r:r instanceof HTMLElement&&a.appendChild(r),s.appendChild(a),s}class r extends i.BaseGridPlugin{name="masterDetail";styles="@layer tbw-plugins{tbw-grid .cell[data-field=__tbw_expander]{border-right:none!important;padding:0;display:flex;align-items:center;justify-content:center}tbw-grid .header-row .cell[data-field=__tbw_expander]{display:none}tbw-grid .master-detail-expander{display:flex;align-items:center;justify-content:center;width:100%;height:100%}tbw-grid .master-detail-toggle{cursor:pointer;opacity:.7;-webkit-user-select:none;user-select:none;display:inline-flex;align-items:center;justify-content:center}tbw-grid .master-detail-toggle:hover{opacity:1}tbw-grid .master-detail-row{grid-column:1 / -1;display:grid;background:var(--tbw-master-detail-bg, var(--tbw-color-row-alt));border-bottom:1px solid var(--tbw-master-detail-border, var(--tbw-color-border));overflow:hidden}tbw-grid .master-detail-cell{padding:var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));overflow:auto}tbw-grid .master-detail-row.tbw-expanding{animation:tbw-detail-expand var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}tbw-grid .master-detail-row.tbw-collapsing{animation:tbw-detail-collapse var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}@keyframes tbw-detail-expand{0%{opacity:0;max-height:0;padding-top:0;padding-bottom:0}to{opacity:1;max-height:var(--tbw-detail-max-height, 31.25rem);padding-top:var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));padding-bottom:var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem))}}@keyframes tbw-detail-collapse{0%{opacity:1;max-height:var(--tbw-detail-max-height, 31.25rem)}to{opacity:0;max-height:0}}}";static dependencies=[{name:"serverSide",required:!1,reason:"Fetches detail data via datasource:fetch-children on expand"}];get#e(){return this.grid}get defaultConfig(){return{detailHeight:"auto",expandOnRowClick:!1,collapseOnClickOutside:!1,animation:"slide"}}attach(e){super.attach(e),this.parseLightDomDetail(),this.on("datasource:children",e=>{const t=e;if("master-detail"!==t.context?.source)return;t.claimed=!0;const i=t.context.row;if(i&&this.expandedRows.has(i)){this.detailDataMap.set(i,t.rows),this.loadingDetails.delete(i);const e=this.detailElements.get(i);e&&(e.remove(),this.detailElements.delete(i),this.measuredDetailHeights.delete(i)),this.requestRender()}})}parseLightDomDetail(){const e=this.gridElement;if(!e)return;const i=e.querySelector("tbw-grid-detail");if(!i)return;const n=this.#e.__frameworkAdapter;if(n?.parseDetailElement){const e=n.parseDetailElement(i);if(e)return void(this.config={...this.config,detailRenderer:e})}const s=i.getAttribute("animation"),a=i.getAttribute("show-expand-column"),r=i.getAttribute("expand-on-row-click"),o=i.getAttribute("collapse-on-click-outside"),d=i.getAttribute("height"),l={};null!==s&&(l.animation="false"!==s&&s),null!==a&&(l.showExpandColumn="false"!==a),null!==r&&(l.expandOnRowClick="true"===r),null!==o&&(l.collapseOnClickOutside="true"===o),null!==d&&(l.detailHeight="auto"===d?"auto":parseInt(d,10));const c=i.innerHTML.trim();c&&!this.config.detailRenderer&&(l.detailRenderer=(e,i)=>{const n=t.evalTemplateString(c,{value:e,row:e});return t.sanitizeHTML(n)}),Object.keys(l).length>0&&(this.config={...this.config,...l})}get animationStyle(){return!!this.isAnimationEnabled&&(this.config.animation??"slide")}animateExpand(e,t,i){if(!this.isAnimationEnabled||!1===this.animationStyle)return!1;e.classList.add("tbw-expanding");let n=!1;const s=()=>{n||(n=!0,e.classList.remove("tbw-expanding"),void 0!==t&&void 0!==i&&this.#t(e,t,i))};return e.addEventListener("animationend",s,{once:!0}),setTimeout(s,this.animationDuration+50),!0}animateCollapse(e,t){if(!this.isAnimationEnabled||!1===this.animationStyle)return void t();e.classList.add("tbw-collapsing");const i=()=>{e.classList.remove("tbw-collapsing"),t()};e.addEventListener("animationend",i,{once:!0}),setTimeout(i,this.animationDuration+50)}#t(e,t,i){if(!e.isConnected)return;const n=e.offsetHeight;if(n>0){const e=this.measuredDetailHeights.get(t);this.measuredDetailHeights.set(t,n),e!==n&&this.grid.invalidateRowHeight(i)}}expandedRows=new Set;detailElements=new Map;measuredDetailHeights=new Map;rowsToAnimate=new Set;loadingDetails=new Set;detailDataMap=new Map;static DEFAULT_DETAIL_HEIGHT=150;getDetailHeight(e){const t=this.detailElements.get(e);if(t){if(!(t.classList.contains("tbw-expanding")||t.classList.contains("tbw-collapsing"))){const i=t.offsetHeight;if(i>0)return this.measuredDetailHeights.set(e,i),i}}const i=this.measuredDetailHeights.get(e);return i&&i>0?i:"number"==typeof this.config?.detailHeight?this.config.detailHeight:r.DEFAULT_DETAIL_HEIGHT}toggleAndEmit(e,t){if(e?.__isGroupRow)return;this.expandedRows=s(this.expandedRows,e);const i=this.expandedRows.has(e);if(i){if(this.rowsToAnimate.add(e),!this.detailDataMap.has(e)){const i=this.grid?.query?.("datasource:is-active",null);i&&(this.loadingDetails.add(e),this.grid.query("datasource:fetch-children",{context:{source:"master-detail",row:e,rowIndex:t}}))}}else this.loadingDetails.delete(e);this.emit("detail-expand",{rowIndex:t,row:e,expanded:i}),this.requestRender()}detach(){this.expandedRows.clear(),this.detailElements.clear(),this.measuredDetailHeights.clear(),this.rowsToAnimate.clear(),this.loadingDetails.clear(),this.detailDataMap.clear()}processColumns(e){if(!(!0===this.config.showExpandColumn||!1!==this.config.showExpandColumn&&!!this.config.detailRenderer))return[...e];const t=[...e];if(n.findExpanderColumn(t))return t;const i=n.createExpanderColumnConfig(this.name);return i.viewRenderer=e=>{const{row:t}=e,i=this.expandedRows.has(t),n=document.createElement("span");n.className="master-detail-expander expander-cell";const s=document.createElement("span");return s.className="master-detail-toggle"+(i?" expanded":""),this.setIcon(s,i?"collapse":"expand"),s.setAttribute("role","button"),s.setAttribute("tabindex","0"),s.setAttribute("aria-expanded",String(i)),s.setAttribute("aria-label",i?"Collapse details":"Expand details"),n.appendChild(s),n},[i,...t]}onRowClick(e){if(this.config.expandOnRowClick&&this.config.detailRenderer)return this.toggleAndEmit(e.row,e.rowIndex),!1}onCellClick(e){const t=e.originalEvent?.target;if(t?.classList.contains("master-detail-toggle"))return this.toggleAndEmit(e.row,e.rowIndex),!0;this.expandedRows.size>0&&queueMicrotask(()=>this.#i())}onKeyDown(e){if(" "!==e.key)return;const t=this.grid._focusCol,i=this.grid._focusRow,s=this.visibleColumns[t];if(!s||!n.isExpanderColumn(s))return;const a=this.rows[i];return a?(e.preventDefault(),this.toggleAndEmit(a,i),this.requestRenderWithFocus(),!0):void 0}afterRender(){this.#n(),this.#i()}#n(){const e=this.gridElement?.querySelector('.header-row .cell[data-field="__tbw_expander"]');if(!e)return;const t=parseInt(e.getAttribute("data-col")||"0",10),i=e.nextElementSibling;i&&(i.style.gridColumn=`${t+1} / ${t+3}`)}onScrollRender(){this.config.detailRenderer&&0!==this.expandedRows.size&&this.#i()}#i(){if(!this.config.detailRenderer)return;const e=this.gridElement?.querySelector(".rows");if(!e)return;const t=this.grid,i=t._rowPool,n=t._virtualization?.start??0,s=t._virtualization?.end??0,r=this.columns.length,o=n,d=s,l=new Map;if(i){const t=Math.min(i.length,d-o);for(let n=0;n<t;n++){const t=i[n];t.parentNode===e&&l.set(o+n,t)}}else{const t=e.querySelectorAll(".data-grid-row");for(const e of t){const t=e.querySelector(".cell[data-row]"),i=t?parseInt(t.getAttribute("data-row")??"-1",10):-1;i>=0&&l.set(i,e)}}for(const[a,c]of this.detailElements){const e=this.rows.indexOf(a),t=this.expandedRows.has(a),i=e>=0&&l.has(e);if(!t||!i){const e=this.#e.__frameworkAdapter;if(e?.unmount){const t=c.querySelector(".master-detail-cell"),i=t?.firstElementChild;i&&e.unmount(i)}c.parentNode&&c.remove(),this.detailElements.delete(a)}}for(const[c,h]of l){const e=this.rows[c];if(!e||!this.expandedRows.has(e))continue;const t=this.detailElements.get(e);if(t){t.previousElementSibling!==h&&h.after(t);continue}const i=a(e,c,this.config.detailRenderer,r);"number"==typeof this.config.detailHeight&&(i.style.height=`${this.config.detailHeight}px`),h.after(i),this.detailElements.set(e,i);const n=this.rowsToAnimate.has(e);n&&this.rowsToAnimate.delete(e);n&&this.animateExpand(i,e,c)||requestAnimationFrame(()=>{this.#t(i,e,c)})}}getRowHeight(e,t){if(!this.expandedRows.has(e))return;return(this.grid.defaultRowHeight??28)+this.getDetailHeight(e)}adjustVirtualStart(e,t,i){if(0===this.expandedRows.size)return e;const n=this.grid?._virtualization?.positionCache;let s=e;if(n&&n.length>0)for(const a of this.expandedRows){const i=this.rows.indexOf(a);if(i<0||i>=e)continue;n[i].offset+n[i].height>t&&i<s&&(s=i)}else{const n=[];for(const e of this.expandedRows){const t=this.rows.indexOf(e);t>=0&&n.push({index:t,row:e})}n.sort((e,t)=>e.index-t.index);let a=0;for(const{index:r,row:o}of n){const n=r*i+a,d=this.getDetailHeight(o);a+=d,r>=e||n+i+d>t&&r<s&&(s=r)}}return s}expand(e){const t=this.rows[e];t&&!t.__isGroupRow&&(this.rowsToAnimate.add(t),this.expandedRows=function(e,t){return e.add(t),e}(this.expandedRows,t),this.requestRender())}collapse(e){const t=this.rows[e];t&&(this.expandedRows=function(e,t){return e.delete(t),e}(this.expandedRows,t),this.requestRender())}toggle(e){const t=this.rows[e];t&&!t.__isGroupRow&&(this.expandedRows=s(this.expandedRows,t),this.expandedRows.has(t)&&this.rowsToAnimate.add(t),this.requestRender())}isExpanded(e){const t=this.rows[e];return!!t&&function(e,t){return e.has(t)}(this.expandedRows,t)}expandAll(){for(const e of this.rows)e?.__isGroupRow||(this.rowsToAnimate.add(e),this.expandedRows.add(e));this.requestRender()}collapseAll(){this.expandedRows.clear(),this.requestRender()}getExpandedRows(){const e=[];for(const t of this.expandedRows){const i=this.rows.indexOf(t);i>=0&&e.push(i)}return e}getDetailElement(e){const t=this.rows[e];return t?this.detailElements.get(t):void 0}getDetailData(e){const t=this.rows[e];return t?this.detailDataMap.get(t):void 0}isDetailLoading(e){const t=this.rows[e];return!!t&&this.loadingDetails.has(t)}refreshDetailRenderer(){const e=this.config.detailRenderer;if(this.config={...this.config,detailRenderer:void 0},this.parseLightDomDetail(),!this.config.detailRenderer&&e&&(this.config={...this.config,detailRenderer:e}),this.config.detailRenderer){const e=this.#e;"function"==typeof e.refreshColumns?e.refreshColumns():this.requestRender()}}}e.MasterDetailPlugin=r,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("../../core/internal/sanitize"),require("../../core/plugin/base-plugin"),require("../../core/plugin/expander-column")):"function"==typeof define&&define.amd?define(["exports","../../core/internal/sanitize","../../core/plugin/base-plugin","../../core/plugin/expander-column"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TbwGridPlugin_masterDetail={},e.TbwGrid,e.TbwGrid,e.TbwGrid)}(this,function(e,t,i,n){"use strict";function s(e,t){return e.has(t)?e.delete(t):e.add(t),e}function a(e,t,i,n){const s=document.createElement("div");s.className="master-detail-row",s.setAttribute("data-detail-for",String(t)),s.setAttribute("role","row");const a=document.createElement("div");a.className="master-detail-cell",a.setAttribute("role","cell"),a.style.gridColumn=`1 / ${n+1}`;const r=i(e,t);return"string"==typeof r?a.innerHTML=r:r instanceof HTMLElement&&a.appendChild(r),s.appendChild(a),s}class r extends i.BaseGridPlugin{name="masterDetail";styles="@layer tbw-plugins{tbw-grid .cell[data-field=__tbw_expander]{border-right:none!important;padding:0;display:flex;align-items:center;justify-content:center}tbw-grid .header-row .cell[data-field=__tbw_expander]{display:none}tbw-grid .master-detail-expander{display:flex;align-items:center;justify-content:center;width:100%;height:100%}tbw-grid .master-detail-toggle{cursor:pointer;opacity:.7;-webkit-user-select:none;user-select:none;display:inline-flex;align-items:center;justify-content:center}tbw-grid .master-detail-toggle:hover{opacity:1}tbw-grid .master-detail-row{grid-column:1 / -1;display:grid;background:var(--tbw-master-detail-bg, var(--tbw-color-row-alt));border-bottom:1px solid var(--tbw-master-detail-border, var(--tbw-color-border));overflow:hidden}tbw-grid .master-detail-cell{padding:var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));overflow:auto}tbw-grid .master-detail-row.tbw-expanding{animation:tbw-detail-expand var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}tbw-grid .master-detail-row.tbw-collapsing{animation:tbw-detail-collapse var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}@keyframes tbw-detail-expand{0%{opacity:0;max-height:0;padding-top:0;padding-bottom:0}to{opacity:1;max-height:var(--tbw-detail-max-height, 31.25rem);padding-top:var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));padding-bottom:var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem))}}@keyframes tbw-detail-collapse{0%{opacity:1;max-height:var(--tbw-detail-max-height, 31.25rem)}to{opacity:0;max-height:0}}}";static dependencies=[{name:"serverSide",required:!1,reason:"Fetches detail data via datasource:fetch-children on expand"}];get#e(){return this.grid}get defaultConfig(){return{detailHeight:"auto",expandOnRowClick:!1,collapseOnClickOutside:!1,animation:"slide"}}attach(e){super.attach(e),this.parseLightDomDetail(),this.on("datasource:children",e=>{const t=e;if("master-detail"!==t.context?.source)return;t.claimed=!0;const i=t.context.row;if(i&&this.expandedRows.has(i)){this.detailDataMap.set(i,t.rows),this.loadingDetails.delete(i);const e=this.detailElements.get(i);e&&(e.remove(),this.detailElements.delete(i),this.measuredDetailHeights.delete(i)),this.requestRender()}})}parseLightDomDetail(){const e=this.gridElement;if(!e)return;const i=e.querySelector("tbw-grid-detail");if(!i)return;const n=this.#e.__frameworkAdapter;if(n?.parseDetailElement){const e=n.parseDetailElement(i);if(e)return void(this.config={...this.config,detailRenderer:e})}const s=i.getAttribute("animation"),a=i.getAttribute("show-expand-column"),r=i.getAttribute("expand-on-row-click"),o=i.getAttribute("collapse-on-click-outside"),d=i.getAttribute("height"),l={};null!==s&&(l.animation="false"!==s&&s),null!==a&&(l.showExpandColumn="false"!==a),null!==r&&(l.expandOnRowClick="true"===r),null!==o&&(l.collapseOnClickOutside="true"===o),null!==d&&(l.detailHeight="auto"===d?"auto":parseInt(d,10));const c=i.innerHTML.trim();c&&!this.config.detailRenderer&&(l.detailRenderer=(e,i)=>{const n=t.evalTemplateString(c,{value:e,row:e});return t.sanitizeHTML(n)}),Object.keys(l).length>0&&(this.config={...this.config,...l})}get animationStyle(){return!!this.isAnimationEnabled&&(this.config.animation??"slide")}animateExpand(e,t,i){if(!this.isAnimationEnabled||!1===this.animationStyle)return!1;e.classList.add("tbw-expanding");let n=!1;const s=()=>{n||(n=!0,e.classList.remove("tbw-expanding"),void 0!==t&&void 0!==i&&this.#t(e,t,i))};return e.addEventListener("animationend",s,{once:!0}),setTimeout(s,this.animationDuration+50),!0}animateCollapse(e,t){if(!this.isAnimationEnabled||!1===this.animationStyle)return void t();e.classList.add("tbw-collapsing");const i=()=>{e.classList.remove("tbw-collapsing"),t()};e.addEventListener("animationend",i,{once:!0}),setTimeout(i,this.animationDuration+50)}#t(e,t,i){if(!e.isConnected)return;const n=e.offsetHeight;if(n>0){const e=this.measuredDetailHeights.get(t);this.measuredDetailHeights.set(t,n),e!==n&&this.grid.invalidateRowHeight(i)}}expandedRows=new Set;detailElements=new Map;measuredDetailHeights=new Map;rowsToAnimate=new Set;loadingDetails=new Set;detailDataMap=new Map;static DEFAULT_DETAIL_HEIGHT=150;getDetailHeight(e){const t=this.detailElements.get(e);if(t){if(!(t.classList.contains("tbw-expanding")||t.classList.contains("tbw-collapsing"))){const i=t.offsetHeight;if(i>0)return this.measuredDetailHeights.set(e,i),i}}const i=this.measuredDetailHeights.get(e);return i&&i>0?i:"number"==typeof this.config?.detailHeight?this.config.detailHeight:r.DEFAULT_DETAIL_HEIGHT}toggleAndEmit(e,t){if(e?.__isGroupRow)return;this.expandedRows=s(this.expandedRows,e);const i=this.expandedRows.has(e);if(i){if(this.rowsToAnimate.add(e),!this.detailDataMap.has(e)){const i=this.grid?.query?.("datasource:is-active",null);i&&(this.loadingDetails.add(e),this.grid.query("datasource:fetch-children",{context:{source:"master-detail",row:e,rowIndex:t}}))}}else this.loadingDetails.delete(e);this.emit("detail-expand",{rowIndex:t,row:e,expanded:i}),this.requestRender()}detach(){this.expandedRows.clear(),this.detailElements.clear(),this.measuredDetailHeights.clear(),this.rowsToAnimate.clear(),this.loadingDetails.clear(),this.detailDataMap.clear()}processColumns(e){if(!(!0===this.config.showExpandColumn||!1!==this.config.showExpandColumn&&!!this.config.detailRenderer))return[...e];const t=[...e];if(n.findExpanderColumn(t))return t;const i=n.createExpanderColumnConfig(this.name);return i.viewRenderer=e=>{const{row:t}=e,i=this.expandedRows.has(t),n=document.createElement("span");n.className="master-detail-expander expander-cell";const s=document.createElement("span");return s.className="master-detail-toggle"+(i?" expanded":""),this.setIcon(s,i?"collapse":"expand"),s.setAttribute("role","button"),s.setAttribute("tabindex","0"),s.setAttribute("aria-expanded",String(i)),s.setAttribute("aria-label",i?"Collapse details":"Expand details"),n.appendChild(s),n},[i,...t]}onRowClick(e){if(this.config.expandOnRowClick&&this.config.detailRenderer)return this.toggleAndEmit(e.row,e.rowIndex),!1}onCellClick(e){const t=e.originalEvent?.target;if(t?.classList.contains("master-detail-toggle"))return this.toggleAndEmit(e.row,e.rowIndex),!0;this.expandedRows.size>0&&queueMicrotask(()=>this.#i())}onKeyDown(e){if(" "!==e.key)return;const t=this.grid._focusCol,i=this.grid._focusRow,s=this.visibleColumns[t];if(!s||!n.isExpanderColumn(s))return;const a=this.rows[i];return a?(e.preventDefault(),this.toggleAndEmit(a,i),this.requestRenderWithFocus(),!0):void 0}afterRender(){this.#n(),this.#i()}#n(){const e=this.gridElement?.querySelector('.header-row .cell[data-field="__tbw_expander"]');if(!e)return;const t=parseInt(e.getAttribute("data-col")||"0",10),i=e.nextElementSibling;i&&(i.style.gridColumn=`${t+1} / ${t+3}`)}onScrollRender(){this.config.detailRenderer&&0!==this.expandedRows.size&&this.#i()}#i(){if(!this.config.detailRenderer)return;const e=this.gridElement?.querySelector(".rows");if(!e)return;const t=this.grid,i=t._rowPool,n=t._virtualization?.start??0,s=t._virtualization?.end??0,r=this.columns.length,o=n,d=s,l=new Map;if(i){const t=Math.min(i.length,d-o);for(let n=0;n<t;n++){const t=i[n];t.parentNode===e&&l.set(o+n,t)}}else{const t=e.querySelectorAll(".data-grid-row");for(const e of t){const t=e.querySelector(".cell[data-row]"),i=t?parseInt(t.getAttribute("data-row")??"-1",10):-1;i>=0&&l.set(i,e)}}for(const[a,c]of this.detailElements){const e=this.rows.indexOf(a),t=this.expandedRows.has(a),i=e>=0&&l.has(e);if(!t||!i){const e=this.#e.__frameworkAdapter;if(e?.unmount){const t=c.querySelector(".master-detail-cell"),i=t?.firstElementChild;i&&e.unmount(i)}c.parentNode&&c.remove(),this.detailElements.delete(a)}}for(const[c,h]of l){const e=this.rows[c];if(!e)continue;const t=this.expandedRows.has(e);if(h.classList.toggle("tbw-row-expanded",t),!t)continue;const i=this.detailElements.get(e);if(i){i.previousElementSibling!==h&&h.after(i);continue}const n=a(e,c,this.config.detailRenderer,r);"number"==typeof this.config.detailHeight&&(n.style.height=`${this.config.detailHeight}px`),h.after(n),this.detailElements.set(e,n);const s=this.rowsToAnimate.has(e);s&&this.rowsToAnimate.delete(e);s&&this.animateExpand(n,e,c)||requestAnimationFrame(()=>{this.#t(n,e,c)})}}getRowHeight(e,t){if(!this.expandedRows.has(e))return;return(this.grid.defaultRowHeight??28)+this.getDetailHeight(e)}adjustVirtualStart(e,t,i){if(0===this.expandedRows.size)return e;const n=this.grid?._virtualization?.positionCache;let s=e;if(n&&n.length>0)for(const a of this.expandedRows){const i=this.rows.indexOf(a);if(i<0||i>=e)continue;n[i].offset+n[i].height>t&&i<s&&(s=i)}else{const n=[];for(const e of this.expandedRows){const t=this.rows.indexOf(e);t>=0&&n.push({index:t,row:e})}n.sort((e,t)=>e.index-t.index);let a=0;for(const{index:r,row:o}of n){const n=r*i+a,d=this.getDetailHeight(o);a+=d,r>=e||n+i+d>t&&r<s&&(s=r)}}return s}expand(e){const t=this.rows[e];t&&!t.__isGroupRow&&(this.rowsToAnimate.add(t),this.expandedRows=function(e,t){return e.add(t),e}(this.expandedRows,t),this.requestRender())}collapse(e){const t=this.rows[e];t&&(this.expandedRows=function(e,t){return e.delete(t),e}(this.expandedRows,t),this.requestRender())}toggle(e){const t=this.rows[e];t&&!t.__isGroupRow&&(this.expandedRows=s(this.expandedRows,t),this.expandedRows.has(t)&&this.rowsToAnimate.add(t),this.requestRender())}isExpanded(e){const t=this.rows[e];return!!t&&function(e,t){return e.has(t)}(this.expandedRows,t)}expandAll(){for(const e of this.rows)e?.__isGroupRow||(this.rowsToAnimate.add(e),this.expandedRows.add(e));this.requestRender()}collapseAll(){this.expandedRows.clear(),this.requestRender()}getExpandedRows(){const e=[];for(const t of this.expandedRows){const i=this.rows.indexOf(t);i>=0&&e.push(i)}return e}getDetailElement(e){const t=this.rows[e];return t?this.detailElements.get(t):void 0}getDetailData(e){const t=this.rows[e];return t?this.detailDataMap.get(t):void 0}isDetailLoading(e){const t=this.rows[e];return!!t&&this.loadingDetails.has(t)}refreshDetailRenderer(){const e=this.config.detailRenderer;if(this.config={...this.config,detailRenderer:void 0},this.parseLightDomDetail(),!this.config.detailRenderer&&e&&(this.config={...this.config,detailRenderer:e}),this.config.detailRenderer){const e=this.#e;"function"==typeof e.refreshColumns?e.refreshColumns():this.requestRender()}}}e.MasterDetailPlugin=r,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
 //# sourceMappingURL=master-detail.umd.js.map

package/umd/plugins/master-detail.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"master-detail.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/master-detail/master-detail.ts","../../../../../libs/grid/src/lib/plugins/master-detail/MasterDetailPlugin.ts"],"sourcesContent":["/**\n * Master/Detail Core Logic\n *\n * Pure functions for managing detail row expansion state.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n// Uses `any` for maximum flexibility with user-defined row types.\n\n/**\n * Toggle the expansion state of a detail row.\n * Mutates the Set in-place and returns it (avoids O(n) copy per toggle).\n */\nexport function toggleDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  if (expandedRows.has(row)) {\n    expandedRows.delete(row);\n  } else {\n    expandedRows.add(row);\n  }\n  return expandedRows;\n}\n\n/**\n * Expand a detail row.\n * Mutates the Set in-place and returns it (avoids O(n) copy).\n */\nexport function expandDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.add(row);\n  return expandedRows;\n}\n\n/**\n * Collapse a detail row.\n * Mutates the Set in-place and returns it (avoids O(n) copy).\n */\nexport function collapseDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.delete(row);\n  return expandedRows;\n}\n\n/**\n * Check if a detail row is expanded.\n */\nexport function isDetailExpanded(expandedRows: Set<object>, row: object): boolean {\n  return expandedRows.has(row);\n}\n\n/**\n * Create a detail element for a given row.\n * The element spans all columns and contains the rendered content.\n */\nexport function createDetailElement(\n  row: any,\n  rowIndex: number,\n  renderer: (row: any, rowIndex: number) => HTMLElement | string,\n  columnCount: number,\n): HTMLElement {\n  const detailRow = document.createElement('div');\n  detailRow.className = 'master-detail-row';\n  detailRow.setAttribute('data-detail-for', String(rowIndex));\n  detailRow.setAttribute('role', 'row');\n\n  const detailCell = document.createElement('div');\n  detailCell.className = 'master-detail-cell';\n  detailCell.setAttribute('role', 'cell');\n  detailCell.style.gridColumn = `1 / ${columnCount + 1}`;\n\n  const content = renderer(row, rowIndex);\n  if (typeof content === 'string') {\n    detailCell.innerHTML = content;\n  } else if (content instanceof HTMLElement) {\n    detailCell.appendChild(content);\n  }\n\n  detailRow.appendChild(detailCell);\n  return detailRow;\n}\n","/**\n * Master/Detail Plugin (Class-based)\n *\n * Enables expandable detail rows showing additional content for each row.\n * Animation style is plugin-configured; respects grid-level animation.mode.\n */\n\nimport { evalTemplateString, sanitizeHTML } from '../../core/internal/sanitize';\nimport { BaseGridPlugin, CellClickEvent, GridElement, RowClickEvent } from '../../core/plugin/base-plugin';\nimport { createExpanderColumnConfig, findExpanderColumn, isExpanderColumn } from '../../core/plugin/expander-column';\nimport type { ColumnConfig, GridHost } from '../../core/types';\nimport type { DataSourceChildrenDetail, FetchChildrenQuery } from '../server-side/datasource-types';\nimport {\n  collapseDetailRow,\n  createDetailElement,\n  expandDetailRow,\n  isDetailExpanded,\n  toggleDetailRow,\n} from './master-detail';\nimport styles from './master-detail.css?inline';\nimport type { DetailExpandDetail, ExpandCollapseAnimation, MasterDetailConfig } from './types';\n\n/**\n * Master-Detail Plugin for tbw-grid\n *\n * Creates expandable detail rows that reveal additional content beneath each master row.\n * Perfect for order/line-item UIs, employee/department views, or any scenario where\n * you need to show related data without navigating away.\n *\n * ## Installation\n *\n * ```ts\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n * ```\n *\n * ## CSS Custom Properties\n *\n * | Property | Default | Description |\n * |----------|---------|-------------|\n * | `--tbw-master-detail-bg` | `var(--tbw-color-row-alt)` | Detail row background |\n * | `--tbw-master-detail-border` | `var(--tbw-color-border)` | Detail row border |\n * | `--tbw-detail-padding` | `1em` | Detail content padding |\n * | `--tbw-animation-duration` | `200ms` | Expand/collapse animation |\n *\n * @example Basic Master-Detail with HTML Template\n * ```ts\n * import '@toolbox-web/grid';\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n *\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'orderId', header: 'Order ID' },\n *     { field: 'customer', header: 'Customer' },\n *     { field: 'total', header: 'Total', type: 'currency' },\n *   ],\n *   plugins: [\n *     new MasterDetailPlugin({\n *       detailRenderer: (row) => `\n *         <div class=\"order-details\">\n *           <h4>Order Items</h4>\n *           <ul>${row.items.map(i => `<li>${i.name} - $${i.price}</li>`).join('')}</ul>\n *         </div>\n *       `,\n *     }),\n *   ],\n * };\n * ```\n *\n * @example Nested Grid in Detail\n * ```ts\n * new MasterDetailPlugin({\n *   detailRenderer: (row) => {\n *     const childGrid = document.createElement('tbw-grid');\n *     childGrid.style.height = '200px';\n *     childGrid.gridConfig = { columns: [...] };\n *     childGrid.rows = row.items || [];\n *     return childGrid;\n *   },\n * })\n * ```\n *\n * @see {@link MasterDetailConfig} for all configuration options\n * @see {@link DetailExpandDetail} for expand/collapse event details\n *\n * @internal Extends BaseGridPlugin\n */\nexport class MasterDetailPlugin extends BaseGridPlugin<MasterDetailConfig> {\n  /** @internal */\n  readonly name = 'masterDetail';\n  /** @internal */\n  override readonly styles = styles;\n\n  /**\n   * Optional dependency on ServerSide for async detail data.\n   * When loaded, MasterDetail can fetch detail data via `datasource:fetch-children`.\n   */\n  static override readonly dependencies = [\n    { name: 'serverSide', required: false, reason: 'Fetches detail data via datasource:fetch-children on expand' },\n  ];\n\n  /** Typed internal grid accessor. */\n  get #internalGrid(): GridHost {\n    return this.grid as unknown as GridHost;\n  }\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<MasterDetailConfig> {\n    return {\n      detailHeight: 'auto',\n      expandOnRowClick: false,\n      collapseOnClickOutside: false,\n      // Note: showExpandColumn is intentionally NOT defaulted here.\n      // If undefined, processColumns() adds expander only when detailRenderer is provided.\n      // Set to true for framework adapters that register renderers asynchronously.\n      animation: 'slide', // Plugin's own default\n    };\n  }\n\n  // #region Light DOM Parsing\n\n  /**\n   * Called when plugin is attached to the grid.\n   * Parses light DOM for `<tbw-grid-detail>` elements to configure detail templates.\n   * @internal\n   */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    this.parseLightDomDetail();\n\n    // Listen for datasource:children — receive async detail data from ServerSide\n    this.on('datasource:children', (detail: unknown) => {\n      const d = detail as DataSourceChildrenDetail;\n      if (d.context?.source !== 'master-detail') return;\n      d.claimed = true;\n\n      const row = d.context.row;\n      if (row && this.expandedRows.has(row)) {\n        this.detailDataMap.set(row, d.rows);\n        this.loadingDetails.delete(row);\n        // Re-render: remove existing detail element so #syncDetailRows recreates it\n        const existingDetail = this.detailElements.get(row);\n        if (existingDetail) {\n          existingDetail.remove();\n          this.detailElements.delete(row);\n          this.measuredDetailHeights.delete(row);\n        }\n        this.requestRender();\n      }\n    });\n  }\n\n  /**\n   * Parse `<tbw-grid-detail>` elements from the grid's light DOM.\n   *\n   * Allows declarative configuration:\n   * ```html\n   * <tbw-grid [rows]=\"data\">\n   *   <tbw-grid-detail>\n   *     <div class=\"detail-content\">\n   *       <p>Name: {{ row.name }}</p>\n   *       <p>Email: {{ row.email }}</p>\n   *     </div>\n   *   </tbw-grid-detail>\n   * </tbw-grid>\n   * ```\n   *\n   * Attributes:\n   * - `animation`: 'slide' | 'fade' | 'false' (default: 'slide')\n   * - `show-expand-column`: 'true' | 'false' (default: 'true')\n   * - `expand-on-row-click`: 'true' | 'false' (default: 'false')\n   * - `collapse-on-click-outside`: 'true' | 'false' (default: 'false')\n   * - `height`: number (pixels) or 'auto' (default: 'auto')\n   */\n  private parseLightDomDetail(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const detailEl = gridEl.querySelector('tbw-grid-detail');\n    if (!detailEl) return;\n\n    // Check if a framework adapter wants to handle this element\n    // (e.g., Angular adapter intercepts for ng-template rendering)\n    const adapter = this.#internalGrid.__frameworkAdapter;\n    if (adapter?.parseDetailElement) {\n      const adapterRenderer = adapter.parseDetailElement(detailEl);\n      if (adapterRenderer) {\n        this.config = { ...this.config, detailRenderer: adapterRenderer };\n        return;\n      }\n    }\n\n    // Parse attributes for configuration\n    const animation = detailEl.getAttribute('animation');\n    const showExpandColumn = detailEl.getAttribute('show-expand-column');\n    const expandOnRowClick = detailEl.getAttribute('expand-on-row-click');\n    const collapseOnClickOutside = detailEl.getAttribute('collapse-on-click-outside');\n    const heightAttr = detailEl.getAttribute('height');\n\n    const configUpdates: Partial<MasterDetailConfig> = {};\n\n    if (animation !== null) {\n      configUpdates.animation = animation === 'false' ? false : (animation as 'slide' | 'fade');\n    }\n    if (showExpandColumn !== null) {\n      configUpdates.showExpandColumn = showExpandColumn !== 'false';\n    }\n    if (expandOnRowClick !== null) {\n      configUpdates.expandOnRowClick = expandOnRowClick === 'true';\n    }\n    if (collapseOnClickOutside !== null) {\n      configUpdates.collapseOnClickOutside = collapseOnClickOutside === 'true';\n    }\n    if (heightAttr !== null) {\n      configUpdates.detailHeight = heightAttr === 'auto' ? 'auto' : parseInt(heightAttr, 10);\n    }\n\n    // Get template content from innerHTML\n    const templateHTML = detailEl.innerHTML.trim();\n    if (templateHTML && !this.config.detailRenderer) {\n      // Create a template-based renderer using the inner HTML\n      configUpdates.detailRenderer = (row: any, _rowIndex: number): string => {\n        // Evaluate template expressions like {{ row.field }}\n        const evaluated = evalTemplateString(templateHTML, { value: row, row });\n        // Sanitize the result to prevent XSS\n        return sanitizeHTML(evaluated);\n      };\n    }\n\n    // Merge updates into config\n    if (Object.keys(configUpdates).length > 0) {\n      this.config = { ...this.config, ...configUpdates };\n    }\n  }\n\n  // #endregion\n\n  // #region Animation Helpers\n\n  /**\n   * Get expand/collapse animation style from plugin config.\n   * Uses base class isAnimationEnabled to respect grid-level settings.\n   */\n  private get animationStyle(): ExpandCollapseAnimation {\n    if (!this.isAnimationEnabled) return false;\n    return this.config.animation ?? 'slide';\n  }\n\n  /**\n   * Apply expand animation to a detail element.\n   * Returns true if animation was applied, false if skipped.\n   * When animated, height measurement is deferred to animationend to avoid\n   * measuring during the max-height: 0 CSS animation constraint.\n   */\n  private animateExpand(detailEl: HTMLElement, row?: any, rowIndex?: number): boolean {\n    if (!this.isAnimationEnabled || this.animationStyle === false) return false;\n\n    detailEl.classList.add('tbw-expanding');\n\n    let measured = false;\n    const measureOnce = () => {\n      if (measured) return;\n      measured = true;\n      detailEl.classList.remove('tbw-expanding');\n\n      // Measure height AFTER animation completes - the element now has its\n      // natural height without the max-height constraint from the animation.\n      if (row !== undefined && rowIndex !== undefined) {\n        this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n      }\n    };\n\n    detailEl.addEventListener('animationend', measureOnce, { once: true });\n    // Fallback timeout in case animationend doesn't fire (e.g., element detached,\n    // animation removed, or framework rendering delays). Matches animateCollapse pattern.\n    setTimeout(measureOnce, this.animationDuration + 50);\n    return true;\n  }\n\n  /**\n   * Apply collapse animation to a detail element and remove after animation.\n   */\n  private animateCollapse(detailEl: HTMLElement, onComplete: () => void): void {\n    if (!this.isAnimationEnabled || this.animationStyle === false) {\n      onComplete();\n      return;\n    }\n\n    detailEl.classList.add('tbw-collapsing');\n    const cleanup = () => {\n      detailEl.classList.remove('tbw-collapsing');\n      onComplete();\n    };\n    detailEl.addEventListener('animationend', cleanup, { once: true });\n    // Fallback timeout in case animation doesn't fire\n    setTimeout(cleanup, this.animationDuration + 50);\n  }\n\n  /**\n   * Measure a detail element's height and update the position cache if it changed.\n   * Used after layout settles (RAF) or after animation completes (animationend).\n   */\n  #measureAndCacheDetailHeight(detailEl: HTMLElement, row: any, rowIndex: number): void {\n    if (!detailEl.isConnected) return;\n\n    const height = detailEl.offsetHeight;\n    if (height > 0) {\n      const previousHeight = this.measuredDetailHeights.get(row);\n      this.measuredDetailHeights.set(row, height);\n\n      // Only invalidate if height actually changed\n      // This triggers an incremental position cache update, not a full rebuild\n      if (previousHeight !== height) {\n        this.grid.invalidateRowHeight(rowIndex);\n      }\n    }\n  }\n\n  // #endregion\n\n  // #region Internal State\n  private expandedRows: Set<any> = new Set();\n  private detailElements: Map<any, HTMLElement> = new Map();\n  /** Cached measured heights - persists even when elements are virtualized out */\n  private measuredDetailHeights: Map<any, number> = new Map();\n  /** Rows that were just expanded by user action and should animate.\n   * Prevents re-animation when rows scroll back into the virtual window. */\n  private rowsToAnimate: Set<any> = new Set();\n  /** Rows currently waiting for datasource:children response. */\n  private loadingDetails: Set<any> = new Set();\n  /** Child rows received via datasource:children, keyed by parent row reference. */\n  private detailDataMap: Map<any, unknown[]> = new Map();\n\n  /** Default height for detail rows when not configured */\n  private static readonly DEFAULT_DETAIL_HEIGHT = 150;\n\n  /**\n   * Get the estimated height for a detail row.\n   * Uses cached measured height when available (survives virtualization).\n   * Avoids reading offsetHeight during CSS animations to prevent poisoning the cache.\n   */\n  private getDetailHeight(row: any): number {\n    // Try DOM element first - works for tests and when element is connected\n    const detailEl = this.detailElements.get(row);\n    if (detailEl) {\n      // Skip DOM measurement if currently animating (max-height constraint gives wrong value)\n      const isAnimating = detailEl.classList.contains('tbw-expanding') || detailEl.classList.contains('tbw-collapsing');\n      if (!isAnimating) {\n        const height = detailEl.offsetHeight;\n        if (height > 0) {\n          // Cache the measurement for when this row is virtualized out\n          this.measuredDetailHeights.set(row, height);\n          return height;\n        }\n      }\n    }\n\n    // DOM element missing, detached, or animating - check cached measurement\n    const cachedHeight = this.measuredDetailHeights.get(row);\n    if (cachedHeight && cachedHeight > 0) {\n      return cachedHeight;\n    }\n\n    // Fallback to config or default\n    return typeof this.config?.detailHeight === 'number'\n      ? this.config.detailHeight\n      : MasterDetailPlugin.DEFAULT_DETAIL_HEIGHT;\n  }\n\n  /**\n   * Toggle a row's detail and emit event.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  private toggleAndEmit(row: any, rowIndex: number): void {\n    // Synthetic rows (e.g., group headers) don't have detail content\n    if (row?.__isGroupRow) return;\n\n    this.expandedRows = toggleDetailRow(this.expandedRows, row as object);\n    const expanded = this.expandedRows.has(row as object);\n    if (expanded) {\n      this.rowsToAnimate.add(row);\n\n      // Request detail data from ServerSide if available and not already cached\n      if (!this.detailDataMap.has(row)) {\n        const isServerSideActive = this.grid?.query?.('datasource:is-active', null);\n        if (isServerSideActive) {\n          this.loadingDetails.add(row);\n          this.grid.query('datasource:fetch-children', {\n            context: { source: 'master-detail', row, rowIndex },\n          } satisfies FetchChildrenQuery);\n        }\n      }\n    } else {\n      this.loadingDetails.delete(row);\n    }\n    this.emit<DetailExpandDetail>('detail-expand', {\n      rowIndex,\n      row: row as Record<string, unknown>,\n      expanded,\n    });\n    this.requestRender();\n  }\n  // #endregion\n\n  // #region Lifecycle\n\n  /** @internal */\n  override detach(): void {\n    this.expandedRows.clear();\n    this.detailElements.clear();\n    this.measuredDetailHeights.clear();\n    this.rowsToAnimate.clear();\n    this.loadingDetails.clear();\n    this.detailDataMap.clear();\n  }\n  // #endregion\n\n  // #region Hooks\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    // Determine whether to add the expander column:\n    // 1. If showExpandColumn === false: never add (explicit opt-out)\n    // 2. If showExpandColumn === true: always add (explicit opt-in, for framework adapters)\n    // 3. If showExpandColumn is undefined: add only if detailRenderer is provided\n    //\n    // This supports React/Angular adapters which register renderers asynchronously via light DOM.\n    // They must set showExpandColumn: true to get the column immediately, avoiding layout shift.\n    const shouldAddExpander =\n      this.config.showExpandColumn === true || (this.config.showExpandColumn !== false && !!this.config.detailRenderer);\n\n    if (!shouldAddExpander) {\n      return [...columns];\n    }\n\n    const cols = [...columns];\n\n    // Check if expander column already exists (from this or another plugin)\n    const existingExpander = findExpanderColumn(cols);\n    if (existingExpander) {\n      // Another plugin already added an expander column - don't add duplicate\n      // Our expand logic will be handled via onCellClick on the expander column\n      return cols;\n    }\n\n    // Create dedicated expander column that stays fixed at position 0\n    const expanderCol = createExpanderColumnConfig(this.name);\n    expanderCol.viewRenderer = (renderCtx) => {\n      const { row } = renderCtx;\n      const isExpanded = this.expandedRows.has(row as object);\n\n      const container = document.createElement('span');\n      container.className = 'master-detail-expander expander-cell';\n\n      // Expand/collapse toggle icon\n      const toggle = document.createElement('span');\n      toggle.className = `master-detail-toggle${isExpanded ? ' expanded' : ''}`;\n      // Use grid-level icons (fall back to defaults)\n      this.setIcon(toggle, isExpanded ? 'collapse' : 'expand');\n      // role=\"button\" is required for aria-expanded to be valid\n      toggle.setAttribute('role', 'button');\n      toggle.setAttribute('tabindex', '0');\n      toggle.setAttribute('aria-expanded', String(isExpanded));\n      toggle.setAttribute('aria-label', isExpanded ? 'Collapse details' : 'Expand details');\n      container.appendChild(toggle);\n\n      return container;\n    };\n\n    // Prepend expander column to ensure it's always first\n    return [expanderCol, ...cols];\n  }\n\n  /** @internal */\n  override onRowClick(event: RowClickEvent): boolean | void {\n    if (!this.config.expandOnRowClick || !this.config.detailRenderer) return;\n    this.toggleAndEmit(event.row, event.rowIndex);\n    return false;\n  }\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean | void {\n    // Handle click on master-detail toggle icon (same pattern as TreePlugin)\n    const target = event.originalEvent?.target as HTMLElement;\n    if (target?.classList.contains('master-detail-toggle')) {\n      this.toggleAndEmit(event.row, event.rowIndex);\n      return true; // Prevent default handling\n    }\n\n    // Sync detail rows after cell click triggers refreshVirtualWindow\n    // This runs in microtask to ensure DOM updates are complete\n    if (this.expandedRows.size > 0) {\n      queueMicrotask(() => this.#syncDetailRows());\n    }\n    return; // Don't prevent default\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    // SPACE toggles expansion when focus is on the expander column\n    if (event.key !== ' ') return;\n\n    const focusCol = this.grid._focusCol;\n    const focusRow = this.grid._focusRow;\n    // _focusCol is a visible-column index (set from data-col), so use visibleColumns\n    const column = this.visibleColumns[focusCol];\n\n    // Only handle SPACE on expander column\n    if (!column || !isExpanderColumn(column)) return;\n\n    const row = this.rows[focusRow];\n    if (!row) return;\n\n    event.preventDefault();\n    this.toggleAndEmit(row, focusRow);\n\n    // Restore focus styling after render completes via render pipeline\n    this.requestRenderWithFocus();\n    return true;\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    this.#fixExpanderHeaderSpan();\n    this.#syncDetailRows();\n  }\n\n  /**\n   * The expander header cell is hidden (display:none), so the next sibling\n   * header cell must span two CSS grid tracks (the expander's + its own)\n   * to keep the header aligned with data rows.  The column position is\n   * computed dynamically so that pinned columns can appear before the expander.\n   */\n  #fixExpanderHeaderSpan(): void {\n    const expanderHeader = this.gridElement?.querySelector(\n      '.header-row .cell[data-field=\"__tbw_expander\"]',\n    ) as HTMLElement | null;\n    if (!expanderHeader) return;\n\n    const colIdx = parseInt(expanderHeader.getAttribute('data-col') || '0', 10);\n    const nextCell = expanderHeader.nextElementSibling as HTMLElement | null;\n    if (nextCell) {\n      // CSS grid columns are 1-based; span from the expander's track to the next cell's track.\n      nextCell.style.gridColumn = `${colIdx + 1} / ${colIdx + 3}`;\n    }\n  }\n\n  /**\n   * Called on scroll to sync detail elements with visible rows.\n   * Removes details for rows that scrolled out of view and reattaches for visible rows.\n   * @internal\n   */\n  override onScrollRender(): void {\n    if (!this.config.detailRenderer || this.expandedRows.size === 0) return;\n    // Full sync needed on scroll to clean up orphaned details\n    this.#syncDetailRows();\n  }\n\n  /**\n   * Full sync of detail rows - cleans up stale elements and creates new ones.\n   * Detail rows are inserted as siblings AFTER their master row to survive row rebuilds.\n   *\n   * PERF: Uses the grid's row pool (_rowPool) and virtual window (_virtualization.start/end)\n   * to avoid querySelectorAll on every scroll frame. The pool is index-aligned with the\n   * virtual window, so pool[i] corresponds to row index (start + i).\n   */\n  #syncDetailRows(): void {\n    if (!this.config.detailRenderer) return;\n\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    // Use grid's virtualization state and row pool for O(1) lookups instead of querySelectorAll.\n    // The row pool is an array of DOM elements aligned to the virtual window:\n    // _rowPool[i] renders row data at index (_virtualization.start + i).\n    const gridInternal = this.grid as any;\n    const rowPool: HTMLElement[] | undefined = gridInternal._rowPool;\n    const vStart: number = gridInternal._virtualization?.start ?? 0;\n    const vEnd: number = gridInternal._virtualization?.end ?? 0;\n    const columnCount = this.columns.length;\n\n    // Build visible row index set from the virtual window range\n    const visibleStart = vStart;\n    const visibleEnd = vEnd;\n\n    // Build a map of row index -> row element using the pool (O(n) where n = visible rows)\n    const visibleRowMap = new Map<number, Element>();\n    if (rowPool) {\n      const poolLen = Math.min(rowPool.length, visibleEnd - visibleStart);\n      for (let i = 0; i < poolLen; i++) {\n        const rowEl = rowPool[i];\n        if (rowEl.parentNode === body) {\n          visibleRowMap.set(visibleStart + i, rowEl);\n        }\n      }\n    } else {\n      // Fallback: use querySelectorAll if pool is not accessible\n      const dataRows = body.querySelectorAll('.data-grid-row');\n      for (const rowEl of dataRows) {\n        const firstCell = rowEl.querySelector('.cell[data-row]');\n        const rowIndex = firstCell ? parseInt(firstCell.getAttribute('data-row') ?? '-1', 10) : -1;\n        if (rowIndex >= 0) {\n          visibleRowMap.set(rowIndex, rowEl);\n        }\n      }\n    }\n\n    // Remove detail rows whose parent row is no longer visible or no longer expanded.\n    // Iterate the detailElements map (which we own) instead of querySelectorAll.\n    for (const [row, detailEl] of this.detailElements) {\n      const rowIndex = this.rows.indexOf(row);\n      const isStillExpanded = this.expandedRows.has(row);\n      const isRowVisible = rowIndex >= 0 && visibleRowMap.has(rowIndex);\n\n      if (!isStillExpanded || !isRowVisible) {\n        // Clean up framework adapter resources (React root, Vue app, Angular view)\n        // before removing to prevent memory leaks.\n        const adapter = this.#internalGrid.__frameworkAdapter;\n        if (adapter?.unmount) {\n          const detailCell = detailEl.querySelector('.master-detail-cell');\n          const container = detailCell?.firstElementChild as HTMLElement | null;\n          if (container) adapter.unmount(container);\n        }\n        if (detailEl.parentNode) detailEl.remove();\n        this.detailElements.delete(row);\n      }\n    }\n\n    // Insert detail rows for expanded rows that are visible\n    for (const [rowIndex, rowEl] of visibleRowMap) {\n      const row = this.rows[rowIndex];\n      if (!row || !this.expandedRows.has(row)) continue;\n\n      // Check if detail already exists for this row\n      const existingDetail = this.detailElements.get(row);\n      if (existingDetail) {\n        // Ensure it's positioned correctly (as next sibling of row element)\n        if (existingDetail.previousElementSibling !== rowEl) {\n          rowEl.after(existingDetail);\n        }\n        continue;\n      }\n\n      // Create new detail element\n      const detailEl = createDetailElement(row, rowIndex, this.config.detailRenderer, columnCount);\n\n      if (typeof this.config.detailHeight === 'number') {\n        detailEl.style.height = `${this.config.detailHeight}px`;\n      }\n\n      // Insert as sibling after the row element (not as child)\n      rowEl.after(detailEl);\n      this.detailElements.set(row, detailEl);\n\n      // Only animate if this row was just expanded by a user action (click, keyboard, API).\n      // Rows re-appearing from scroll (virtualization) should not re-animate.\n      const shouldAnimate = this.rowsToAnimate.has(row);\n      if (shouldAnimate) {\n        this.rowsToAnimate.delete(row);\n      }\n\n      const willAnimate = shouldAnimate && this.animateExpand(detailEl, row, rowIndex);\n\n      if (!willAnimate) {\n        // No animation - measure height after layout settles via RAF\n        requestAnimationFrame(() => {\n          this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n        });\n      }\n      // When animating, measurement is deferred to animationend callback\n      // (inside animateExpand) to avoid measuring during max-height: 0 constraint\n    }\n  }\n\n  /**\n   * Get the height of a specific row, including any expanded detail content.\n   * Always returns a height to ensure the position cache uses plugin-controlled values\n   * rather than stale DOM measurements.\n   *\n   * @param row - The row data\n   * @param _index - The row index (unused, but part of the interface)\n   * @returns The row height in pixels (base height for collapsed, base + detail for expanded)\n   */\n  override getRowHeight(row: unknown, _index: number): number | undefined {\n    const isExpanded = this.expandedRows.has(row as object);\n\n    if (!isExpanded) {\n      // Collapsed row - return undefined to let the grid use its measured/estimated height.\n      // This ensures the position cache uses the correct row height from CSS/config.\n      return undefined;\n    }\n\n    // Row is expanded - return base height plus detail height\n    // Use grid's defaultRowHeight which reflects the actual measured/configured height\n    const baseHeight = this.grid.defaultRowHeight ?? 28;\n    const detailHeight = this.getDetailHeight(row);\n\n    return baseHeight + detailHeight;\n  }\n\n  /**\n   * Adjust the virtualization start index to keep expanded row visible while its detail is visible.\n   * This ensures the detail scrolls smoothly out of view instead of disappearing abruptly.\n   */\n  override adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n    if (this.expandedRows.size === 0) return start;\n\n    // Use position cache for accurate row positions when available (variable heights mode)\n    const positionCache = (this.grid as any)?._virtualization?.positionCache as\n      | Array<{ offset: number; height: number }>\n      | undefined;\n\n    let minStart = start;\n\n    if (positionCache && positionCache.length > 0) {\n      // Variable heights: use position cache for accurate offset\n      for (const row of this.expandedRows) {\n        const rowIndex = this.rows.indexOf(row);\n        if (rowIndex < 0 || rowIndex >= start) continue;\n\n        // Position cache already includes cumulative heights from all expanded details\n        const detailBottom = positionCache[rowIndex].offset + positionCache[rowIndex].height;\n\n        if (detailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    } else {\n      // Fixed heights fallback: accumulate detail heights manually\n      // Build sorted list of expanded row indices for cumulative height calculation\n      const expandedIndices: Array<{ index: number; row: any }> = [];\n      for (const row of this.expandedRows) {\n        const index = this.rows.indexOf(row);\n        if (index >= 0) {\n          expandedIndices.push({ index, row });\n        }\n      }\n      expandedIndices.sort((a, b) => a.index - b.index);\n\n      let cumulativeExtraHeight = 0;\n\n      for (const { index: rowIndex, row } of expandedIndices) {\n        const actualRowTop = rowIndex * rowHeight + cumulativeExtraHeight;\n        const detailHeight = this.getDetailHeight(row);\n        const actualDetailBottom = actualRowTop + rowHeight + detailHeight;\n\n        cumulativeExtraHeight += detailHeight;\n\n        if (rowIndex >= start) continue;\n\n        if (actualDetailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    }\n\n    return minStart;\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Expand the detail row at the given index.\n   * @param rowIndex - Index of the row to expand\n   */\n  expand(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.rowsToAnimate.add(row);\n      this.expandedRows = expandDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Collapse the detail row at the given index.\n   * @param rowIndex - Index of the row to collapse\n   */\n  collapse(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row) {\n      this.expandedRows = collapseDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Toggle the detail row at the given index.\n   * @param rowIndex - Index of the row to toggle\n   */\n  toggle(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.expandedRows = toggleDetailRow(this.expandedRows, row);\n      if (this.expandedRows.has(row)) {\n        this.rowsToAnimate.add(row);\n      }\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Check if the detail row at the given index is expanded.\n   * @param rowIndex - Index of the row to check\n   * @returns Whether the detail row is expanded\n   */\n  isExpanded(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? isDetailExpanded(this.expandedRows, row) : false;\n  }\n\n  /**\n   * Expand all detail rows.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  expandAll(): void {\n    for (const row of this.rows) {\n      if (row?.__isGroupRow) continue;\n      this.rowsToAnimate.add(row);\n      this.expandedRows.add(row);\n    }\n    this.requestRender();\n  }\n\n  /**\n   * Collapse all detail rows.\n   */\n  collapseAll(): void {\n    this.expandedRows.clear();\n    this.requestRender();\n  }\n\n  /**\n   * Get the indices of all expanded rows.\n   * @returns Array of row indices that are expanded\n   */\n  getExpandedRows(): number[] {\n    const indices: number[] = [];\n    for (const row of this.expandedRows) {\n      const idx = this.rows.indexOf(row);\n      if (idx >= 0) indices.push(idx);\n    }\n    return indices;\n  }\n\n  /**\n   * Get the detail element for a specific row.\n   * @param rowIndex - Index of the row\n   * @returns The detail HTMLElement or undefined\n   */\n  getDetailElement(rowIndex: number): HTMLElement | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailElements.get(row) : undefined;\n  }\n\n  /**\n   * Get async detail data fetched via `ServerSidePlugin` for a specific row.\n   *\n   * Returns the child rows received from `datasource:children` after a\n   * `datasource:fetch-children` query was fired on expand. Returns `undefined`\n   * when ServerSide is not loaded or data has not arrived yet.\n   *\n   * @param rowIndex - Index of the row\n   * @returns Array of child rows or undefined\n   */\n  getDetailData(rowIndex: number): unknown[] | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailDataMap.get(row) : undefined;\n  }\n\n  /**\n   * Check if detail data is currently being loaded for a row.\n   * @param rowIndex - Index of the row\n   * @returns Whether the detail is loading\n   */\n  isDetailLoading(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? this.loadingDetails.has(row) : false;\n  }\n\n  /**\n   * Re-parse light DOM to refresh the detail renderer.\n   * Call this after framework templates are registered (e.g., Angular ngAfterContentInit).\n   *\n   * This allows frameworks to register templates asynchronously and then\n   * update the plugin's detailRenderer.\n   */\n  refreshDetailRenderer(): void {\n    // Force re-parse by temporarily clearing the renderer\n    const currentRenderer = this.config.detailRenderer;\n    this.config = { ...this.config, detailRenderer: undefined };\n    this.parseLightDomDetail();\n\n    // If no new renderer was found, restore the original\n    if (!this.config.detailRenderer && currentRenderer) {\n      this.config = { ...this.config, detailRenderer: currentRenderer };\n    }\n\n    // Request a COLUMNS phase re-render so processColumns runs again with the new detailRenderer\n    // This ensures the expand toggle is added to the first column.\n    // Must use refreshColumns() (COLUMNS phase) not requestRender() (ROWS phase)\n    // because processColumns only runs at COLUMNS phase or higher.\n    if (this.config.detailRenderer) {\n      const grid = this.#internalGrid;\n      if (typeof grid.refreshColumns === 'function') {\n        grid.refreshColumns();\n      } else {\n        // Fallback to requestRender if refreshColumns not available\n        this.requestRender();\n      }\n    }\n  }\n  // #endregion\n}\n"],"names":["toggleDetailRow","expandedRows","row","has","delete","add","createDetailElement","rowIndex","renderer","columnCount","detailRow","document","createElement","className","setAttribute","String","detailCell","style","gridColumn","content","innerHTML","HTMLElement","appendChild","MasterDetailPlugin","BaseGridPlugin","name","styles","static","required","reason","internalGrid","this","grid","defaultConfig","detailHeight","expandOnRowClick","collapseOnClickOutside","animation","attach","super","parseLightDomDetail","on","detail","d","context","source","claimed","detailDataMap","set","rows","loadingDetails","existingDetail","detailElements","get","remove","measuredDetailHeights","requestRender","gridEl","gridElement","detailEl","querySelector","adapter","__frameworkAdapter","parseDetailElement","adapterRenderer","config","detailRenderer","getAttribute","showExpandColumn","heightAttr","configUpdates","parseInt","templateHTML","trim","_rowIndex","evaluated","evalTemplateString","value","sanitizeHTML","Object","keys","length","animationStyle","isAnimationEnabled","animateExpand","classList","measured","measureOnce","measureAndCacheDetailHeight","addEventListener","once","setTimeout","animationDuration","animateCollapse","onComplete","cleanup","isConnected","height","offsetHeight","previousHeight","invalidateRowHeight","Set","Map","rowsToAnimate","getDetailHeight","contains","cachedHeight","DEFAULT_DETAIL_HEIGHT","toggleAndEmit","__isGroupRow","expanded","isServerSideActive","query","emit","detach","clear","processColumns","columns","cols","findExpanderColumn","expanderCol","createExpanderColumnConfig","viewRenderer","renderCtx","isExpanded","container","toggle","setIcon","onRowClick","event","onCellClick","target","originalEvent","size","queueMicrotask","syncDetailRows","onKeyDown","key","focusCol","_focusCol","focusRow","_focusRow","column","visibleColumns","isExpanderColumn","preventDefault","requestRenderWithFocus","afterRender","fixExpanderHeaderSpan","expanderHeader","colIdx","nextCell","nextElementSibling","onScrollRender","body","gridInternal","rowPool","_rowPool","vStart","_virtualization","start","vEnd","end","visibleStart","visibleEnd","visibleRowMap","poolLen","Math","min","i","rowEl","parentNode","dataRows","querySelectorAll","firstCell","indexOf","isStillExpanded","isRowVisible","unmount","firstElementChild","previousElementSibling","after","shouldAnimate","requestAnimationFrame","getRowHeight","_index","defaultRowHeight","adjustVirtualStart","scrollTop","rowHeight","positionCache","minStart","offset","expandedIndices","index","push","sort","a","b","cumulativeExtraHeight","actualRowTop","expand","expandDetailRow","collapse","collapseDetailRow","isDetailExpanded","expandAll","collapseAll","getExpandedRows","indices","idx","getDetailElement","getDetailData","isDetailLoading","refreshDetailRenderer","currentRenderer","refreshColumns"],"mappings":"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"}
+{"version":3,"file":"master-detail.umd.js","sources":["../../../../../libs/grid/src/lib/plugins/master-detail/master-detail.ts","../../../../../libs/grid/src/lib/plugins/master-detail/MasterDetailPlugin.ts"],"sourcesContent":["/**\n * Master/Detail Core Logic\n *\n * Pure functions for managing detail row expansion state.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n// Uses `any` for maximum flexibility with user-defined row types.\n\n/**\n * Toggle the expansion state of a detail row.\n * Mutates the Set in-place and returns it (avoids O(n) copy per toggle).\n */\nexport function toggleDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  if (expandedRows.has(row)) {\n    expandedRows.delete(row);\n  } else {\n    expandedRows.add(row);\n  }\n  return expandedRows;\n}\n\n/**\n * Expand a detail row.\n * Mutates the Set in-place and returns it (avoids O(n) copy).\n */\nexport function expandDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.add(row);\n  return expandedRows;\n}\n\n/**\n * Collapse a detail row.\n * Mutates the Set in-place and returns it (avoids O(n) copy).\n */\nexport function collapseDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.delete(row);\n  return expandedRows;\n}\n\n/**\n * Check if a detail row is expanded.\n */\nexport function isDetailExpanded(expandedRows: Set<object>, row: object): boolean {\n  return expandedRows.has(row);\n}\n\n/**\n * Create a detail element for a given row.\n * The element spans all columns and contains the rendered content.\n */\nexport function createDetailElement(\n  row: any,\n  rowIndex: number,\n  renderer: (row: any, rowIndex: number) => HTMLElement | string,\n  columnCount: number,\n): HTMLElement {\n  const detailRow = document.createElement('div');\n  detailRow.className = 'master-detail-row';\n  detailRow.setAttribute('data-detail-for', String(rowIndex));\n  detailRow.setAttribute('role', 'row');\n\n  const detailCell = document.createElement('div');\n  detailCell.className = 'master-detail-cell';\n  detailCell.setAttribute('role', 'cell');\n  detailCell.style.gridColumn = `1 / ${columnCount + 1}`;\n\n  const content = renderer(row, rowIndex);\n  if (typeof content === 'string') {\n    detailCell.innerHTML = content;\n  } else if (content instanceof HTMLElement) {\n    detailCell.appendChild(content);\n  }\n\n  detailRow.appendChild(detailCell);\n  return detailRow;\n}\n","/**\n * Master/Detail Plugin (Class-based)\n *\n * Enables expandable detail rows showing additional content for each row.\n * Animation style is plugin-configured; respects grid-level animation.mode.\n */\n\nimport { evalTemplateString, sanitizeHTML } from '../../core/internal/sanitize';\nimport { BaseGridPlugin, CellClickEvent, GridElement, RowClickEvent } from '../../core/plugin/base-plugin';\nimport { createExpanderColumnConfig, findExpanderColumn, isExpanderColumn } from '../../core/plugin/expander-column';\nimport type { ColumnConfig, GridHost } from '../../core/types';\nimport type { DataSourceChildrenDetail, FetchChildrenQuery } from '../server-side/datasource-types';\nimport {\n  collapseDetailRow,\n  createDetailElement,\n  expandDetailRow,\n  isDetailExpanded,\n  toggleDetailRow,\n} from './master-detail';\nimport styles from './master-detail.css?inline';\nimport type { DetailExpandDetail, ExpandCollapseAnimation, MasterDetailConfig } from './types';\n\n/**\n * Master-Detail Plugin for tbw-grid\n *\n * Creates expandable detail rows that reveal additional content beneath each master row.\n * Perfect for order/line-item UIs, employee/department views, or any scenario where\n * you need to show related data without navigating away.\n *\n * ## Installation\n *\n * ```ts\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n * ```\n *\n * ## CSS Custom Properties\n *\n * | Property | Default | Description |\n * |----------|---------|-------------|\n * | `--tbw-master-detail-bg` | `var(--tbw-color-row-alt)` | Detail row background |\n * | `--tbw-master-detail-border` | `var(--tbw-color-border)` | Detail row border |\n * | `--tbw-detail-padding` | `1em` | Detail content padding |\n * | `--tbw-animation-duration` | `200ms` | Expand/collapse animation |\n *\n * @example Basic Master-Detail with HTML Template\n * ```ts\n * import '@toolbox-web/grid';\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n *\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'orderId', header: 'Order ID' },\n *     { field: 'customer', header: 'Customer' },\n *     { field: 'total', header: 'Total', type: 'currency' },\n *   ],\n *   plugins: [\n *     new MasterDetailPlugin({\n *       detailRenderer: (row) => `\n *         <div class=\"order-details\">\n *           <h4>Order Items</h4>\n *           <ul>${row.items.map(i => `<li>${i.name} - $${i.price}</li>`).join('')}</ul>\n *         </div>\n *       `,\n *     }),\n *   ],\n * };\n * ```\n *\n * @example Nested Grid in Detail\n * ```ts\n * new MasterDetailPlugin({\n *   detailRenderer: (row) => {\n *     const childGrid = document.createElement('tbw-grid');\n *     childGrid.style.height = '200px';\n *     childGrid.gridConfig = { columns: [...] };\n *     childGrid.rows = row.items || [];\n *     return childGrid;\n *   },\n * })\n * ```\n *\n * @see {@link MasterDetailConfig} for all configuration options\n * @see {@link DetailExpandDetail} for expand/collapse event details\n *\n * @internal Extends BaseGridPlugin\n */\nexport class MasterDetailPlugin extends BaseGridPlugin<MasterDetailConfig> {\n  /** @internal */\n  readonly name = 'masterDetail';\n  /** @internal */\n  override readonly styles = styles;\n\n  /**\n   * Optional dependency on ServerSide for async detail data.\n   * When loaded, MasterDetail can fetch detail data via `datasource:fetch-children`.\n   */\n  static override readonly dependencies = [\n    { name: 'serverSide', required: false, reason: 'Fetches detail data via datasource:fetch-children on expand' },\n  ];\n\n  /** Typed internal grid accessor. */\n  get #internalGrid(): GridHost {\n    return this.grid as unknown as GridHost;\n  }\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<MasterDetailConfig> {\n    return {\n      detailHeight: 'auto',\n      expandOnRowClick: false,\n      collapseOnClickOutside: false,\n      // Note: showExpandColumn is intentionally NOT defaulted here.\n      // If undefined, processColumns() adds expander only when detailRenderer is provided.\n      // Set to true for framework adapters that register renderers asynchronously.\n      animation: 'slide', // Plugin's own default\n    };\n  }\n\n  // #region Light DOM Parsing\n\n  /**\n   * Called when plugin is attached to the grid.\n   * Parses light DOM for `<tbw-grid-detail>` elements to configure detail templates.\n   * @internal\n   */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    this.parseLightDomDetail();\n\n    // Listen for datasource:children — receive async detail data from ServerSide\n    this.on('datasource:children', (detail: unknown) => {\n      const d = detail as DataSourceChildrenDetail;\n      if (d.context?.source !== 'master-detail') return;\n      d.claimed = true;\n\n      const row = d.context.row;\n      if (row && this.expandedRows.has(row)) {\n        this.detailDataMap.set(row, d.rows);\n        this.loadingDetails.delete(row);\n        // Re-render: remove existing detail element so #syncDetailRows recreates it\n        const existingDetail = this.detailElements.get(row);\n        if (existingDetail) {\n          existingDetail.remove();\n          this.detailElements.delete(row);\n          this.measuredDetailHeights.delete(row);\n        }\n        this.requestRender();\n      }\n    });\n  }\n\n  /**\n   * Parse `<tbw-grid-detail>` elements from the grid's light DOM.\n   *\n   * Allows declarative configuration:\n   * ```html\n   * <tbw-grid [rows]=\"data\">\n   *   <tbw-grid-detail>\n   *     <div class=\"detail-content\">\n   *       <p>Name: {{ row.name }}</p>\n   *       <p>Email: {{ row.email }}</p>\n   *     </div>\n   *   </tbw-grid-detail>\n   * </tbw-grid>\n   * ```\n   *\n   * Attributes:\n   * - `animation`: 'slide' | 'fade' | 'false' (default: 'slide')\n   * - `show-expand-column`: 'true' | 'false' (default: 'true')\n   * - `expand-on-row-click`: 'true' | 'false' (default: 'false')\n   * - `collapse-on-click-outside`: 'true' | 'false' (default: 'false')\n   * - `height`: number (pixels) or 'auto' (default: 'auto')\n   */\n  private parseLightDomDetail(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const detailEl = gridEl.querySelector('tbw-grid-detail');\n    if (!detailEl) return;\n\n    // Check if a framework adapter wants to handle this element\n    // (e.g., Angular adapter intercepts for ng-template rendering)\n    const adapter = this.#internalGrid.__frameworkAdapter;\n    if (adapter?.parseDetailElement) {\n      const adapterRenderer = adapter.parseDetailElement(detailEl);\n      if (adapterRenderer) {\n        this.config = { ...this.config, detailRenderer: adapterRenderer };\n        return;\n      }\n    }\n\n    // Parse attributes for configuration\n    const animation = detailEl.getAttribute('animation');\n    const showExpandColumn = detailEl.getAttribute('show-expand-column');\n    const expandOnRowClick = detailEl.getAttribute('expand-on-row-click');\n    const collapseOnClickOutside = detailEl.getAttribute('collapse-on-click-outside');\n    const heightAttr = detailEl.getAttribute('height');\n\n    const configUpdates: Partial<MasterDetailConfig> = {};\n\n    if (animation !== null) {\n      configUpdates.animation = animation === 'false' ? false : (animation as 'slide' | 'fade');\n    }\n    if (showExpandColumn !== null) {\n      configUpdates.showExpandColumn = showExpandColumn !== 'false';\n    }\n    if (expandOnRowClick !== null) {\n      configUpdates.expandOnRowClick = expandOnRowClick === 'true';\n    }\n    if (collapseOnClickOutside !== null) {\n      configUpdates.collapseOnClickOutside = collapseOnClickOutside === 'true';\n    }\n    if (heightAttr !== null) {\n      configUpdates.detailHeight = heightAttr === 'auto' ? 'auto' : parseInt(heightAttr, 10);\n    }\n\n    // Get template content from innerHTML\n    const templateHTML = detailEl.innerHTML.trim();\n    if (templateHTML && !this.config.detailRenderer) {\n      // Create a template-based renderer using the inner HTML\n      configUpdates.detailRenderer = (row: any, _rowIndex: number): string => {\n        // Evaluate template expressions like {{ row.field }}\n        const evaluated = evalTemplateString(templateHTML, { value: row, row });\n        // Sanitize the result to prevent XSS\n        return sanitizeHTML(evaluated);\n      };\n    }\n\n    // Merge updates into config\n    if (Object.keys(configUpdates).length > 0) {\n      this.config = { ...this.config, ...configUpdates };\n    }\n  }\n\n  // #endregion\n\n  // #region Animation Helpers\n\n  /**\n   * Get expand/collapse animation style from plugin config.\n   * Uses base class isAnimationEnabled to respect grid-level settings.\n   */\n  private get animationStyle(): ExpandCollapseAnimation {\n    if (!this.isAnimationEnabled) return false;\n    return this.config.animation ?? 'slide';\n  }\n\n  /**\n   * Apply expand animation to a detail element.\n   * Returns true if animation was applied, false if skipped.\n   * When animated, height measurement is deferred to animationend to avoid\n   * measuring during the max-height: 0 CSS animation constraint.\n   */\n  private animateExpand(detailEl: HTMLElement, row?: any, rowIndex?: number): boolean {\n    if (!this.isAnimationEnabled || this.animationStyle === false) return false;\n\n    detailEl.classList.add('tbw-expanding');\n\n    let measured = false;\n    const measureOnce = () => {\n      if (measured) return;\n      measured = true;\n      detailEl.classList.remove('tbw-expanding');\n\n      // Measure height AFTER animation completes - the element now has its\n      // natural height without the max-height constraint from the animation.\n      if (row !== undefined && rowIndex !== undefined) {\n        this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n      }\n    };\n\n    detailEl.addEventListener('animationend', measureOnce, { once: true });\n    // Fallback timeout in case animationend doesn't fire (e.g., element detached,\n    // animation removed, or framework rendering delays). Matches animateCollapse pattern.\n    setTimeout(measureOnce, this.animationDuration + 50);\n    return true;\n  }\n\n  /**\n   * Apply collapse animation to a detail element and remove after animation.\n   */\n  private animateCollapse(detailEl: HTMLElement, onComplete: () => void): void {\n    if (!this.isAnimationEnabled || this.animationStyle === false) {\n      onComplete();\n      return;\n    }\n\n    detailEl.classList.add('tbw-collapsing');\n    const cleanup = () => {\n      detailEl.classList.remove('tbw-collapsing');\n      onComplete();\n    };\n    detailEl.addEventListener('animationend', cleanup, { once: true });\n    // Fallback timeout in case animation doesn't fire\n    setTimeout(cleanup, this.animationDuration + 50);\n  }\n\n  /**\n   * Measure a detail element's height and update the position cache if it changed.\n   * Used after layout settles (RAF) or after animation completes (animationend).\n   */\n  #measureAndCacheDetailHeight(detailEl: HTMLElement, row: any, rowIndex: number): void {\n    if (!detailEl.isConnected) return;\n\n    const height = detailEl.offsetHeight;\n    if (height > 0) {\n      const previousHeight = this.measuredDetailHeights.get(row);\n      this.measuredDetailHeights.set(row, height);\n\n      // Only invalidate if height actually changed\n      // This triggers an incremental position cache update, not a full rebuild\n      if (previousHeight !== height) {\n        this.grid.invalidateRowHeight(rowIndex);\n      }\n    }\n  }\n\n  // #endregion\n\n  // #region Internal State\n  private expandedRows: Set<any> = new Set();\n  private detailElements: Map<any, HTMLElement> = new Map();\n  /** Cached measured heights - persists even when elements are virtualized out */\n  private measuredDetailHeights: Map<any, number> = new Map();\n  /** Rows that were just expanded by user action and should animate.\n   * Prevents re-animation when rows scroll back into the virtual window. */\n  private rowsToAnimate: Set<any> = new Set();\n  /** Rows currently waiting for datasource:children response. */\n  private loadingDetails: Set<any> = new Set();\n  /** Child rows received via datasource:children, keyed by parent row reference. */\n  private detailDataMap: Map<any, unknown[]> = new Map();\n\n  /** Default height for detail rows when not configured */\n  private static readonly DEFAULT_DETAIL_HEIGHT = 150;\n\n  /**\n   * Get the estimated height for a detail row.\n   * Uses cached measured height when available (survives virtualization).\n   * Avoids reading offsetHeight during CSS animations to prevent poisoning the cache.\n   */\n  private getDetailHeight(row: any): number {\n    // Try DOM element first - works for tests and when element is connected\n    const detailEl = this.detailElements.get(row);\n    if (detailEl) {\n      // Skip DOM measurement if currently animating (max-height constraint gives wrong value)\n      const isAnimating = detailEl.classList.contains('tbw-expanding') || detailEl.classList.contains('tbw-collapsing');\n      if (!isAnimating) {\n        const height = detailEl.offsetHeight;\n        if (height > 0) {\n          // Cache the measurement for when this row is virtualized out\n          this.measuredDetailHeights.set(row, height);\n          return height;\n        }\n      }\n    }\n\n    // DOM element missing, detached, or animating - check cached measurement\n    const cachedHeight = this.measuredDetailHeights.get(row);\n    if (cachedHeight && cachedHeight > 0) {\n      return cachedHeight;\n    }\n\n    // Fallback to config or default\n    return typeof this.config?.detailHeight === 'number'\n      ? this.config.detailHeight\n      : MasterDetailPlugin.DEFAULT_DETAIL_HEIGHT;\n  }\n\n  /**\n   * Toggle a row's detail and emit event.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  private toggleAndEmit(row: any, rowIndex: number): void {\n    // Synthetic rows (e.g., group headers) don't have detail content\n    if (row?.__isGroupRow) return;\n\n    this.expandedRows = toggleDetailRow(this.expandedRows, row as object);\n    const expanded = this.expandedRows.has(row as object);\n    if (expanded) {\n      this.rowsToAnimate.add(row);\n\n      // Request detail data from ServerSide if available and not already cached\n      if (!this.detailDataMap.has(row)) {\n        const isServerSideActive = this.grid?.query?.('datasource:is-active', null);\n        if (isServerSideActive) {\n          this.loadingDetails.add(row);\n          this.grid.query('datasource:fetch-children', {\n            context: { source: 'master-detail', row, rowIndex },\n          } satisfies FetchChildrenQuery);\n        }\n      }\n    } else {\n      this.loadingDetails.delete(row);\n    }\n    this.emit<DetailExpandDetail>('detail-expand', {\n      rowIndex,\n      row: row as Record<string, unknown>,\n      expanded,\n    });\n    this.requestRender();\n  }\n  // #endregion\n\n  // #region Lifecycle\n\n  /** @internal */\n  override detach(): void {\n    this.expandedRows.clear();\n    this.detailElements.clear();\n    this.measuredDetailHeights.clear();\n    this.rowsToAnimate.clear();\n    this.loadingDetails.clear();\n    this.detailDataMap.clear();\n  }\n  // #endregion\n\n  // #region Hooks\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    // Determine whether to add the expander column:\n    // 1. If showExpandColumn === false: never add (explicit opt-out)\n    // 2. If showExpandColumn === true: always add (explicit opt-in, for framework adapters)\n    // 3. If showExpandColumn is undefined: add only if detailRenderer is provided\n    //\n    // This supports React/Angular adapters which register renderers asynchronously via light DOM.\n    // They must set showExpandColumn: true to get the column immediately, avoiding layout shift.\n    const shouldAddExpander =\n      this.config.showExpandColumn === true || (this.config.showExpandColumn !== false && !!this.config.detailRenderer);\n\n    if (!shouldAddExpander) {\n      return [...columns];\n    }\n\n    const cols = [...columns];\n\n    // Check if expander column already exists (from this or another plugin)\n    const existingExpander = findExpanderColumn(cols);\n    if (existingExpander) {\n      // Another plugin already added an expander column - don't add duplicate\n      // Our expand logic will be handled via onCellClick on the expander column\n      return cols;\n    }\n\n    // Create dedicated expander column that stays fixed at position 0\n    const expanderCol = createExpanderColumnConfig(this.name);\n    expanderCol.viewRenderer = (renderCtx) => {\n      const { row } = renderCtx;\n      const isExpanded = this.expandedRows.has(row as object);\n\n      const container = document.createElement('span');\n      container.className = 'master-detail-expander expander-cell';\n\n      // Expand/collapse toggle icon\n      const toggle = document.createElement('span');\n      toggle.className = `master-detail-toggle${isExpanded ? ' expanded' : ''}`;\n      // Use grid-level icons (fall back to defaults)\n      this.setIcon(toggle, isExpanded ? 'collapse' : 'expand');\n      // role=\"button\" is required for aria-expanded to be valid\n      toggle.setAttribute('role', 'button');\n      toggle.setAttribute('tabindex', '0');\n      toggle.setAttribute('aria-expanded', String(isExpanded));\n      toggle.setAttribute('aria-label', isExpanded ? 'Collapse details' : 'Expand details');\n      container.appendChild(toggle);\n\n      return container;\n    };\n\n    // Prepend expander column to ensure it's always first\n    return [expanderCol, ...cols];\n  }\n\n  /** @internal */\n  override onRowClick(event: RowClickEvent): boolean | void {\n    if (!this.config.expandOnRowClick || !this.config.detailRenderer) return;\n    this.toggleAndEmit(event.row, event.rowIndex);\n    return false;\n  }\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean | void {\n    // Handle click on master-detail toggle icon (same pattern as TreePlugin)\n    const target = event.originalEvent?.target as HTMLElement;\n    if (target?.classList.contains('master-detail-toggle')) {\n      this.toggleAndEmit(event.row, event.rowIndex);\n      return true; // Prevent default handling\n    }\n\n    // Sync detail rows after cell click triggers refreshVirtualWindow\n    // This runs in microtask to ensure DOM updates are complete\n    if (this.expandedRows.size > 0) {\n      queueMicrotask(() => this.#syncDetailRows());\n    }\n    return; // Don't prevent default\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    // SPACE toggles expansion when focus is on the expander column\n    if (event.key !== ' ') return;\n\n    const focusCol = this.grid._focusCol;\n    const focusRow = this.grid._focusRow;\n    // _focusCol is a visible-column index (set from data-col), so use visibleColumns\n    const column = this.visibleColumns[focusCol];\n\n    // Only handle SPACE on expander column\n    if (!column || !isExpanderColumn(column)) return;\n\n    const row = this.rows[focusRow];\n    if (!row) return;\n\n    event.preventDefault();\n    this.toggleAndEmit(row, focusRow);\n\n    // Restore focus styling after render completes via render pipeline\n    this.requestRenderWithFocus();\n    return true;\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    this.#fixExpanderHeaderSpan();\n    this.#syncDetailRows();\n  }\n\n  /**\n   * The expander header cell is hidden (display:none), so the next sibling\n   * header cell must span two CSS grid tracks (the expander's + its own)\n   * to keep the header aligned with data rows.  The column position is\n   * computed dynamically so that pinned columns can appear before the expander.\n   */\n  #fixExpanderHeaderSpan(): void {\n    const expanderHeader = this.gridElement?.querySelector(\n      '.header-row .cell[data-field=\"__tbw_expander\"]',\n    ) as HTMLElement | null;\n    if (!expanderHeader) return;\n\n    const colIdx = parseInt(expanderHeader.getAttribute('data-col') || '0', 10);\n    const nextCell = expanderHeader.nextElementSibling as HTMLElement | null;\n    if (nextCell) {\n      // CSS grid columns are 1-based; span from the expander's track to the next cell's track.\n      nextCell.style.gridColumn = `${colIdx + 1} / ${colIdx + 3}`;\n    }\n  }\n\n  /**\n   * Called on scroll to sync detail elements with visible rows.\n   * Removes details for rows that scrolled out of view and reattaches for visible rows.\n   * @internal\n   */\n  override onScrollRender(): void {\n    if (!this.config.detailRenderer || this.expandedRows.size === 0) return;\n    // Full sync needed on scroll to clean up orphaned details\n    this.#syncDetailRows();\n  }\n\n  /**\n   * Full sync of detail rows - cleans up stale elements and creates new ones.\n   * Detail rows are inserted as siblings AFTER their master row to survive row rebuilds.\n   *\n   * PERF: Uses the grid's row pool (_rowPool) and virtual window (_virtualization.start/end)\n   * to avoid querySelectorAll on every scroll frame. The pool is index-aligned with the\n   * virtual window, so pool[i] corresponds to row index (start + i).\n   */\n  #syncDetailRows(): void {\n    if (!this.config.detailRenderer) return;\n\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    // Use grid's virtualization state and row pool for O(1) lookups instead of querySelectorAll.\n    // The row pool is an array of DOM elements aligned to the virtual window:\n    // _rowPool[i] renders row data at index (_virtualization.start + i).\n    const gridInternal = this.grid as any;\n    const rowPool: HTMLElement[] | undefined = gridInternal._rowPool;\n    const vStart: number = gridInternal._virtualization?.start ?? 0;\n    const vEnd: number = gridInternal._virtualization?.end ?? 0;\n    const columnCount = this.columns.length;\n\n    // Build visible row index set from the virtual window range\n    const visibleStart = vStart;\n    const visibleEnd = vEnd;\n\n    // Build a map of row index -> row element using the pool (O(n) where n = visible rows)\n    const visibleRowMap = new Map<number, Element>();\n    if (rowPool) {\n      const poolLen = Math.min(rowPool.length, visibleEnd - visibleStart);\n      for (let i = 0; i < poolLen; i++) {\n        const rowEl = rowPool[i];\n        if (rowEl.parentNode === body) {\n          visibleRowMap.set(visibleStart + i, rowEl);\n        }\n      }\n    } else {\n      // Fallback: use querySelectorAll if pool is not accessible\n      const dataRows = body.querySelectorAll('.data-grid-row');\n      for (const rowEl of dataRows) {\n        const firstCell = rowEl.querySelector('.cell[data-row]');\n        const rowIndex = firstCell ? parseInt(firstCell.getAttribute('data-row') ?? '-1', 10) : -1;\n        if (rowIndex >= 0) {\n          visibleRowMap.set(rowIndex, rowEl);\n        }\n      }\n    }\n\n    // Remove detail rows whose parent row is no longer visible or no longer expanded.\n    // Iterate the detailElements map (which we own) instead of querySelectorAll.\n    for (const [row, detailEl] of this.detailElements) {\n      const rowIndex = this.rows.indexOf(row);\n      const isStillExpanded = this.expandedRows.has(row);\n      const isRowVisible = rowIndex >= 0 && visibleRowMap.has(rowIndex);\n\n      if (!isStillExpanded || !isRowVisible) {\n        // Clean up framework adapter resources (React root, Vue app, Angular view)\n        // before removing to prevent memory leaks.\n        const adapter = this.#internalGrid.__frameworkAdapter;\n        if (adapter?.unmount) {\n          const detailCell = detailEl.querySelector('.master-detail-cell');\n          const container = detailCell?.firstElementChild as HTMLElement | null;\n          if (container) adapter.unmount(container);\n        }\n        if (detailEl.parentNode) detailEl.remove();\n        this.detailElements.delete(row);\n      }\n    }\n\n    // Insert detail rows for expanded rows that are visible. We also toggle\n    // `.tbw-row-expanded` on every visible master row (matches Tree /\n    // GroupingRows) so devs can style expanded rows via CSS instead of\n    // depending on `[aria-expanded=\"true\"]` (which lives on the toggle\n    // button, not the row). MUST clear on the negative branch \\u2014 the row\n    // pool recycles elements as the virtual window slides.\n    for (const [rowIndex, rowEl] of visibleRowMap) {\n      const row = this.rows[rowIndex];\n      if (!row) continue;\n      const isExpanded = this.expandedRows.has(row);\n      rowEl.classList.toggle('tbw-row-expanded', isExpanded);\n      if (!isExpanded) continue;\n\n      // Check if detail already exists for this row\n      const existingDetail = this.detailElements.get(row);\n      if (existingDetail) {\n        // Ensure it's positioned correctly (as next sibling of row element)\n        if (existingDetail.previousElementSibling !== rowEl) {\n          rowEl.after(existingDetail);\n        }\n        continue;\n      }\n\n      // Create new detail element\n      const detailEl = createDetailElement(row, rowIndex, this.config.detailRenderer, columnCount);\n\n      if (typeof this.config.detailHeight === 'number') {\n        detailEl.style.height = `${this.config.detailHeight}px`;\n      }\n\n      // Insert as sibling after the row element (not as child)\n      rowEl.after(detailEl);\n      this.detailElements.set(row, detailEl);\n\n      // Only animate if this row was just expanded by a user action (click, keyboard, API).\n      // Rows re-appearing from scroll (virtualization) should not re-animate.\n      const shouldAnimate = this.rowsToAnimate.has(row);\n      if (shouldAnimate) {\n        this.rowsToAnimate.delete(row);\n      }\n\n      const willAnimate = shouldAnimate && this.animateExpand(detailEl, row, rowIndex);\n\n      if (!willAnimate) {\n        // No animation - measure height after layout settles via RAF\n        requestAnimationFrame(() => {\n          this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n        });\n      }\n      // When animating, measurement is deferred to animationend callback\n      // (inside animateExpand) to avoid measuring during max-height: 0 constraint\n    }\n  }\n\n  /**\n   * Get the height of a specific row, including any expanded detail content.\n   * Always returns a height to ensure the position cache uses plugin-controlled values\n   * rather than stale DOM measurements.\n   *\n   * @param row - The row data\n   * @param _index - The row index (unused, but part of the interface)\n   * @returns The row height in pixels (base height for collapsed, base + detail for expanded)\n   */\n  override getRowHeight(row: unknown, _index: number): number | undefined {\n    const isExpanded = this.expandedRows.has(row as object);\n\n    if (!isExpanded) {\n      // Collapsed row - return undefined to let the grid use its measured/estimated height.\n      // This ensures the position cache uses the correct row height from CSS/config.\n      return undefined;\n    }\n\n    // Row is expanded - return base height plus detail height\n    // Use grid's defaultRowHeight which reflects the actual measured/configured height\n    const baseHeight = this.grid.defaultRowHeight ?? 28;\n    const detailHeight = this.getDetailHeight(row);\n\n    return baseHeight + detailHeight;\n  }\n\n  /**\n   * Adjust the virtualization start index to keep expanded row visible while its detail is visible.\n   * This ensures the detail scrolls smoothly out of view instead of disappearing abruptly.\n   */\n  override adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n    if (this.expandedRows.size === 0) return start;\n\n    // Use position cache for accurate row positions when available (variable heights mode)\n    const positionCache = (this.grid as any)?._virtualization?.positionCache as\n      | Array<{ offset: number; height: number }>\n      | undefined;\n\n    let minStart = start;\n\n    if (positionCache && positionCache.length > 0) {\n      // Variable heights: use position cache for accurate offset\n      for (const row of this.expandedRows) {\n        const rowIndex = this.rows.indexOf(row);\n        if (rowIndex < 0 || rowIndex >= start) continue;\n\n        // Position cache already includes cumulative heights from all expanded details\n        const detailBottom = positionCache[rowIndex].offset + positionCache[rowIndex].height;\n\n        if (detailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    } else {\n      // Fixed heights fallback: accumulate detail heights manually\n      // Build sorted list of expanded row indices for cumulative height calculation\n      const expandedIndices: Array<{ index: number; row: any }> = [];\n      for (const row of this.expandedRows) {\n        const index = this.rows.indexOf(row);\n        if (index >= 0) {\n          expandedIndices.push({ index, row });\n        }\n      }\n      expandedIndices.sort((a, b) => a.index - b.index);\n\n      let cumulativeExtraHeight = 0;\n\n      for (const { index: rowIndex, row } of expandedIndices) {\n        const actualRowTop = rowIndex * rowHeight + cumulativeExtraHeight;\n        const detailHeight = this.getDetailHeight(row);\n        const actualDetailBottom = actualRowTop + rowHeight + detailHeight;\n\n        cumulativeExtraHeight += detailHeight;\n\n        if (rowIndex >= start) continue;\n\n        if (actualDetailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    }\n\n    return minStart;\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Expand the detail row at the given index.\n   * @param rowIndex - Index of the row to expand\n   */\n  expand(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.rowsToAnimate.add(row);\n      this.expandedRows = expandDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Collapse the detail row at the given index.\n   * @param rowIndex - Index of the row to collapse\n   */\n  collapse(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row) {\n      this.expandedRows = collapseDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Toggle the detail row at the given index.\n   * @param rowIndex - Index of the row to toggle\n   */\n  toggle(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.expandedRows = toggleDetailRow(this.expandedRows, row);\n      if (this.expandedRows.has(row)) {\n        this.rowsToAnimate.add(row);\n      }\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Check if the detail row at the given index is expanded.\n   * @param rowIndex - Index of the row to check\n   * @returns Whether the detail row is expanded\n   */\n  isExpanded(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? isDetailExpanded(this.expandedRows, row) : false;\n  }\n\n  /**\n   * Expand all detail rows.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  expandAll(): void {\n    for (const row of this.rows) {\n      if (row?.__isGroupRow) continue;\n      this.rowsToAnimate.add(row);\n      this.expandedRows.add(row);\n    }\n    this.requestRender();\n  }\n\n  /**\n   * Collapse all detail rows.\n   */\n  collapseAll(): void {\n    this.expandedRows.clear();\n    this.requestRender();\n  }\n\n  /**\n   * Get the indices of all expanded rows.\n   * @returns Array of row indices that are expanded\n   */\n  getExpandedRows(): number[] {\n    const indices: number[] = [];\n    for (const row of this.expandedRows) {\n      const idx = this.rows.indexOf(row);\n      if (idx >= 0) indices.push(idx);\n    }\n    return indices;\n  }\n\n  /**\n   * Get the detail element for a specific row.\n   * @param rowIndex - Index of the row\n   * @returns The detail HTMLElement or undefined\n   */\n  getDetailElement(rowIndex: number): HTMLElement | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailElements.get(row) : undefined;\n  }\n\n  /**\n   * Get async detail data fetched via `ServerSidePlugin` for a specific row.\n   *\n   * Returns the child rows received from `datasource:children` after a\n   * `datasource:fetch-children` query was fired on expand. Returns `undefined`\n   * when ServerSide is not loaded or data has not arrived yet.\n   *\n   * @param rowIndex - Index of the row\n   * @returns Array of child rows or undefined\n   */\n  getDetailData(rowIndex: number): unknown[] | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailDataMap.get(row) : undefined;\n  }\n\n  /**\n   * Check if detail data is currently being loaded for a row.\n   * @param rowIndex - Index of the row\n   * @returns Whether the detail is loading\n   */\n  isDetailLoading(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? this.loadingDetails.has(row) : false;\n  }\n\n  /**\n   * Re-parse light DOM to refresh the detail renderer.\n   * Call this after framework templates are registered (e.g., Angular ngAfterContentInit).\n   *\n   * This allows frameworks to register templates asynchronously and then\n   * update the plugin's detailRenderer.\n   */\n  refreshDetailRenderer(): void {\n    // Force re-parse by temporarily clearing the renderer\n    const currentRenderer = this.config.detailRenderer;\n    this.config = { ...this.config, detailRenderer: undefined };\n    this.parseLightDomDetail();\n\n    // If no new renderer was found, restore the original\n    if (!this.config.detailRenderer && currentRenderer) {\n      this.config = { ...this.config, detailRenderer: currentRenderer };\n    }\n\n    // Request a COLUMNS phase re-render so processColumns runs again with the new detailRenderer\n    // This ensures the expand toggle is added to the first column.\n    // Must use refreshColumns() (COLUMNS phase) not requestRender() (ROWS phase)\n    // because processColumns only runs at COLUMNS phase or higher.\n    if (this.config.detailRenderer) {\n      const grid = this.#internalGrid;\n      if (typeof grid.refreshColumns === 'function') {\n        grid.refreshColumns();\n      } else {\n        // Fallback to requestRender if refreshColumns not available\n        this.requestRender();\n      }\n    }\n  }\n  // #endregion\n}\n"],"names":["toggleDetailRow","expandedRows","row","has","delete","add","createDetailElement","rowIndex","renderer","columnCount","detailRow","document","createElement","className","setAttribute","String","detailCell","style","gridColumn","content","innerHTML","HTMLElement","appendChild","MasterDetailPlugin","BaseGridPlugin","name","styles","static","required","reason","internalGrid","this","grid","defaultConfig","detailHeight","expandOnRowClick","collapseOnClickOutside","animation","attach","super","parseLightDomDetail","on","detail","d","context","source","claimed","detailDataMap","set","rows","loadingDetails","existingDetail","detailElements","get","remove","measuredDetailHeights","requestRender","gridEl","gridElement","detailEl","querySelector","adapter","__frameworkAdapter","parseDetailElement","adapterRenderer","config","detailRenderer","getAttribute","showExpandColumn","heightAttr","configUpdates","parseInt","templateHTML","trim","_rowIndex","evaluated","evalTemplateString","value","sanitizeHTML","Object","keys","length","animationStyle","isAnimationEnabled","animateExpand","classList","measured","measureOnce","measureAndCacheDetailHeight","addEventListener","once","setTimeout","animationDuration","animateCollapse","onComplete","cleanup","isConnected","height","offsetHeight","previousHeight","invalidateRowHeight","Set","Map","rowsToAnimate","getDetailHeight","contains","cachedHeight","DEFAULT_DETAIL_HEIGHT","toggleAndEmit","__isGroupRow","expanded","isServerSideActive","query","emit","detach","clear","processColumns","columns","cols","findExpanderColumn","expanderCol","createExpanderColumnConfig","viewRenderer","renderCtx","isExpanded","container","toggle","setIcon","onRowClick","event","onCellClick","target","originalEvent","size","queueMicrotask","syncDetailRows","onKeyDown","key","focusCol","_focusCol","focusRow","_focusRow","column","visibleColumns","isExpanderColumn","preventDefault","requestRenderWithFocus","afterRender","fixExpanderHeaderSpan","expanderHeader","colIdx","nextCell","nextElementSibling","onScrollRender","body","gridInternal","rowPool","_rowPool","vStart","_virtualization","start","vEnd","end","visibleStart","visibleEnd","visibleRowMap","poolLen","Math","min","i","rowEl","parentNode","dataRows","querySelectorAll","firstCell","indexOf","isStillExpanded","isRowVisible","unmount","firstElementChild","previousElementSibling","after","shouldAnimate","requestAnimationFrame","getRowHeight","_index","defaultRowHeight","adjustVirtualStart","scrollTop","rowHeight","positionCache","minStart","offset","expandedIndices","index","push","sort","a","b","cumulativeExtraHeight","actualRowTop","expand","expandDetailRow","collapse","collapseDetailRow","isDetailExpanded","expandAll","collapseAll","getExpandedRows","indices","idx","getDetailElement","getDetailData","isDetailLoading","refreshDetailRenderer","currentRenderer","refreshColumns"],"mappings":"sgBAaO,SAASA,EAAgBC,EAA2BC,GAMzD,OALID,EAAaE,IAAID,GACnBD,EAAaG,OAAOF,GAEpBD,EAAaI,IAAIH,GAEZD,CACT,CA+BO,SAASK,EACdJ,EACAK,EACAC,EACAC,GAEA,MAAMC,EAAYC,SAASC,cAAc,OACzCF,EAAUG,UAAY,oBACtBH,EAAUI,aAAa,kBAAmBC,OAAOR,IACjDG,EAAUI,aAAa,OAAQ,OAE/B,MAAME,EAAaL,SAASC,cAAc,OAC1CI,EAAWH,UAAY,qBACvBG,EAAWF,aAAa,OAAQ,QAChCE,EAAWC,MAAMC,WAAa,OAAOT,EAAc,IAEnD,MAAMU,EAAUX,EAASN,EAAKK,GAQ9B,MAPuB,iBAAZY,EACTH,EAAWI,UAAYD,EACdA,aAAmBE,aAC5BL,EAAWM,YAAYH,GAGzBT,EAAUY,YAAYN,GACfN,CACT,CCUO,MAAMa,UAA2BC,EAAAA,eAE7BC,KAAO,eAEEC,0jDAMlBC,oBAAwC,CACtC,CAAEF,KAAM,aAAcG,UAAU,EAAOC,OAAQ,gEAIjD,KAAIC,GACF,OAAOC,KAAKC,IACd,CAGA,iBAAuBC,GACrB,MAAO,CACLC,aAAc,OACdC,kBAAkB,EAClBC,wBAAwB,EAIxBC,UAAW,QAEf,CASS,MAAAC,CAAON,GACdO,MAAMD,OAAON,GACbD,KAAKS,sBAGLT,KAAKU,GAAG,sBAAwBC,IAC9B,MAAMC,EAAID,EACV,GAA0B,kBAAtBC,EAAEC,SAASC,OAA4B,OAC3CF,EAAEG,SAAU,EAEZ,MAAM5C,EAAMyC,EAAEC,QAAQ1C,IACtB,GAAIA,GAAO6B,KAAK9B,aAAaE,IAAID,GAAM,CACrC6B,KAAKgB,cAAcC,IAAI9C,EAAKyC,EAAEM,MAC9BlB,KAAKmB,eAAe9C,OAAOF,GAE3B,MAAMiD,EAAiBpB,KAAKqB,eAAeC,IAAInD,GAC3CiD,IACFA,EAAeG,SACfvB,KAAKqB,eAAehD,OAAOF,GAC3B6B,KAAKwB,sBAAsBnD,OAAOF,IAEpC6B,KAAKyB,eACP,GAEJ,CAwBQ,mBAAAhB,GACN,MAAMiB,EAAS1B,KAAK2B,YACpB,IAAKD,EAAQ,OAEb,MAAME,EAAWF,EAAOG,cAAc,mBACtC,IAAKD,EAAU,OAIf,MAAME,EAAU9B,MAAKD,EAAcgC,mBACnC,GAAID,GAASE,mBAAoB,CAC/B,MAAMC,EAAkBH,EAAQE,mBAAmBJ,GACnD,GAAIK,EAEF,YADAjC,KAAKkC,OAAS,IAAKlC,KAAKkC,OAAQC,eAAgBF,GAGpD,CAGA,MAAM3B,EAAYsB,EAASQ,aAAa,aAClCC,EAAmBT,EAASQ,aAAa,sBACzChC,EAAmBwB,EAASQ,aAAa,uBACzC/B,EAAyBuB,EAASQ,aAAa,6BAC/CE,EAAaV,EAASQ,aAAa,UAEnCG,EAA6C,CAAA,EAEjC,OAAdjC,IACFiC,EAAcjC,UAA0B,UAAdA,GAAiCA,GAEpC,OAArB+B,IACFE,EAAcF,iBAAwC,UAArBA,GAEV,OAArBjC,IACFmC,EAAcnC,iBAAwC,SAArBA,GAEJ,OAA3BC,IACFkC,EAAclC,uBAAoD,SAA3BA,GAEtB,OAAfiC,IACFC,EAAcpC,aAA8B,SAAfmC,EAAwB,OAASE,SAASF,EAAY,KAIrF,MAAMG,EAAeb,EAASvC,UAAUqD,OACpCD,IAAiBzC,KAAKkC,OAAOC,iBAE/BI,EAAcJ,eAAiB,CAAChE,EAAUwE,KAExC,MAAMC,EAAYC,EAAAA,mBAAmBJ,EAAc,CAAEK,MAAO3E,EAAKA,QAEjE,OAAO4E,EAAAA,aAAaH,KAKpBI,OAAOC,KAAKV,GAAeW,OAAS,IACtClD,KAAKkC,OAAS,IAAKlC,KAAKkC,UAAWK,GAEvC,CAUA,kBAAYY,GACV,QAAKnD,KAAKoD,qBACHpD,KAAKkC,OAAO5B,WAAa,QAClC,CAQQ,aAAA+C,CAAczB,EAAuBzD,EAAWK,GACtD,IAAKwB,KAAKoD,qBAA8C,IAAxBpD,KAAKmD,eAA0B,OAAO,EAEtEvB,EAAS0B,UAAUhF,IAAI,iBAEvB,IAAIiF,GAAW,EACf,MAAMC,EAAc,KACdD,IACJA,GAAW,EACX3B,EAAS0B,UAAU/B,OAAO,sBAId,IAARpD,QAAkC,IAAbK,GACvBwB,MAAKyD,EAA6B7B,EAAUzD,EAAKK,KAQrD,OAJAoD,EAAS8B,iBAAiB,eAAgBF,EAAa,CAAEG,MAAM,IAG/DC,WAAWJ,EAAaxD,KAAK6D,kBAAoB,KAC1C,CACT,CAKQ,eAAAC,CAAgBlC,EAAuBmC,GAC7C,IAAK/D,KAAKoD,qBAA8C,IAAxBpD,KAAKmD,eAEnC,YADAY,IAIFnC,EAAS0B,UAAUhF,IAAI,kBACvB,MAAM0F,EAAU,KACdpC,EAAS0B,UAAU/B,OAAO,kBAC1BwC,KAEFnC,EAAS8B,iBAAiB,eAAgBM,EAAS,CAAEL,MAAM,IAE3DC,WAAWI,EAAShE,KAAK6D,kBAAoB,GAC/C,CAMA,EAAAJ,CAA6B7B,EAAuBzD,EAAUK,GAC5D,IAAKoD,EAASqC,YAAa,OAE3B,MAAMC,EAAStC,EAASuC,aACxB,GAAID,EAAS,EAAG,CACd,MAAME,EAAiBpE,KAAKwB,sBAAsBF,IAAInD,GACtD6B,KAAKwB,sBAAsBP,IAAI9C,EAAK+F,GAIhCE,IAAmBF,GACrBlE,KAAKC,KAAKoE,oBAAoB7F,EAElC,CACF,CAKQN,iBAA6BoG,IAC7BjD,mBAA4CkD,IAE5C/C,0BAA8C+C,IAG9CC,kBAA8BF,IAE9BnD,mBAA+BmD,IAE/BtD,kBAAyCuD,IAGjD3E,6BAAgD,IAOxC,eAAA6E,CAAgBtG,GAEtB,MAAMyD,EAAW5B,KAAKqB,eAAeC,IAAInD,GACzC,GAAIyD,EAAU,CAGZ,KADoBA,EAAS0B,UAAUoB,SAAS,kBAAoB9C,EAAS0B,UAAUoB,SAAS,mBAC9E,CAChB,MAAMR,EAAStC,EAASuC,aACxB,GAAID,EAAS,EAGX,OADAlE,KAAKwB,sBAAsBP,IAAI9C,EAAK+F,GAC7BA,CAEX,CACF,CAGA,MAAMS,EAAe3E,KAAKwB,sBAAsBF,IAAInD,GACpD,OAAIwG,GAAgBA,EAAe,EAC1BA,EAImC,iBAA9B3E,KAAKkC,QAAQ/B,aACvBH,KAAKkC,OAAO/B,aACZX,EAAmBoF,qBACzB,CAMQ,aAAAC,CAAc1G,EAAUK,GAE9B,GAAIL,GAAK2G,aAAc,OAEvB9E,KAAK9B,aAAeD,EAAgB+B,KAAK9B,aAAcC,GACvD,MAAM4G,EAAW/E,KAAK9B,aAAaE,IAAID,GACvC,GAAI4G,GAIF,GAHA/E,KAAKwE,cAAclG,IAAIH,IAGlB6B,KAAKgB,cAAc5C,IAAID,GAAM,CAChC,MAAM6G,EAAqBhF,KAAKC,MAAMgF,QAAQ,uBAAwB,MAClED,IACFhF,KAAKmB,eAAe7C,IAAIH,GACxB6B,KAAKC,KAAKgF,MAAM,4BAA6B,CAC3CpE,QAAS,CAAEC,OAAQ,gBAAiB3C,MAAKK,cAG/C,OAEAwB,KAAKmB,eAAe9C,OAAOF,GAE7B6B,KAAKkF,KAAyB,gBAAiB,CAC7C1G,WACAL,MACA4G,aAEF/E,KAAKyB,eACP,CAMS,MAAA0D,GACPnF,KAAK9B,aAAakH,QAClBpF,KAAKqB,eAAe+D,QACpBpF,KAAKwB,sBAAsB4D,QAC3BpF,KAAKwE,cAAcY,QACnBpF,KAAKmB,eAAeiE,QACpBpF,KAAKgB,cAAcoE,OACrB,CAMS,cAAAC,CAAeC,GAWtB,MAFmC,IAAjCtF,KAAKkC,OAAOG,mBAA+D,IAAjCrC,KAAKkC,OAAOG,oBAAgCrC,KAAKkC,OAAOC,gBAGlG,MAAO,IAAImD,GAGb,MAAMC,EAAO,IAAID,GAIjB,GADyBE,EAAAA,mBAAmBD,GAI1C,OAAOA,EAIT,MAAME,EAAcC,EAAAA,2BAA2B1F,KAAKN,MAwBpD,OAvBA+F,EAAYE,aAAgBC,IAC1B,MAAMzH,IAAEA,GAAQyH,EACVC,EAAa7F,KAAK9B,aAAaE,IAAID,GAEnC2H,EAAYlH,SAASC,cAAc,QACzCiH,EAAUhH,UAAY,uCAGtB,MAAMiH,EAASnH,SAASC,cAAc,QAWtC,OAVAkH,EAAOjH,UAAY,wBAAuB+G,EAAa,YAAc,IAErE7F,KAAKgG,QAAQD,EAAQF,EAAa,WAAa,UAE/CE,EAAOhH,aAAa,OAAQ,UAC5BgH,EAAOhH,aAAa,WAAY,KAChCgH,EAAOhH,aAAa,gBAAiBC,OAAO6G,IAC5CE,EAAOhH,aAAa,aAAc8G,EAAa,mBAAqB,kBACpEC,EAAUvG,YAAYwG,GAEfD,GAIF,CAACL,KAAgBF,EAC1B,CAGS,UAAAU,CAAWC,GAClB,GAAKlG,KAAKkC,OAAO9B,kBAAqBJ,KAAKkC,OAAOC,eAElD,OADAnC,KAAK6E,cAAcqB,EAAM/H,IAAK+H,EAAM1H,WAC7B,CACT,CAGS,WAAA2H,CAAYD,GAEnB,MAAME,EAASF,EAAMG,eAAeD,OACpC,GAAIA,GAAQ9C,UAAUoB,SAAS,wBAE7B,OADA1E,KAAK6E,cAAcqB,EAAM/H,IAAK+H,EAAM1H,WAC7B,EAKLwB,KAAK9B,aAAaoI,KAAO,GAC3BC,eAAe,IAAMvG,MAAKwG,IAG9B,CAGS,SAAAC,CAAUP,GAEjB,GAAkB,MAAdA,EAAMQ,IAAa,OAEvB,MAAMC,EAAW3G,KAAKC,KAAK2G,UACrBC,EAAW7G,KAAKC,KAAK6G,UAErBC,EAAS/G,KAAKgH,eAAeL,GAGnC,IAAKI,IAAWE,EAAAA,iBAAiBF,GAAS,OAE1C,MAAM5I,EAAM6B,KAAKkB,KAAK2F,GACtB,OAAK1I,GAEL+H,EAAMgB,iBACNlH,KAAK6E,cAAc1G,EAAK0I,GAGxB7G,KAAKmH,0BACE,QAPP,CAQF,CAGS,WAAAC,GACPpH,MAAKqH,IACLrH,MAAKwG,GACP,CAQA,EAAAa,GACE,MAAMC,EAAiBtH,KAAK2B,aAAaE,cACvC,kDAEF,IAAKyF,EAAgB,OAErB,MAAMC,EAAS/E,SAAS8E,EAAelF,aAAa,aAAe,IAAK,IAClEoF,EAAWF,EAAeG,mBAC5BD,IAEFA,EAAStI,MAAMC,WAAa,GAAGoI,EAAS,OAAOA,EAAS,IAE5D,CAOS,cAAAG,GACF1H,KAAKkC,OAAOC,gBAA6C,IAA3BnC,KAAK9B,aAAaoI,MAErDtG,MAAKwG,GACP,CAUA,EAAAA,GACE,IAAKxG,KAAKkC,OAAOC,eAAgB,OAEjC,MAAMwF,EAAO3H,KAAK2B,aAAaE,cAAc,SAC7C,IAAK8F,EAAM,OAKX,MAAMC,EAAe5H,KAAKC,KACpB4H,EAAqCD,EAAaE,SAClDC,EAAiBH,EAAaI,iBAAiBC,OAAS,EACxDC,EAAeN,EAAaI,iBAAiBG,KAAO,EACpDzJ,EAAcsB,KAAKsF,QAAQpC,OAG3BkF,EAAeL,EACfM,EAAaH,EAGbI,MAAoB/D,IAC1B,GAAIsD,EAAS,CACX,MAAMU,EAAUC,KAAKC,IAAIZ,EAAQ3E,OAAQmF,EAAaD,GACtD,IAAA,IAASM,EAAI,EAAGA,EAAIH,EAASG,IAAK,CAChC,MAAMC,EAAQd,EAAQa,GAClBC,EAAMC,aAAejB,GACvBW,EAAcrH,IAAImH,EAAeM,EAAGC,EAExC,CACF,KAAO,CAEL,MAAME,EAAWlB,EAAKmB,iBAAiB,kBACvC,IAAA,MAAWH,KAASE,EAAU,CAC5B,MAAME,EAAYJ,EAAM9G,cAAc,mBAChCrD,EAAWuK,EAAYvG,SAASuG,EAAU3G,aAAa,aAAe,KAAM,KAAM,EACpF5D,GAAY,GACd8J,EAAcrH,IAAIzC,EAAUmK,EAEhC,CACF,CAIA,IAAA,MAAYxK,EAAKyD,KAAa5B,KAAKqB,eAAgB,CACjD,MAAM7C,EAAWwB,KAAKkB,KAAK8H,QAAQ7K,GAC7B8K,EAAkBjJ,KAAK9B,aAAaE,IAAID,GACxC+K,EAAe1K,GAAY,GAAK8J,EAAclK,IAAII,GAExD,IAAKyK,IAAoBC,EAAc,CAGrC,MAAMpH,EAAU9B,MAAKD,EAAcgC,mBACnC,GAAID,GAASqH,QAAS,CACpB,MAAMlK,EAAa2C,EAASC,cAAc,uBACpCiE,EAAY7G,GAAYmK,kBAC1BtD,GAAWhE,EAAQqH,QAAQrD,EACjC,CACIlE,EAASgH,YAAYhH,EAASL,SAClCvB,KAAKqB,eAAehD,OAAOF,EAC7B,CACF,CAQA,IAAA,MAAYK,EAAUmK,KAAUL,EAAe,CAC7C,MAAMnK,EAAM6B,KAAKkB,KAAK1C,GACtB,IAAKL,EAAK,SACV,MAAM0H,EAAa7F,KAAK9B,aAAaE,IAAID,GAEzC,GADAwK,EAAMrF,UAAUyC,OAAO,mBAAoBF,IACtCA,EAAY,SAGjB,MAAMzE,EAAiBpB,KAAKqB,eAAeC,IAAInD,GAC/C,GAAIiD,EAAgB,CAEdA,EAAeiI,yBAA2BV,GAC5CA,EAAMW,MAAMlI,GAEd,QACF,CAGA,MAAMQ,EAAWrD,EAAoBJ,EAAKK,EAAUwB,KAAKkC,OAAOC,eAAgBzD,GAExC,iBAA7BsB,KAAKkC,OAAO/B,eACrByB,EAAS1C,MAAMgF,OAAS,GAAGlE,KAAKkC,OAAO/B,kBAIzCwI,EAAMW,MAAM1H,GACZ5B,KAAKqB,eAAeJ,IAAI9C,EAAKyD,GAI7B,MAAM2H,EAAgBvJ,KAAKwE,cAAcpG,IAAID,GACzCoL,GACFvJ,KAAKwE,cAAcnG,OAAOF,GAGRoL,GAAiBvJ,KAAKqD,cAAczB,EAAUzD,EAAKK,IAIrEgL,sBAAsB,KACpBxJ,MAAKyD,EAA6B7B,EAAUzD,EAAKK,IAKvD,CACF,CAWS,YAAAiL,CAAatL,EAAcuL,GAGlC,IAFmB1J,KAAK9B,aAAaE,IAAID,GAKvC,OAQF,OAHmB6B,KAAKC,KAAK0J,kBAAoB,IAC5B3J,KAAKyE,gBAAgBtG,EAG5C,CAMS,kBAAAyL,CAAmB3B,EAAe4B,EAAmBC,GAC5D,GAA+B,IAA3B9J,KAAK9B,aAAaoI,KAAY,OAAO2B,EAGzC,MAAM8B,EAAiB/J,KAAKC,MAAc+H,iBAAiB+B,cAI3D,IAAIC,EAAW/B,EAEf,GAAI8B,GAAiBA,EAAc7G,OAAS,EAE1C,IAAA,MAAW/E,KAAO6B,KAAK9B,aAAc,CACnC,MAAMM,EAAWwB,KAAKkB,KAAK8H,QAAQ7K,GACnC,GAAIK,EAAW,GAAKA,GAAYyJ,EAAO,SAGlB8B,EAAcvL,GAAUyL,OAASF,EAAcvL,GAAU0F,OAE3D2F,GAAarL,EAAWwL,IACzCA,EAAWxL,EAEf,KACK,CAGL,MAAM0L,EAAsD,GAC5D,IAAA,MAAW/L,KAAO6B,KAAK9B,aAAc,CACnC,MAAMiM,EAAQnK,KAAKkB,KAAK8H,QAAQ7K,GAC5BgM,GAAS,GACXD,EAAgBE,KAAK,CAAED,QAAOhM,OAElC,CACA+L,EAAgBG,KAAK,CAACC,EAAGC,IAAMD,EAAEH,MAAQI,EAAEJ,OAE3C,IAAIK,EAAwB,EAE5B,IAAA,MAAaL,MAAO3L,EAAAL,IAAUA,KAAS+L,EAAiB,CACtD,MAAMO,EAAejM,EAAWsL,EAAYU,EACtCrK,EAAeH,KAAKyE,gBAAgBtG,GAG1CqM,GAAyBrK,EAErB3B,GAAYyJ,GAJWwC,EAAeX,EAAY3J,EAM7B0J,GAAarL,EAAWwL,IAC/CA,EAAWxL,EAEf,CACF,CAEA,OAAOwL,CACT,CASA,MAAAU,CAAOlM,GACL,MAAML,EAAM6B,KAAKkB,KAAK1C,GAClBL,IAAQA,EAAI2G,eACd9E,KAAKwE,cAAclG,IAAIH,GACvB6B,KAAK9B,aD/uBJ,SAAyBA,EAA2BC,GAEzD,OADAD,EAAaI,IAAIH,GACVD,CACT,CC4uB0ByM,CAAgB3K,KAAK9B,aAAcC,GACvD6B,KAAKyB,gBAET,CAMA,QAAAmJ,CAASpM,GACP,MAAML,EAAM6B,KAAKkB,KAAK1C,GAClBL,IACF6B,KAAK9B,aDlvBJ,SAA2BA,EAA2BC,GAE3D,OADAD,EAAaG,OAAOF,GACbD,CACT,CC+uB0B2M,CAAkB7K,KAAK9B,aAAcC,GACzD6B,KAAKyB,gBAET,CAMA,MAAAsE,CAAOvH,GACL,MAAML,EAAM6B,KAAKkB,KAAK1C,GAClBL,IAAQA,EAAI2G,eACd9E,KAAK9B,aAAeD,EAAgB+B,KAAK9B,aAAcC,GACnD6B,KAAK9B,aAAaE,IAAID,IACxB6B,KAAKwE,cAAclG,IAAIH,GAEzB6B,KAAKyB,gBAET,CAOA,UAAAoE,CAAWrH,GACT,MAAML,EAAM6B,KAAKkB,KAAK1C,GACtB,QAAOL,GDrwBJ,SAA0BD,EAA2BC,GAC1D,OAAOD,EAAaE,IAAID,EAC1B,CCmwBiB2M,CAAiB9K,KAAK9B,aAAcC,EACnD,CAMA,SAAA4M,GACE,IAAA,MAAW5M,KAAO6B,KAAKkB,KACjB/C,GAAK2G,eACT9E,KAAKwE,cAAclG,IAAIH,GACvB6B,KAAK9B,aAAaI,IAAIH,IAExB6B,KAAKyB,eACP,CAKA,WAAAuJ,GACEhL,KAAK9B,aAAakH,QAClBpF,KAAKyB,eACP,CAMA,eAAAwJ,GACE,MAAMC,EAAoB,GAC1B,IAAA,MAAW/M,KAAO6B,KAAK9B,aAAc,CACnC,MAAMiN,EAAMnL,KAAKkB,KAAK8H,QAAQ7K,GAC1BgN,GAAO,GAAGD,EAAQd,KAAKe,EAC7B,CACA,OAAOD,CACT,CAOA,gBAAAE,CAAiB5M,GACf,MAAML,EAAM6B,KAAKkB,KAAK1C,GACtB,OAAOL,EAAM6B,KAAKqB,eAAeC,IAAInD,QAAO,CAC9C,CAYA,aAAAkN,CAAc7M,GACZ,MAAML,EAAM6B,KAAKkB,KAAK1C,GACtB,OAAOL,EAAM6B,KAAKgB,cAAcM,IAAInD,QAAO,CAC7C,CAOA,eAAAmN,CAAgB9M,GACd,MAAML,EAAM6B,KAAKkB,KAAK1C,GACtB,QAAOL,GAAM6B,KAAKmB,eAAe/C,IAAID,EACvC,CASA,qBAAAoN,GAEE,MAAMC,EAAkBxL,KAAKkC,OAAOC,eAapC,GAZAnC,KAAKkC,OAAS,IAAKlC,KAAKkC,OAAQC,oBAAgB,GAChDnC,KAAKS,uBAGAT,KAAKkC,OAAOC,gBAAkBqJ,IACjCxL,KAAKkC,OAAS,IAAKlC,KAAKkC,OAAQC,eAAgBqJ,IAO9CxL,KAAKkC,OAAOC,eAAgB,CAC9B,MAAMlC,EAAOD,MAAKD,EACiB,mBAAxBE,EAAKwL,eACdxL,EAAKwL,iBAGLzL,KAAKyB,eAET,CACF"}

package/umd/plugins/tree.umd.js

@@ -1,2 +1,2 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("../../core/constants"),require("../../core/internal/sorting"),require("../../core/plugin/base-plugin")):"function"==typeof define&&define.amd?define(["exports","../../core/constants","../../core/internal/sorting","../../core/plugin/base-plugin"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TbwGridPlugin_tree={},e.TbwGrid,e.TbwGrid,e.TbwGrid)}(this,function(e,t,r,i){"use strict";function n(e,t,r){return void 0!==e.id?String(e.id):r?`${r}-${t}`:String(t)}function s(e,t){const r=new Set(e);return r.has(t)?r.delete(t):r.add(t),r}function a(e,t,r=null,i=0){const s=t.childrenField??"children",o=new Set;for(let d=0;d<e.length;d++){const l=e[d],h=n(l,d,r),c=l[s];if(Array.isArray(c)&&c.length>0){o.add(h);const e=a(c,t,h,i+1);for(const t of e)o.add(t)}}return o}function o(e,t,r,i=null,s=0){const a=r.childrenField??"children";for(let d=0;d<e.length;d++){const l=e[d],h=n(l,d,i);if(h===t)return[h];const c=l[a];if(Array.isArray(c)&&c.length>0){const e=o(c,t,r,h,s+1);if(e)return[h,...e]}}return null}function d(e,t,r,i){const n=o(e,t,r);if(!n)return i;const s=new Set(i);for(let a=0;a<n.length-1;a++)s.add(n[a]);return s}function l(e,t){const r=Math.min(t,e.length-1);if(r<0)return 0;let i=r;for(;i>0&&e[i].depth>0;)i--;let n=0;for(let s=0;s<=i;s++)0===e[s].depth&&n++;return n-1}function h(e,t="children"){if(!Array.isArray(e)||0===e.length)return!1;for(const r of e){if(!r)continue;const e=r[t];if(Array.isArray(e)&&e.length>0)return!0;if(null!=e&&!Array.isArray(e)&&e)return!0}return!1}class c extends i.BaseGridPlugin{static manifest={modifiesRowStructure:!0,hookPriority:{processRows:10},incompatibleWith:[{name:"groupingRows",reason:"Both plugins transform the entire row model. TreePlugin flattens nested hierarchies while GroupingRowsPlugin groups flat rows with synthetic headers. Use one approach per grid."},{name:"pivot",reason:"PivotPlugin replaces the entire row and column structure with aggregated pivot data. Tree hierarchy cannot coexist with pivot aggregation."}],events:[{type:"tree-expand",description:"Emitted when tree expansion state changes (toggle, expand all, collapse all). Broadcast to both DOM consumers and plugin bus."}],queries:[{type:"canMoveRow",description:"Returns false for rows with children (parent nodes cannot be reordered)"},{type:"datasource:viewport-mapping",description:"Translates flat viewport row indices to top-level node indices for ServerSide pagination."}]};static dependencies=[{name:"multiSort",required:!1,reason:"Queries sort model for coordinated tree sorting"},{name:"serverSide",required:!1,reason:"Consumes datasource events for lazy-loaded tree data"}];name="tree";styles='@layer tbw-plugins{tbw-grid .cell[data-field=__tbw_expander]{border-inline-end:none!important;padding:0;display:flex;align-items:center;justify-content:flex-start}tbw-grid .header-row .cell[data-field=__tbw_expander]{display:none}tbw-grid .header-row .cell[data-field=__tbw_expander]+.cell{grid-column:1 / 3}tbw-grid .tree-cell-wrapper{display:inline-flex;align-items:center;vertical-align:middle;overflow:visible;padding-inline-start:calc(var(--tbw-tree-depth, 0) * var(--tbw-tree-indent-width, var(--tbw-tree-toggle-size, 1.25em)))}tbw-grid .tree-expander{display:flex;align-items:center;justify-content:flex-start;width:100%;height:100%;box-sizing:border-box}tbw-grid .tree-toggle{cursor:pointer;-webkit-user-select:none;user-select:none;display:inline-flex;align-items:center;justify-content:center;width:var(--tbw-tree-toggle-size, 1.25em);height:var(--tbw-tree-toggle-size, 1.25em);flex-shrink:0}tbw-grid .tree-toggle:hover{color:var(--tbw-tree-accent, var(--tbw-color-accent))}tbw-grid .tree-spacer{width:var(--tbw-tree-toggle-size, 1.25em);height:var(--tbw-tree-toggle-size, 1.25em);display:inline-block;flex-shrink:0}tbw-grid .data-grid-row.tbw-tree-slide-in{animation:tbw-tree-slide-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}tbw-grid .data-grid-row.tbw-tree-fade-in{animation:tbw-tree-fade-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}@keyframes tbw-tree-slide-in{0%{opacity:0;transform:translate(-8px)}to{opacity:1;transform:translate(0)}}@keyframes tbw-tree-fade-in{0%{opacity:0}to{opacity:1}}tbw-grid.tbw-tree-loading .rows-viewport:after{content:"";display:block;height:2px;background:linear-gradient(90deg,transparent,var(--tbw-color-accent, #2563eb),transparent);animation:tbw-tree-loading-bar 1s ease-in-out infinite;position:sticky;bottom:0;left:0;right:0}@keyframes tbw-tree-loading-bar{0%{transform:translate(-100%)}to{transform:translate(100%)}}}';get defaultConfig(){return{childrenField:"children",autoDetect:!0,defaultExpanded:!1,indentWidth:20,showExpandIcons:!0,animation:"slide"}}expandedKeys=new Set;initialExpansionDone=!1;flattenedRows=[];rowKeyMap=new Map;previousVisibleKeys=new Set;keysToAnimate=new Set;sortState=null;loadingKeys=new Set;#e=new WeakMap;#t=new WeakMap;originalTreeColumnRenderer;wrappedTreeColumnField;detach(){const e=this.gridElement?.querySelector(".rows-body");e?.setAttribute("role","grid"),this.expandedKeys.clear(),this.initialExpansionDone=!1,this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),this.keysToAnimate.clear(),this.sortState=null,this.loadingKeys.clear(),this.originalTreeColumnRenderer=void 0,this.wrappedTreeColumnField=void 0}handleQuery(e){if("canMoveRow"===e.type){const t=e.context,r=this.config.childrenField??"children",i=t?.[r];if(Array.isArray(i)&&i.length>0)return!1}if("datasource:viewport-mapping"===e.type){const{viewportStart:t,viewportEnd:r}=e.context;if(0===this.flattenedRows.length)return;return{startNode:l(this.flattenedRows,t),endNode:l(this.flattenedRows,r)+1,totalLoadedNodes:function(e){let t=0;for(const r of e)0===r.depth&&t++;return t}(this.flattenedRows)}}}attach(e){super.attach(e),this.on("datasource:data",e=>{const t=e;t.claimed||(t.claimed=!0)}),this.on("datasource:children",e=>{const t=e;if("tree"!==t.context?.source)return;t.claimed=!0;const r=t.context.parentNode;if(r){r[this.config.childrenField??"children"]=t.rows;const e=this.#e.get(r)??String(r.id??"?");this.loadingKeys.delete(e),this.requestRender()}})}get animationStyle(){return!!this.isAnimationEnabled&&(this.config.animation??"slide")}detect(e){if(!this.config.autoDetect)return!1;const t=e,r=this.config.childrenField??function(e){if(!Array.isArray(e)||0===e.length)return null;const t=["children","items","nodes","subRows","nested"];for(const r of e)if(r&&"object"==typeof r)for(const e of t){const t=r[e];if(Array.isArray(t)&&t.length>0)return e}return null}(t)??"children";return h(t,r)}processRows(e){const t=this.config.childrenField??"children",r=e;if(0===r.length||!h(r,t))return this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),[...e];const i=this.resolveEffectiveSortState();this.config.defaultExpanded&&!this.initialExpansionDone&&(this.expandedKeys=a(r,this.config),this.initialExpansionDone=!0),this.flattenedRows=this.#r(r,this.expandedKeys,i,null,0),this.#t=new WeakMap,this.rowKeyMap.clear(),this.keysToAnimate.clear();const n=new Set;for(const s of this.flattenedRows)this.rowKeyMap.set(s.key,s),this.#t.set(s.data,s),n.add(s.key),!this.previousVisibleKeys.has(s.key)&&s.depth>0&&this.keysToAnimate.add(s.key);return this.previousVisibleKeys=n,this.flattenedRows.map(e=>e.data)}#i(e,t,r){if(void 0!==e.id){const t=String(e.id);return this.#e.set(e,t),t}const i=this.#e.get(e);if(void 0!==i)return i;const n=r?`${r}-${t}`:String(t);return this.#e.set(e,n),n}#r(e,t,r,i,n){const s=this.config.childrenField??"children";for(let d=0;d<e.length;d++)this.#i(e[d],d,i);const a=r?this.#n(e,r.field,r.direction):e,o=[];for(let d=0;d<a.length;d++){const e=a[d],l=this.#i(e,d,i),h=e[s],c=Array.isArray(h)&&h.length>0,p=null!=h&&!Array.isArray(h)&&!!h,u=c||p,f=t.has(l);o.push({key:l,data:e,depth:n,hasChildren:u,isExpanded:f,parentKey:i,posInSet:d+1,setSize:a.length}),c&&f&&o.push(...this.#r(h,t,r,l,n+1))}return o}#n(e,t,i){const n=this.grid,s=n?._columns??[],a={field:t,direction:i},o=[...e],d=(n?.effectiveConfig?.sortHandler??r.builtInSort)(o,a,s);return d&&"function"==typeof d.then?(d.catch(()=>{}),r.builtInSort(o,a,s)):d}requestLazyChildren(e){if(this.loadingKeys.has(e.key))return;const t=this.config.childrenField??"children",r=e.data[t];if(Array.isArray(r)&&r.length>0)return;const i=this.grid?.query?.("datasource:is-active",null);i&&(this.loadingKeys.add(e.key),this.grid.query("datasource:fetch-children",{context:{source:"tree",parentNode:e.data,nodePath:[e.key]}}))}resolveEffectiveSortState(){const e=this.grid?.query?.("sort:get-model",null);if(Array.isArray(e)&&e.length>0){const t=e[0];if(Array.isArray(t)&&t.length>0)return{field:t[0].field,direction:"desc"===t[0].direction?-1:1}}return this.sortState}processColumns(e){if(0===this.flattenedRows.length)return[...e];const r=[...e];if(0===r.length)return r;const{treeColumn:i}=this.config;let n=0;if(i){const e=r.findIndex(e=>e.field===i);e>=0&&(n=e)}const s=r[n],a=s.field;this.wrappedTreeColumnField!==a&&(this.originalTreeColumnRenderer=s.viewRenderer,this.wrappedTreeColumnField=a);const o=this.originalTreeColumnRenderer,d=()=>this.config,l=this.setIcon.bind(this);return r[n]={...s,viewRenderer:e=>{const{row:r,value:i}=e,{showExpandIcons:n=!0,indentWidth:s}=d(),a=this.#t.get(r),h=a?.depth??0,c=document.createElement("span");if(c.className="tree-cell-wrapper",c.style.setProperty("--tbw-tree-depth",String(h)),void 0!==s&&c.style.setProperty("--tbw-tree-indent-width",`${s}px`),n)if(a&&a.hasChildren){const e=document.createElement("span");e.className=`${t.GridClasses.TREE_TOGGLE}${a.isExpanded?` ${t.GridClasses.EXPANDED}`:""}`,l(e,a.isExpanded?"collapse":"expand"),e.setAttribute("data-tree-key",a.key),c.appendChild(e)}else{const e=document.createElement("span");e.className="tree-spacer",c.appendChild(e)}const p=document.createElement("span");if(p.className="tree-content",o){const t=o(e);t instanceof Node?p.appendChild(t):"string"==typeof t&&(p.innerHTML=t)}else p.textContent=null!=i?String(i):"";return c.appendChild(p),c}},r}onCellClick(e){const r=e.originalEvent?.target;if(!r?.classList.contains(t.GridClasses.TREE_TOGGLE))return!1;const i=r.getAttribute("data-tree-key");if(!i)return!1;const n=this.rowKeyMap.get(i);return!!n&&(this.expandedKeys=s(this.expandedKeys,i),this.expandedKeys.has(i)&&this.requestLazyChildren(n),this.broadcast("tree-expand",{key:i,row:n.data,expanded:this.expandedKeys.has(i),depth:n.depth,expandedKeys:[...this.expandedKeys]}),this.requestRender(),!0)}onKeyDown(e){if(" "!==e.key)return;const t=this.grid._focusRow,r=this.flattenedRows[t];return r?.hasChildren?(e.preventDefault(),this.expandedKeys=s(this.expandedKeys,r.key),this.expandedKeys.has(r.key)&&this.requestLazyChildren(r),this.broadcast("tree-expand",{key:r.key,row:r.data,expanded:this.expandedKeys.has(r.key),depth:r.depth,expandedKeys:[...this.expandedKeys]}),this.requestRenderWithFocus(),!0):void 0}onHeaderClick(e){if(0===this.flattenedRows.length||!e.column.sortable)return!1;const t=this.grid?.query?.("sort:get-model",null);if(Array.isArray(t)&&t.length>0)return!1;const{field:r}=e.column;this.sortState&&this.sortState.field===r?1===this.sortState.direction?this.sortState={field:r,direction:-1}:this.sortState=null:this.sortState={field:r,direction:1};const i=this.grid;return void 0!==i._sortState&&(i._sortState=this.sortState?{...this.sortState}:null),this.broadcast("sort-change",{field:r,direction:this.sortState?.direction??0}),this.requestRender(),!0}afterRender(){const e=this.gridElement?.querySelector(".rows-body");e&&"treegrid"!==e.getAttribute("role")&&e.setAttribute("role","treegrid");const t=this.gridElement?.querySelector(".rows");if(!t)return;const r=this.animationStyle,i=!1!==r&&this.keysToAnimate.size>0,n="fade"===r?"tbw-tree-fade-in":"tbw-tree-slide-in";for(const s of t.querySelectorAll(".data-grid-row")){const e=s.querySelector(".cell[data-row]"),t=e?parseInt(e.getAttribute("data-row")??"-1",10):-1,r=this.flattenedRows[t];r&&(s.setAttribute("aria-level",String(r.depth+1)),s.setAttribute("aria-setsize",String(r.setSize)),s.setAttribute("aria-posinset",String(r.posInSet)),r.hasChildren&&s.setAttribute("aria-expanded",String(r.isExpanded)),i&&r.key&&this.keysToAnimate.has(r.key)&&(s.classList.add(n),s.addEventListener("animationend",()=>s.classList.remove(n),{once:!0})))}this.keysToAnimate.clear()}expand(e){this.expandedKeys.add(e);const t=this.rowKeyMap.get(e);t&&this.requestLazyChildren(t),this.requestRender()}collapse(e){this.expandedKeys.delete(e),this.requestRender()}toggle(e){this.expandedKeys=s(this.expandedKeys,e);const t=this.rowKeyMap.get(e);t?(this.expandedKeys.has(e)&&this.requestLazyChildren(t),this.broadcast("tree-expand",{key:e,row:t.data,expanded:this.expandedKeys.has(e),depth:t.depth,expandedKeys:[...this.expandedKeys]})):this.emitPluginEvent("tree-expand",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}expandAll(){this.expandedKeys=a(this.rows,this.config),this.emitPluginEvent("tree-expand",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}collapseAll(){this.expandedKeys=new Set,this.emitPluginEvent("tree-expand",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}isExpanded(e){return this.expandedKeys.has(e)}getExpandedKeys(){return[...this.expandedKeys]}getFlattenedRows(){return[...this.flattenedRows]}getRowMeta(e){return this.#t.get(e)}getRowByKey(e){return this.rowKeyMap.get(e)?.data}expandToKey(e){this.expandedKeys=d(this.rows,e,this.config,this.expandedKeys),this.requestRender()}}e.TreePlugin=c,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("../../core/constants"),require("../../core/internal/sorting"),require("../../core/plugin/base-plugin")):"function"==typeof define&&define.amd?define(["exports","../../core/constants","../../core/internal/sorting","../../core/plugin/base-plugin"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).TbwGridPlugin_tree={},e.TbwGrid,e.TbwGrid,e.TbwGrid)}(this,function(e,t,r,i){"use strict";function n(e,t,r){return void 0!==e.id?String(e.id):r?`${r}-${t}`:String(t)}function s(e,t){const r=new Set(e);return r.has(t)?r.delete(t):r.add(t),r}function a(e,t,r=null,i=0){const s=t.childrenField??"children",o=new Set;for(let d=0;d<e.length;d++){const l=e[d],h=n(l,d,r),c=l[s];if(Array.isArray(c)&&c.length>0){o.add(h);const e=a(c,t,h,i+1);for(const t of e)o.add(t)}}return o}function o(e,t,r,i=null,s=0){const a=r.childrenField??"children";for(let d=0;d<e.length;d++){const l=e[d],h=n(l,d,i);if(h===t)return[h];const c=l[a];if(Array.isArray(c)&&c.length>0){const e=o(c,t,r,h,s+1);if(e)return[h,...e]}}return null}function d(e,t,r,i){const n=o(e,t,r);if(!n)return i;const s=new Set(i);for(let a=0;a<n.length-1;a++)s.add(n[a]);return s}function l(e,t){const r=Math.min(t,e.length-1);if(r<0)return 0;let i=r;for(;i>0&&e[i].depth>0;)i--;let n=0;for(let s=0;s<=i;s++)0===e[s].depth&&n++;return n-1}function h(e,t="children"){if(!Array.isArray(e)||0===e.length)return!1;for(const r of e){if(!r)continue;const e=r[t];if(Array.isArray(e)&&e.length>0)return!0;if(null!=e&&!Array.isArray(e)&&e)return!0}return!1}class c extends i.BaseGridPlugin{static manifest={modifiesRowStructure:!0,hookPriority:{processRows:10},incompatibleWith:[{name:"groupingRows",reason:"Both plugins transform the entire row model. TreePlugin flattens nested hierarchies while GroupingRowsPlugin groups flat rows with synthetic headers. Use one approach per grid."},{name:"pivot",reason:"PivotPlugin replaces the entire row and column structure with aggregated pivot data. Tree hierarchy cannot coexist with pivot aggregation."}],events:[{type:"tree-expand",description:"Emitted when tree expansion state changes (toggle, expand all, collapse all). Broadcast to both DOM consumers and plugin bus."}],queries:[{type:"canMoveRow",description:"Returns false for rows with children (parent nodes cannot be reordered)"},{type:"datasource:viewport-mapping",description:"Translates flat viewport row indices to top-level node indices for ServerSide pagination."}]};static dependencies=[{name:"multiSort",required:!1,reason:"Queries sort model for coordinated tree sorting"},{name:"serverSide",required:!1,reason:"Consumes datasource events for lazy-loaded tree data"}];name="tree";styles='@layer tbw-plugins{tbw-grid .cell[data-field=__tbw_expander]{border-inline-end:none!important;padding:0;display:flex;align-items:center;justify-content:flex-start}tbw-grid .header-row .cell[data-field=__tbw_expander]{display:none}tbw-grid .header-row .cell[data-field=__tbw_expander]+.cell{grid-column:1 / 3}tbw-grid .tree-cell-wrapper{display:inline-flex;align-items:center;vertical-align:middle;overflow:visible;padding-inline-start:calc(var(--tbw-tree-depth, 0) * var(--tbw-tree-indent-width, var(--tbw-tree-toggle-size, 1.25em)))}tbw-grid .tree-expander{display:flex;align-items:center;justify-content:flex-start;width:100%;height:100%;box-sizing:border-box}tbw-grid .tree-toggle{cursor:pointer;-webkit-user-select:none;user-select:none;display:inline-flex;align-items:center;justify-content:center;width:var(--tbw-tree-toggle-size, 1.25em);height:var(--tbw-tree-toggle-size, 1.25em);flex-shrink:0}tbw-grid .tree-toggle:hover{color:var(--tbw-tree-accent, var(--tbw-color-accent))}tbw-grid .tree-spacer{width:var(--tbw-tree-toggle-size, 1.25em);height:var(--tbw-tree-toggle-size, 1.25em);display:inline-block;flex-shrink:0}tbw-grid .data-grid-row.tbw-tree-slide-in{animation:tbw-tree-slide-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}tbw-grid .data-grid-row.tbw-tree-fade-in{animation:tbw-tree-fade-in var(--tbw-animation-duration, .2s) var(--tbw-animation-easing, ease-out) forwards}@keyframes tbw-tree-slide-in{0%{opacity:0;transform:translate(-8px)}to{opacity:1;transform:translate(0)}}@keyframes tbw-tree-fade-in{0%{opacity:0}to{opacity:1}}tbw-grid.tbw-tree-loading .rows-viewport:after{content:"";display:block;height:2px;background:linear-gradient(90deg,transparent,var(--tbw-color-accent, #2563eb),transparent);animation:tbw-tree-loading-bar 1s ease-in-out infinite;position:sticky;bottom:0;left:0;right:0}@keyframes tbw-tree-loading-bar{0%{transform:translate(-100%)}to{transform:translate(100%)}}}';get defaultConfig(){return{childrenField:"children",autoDetect:!0,defaultExpanded:!1,indentWidth:20,showExpandIcons:!0,animation:"slide"}}expandedKeys=new Set;initialExpansionDone=!1;flattenedRows=[];rowKeyMap=new Map;previousVisibleKeys=new Set;keysToAnimate=new Set;sortState=null;loadingKeys=new Set;#e=new WeakMap;#t=new WeakMap;originalTreeColumnRenderer;wrappedTreeColumnField;detach(){const e=this.gridElement?.querySelector(".rows-body");e?.setAttribute("role","grid"),this.expandedKeys.clear(),this.initialExpansionDone=!1,this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),this.keysToAnimate.clear(),this.sortState=null,this.loadingKeys.clear(),this.originalTreeColumnRenderer=void 0,this.wrappedTreeColumnField=void 0}handleQuery(e){if("canMoveRow"===e.type){const t=e.context,r=this.config.childrenField??"children",i=t?.[r];if(Array.isArray(i)&&i.length>0)return!1}if("datasource:viewport-mapping"===e.type){const{viewportStart:t,viewportEnd:r}=e.context;if(0===this.flattenedRows.length)return;return{startNode:l(this.flattenedRows,t),endNode:l(this.flattenedRows,r)+1,totalLoadedNodes:function(e){let t=0;for(const r of e)0===r.depth&&t++;return t}(this.flattenedRows)}}}attach(e){super.attach(e),this.on("datasource:data",e=>{const t=e;t.claimed||(t.claimed=!0)}),this.on("datasource:children",e=>{const t=e;if("tree"!==t.context?.source)return;t.claimed=!0;const r=t.context.parentNode;if(r){r[this.config.childrenField??"children"]=t.rows;const e=this.#e.get(r)??String(r.id??"?");this.loadingKeys.delete(e),this.requestRender()}})}get animationStyle(){return!!this.isAnimationEnabled&&(this.config.animation??"slide")}detect(e){if(!this.config.autoDetect)return!1;const t=e,r=this.config.childrenField??function(e){if(!Array.isArray(e)||0===e.length)return null;const t=["children","items","nodes","subRows","nested"];for(const r of e)if(r&&"object"==typeof r)for(const e of t){const t=r[e];if(Array.isArray(t)&&t.length>0)return e}return null}(t)??"children";return h(t,r)}processRows(e){const t=this.config.childrenField??"children",r=e;if(0===r.length||!h(r,t))return this.flattenedRows=[],this.rowKeyMap.clear(),this.previousVisibleKeys.clear(),[...e];const i=this.resolveEffectiveSortState();this.config.defaultExpanded&&!this.initialExpansionDone&&(this.expandedKeys=a(r,this.config),this.initialExpansionDone=!0),this.flattenedRows=this.#r(r,this.expandedKeys,i,null,0),this.#t=new WeakMap,this.rowKeyMap.clear(),this.keysToAnimate.clear();const n=new Set;for(const s of this.flattenedRows)this.rowKeyMap.set(s.key,s),this.#t.set(s.data,s),n.add(s.key),!this.previousVisibleKeys.has(s.key)&&s.depth>0&&this.keysToAnimate.add(s.key);return this.previousVisibleKeys=n,this.flattenedRows.map(e=>e.data)}#i(e,t,r){if(void 0!==e.id){const t=String(e.id);return this.#e.set(e,t),t}const i=this.#e.get(e);if(void 0!==i)return i;const n=r?`${r}-${t}`:String(t);return this.#e.set(e,n),n}#r(e,t,r,i,n){const s=this.config.childrenField??"children";for(let d=0;d<e.length;d++)this.#i(e[d],d,i);const a=r?this.#n(e,r.field,r.direction):e,o=[];for(let d=0;d<a.length;d++){const e=a[d],l=this.#i(e,d,i),h=e[s],c=Array.isArray(h)&&h.length>0,p=null!=h&&!Array.isArray(h)&&!!h,u=c||p,f=t.has(l);o.push({key:l,data:e,depth:n,hasChildren:u,isExpanded:f,parentKey:i,posInSet:d+1,setSize:a.length}),c&&f&&o.push(...this.#r(h,t,r,l,n+1))}return o}#n(e,t,i){const n=this.grid,s=n?._columns??[],a={field:t,direction:i},o=[...e],d=(n?.effectiveConfig?.sortHandler??r.builtInSort)(o,a,s);return d&&"function"==typeof d.then?(d.catch(()=>{}),r.builtInSort(o,a,s)):d}requestLazyChildren(e){if(this.loadingKeys.has(e.key))return;const t=this.config.childrenField??"children",r=e.data[t];if(Array.isArray(r)&&r.length>0)return;const i=this.grid?.query?.("datasource:is-active",null);i&&(this.loadingKeys.add(e.key),this.grid.query("datasource:fetch-children",{context:{source:"tree",parentNode:e.data,nodePath:[e.key]}}))}resolveEffectiveSortState(){const e=this.grid?.query?.("sort:get-model",null);if(Array.isArray(e)&&e.length>0){const t=e[0];if(Array.isArray(t)&&t.length>0)return{field:t[0].field,direction:"desc"===t[0].direction?-1:1}}return this.sortState}processColumns(e){if(0===this.flattenedRows.length)return[...e];const r=[...e];if(0===r.length)return r;const{treeColumn:i}=this.config;let n=0;if(i){const e=r.findIndex(e=>e.field===i);e>=0&&(n=e)}const s=r[n],a=s.field;this.wrappedTreeColumnField!==a&&(this.originalTreeColumnRenderer=s.viewRenderer,this.wrappedTreeColumnField=a);const o=this.originalTreeColumnRenderer,d=()=>this.config,l=this.setIcon.bind(this);return r[n]={...s,viewRenderer:e=>{const{row:r,value:i}=e,{showExpandIcons:n=!0,indentWidth:s}=d(),a=this.#t.get(r),h=a?.depth??0,c=document.createElement("span");if(c.className="tree-cell-wrapper",c.style.setProperty("--tbw-tree-depth",String(h)),void 0!==s&&c.style.setProperty("--tbw-tree-indent-width",`${s}px`),n)if(a&&a.hasChildren){const e=document.createElement("span");e.className=`${t.GridClasses.TREE_TOGGLE}${a.isExpanded?` ${t.GridClasses.EXPANDED}`:""}`,l(e,a.isExpanded?"collapse":"expand"),e.setAttribute("data-tree-key",a.key),c.appendChild(e)}else{const e=document.createElement("span");e.className="tree-spacer",c.appendChild(e)}const p=document.createElement("span");if(p.className="tree-content",o){const t=o(e);t instanceof Node?p.appendChild(t):"string"==typeof t&&(p.innerHTML=t)}else p.textContent=null!=i?String(i):"";return c.appendChild(p),c}},r}onCellClick(e){const r=e.originalEvent?.target;if(!r?.classList.contains(t.GridClasses.TREE_TOGGLE))return!1;const i=r.getAttribute("data-tree-key");if(!i)return!1;const n=this.rowKeyMap.get(i);return!!n&&(this.expandedKeys=s(this.expandedKeys,i),this.expandedKeys.has(i)&&this.requestLazyChildren(n),this.broadcast("tree-expand",{key:i,row:n.data,expanded:this.expandedKeys.has(i),depth:n.depth,expandedKeys:[...this.expandedKeys]}),this.requestRender(),!0)}onKeyDown(e){if(" "!==e.key)return;const t=this.grid._focusRow,r=this.flattenedRows[t];return r?.hasChildren?(e.preventDefault(),this.expandedKeys=s(this.expandedKeys,r.key),this.expandedKeys.has(r.key)&&this.requestLazyChildren(r),this.broadcast("tree-expand",{key:r.key,row:r.data,expanded:this.expandedKeys.has(r.key),depth:r.depth,expandedKeys:[...this.expandedKeys]}),this.requestRenderWithFocus(),!0):void 0}onHeaderClick(e){if(0===this.flattenedRows.length||!e.column.sortable)return!1;const t=this.grid?.query?.("sort:get-model",null);if(Array.isArray(t)&&t.length>0)return!1;const{field:r}=e.column;this.sortState&&this.sortState.field===r?1===this.sortState.direction?this.sortState={field:r,direction:-1}:this.sortState=null:this.sortState={field:r,direction:1};const i=this.grid;return void 0!==i._sortState&&(i._sortState=this.sortState?{...this.sortState}:null),this.broadcast("sort-change",{field:r,direction:this.sortState?.direction??0}),this.requestRender(),!0}afterRender(){const e=this.gridElement?.querySelector(".rows-body");e&&"treegrid"!==e.getAttribute("role")&&e.setAttribute("role","treegrid");const t=this.gridElement?.querySelector(".rows");if(!t)return;const r=this.animationStyle,i=!1!==r&&this.keysToAnimate.size>0,n="fade"===r?"tbw-tree-fade-in":"tbw-tree-slide-in";for(const s of t.querySelectorAll(".data-grid-row")){const e=s.querySelector(".cell[data-row]"),t=e?parseInt(e.getAttribute("data-row")??"-1",10):-1,r=this.flattenedRows[t];r&&(s.setAttribute("aria-level",String(r.depth+1)),s.setAttribute("aria-setsize",String(r.setSize)),s.setAttribute("aria-posinset",String(r.posInSet)),r.hasChildren?s.setAttribute("aria-expanded",String(r.isExpanded)):s.hasAttribute("aria-expanded")&&s.removeAttribute("aria-expanded"),s.classList.toggle("tbw-row-expanded",r.hasChildren&&r.isExpanded),i&&r.key&&this.keysToAnimate.has(r.key)&&(s.classList.add(n),s.addEventListener("animationend",()=>s.classList.remove(n),{once:!0})))}this.keysToAnimate.clear()}expand(e){this.expandedKeys.add(e);const t=this.rowKeyMap.get(e);t&&this.requestLazyChildren(t),this.requestRender()}collapse(e){this.expandedKeys.delete(e),this.requestRender()}toggle(e){this.expandedKeys=s(this.expandedKeys,e);const t=this.rowKeyMap.get(e);t?(this.expandedKeys.has(e)&&this.requestLazyChildren(t),this.broadcast("tree-expand",{key:e,row:t.data,expanded:this.expandedKeys.has(e),depth:t.depth,expandedKeys:[...this.expandedKeys]})):this.emitPluginEvent("tree-expand",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}expandAll(){this.expandedKeys=a(this.rows,this.config),this.emitPluginEvent("tree-expand",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}collapseAll(){this.expandedKeys=new Set,this.emitPluginEvent("tree-expand",{expandedKeys:[...this.expandedKeys]}),this.requestRender()}isExpanded(e){return this.expandedKeys.has(e)}getExpandedKeys(){return[...this.expandedKeys]}getFlattenedRows(){return[...this.flattenedRows]}getRowMeta(e){return this.#t.get(e)}getRowByKey(e){return this.rowKeyMap.get(e)?.data}expandToKey(e){this.expandedKeys=d(this.rows,e,this.config,this.expandedKeys),this.requestRender()}}e.TreePlugin=c,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
 //# sourceMappingURL=tree.umd.js.map